Logging

Enable request and response logging through the gateway for debugging and observability. Record full HTTP headers, bodies, and metadata.

Deploying applications on Unkey is in public beta. To try it, select Projects in the dashboard sidebar and create a project. Deployed resources are free until August 1, 2026. We’re eager for feedback, so let us know what you think on Discord, X, or email [e-mail].

The logging policy records the full HTTP request and response for every matched request. Use it to debug issues, audit API usage, and understand traffic patterns without adding instrumentation to your application.

What gets logged

The gateway captures the following for each request:

Request data

• HTTP method, host, path, and query string
• Request headers (Authorization headers are redacted)
• Request body

Response data

• Status code
• Response headers
• Response body

Metadata

• Request ID
• Timestamp
• Deployment and instance identifiers
• Client IP address and user agent
• Region

Latency breakdown

Metric	Description
Total latency	End-to-end time from when the gateway received the request
Instance latency	Time your app spent processing the request
Gateway latency	Overhead added by the gateway (policy evaluation, routing)

View logs

Logs are available in the Requests tab of your project in the Unkey dashboard. You can filter by:

• Status code
• HTTP method
• Path
• Deployment
• Environment

The dashboard supports live streaming for real-time monitoring.

Retention

Logs are retained for 30 days.