Monitoring

Monitor QilbeeDB performance and health.

Health Check#

# HTTP health endpoint
curl http://localhost:7474/health

Response:

{
  "status": "healthy",
  "version": "0.1.0",
  "uptime_seconds": 3600
}

Metrics#

System Metrics#

# Get system statistics
curl http://localhost:7474/admin/stats

Response:

{
  "storage": {
    "totalSizeBytes": 1073741824,
    "nodeCount": 1000000,
    "relationshipCount": 5000000
  },
  "memory": {
    "usedBytes": 536870912,
    "availableBytes": 8589934592
  },
  "queries": {
    "totalExecuted": 50000,
    "avgExecutionTimeMs": 25
  }
}

Query Performance#

# Get slow query log
curl http://localhost:7474/admin/slow-queries

Logging#

Configure logging in config.toml:

[logging]
level = "info"  # trace, debug, info, warn, error
format = "json"  # json, text
output = "/var/log/qilbeedb/qilbee.log"

View logs:

# Docker logs
docker logs -f qilbeedb

# File logs
tail -f /var/log/qilbeedb/qilbee.log

Prometheus Integration#

Expose metrics for Prometheus:

[metrics]
enabled = true
address = "0.0.0.0:9090"

Prometheus config:

scrape_configs:
  - job_name: 'qilbeedb'
    static_configs:
      - targets: ['localhost:9090']

Grafana Dashboard#

Import QilbeeDB dashboard: - Query throughput - Response times - Storage usage - Memory usage - Connection count

Alerts#

Set up alerts for: - High query latency (>100ms avg) - Storage near capacity (>80%) - High memory usage (>90%) - Connection pool exhaustion

Next Steps#

Edit this page on GitHub