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

# Troubleshooting

> Diagnose a missing row, silent hooks, or a stale database config for coding-agent telemetry

## First stop: run `openlit doctor`

It prints the resolved config, the cached session count, the installed plugin paths, and TCP-dials your OTLP endpoint. Exit code `1` means at least one failure; `0` (possibly with warnings) means the CLI is wired up correctly.

## No row on the Agents page

The hook never writes to a log file - it emits to stderr, which is captured by the host coding agent's own logs (Claude Code: `~/.claude/logs/`; Cursor: Developer Tools → Console; Codex: `~/.codex/`). Set `OPENLIT_DEBUG_PAYLOAD_DIR=/tmp/openlit-debug` to capture the exact JSON the vendor is sending the hook - useful when fields appear to be missing on the resulting spans.

## Hooks ran but no spans landed

Confirm `openlit configure --show` reports the right endpoint. The CLI never reads `~/.zshrc`; if you set `OPENLIT_*` in your shell rc, source it before launching the agent.

## "Database config not found" on the Agents page

Your OpenLIT installation hasn't run the latest migrations. Restart the `openlit` container or run the migration manually (`pnpm --filter client run migrate`).

***

<Card title="Setup & Configure" href="/latest/openlit/coding-agents/setup-and-configure" icon="download">
  Re-check install, wiring, and endpoint configuration
</Card>