Developer Documentation

Observability

Observability

Every request receives an X-Request-ID response header. The same request ID is included in structured log entries and database-backed request logs.

Tables:

• request_logs
• error_logs
• api_latency_logs
• slow_query_logs

Endpoints:

• GET /v1/admin/observability/requests
• GET /v1/admin/observability/errors
• GET /v1/admin/observability/latency
• GET /v1/admin/observability/slow-queries

Operational notes:

• API errors never expose stack traces when APP_DEBUG=false.
• Slow query logging stores query summaries and hashes, not sensitive parameter values.
• Request logs include method, path, user ID, IP, status code, latency, and user agent.