Skip to content

Commit da645b4

Browse files
committed
docs: refine landing page card content and section ordering
- Update card bullet points for accuracy (log-trace correlation, PPL/PromQL, SDKs) - Mention Prometheus metrics in intro - Move Why section above Quickstarts - Hyperlink semantic conventions in Why section - Use hybrid intro text preserving original voice
1 parent b90ee15 commit da645b4

1 file changed

Lines changed: 11 additions & 11 deletions

File tree

  • docs/starlight-docs/src/content/docs

docs/starlight-docs/src/content/docs/index.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,25 @@ import { LinkCard, CardGrid, Tabs, TabItem, Aside } from '@astrojs/starlight/com
77
import IconCard from '../../components/IconCard.astro';
88
import IconCardGrid from '../../components/IconCardGrid.astro';
99

10-
OpenSearch Observability Stack is an **open-source, OpenTelemetry-native observability platform** ([GitHub](https://github.com/opensearch-project/observability-stack)) for monitoring services, infrastructure, and AI agents. Install locally via Docker Compose — traces, logs, metrics, service maps, and agent tracing out of the box.
10+
OpenSearch Observability Stack is an **open-source, OpenTelemetry-native observability platform** ([GitHub](https://github.com/opensearch-project/observability-stack)) for monitoring services, infrastructure, and AI agents. Install locally via Docker Compose — traces, logs, Prometheus metrics, service maps, and agent tracing out of the box.
1111

1212
## What You Can Do
1313

1414
<IconCardGrid>
15-
<IconCard title="Traces, Logs & Metrics" icon="/docs/icons/app_monitoring.svg" items={["Collect via OTLP", "Correlate across signals", "Search with PPL and PromQL"]} href="/docs/investigate/discover-logs/" />
15+
<IconCard title="Traces, Logs & Metrics" icon="/docs/icons/app_monitoring.svg" items={["Collect via OTLP", "Log-trace correlation", "Search with PPL and PromQL"]} href="/docs/investigate/discover-logs/" />
1616
<IconCard title="Application Monitoring" icon="/docs/icons/app_apm.svg" items={["Auto-generated service maps", "RED metrics from traces", "Latency and error tracking"]} href="/docs/apm/" />
17-
<IconCard title="AI Agent Observability" icon="/docs/icons/app_ml.svg" items={["Trace LLM calls and tool use", "Agent execution graphs", "Token usage and cost tracking"]} href="/docs/ai-observability/" />
17+
<IconCard title="AI Agent Observability" icon="/docs/icons/app_ml.svg" items={["Trace LLM calls, token usage, and tool use", "Agent execution graphs", "Python and JavaScript SDKs"]} href="/docs/ai-observability/" />
1818
<IconCard title="Dashboards & Alerting" icon="/docs/icons/app_dashboard.svg" items={["Custom dashboards", "Anomaly detection", "Slack, email, webhook alerts"]} href="/docs/dashboards/" />
1919
</IconCardGrid>
2020

21+
## Why Observability Stack?
22+
23+
- **Open source**: Fully open source, no vendor lock-in, self-host everything
24+
- **OpenTelemetry-native**: All data ingestion uses OTel protocols and [semantic conventions](https://opentelemetry.io/docs/specs/semconv/)
25+
- **GenAI-first**: Purpose-built views for AI agent tracing using standard `gen_ai.*` attributes
26+
- **Local-first**: Runs entirely on your machine via Docker Compose — no cloud account required
27+
- **Production path**: Same components (OpenSearch, Prometheus, OTel Collector) scale to production
28+
2129
## Quickstarts
2230

2331
<LinkCard title="Install & Explore" href="/docs/get-started/" description="Install the stack and explore traces already flowing from the built-in example services." />
@@ -28,14 +36,6 @@ OpenSearch Observability Stack is an **open-source, OpenTelemetry-native observa
2836
The stack optionally ships with example services — a multi-agent travel planner, weather agent, and events agent that generate agent traces automatically. You can also enable the [OpenTelemetry Demo](https://opentelemetry.io/docs/demo/architecture/), a full microservices e-commerce app for realistic telemetry. Install, open Dashboards, and start exploring — no instrumentation needed.
2937
</Aside>
3038

31-
## Why Observability Stack?
32-
33-
- **Open source**: Fully open source, no vendor lock-in, self-host everything
34-
- **OpenTelemetry-native**: All data ingestion uses OTel protocols and semantic conventions
35-
- **GenAI-first**: Purpose-built views for AI agent tracing using standard `gen_ai.*` attributes
36-
- **Local-first**: Runs entirely on your machine via Docker Compose — no cloud account required
37-
- **Production path**: Same components (OpenSearch, Prometheus, OTel Collector) scale to production
38-
3939
## Community
4040

4141
- [GitHub](https://github.com/opensearch-project/observability-stack) — issues, PRs, discussions

0 commit comments

Comments
 (0)