Skip to main content
Observability gives you visibility into how your agents are performing by capturing a record of every run. Each record includes when the run happened, which model was used, how many tokens were consumed, and whether any errors occurred.

​
What you can see

Each agent run generates spans that capture:
  • Timing – When a run started and ended
  • Model usage – Which model handled the request
  • Token consumption – Input and output token counts
  • Errors – Whether an exception occurred and what type it was

​
When to use

Monitor agent health – Track whether runs are completing successfully and identify patterns in failures. Investigate a failed run – Retrieve spans for a specific run to see where it went wrong. Understand usage and costs – Review token consumption across runs to inform capacity planning and cost management. For implementation details, see Observability SDK guide.
Last modified on June 22, 2026