# Observability

Access project data, detect issues, diagnose findings, and automate repeatable checks with an agent.



Monitor your Supabase project with the tools you already use, as a person or an agent.

## 1. Observe the data

The sources you can query, and where to read them.

- **[Logs](https://supabase.com/docs/guides/observability/advanced-log-filtering):** Query ClickHouse logs from Studio, MCP, or the API. Filter events in the Logs UI.
- **[Metrics API](https://supabase.com/docs/guides/observability/metrics):** Scrape Prometheus-compatible database metrics, or chart a subset in Reports.
- **[Database](https://supabase.com/docs/guides/observability/inspect):** Inspect live Postgres stats from the CLI, the SQL Editor, or MCP.
- **[Advisors](https://supabase.com/docs/guides/observability/advisors):** Pull security and performance findings from Studio, MCP, the CLI, or the API.
- **[Reports](https://supabase.com/docs/guides/observability/reports):** Studio dashboards for API, Auth, Storage, Realtime, and database signals.

## 2. Detect issues

Use queries and checks against those sources to pick up health, security, performance, and usage signals.

- **[Detect issues](https://supabase.com/docs/guides/observability/detecting):** Run health, security, performance, and usage checks against logs and database statistics to pick up a signal.

## 3. Diagnose and resolve

Use a concrete finding, symptom, or error code to identify the cause and apply a known solution.

- **[Diagnose and resolve](https://supabase.com/docs/guides/troubleshooting):** Use a concrete finding, symptom, or error code to identify the cause and apply a known solution.

## 4. Hire an agent

Turn the checks you trust into a read-only routine in your agent harness and run it on a schedule.

- **[Generalist](https://supabase.com/docs/guides/observability/automate-with-agents/all):** Once per day. Run all four checks — health, security, performance, and usage — in one daily pass.
- **[Health monitor](https://supabase.com/docs/guides/observability/automate-with-agents/health):** Once per hour. Watch logs for 5xx spikes and Auth failures.
- **[Security monitor](https://supabase.com/docs/guides/observability/automate-with-agents/security):** Once per day. Review advisor findings and authorization failures.
- **[Performance monitor](https://supabase.com/docs/guides/observability/automate-with-agents/performance):** Once per hour. Find slow queries, lock waits, and missing indexes.
- **[Capacity monitor](https://supabase.com/docs/guides/observability/automate-with-agents/usage):** Once each morning. Track request growth, error rates, and approaching limits.

## Export your data

Send logs and traces to the tools you already run.

- **[Log drains](https://supabase.com/docs/guides/observability/log-drains):** Send project logs to your own destination.
- **[Client-side tracing](https://supabase.com/docs/guides/observability/client-side-tracing):** Propagate W3C trace context from the client through Supabase services.
- **[Sentry integration](https://supabase.com/docs/guides/observability/sentry-monitoring):** Capture supabase-js errors and spans in Sentry.