Tracing
OpenTelemetry tracing for AgentOS agents, teams, and workflows, including filtering, metrics, trace trees, and ClickHouse storage.
| Example | Description |
|---|---|
| Enable AgentOS Tracing | Enable OpenTelemetry tracing for a served agent with one AgentOS flag. |
| Filter Traces Through AgentOS | 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 | 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 | 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 | Keep transactional sessions in SQLite while batching trace spans into a dedicated ClickHouse OLAP store. |