Monitoring and Debugging
Monitor your project, debug errors, and understand what's happening across the Supabase stack.
Debugging with an AI agent? See Debug with AI tools for the MCP tools and agent skill that let it read your logs and advisors.
Debugging#
- Isolate the failing layer, read logs as evidence, and match symptoms to troubleshooting guides.
Debugging guide
- Query events from any Supabase service using the Logs Explorer.
Logging
- Regex filtering, structured-field queries, and field discovery in ClickHouse.
Advanced log filtering
- Searchable index of known error codes, symptoms, and fixes.
Troubleshooting index
- Find sessions blocked by a lock, and cancel or terminate the one responsible.
Diagnosing stuck and blocked queries
Monitoring#
- Forward logs to Datadog, Loki, Axiom, S3, or a custom HTTP endpoint.
Log drains
- Built-in dashboards for API, Auth, Storage, and Realtime activity.
Reports
- Prometheus-compatible database metrics for Grafana and other tools.
Metrics
- Correlate browser requests end-to-end using W3C Trace Context.
Client-side tracing
- Find and fix slow queries using indexes and query plan analysis.
Query optimization
- Send errors to Sentry for alerting and grouping.
Sentry integration