> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/sre-ai-agent/data-sources/opensearch.md).

# OpenSearch

## What the Agent Can Do

* Search logs by keyword, time range, and field filters
* List available indices and their health
* Query using OpenSearch DSL (compatible with Elasticsearch)

## Setup Instructions

1. Log into your **AWS console** or **OpenSearch dashboard**
2. Navigate to your OpenSearch domain
3. Copy the domain endpoint URL
4. Create or use an existing master user with read access
5. Enter the endpoint and credentials in the Pagerly dashboard

## Required Credentials

| Field                       | Description                     | Example                                                      |
| --------------------------- | ------------------------------- | ------------------------------------------------------------ |
| **OpenSearch Endpoint URL** | Your OpenSearch domain endpoint | `https://search-my-domain-abc123.us-east-1.es.amazonaws.com` |

## Context Prompt Tips

> *"Our application logs are in the app-logs-* index pattern. Error logs have level field set to ERROR. Timestamps are in @timestamp."\*

## Docs

* [OpenSearch Service Developer Guide](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/)