Reference

Troubleshooting

Start with the symptom, then the mode.

Details

Start with the symptom, then the mode.

Desktop hook not firing:
- Inspect the installed agent hook and confirm its configured client-api URL
- Check that client-api /health is reachable from the agent environment
- For Individual Open Source, check http://127.0.0.1:9318/health
- Check desktop is signed in/enrolled so approvals and activity can arrive
- Reinstall hooks

Cloud API unhealthy:
- Check DATABASE_URL secret
- Check Cloud SQL attachment
- Run migrations
- Check revision logs

Dashboard missing data:
- Check dashboard-api health
- Check identity sync
- Check organization/tenant mapping