Skip to main content
Use Logs to inspect runtime failures. Use Traces to inspect agent runs. Use Metrics to inspect measurements over time.

Runtime issues

  1. Open Logs.
  2. Find the log entry or time window that matches the issue.
  3. Check the active deployment, server, or route involved.
  4. Use Code to inspect the source linked to the failure.
Load more reads earlier log entries in the same time window.

Agent issues

  1. Open Traces.
  2. Select the agent run that produced the unexpected result.
  3. Review messages, tool calls, and timing.
  4. Use Tools or Agents to adjust the capability that failed.

Metric issues

  1. Open the Metrics panel.
  2. Select the metric and time range that match the issue.
  3. If the panel shows a message, follow the matching row.
The panel never draws a partial chart. Could not load metrics often means the time range and step need more than 11,000 points in one series.

Outside Studio

Agents and MCP clients read the same data with the list_project_logs, query_project_metrics, and list_project_alerts tools. The Observability API describes the limits and cursors.