Steps
- Start from the project that owns the work.
- Check logs for runtime output and operational messages.
- Check traces for request and execution paths.
- Check errors for failure type, message, and affected resource.
- Open run events when the issue belongs to an agent, job, or workflow.
Try it with REST
Search recent error logs:GET /projects/{project_reference}/logs?level=error&limit=50
Terminal
GET /projects/{project_reference}/traces?limit=50
Terminal
API surfaces
| Surface | Start here |
|---|---|
| REST | Logs, Traces, Errors |
| GraphQL | Project Logs, Project Traces |
| MCP | Search Project Logs, Search Project Traces |
Verify
Open the newest matching log or trace. Follow the related run, deployment, or request ID to the owning resource.Choose a signal
| Signal | Use it for |
|---|---|
| Logs | Runtime output and operational messages. |
| Traces | Request and execution paths across services. |
| Errors | Failure type, message, and affected resource. |
| Run events | Ordered execution history. |
| Usage | Resource consumption over time. |
Next
| Goal | Page |
|---|---|
| Understand observability signals | Observability |
| Inspect execution history | Runs and events |
| Check usage and limits | Check usage and limits |