Troubleshooting - Snapsec Suite

Common Diagnostics

# 1. Check overall cluster service health
sudo snapsec-ctl healthcheck

# 2. View real-time application logs
sudo docker compose logs -f app

# 3. Inspect worker queue backlog
sudo snapsec-ctl queue-status

# 4. Test database connectivity
sudo snapsec-ctl db-ping

Database Connection Exhaustion

Symptom: Web console returns 500 Internal Server Error with connection pool exhausted.
Fix: Increase max_connections in postgresql.conf and tune DATABASE_POOL_SIZE in /opt/snapsec/.env.