Skip to main content

KG health and monitoring

You can monitor the KG through MCP health tools, the CLI pipeline verifier, and queue health endpoints. Use these before deciding a graph repair is needed.

Health tool

okto_pulse_kg_health(board_id="...")
The response reports queue depth, oldest pending age, dead-letter count, decay tick freshness, relevance score distribution, and graph availability.

Pipeline health CLI

okto-pulse verify-pipeline <board_id> --json
{"ok": true, "checks": []}

Relevance score histogram

The health surface includes score distribution so operators can detect stale or low-confidence graph content.

Alert thresholds

KG_QUEUE_ALERT_THRESHOLD controls when queue depth should be surfaced as unhealthy or warning-level.

Decay tick monitoring

Decay tick freshness depends on KG_DECAY_TICK_INTERVAL_MINUTES, KG_DECAY_TICK_STALENESS_DAYS, and KG_DECAY_TICK_MAX_AGE_DAYS.
Last modified on May 9, 2026