trace-analytics
Trace Analytics lets you explore distributed traces and spans stored in OpenSearch to diagnose latency, errors, and service dependencies. Query span data with PPL, reconstruct trace trees, examine agent invocations and tool executions, and measure token usage across your system.
Trace Analytics helps you investigate distributed traces and spans in OpenSearch to debug performance and errors.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-22
Trace Analytics helps you investigate distributed traces and spans in OpenSearch to debug performance and errors. Trace Analytics lets you explore distributed traces and spans stored in OpenSearch to diagnose latency, errors, and service dependencies. Query span data with PPL, reconstruct trace trees, examine agent invocations and tool executions, and measure token usage across your system.
Use it when
- Trace Analytics enables you to debug slow spans by analyzing trace latency and performance metrics.
- Trace Analytics helps you find and analyze error spans and exceptions in distributed systems.
Verify before relying
Read SKILL.md below before installing (2 files). Open directory: indexed for reading, not audited.
Install
opensearch-project/opensearch-agent-skills/trace-analytics · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I investigate distributed traces in OpenSearch?
Trace Analytics helps you investigate distributed traces in OpenSearch by letting you explore spans and trace data through an intuitive interface. You can query span information using PPL, reconstruct full trace trees by traceId, and correlate spans across services to understand request flow through your distributed system.
How can I find and debug slow spans in my traces?
Trace Analytics enables you to debug slow spans by analyzing trace latency and performance metrics. Filter spans by duration, identify performance bottlenecks, and examine individual span details to pinpoint which services or operations are causing delays in your distributed system.
What does Trace Analytics do for error analysis?
Trace Analytics helps you find and analyze error spans and exceptions in distributed systems. Search for spans with specific error status codes, examine exception details, and trace errors across service boundaries to understand how failures propagate through your OpenTelemetry-instrumented applications.
Can Trace Analytics track agent invocations and token usage?
Yes, Trace Analytics lets you track agent invocations and measure token usage from traces. Monitor tool executions, analyze gen_ai operation traces, and correlate token consumption across your system to understand resource usage patterns in agentic workflows.
How does Trace Analytics help with service dependency mapping?
Trace Analytics lets you query service maps and understand service dependencies by visualizing how services communicate through distributed traces. Examine service topology, identify inter-service relationships, and troubleshoot slow distributed traces by understanding the full dependency graph.
What's required to set up Trace Analytics in OpenSearch?
Trace Analytics works with OpenSearch trace data from OpenTelemetry instrumentation. Store your OTEL spans in OpenSearch, then use Trace Analytics to query and visualize the trace tree. The skill operates under Apache-2.0 license and integrates with your existing OpenSearch deployment.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
OpenSearch Trace Analytics
You are an OpenSearch trace analytics specialist. You help users investigate distributed traces, analyze span performance, debug errors, and understand service dependencies.
Prerequisites
- A running OpenSearch cluster with OTel trace data (typically
otel-v1-apm-span-*) uvinstalled (for running helper scripts)
Optional MCP Servers
```json { "mcpServers": { "ddg-search": { "command": "uvx", "args":
(truncated - see the full file via the links below)
File tree — 2 files
skills/opensearch-skills/observability/trace-analytics/SKILL.md
skills/opensearch-skills/observability/trace-analytics/traces.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Investigate and analyze distributed traces and spans in OpenSearch”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
agentcore-investigation lets you troubleshoot Bedrock AgentCore runtime sessions by querying CloudWatch Logs Insights with structured and glob-style parsing. It resolves session-to-trace relationships through OpenTelemetry span correlation, filters instrumentation noise, and surfaces errors, tool invocations, token usage, and performance metrics in timeline format.
Provision and configure Amazon OpenSearch Service domains or Serverless collections, then deploy your search configurations to AWS. Handles infrastructure setup, IAM role configuration, Bedrock connector integration, and supports both managed domains and serverless deployments with optional agentic search capabilities.
OpenSearch Launchpad is your guided path from initial requirements to a fully operational search system. It handles data ingestion, strategy selection (keyword, semantic, hybrid, or agentic), and deployment to either local Docker or Amazon OpenSearch Serverless. The skill walks you through architecture planning and launches a search UI ready for queries.
Observability is a category skill for log analytics and trace investigation in OpenSearch. It routes you to specialized skills for querying logs to spot errors and patterns, or for investigating distributed traces to debug latency and service dependencies.
OpenSearch Skills provides a modular toolkit for constructing search applications with advanced retrieval strategies including vector and semantic search, plus observability features for log analysis and trace investigation. Deploy locally or to AWS, process documents at scale, and route queries intelligently across search, observability, and cloud infrastructure tasks.
This skill automates the setup and teardown of Amazon OpenSearch Serverless NextGen collections, handling encryption policies, network policies, collection groups, and collections in the correct dependency order. Choose from simple defaults, advanced customization, standalone collections, or add to existing groups. Includes safeguards for valid OCU capacity, mandatory standby replicas, and confirmation before deletion.
More skills search (Apache-2.0) · cloud (Apache-2.0) · ingest (Apache-2.0) · document-processing (Apache-2.0)