analytics_connection_failed - Unkey Docs

err:unkey:data:analytics_connection_failed

Your analytics query couldn’t run because of a failure on our side. Nothing about the query caused it. You get HTTP 503.

Example response

{
  "meta": {
    "requestId": "req_2c9a0jf23l4k567"
  },
  "error": {
    "detail": "Failed to connect to ClickHouse analytics database",
    "status": 503,
    "title": "Service Unavailable",
    "type": "/errors/unkey/data/analytics_connection_failed"
  }
}

How to fix

Retry with exponential backoff. It usually clears quickly.
Check the Unkey status page for an incident.
If it keeps failing, contact support with the requestId.

err:unkey:data:analytics_not_configured: analytics isn’t enabled for your workspace.
err:unkey:application:service_unavailable: other failures on our side, reported as 500.
err:user:unprocessable_entity:query_execution_timeout: the query ran but timed out.

Last modified on October 6, 2026

⌘I