Diagnostics
Troubleshooting
Symptom-based decision trees for the most common issues.
System is slow
- 1Check worker queue backlog
- 2Review PostgreSQL long-running queries
- 3Inspect cache hit ratio
- 4Escalate to L2 if unresolved
Login fails
- 1Confirm SSO IdP status
- 2Check user role and MFA setup
- 3Review SAML clock skew
- 4Reset password from admin
Emails not sending
- 1Verify SMTP credentials
- 2Check DKIM/SPF records
- 3Inspect mail queue
- 4Review recipient reputation
Reports failing
- 1Check report parameters
- 2Review data volume vs timeout
- 3Rebuild aggregates
- 4Escalate for query tuning
Integration errors
- 1Verify API credentials
- 2Check rate limits
- 3Inspect webhook signatures
- 4Retry with exponential backoff
Data import stuck
- 1Check schema mapping
- 2Inspect duplicate keys
- 3Validate encoding (UTF-8)
- 4Resume from last checkpoint
