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.