> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# KG health and monitoring

> Monitor queue depth, dead letters, decay tick freshness, and relevance distribution.

# 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

```text theme={null}
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

```bash theme={null}
okto-pulse verify-pipeline <board_id> --json
```

```json theme={null}
{"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`.

## Related pages

* [Dead-letter queue](/kg-operations/dead-letter)
* [KG settings](/configuration/server-config)
* [KG health tools](/reference/mcp/kg/health)