Troubleshooting
Start here when something isn’t working.
Quick health check
Section titled “Quick health check”curl http://localhost:8080/observe/doctor | jqBy symptom
Section titled “By symptom”| Symptom | Where to look |
|---|---|
| Illegal instruction / missing CPU feature | CPU Compatibility |
| Queries are slow | Slow Queries |
| Can’t connect (LDAP/REST) | Connection Issues |
| Errors in responses | Error Handling |
| Config not applied | FAQ — Print resolved config |
| Need more log detail | FAQ — Enable debug logging |
| MCP OAuth callback fails (Cursor) | MCP Cursor Callback |
Related
Section titled “Related”- Health and Monitoring — Dashboards and operational workflows
- Signals — Golden signals and error classification
- PromQL Recipes — Alert queries and dashboards
- Logging and Traces — Trace layout and debugging
- Error Handling — Error codes, retries, and support workflow
Getting help
Section titled “Getting help”See Report an issue for what to include in support requests.