Get Started
The OpenSearch Observability Stack is an open-source, OpenTelemetry-native observability platform. It runs locally via Docker Compose and provides traces, logs, metrics, dashboards, service maps, and AI agent tracing out of the box.
Prerequisites
Section titled “Prerequisites”- Docker and Docker Compose (v2.20+)
- At least 8 GB of available RAM
- macOS, Linux, or WSL2 on Windows
Installation
Section titled “Installation”Run the interactive installer:
curl -fsSL https://raw.githubusercontent.com/opensearch-project/observability-stack/main/install.sh | bashThe installer TUI guides you through component selection and configuration. Once complete, the stack starts automatically.
What gets installed
Section titled “What gets installed”| Component | Purpose |
|---|---|
| OpenTelemetry Collector | Receives traces, logs, and metrics via OTLP |
| Data Prepper | Processes traces, generates service maps and RED metrics |
| OpenSearch | Stores and indexes all observability data |
| Prometheus | Scrapes and stores time-series metrics |
| OpenSearch Dashboards | Visualizes data, agent traces, and service maps |
Next steps
Section titled “Next steps”- Platform Overview — architecture and data flow
- Core Concepts — key terms and ideas
- Quickstart — send your first traces