Troubleshooting
Owner: Operations
Reviewers: Engineering, DevOps
Status: Draft
Version: 0.1
Last Updated: 2026-09-16
Review Cycle: Per recurring incident
Quick Paths
| Symptom | First Checks |
|---|---|
| API unavailable | /api/health, backend logs, database connectivity. |
| Web cannot login | API base URL, auth endpoint, CORS, token refresh. |
| Mobile cannot connect | Mobile .env, API URL, network reachability. |
| Reports fail | Backend report logs, database query, export permissions. |
| Telemetry missing | MQTT broker, Telegraf logs, worker logs, sensor mapping. |
| Device command stuck | Command broker config, ACK callback, timeout job. |
References
../current/workflows/iot-local-build-guide.md../../k8s/README.md../04-architecture/integrations.md