📊 Observability
Grafana Dashboards
Visualize Gauzy metrics with Grafana.
Setup
Docker Compose
grafana:
image: grafana/grafana:latest
environment:
GF_SECURITY_ADMIN_PASSWORD: admin
ports:
- "3001:3000"
volumes:
- grafana-data:/var/lib/grafanaConnect to Prometheus
- Open Grafana at
http://localhost:3001 - Go to Settings → Data Sources
- Add Prometheus
- URL:
http://prometheus:9090 - Click Save & Test
Recommended Dashboards
API Performance
| Panel | Query |
|---|---|
| Request Rate | rate(http_requests_total[5m]) |
| Avg Latency | histogram_quantile(0.5, rate(http_request_duration_seconds_bucket[5m])) |
| P99 Latency | histogram_quantile(0.99, ...) |
| Error Rate | rate(http_requests_total{status=~"5.."}[5m]) |
System Health
| Panel | Query |
|---|---|
| Memory Usage | nodejs_heap_size_bytes |
| Active Connections | active_connections |
| CPU Usage | process_cpu_seconds_total |
Business Metrics
| Panel | Query |
|---|---|
| Active Timers | timer_active_count |
| Jobs Processed | rate(background_jobs_total[5m]) |
| DB Query Time | histogram_quantile(0.95, rate(db_query_duration_seconds_bucket[5m])) |
Alerting
Configure alerts in Grafana:
- alert: HighErrorRate
expr: rate(http_requests_total{status=~"5.."}[5m]) > 0.1
for: 5m
labels:
severity: critical
annotations:
summary: High 5xx error rateRelated Pages
- Prometheus Metrics — metric collection
- Sentry Error Tracking — error monitoring