> ## Documentation Index
> Fetch the complete documentation index at: https://docs.foggyhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenSearch

> Query logs from OpenSearch during investigations.

Connect OpenSearch so Foggy can search your application and infrastructure logs.

## What Foggy can do

| Tool     | Description                             |
| -------- | --------------------------------------- |
| **Logs** | Search, filter, and analyse log streams |

## Setup

Go to **Connectors** → **Add Connector** → **OpenSearch** and fill in the form.

| Field     | Required | Description                                                                                                    |
| --------- | -------- | -------------------------------------------------------------------------------------------------------------- |
| **Name**  | Yes      | Label for this connector (e.g. "Production OpenSearch")                                                        |
| **Host**  | Yes      | Your OpenSearch endpoint (e.g. `https://opensearch.my-company.com`)                                            |
| **Token** | No       | Bearer token for authenticated access. Omit if your cluster is open or sits behind a network-level auth proxy. |

<Info>
  **Read-only.** Foggy only issues search queries — no index writes, no cluster mutations.
</Info>

## Troubleshooting

* **401 / 403 on every query** — cluster requires auth; enter a bearer token.
* **Timeouts from self-hosted clusters** — the Foggy agent must reach the OpenSearch endpoint over the network. For private clusters, deploy the Satellite agent (see [Self-Hosted → Install Foggy](/self-hosted/getting-started)).

## Next steps

<CardGroup cols={2}>
  <Card title="Grafana" icon="chart-line" href="/integrations/grafana">
    Query dashboards, metrics, and alerts from Grafana.
  </Card>

  <Card title="Kubernetes" icon="server" href="/integrations/kubernetes">
    Monitor cluster health alongside log search.
  </Card>
</CardGroup>