Gets data for a debug session (internal only)
Gets data for a debug session (internal only)
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
application/json
Response
Data response
Authentication
Path Parameters
List debug session traces
Returns a list of debug session traces using time range and selectors
Query Parameters
Unix epoch start time in seconds
Unix epoch start time in seconds
limit number of traces in a debug session
Default:500
Comma-separated list of span attribute keys (e.g. span.http.response.status_code,span.http.request.method,span.url.full)
A list of data plane node IDs to filter traces. Usage filter[node_id]={node_id1}&filter[node_id]={node_id2}.
Example:39596fd9-0b88-4728-9957-9a2be978d8ef
A list of status code groups to filter traces. Usage filter[status_code_group]=4XX&filter[status_code_group]=5XX.
Allowed values:2XX3XX4XX5XX
Example:2XX
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Debug Session identifier
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Response
application/json
Response
List of traces response
ListDebugSessionTracesResponse
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Get debug session trace
Returns a Trace in a debug session by ID
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Debug Session identifier
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Unique identifier of the trace.
Example:0b419ff749c4dabf5f45b0cfee053bc1
Response
application/json
Response
Trace response
Trace
Show Child Parameters
Authentication
Path Parameters
Get the captures for a trace
Returns the request/response body/headers for a trace ID as part of the session capture
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Debug Session identifier
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Unique identifier of the trace.
Example:0b419ff749c4dabf5f45b0cfee053bc1
Response
application/json
Response
The capture content for a trace ID
TraceCaptures
Represents the request/response captures associated with a trace
The captured request body
The captured request headers
The captured response body
The captured response headers
Authentication
Path Parameters
Download traces and logs for a trace ID
Downloads traces and associated logs and payload for a specific trace ID in a debug session as a ZIP file.
The ZIP file contains separate JSON files:
trace.json: Complete trace data (same format as getTraceById)logs.json: Associated logs array (same format as log search responses)captures.json: Request/response captures (same format as getCapturesForTrace)
Files are only included based on the request parameters (include_logs, include_captures).
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Debug Session identifier
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Unique identifier of the trace.
Example:0b419ff749c4dabf5f45b0cfee053bc1
Body
application/json
Body
TraceDownloadRequest
Request payload for downloading traces and logs for a specific trace ID
Whether to include associated logs in the ZIP file
Default:true
Key-value pairs to filter logs based on specific attributes.
Show Child Parameters
Whether to include request/response captures in the ZIP file
Default:true
The format for the downloaded data (currently only ZIP is supported)
Allowed values:zip
Default:zip
Response
application/zip
Response
ZIP file containing separate JSON files for traces, logs, and captures for the specified trace ID
ZIP file containing separate JSON files (trace.json, logs.json, captures.json)