System

System API

Health checks, metrics, and gateway logs for monitoring and observability.

GET
/healthz

Health check. Returns 200 when healthy, 503 when degraded.

jsonResponse
{
  "status": "ok",
  "components": {
    "postgresql": { "status": "ok" },
    "redis": { "status": "ok" }
  }
}
GET
/api/metrics

JSON-formatted metrics snapshot.

jsonResponse
{
  "total_requests": 15432,
  "total_tokens": 2847293,
  "avg_latency_ms": 342,
  "providers": {
    "openai": { "requests": 12000, "errors": 12 },
    "anthropic": { "requests": 3432, "errors": 3 }
  },
  "uptime_seconds": 86400
}
GET
/api/logs

Recent gateway logs. Filter with ?provider= and ?model=.

ParameterDescription
providerFilter by provider name
modelFilter by model name

Metrics Exposed

  • Request count by provider, model, and status code
  • Latency histograms (p50, p95, p99)
  • Token usage counters
  • Eval pass/fail rates