> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracing

> OpenTelemetry tracing for AgentOS agents, teams, and workflows, including filtering, metrics, trace trees, and ClickHouse storage.

| Example | Description |
| - | - |
| [Enable AgentOS Tracing](https://agno-v2.mintlify.site/examples/agent-os/observability/basic.md) | Enable OpenTelemetry tracing for a served agent with one AgentOS flag. |
| [Filter Traces Through AgentOS](https://agno-v2.mintlify.site/examples/agent-os/observability/filtering.md) | Build a composable FilterExpr, apply it directly to the tracing database, and send the same expression to POST /traces/search. |
| [Refresh and Read AgentOS Metrics](https://agno-v2.mintlify.site/examples/agent-os/observability/metrics.md) | Create a persisted agent run, refresh daily aggregates through POST /metrics/refresh, then read the stored result through GET /metrics. |
| [Read Trace Trees Through AgentOS](https://agno-v2.mintlify.site/examples/agent-os/observability/read-traces.md) | Generate one synchronous and one asynchronous agent run, list their traces through GET /traces, then fetch GET /traces/{trace_id} and print each nested span tree. |
| [Route AgentOS Traces to ClickHouse](https://agno-v2.mintlify.site/examples/agent-os/observability/traces-to-clickhouse.md) | Keep transactional sessions in SQLite while batching trace spans into a dedicated ClickHouse OLAP store. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.