Troubleshooting
Start here when something isn’t working.
Quick health check
Section titled “Quick health check”curl -H "Authorization: Bearer <token>" 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 |
/api is 404, or the UI shows no entries | API & Networking — Troubleshooting |
| Errors in responses | Error Handling |
| Config not applied | Configuration — Debug configuration loading |
| Need more log detail | FAQ — How do I debug a problem? |
| 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 Reporting to support for what to include in support requests.