Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Health & Metrics

Liveness and observability endpoints. No authentication required for /health.

GET /api/v1/health

Returns runtime liveness status.

Response 200 OK

{"status": "ok"}

Returns 503 Service Unavailable if the runtime is shutting down.

GET /api/v1/metrics

Returns Prometheus-format metrics. Requires authentication.

Response 200 OK (text/plain; charset=utf-8)

# HELP akshi_build_info Build metadata.
# TYPE akshi_build_info gauge
akshi_build_info{version="0.5.0",commit="a1b2c3d"} 1

# HELP akshi_agents_total Current number of loaded agents.
# TYPE akshi_agents_total gauge
akshi_agents_total 3

# HELP akshi_agent_restarts_total Cumulative agent restart count.
# TYPE akshi_agent_restarts_total counter
akshi_agent_restarts_total{agent="log-monitor"} 0
akshi_agent_restarts_total{agent="researcher"} 1

# HELP akshi_inference_requests_total Inference requests routed.
# TYPE akshi_inference_requests_total counter
akshi_inference_requests_total{route="local"} 42
akshi_inference_requests_total{route="cloud"} 7

# HELP akshi_fuel_consumed_total WASM fuel consumed.
# TYPE akshi_fuel_consumed_total counter
akshi_fuel_consumed_total{agent="log-monitor"} 128000

Key metric families

MetricTypeDescription
akshi_build_infogaugeVersion and commit metadata
akshi_agents_totalgaugeNumber of loaded agents
akshi_agent_restarts_totalcounterPer-agent restart count
akshi_inference_requests_totalcounterInference requests by route type
akshi_fuel_consumed_totalcounterWASM fuel consumed per agent
akshi_sync_envelopes_totalcounterSync envelopes sent/received
akshi_approvals_pendinggaugePending approval requests
akshi_http_request_duration_secondshistogramAPI request latency