DocumentationFauxDB Documentation

FauxDB Monitoring & Observability

Prometheus Metrics

Enable and configure Prometheus metrics for FauxDB.

Enable metrics in configuration

[monitoring]
prometheus_enabled = true
prometheus_port = 9090
metrics_path = "/metrics"

Access metrics at: http://localhost:9090/metrics

Available Metrics

FauxDB exposes the following Prometheus metrics:

Connection Metrics

fauxdb_connections_total - Total number of connections (Counter)
fauxdb_connections_active - Active connections (Gauge)

Query Metrics

fauxdb_queries_total - Total queries executed (Counter)
fauxdb_query_duration_seconds - Query execution time (Histogram)

PostgreSQL Pool Metrics

fauxdb_pg_pool_size - PostgreSQL connection pool size (Gauge)
fauxdb_pg_pool_idle - Idle connections in pool (Gauge)

Transaction Metrics

fauxdb_transactions_total - Total transactions (Counter)
fauxdb_transaction_duration_seconds - Transaction duration (Histogram)

Grafana Dashboard

Import the official FauxDB Grafana dashboard for visualization.

Import dashboard

# Dashboard ID: fauxdb-overview
# Download from: https://grafana.com/dashboards/fauxdb

# Or manually configure:
1. Add Prometheus data source
2. Import dashboard JSON from /monitoring/grafana-dashboard.json
3. Configure variables for your environment

Health Checks

Monitor FauxDB health and status endpoints.

Health check endpoints

# Basic health check
curl http://localhost:9090/health

# Detailed status
curl http://localhost:9090/status

# Database connectivity
curl http://localhost:9090/db/health