> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snapsec.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Diagnostic procedures, health checks, log inspection, and common administrative solutions.

### Common Diagnostics

```bash theme={null}
# 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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.