Audit Issues

Troubleshooting audit logging problems.

Audit Events Not Logging

Worker Not Running

Check:

1. Verify the background worker is running: npm run worker
2. Check worker logs for errors
3. Verify worker in Docker: docker compose ps

Solutions:

1. Start the background worker: npm run worker
2. Check worker logs
3. Verify environment variables

Events Queued But Not Processed

Check:

1. Worker is running
2. Database connection working
3. Queue status: Check pgboss.job table

Solutions:

1. Restart the background worker
2. Check database connection
3. Verify AUDIT_WORKER_CONCURRENCY setting

Queue Issues

Jobs Stuck

Check:

SELECT * FROM pgboss.job
WHERE name = 'audit-events' AND state IN ('created', 'retry')
ORDER BY created_on DESC;

Solutions:

1. Restart worker
2. Check for database locks
3. Verify job TTL settings

Related Topics

• Audit Logs - Audit system
• Background Workers - Worker management