Sign in
Proxy Logs

Get a proxy log by request ID (for tracing)

Changed on
get/proxy-logs/request/{request_id}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/proxy-logs/request/{request_id}
  • Auth: HTTP bearer

Path parameters

request_idstring required

Request ID from pingora

Query parameters

project_idinteger nullable

Project scope for the lookup. Required for non-administrator callers. Instance administrators may omit it for legacy global deep links.

timestampstring date-time nullable

Event time of the log row (ISO 8601). When provided, the lookup is bounded to the hypertable chunks around this instant instead of scanning (and decompressing) the whole retention window. The list endpoint already returns this value per row — always pass it when navigating from a list.

Response

Proxy log found

bot_namestring nullable
browserstring nullable
browser_versionstring nullable
cache_statusstring nullable
client_ipstring nullable
container_idstring nullable
deployment_idinteger nullable
device_typestring nullable
environment_idinteger nullable
error_messagestring nullable
hoststring required
idinteger required
ip_geolocation_idinteger nullable
is_botboolean nullable
is_system_requestboolean required
methodstring required
operating_systemstring nullable
pathstring required
project_idinteger nullable
query_stringstring nullable
referrerstring nullable
request_headersobject nullable

Inbound request headers, credential values already replaced with [REDACTED] at ingest (see [crate::redaction]). None when the entry predates header capture or was written by a path that doesn't record them; an empty map means "captured, but no headers", which is different and worth being able to tell apart.

A BTreeMap rather than a raw serde_json::Value so the schema stays typed and the UI gets a stable alphabetical ordering for free.

request_idstring required
request_size_bytesinteger nullable
request_sourcestring required
response_headersobject nullable

Upstream response headers, redacted on the same terms as [Self::request_headers].

response_size_bytesinteger nullable
response_time_msinteger nullable
routing_statusstring required
session_idinteger nullable
status_codeinteger required
timestampstring required
upstream_hoststring nullable
user_agentstring nullable
visitor_idinteger nullable

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status