Search Distinct Values in Control Plane Logs
Retrieve distinct values for a specified field in control plane logs with optional filtering
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Field to filter logs by distinct values.
Allowed values:log_levelnode_idnode_version
Example:log_level
Body
application/json
Body
Request body for searching control plane logs.
Represents the request payload for searching control plane logs.
The start time for the log search query. Must be in RFC-3339 format.
The end time for the log search query. Must be in RFC-3339 format.
A list of data plane node IDs to filter logs.
The log level for control plane logs.
Allowed values:DEBUGINFOWARNERROR
Key-value pairs to filter logs based on specific attributes.
Show Child Parameters
Specifies the sorting order for the logs in the response.
Show Child Parameters
Response
application/json
Response
Response containing distinct values for a specific attribute in control plane logs
DistinctValuesResponse
Represents distinct values for a specific attribute
A list of distinct values for the specified attribute
Authentication
Path Parameters
Body
Cloud Gateway Logs
Cloud Gateway Logs APIs
Search cloud gateway logs
Search logs for a cloud gateway with filtering capabilities
Query Parameters
The maximum number of items to include per page. The last page of a collection may include fewer items.
Example:10
Request the next page of data, starting with the item after this parameter.
Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
Request the next page of data, starting with the item before this parameter.
Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Body
application/json
Body
Request body for searching cloud gateway logs.
CGWLogSearchRequestSchema
Base schema for searching cloud gateway logs.
The start time for the log search query. Must be in RFC-3339 format.
The end time for the log search query. Must be in RFC-3339 format.
A list of data plane node IDs to filter logs.
Specifies the sorting order for the logs in the response.
Show Child Parameters
Response
application/json
Response
Matching OTel CGW data plane logs
LogSearchResponse
Show Child Parameters
Represents a log entry based on the OpenTelemetry (OTel) data model.
Example:{"span_id":"090a0b0c0d0e0f00","trace_id":"ff0102030405060708090a0b0c0d0e0f","timestamp":"2025-04-22T14:12:00.123Z","observed_timestamp_ns":1749449968177456600,"severity_text":"ERROR","severity_number":17,"body":"Timeout from downstream service","attributes":{"user_id":"user-123","request_id":"abc-123","check_number":2344},"resource":{"attributes":{"service.name":"Kong","service.version":"1.2.3"}},"scope":{"attributes":{"log_body_decryption_error\"":"error decrypting log"}}}
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Body
Count cloud gateway logs
Count logs for a cloud gateway with filtering capabilities
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Body
application/json
Body
Request body for searching cloud gateway logs.
CGWLogSearchRequestSchema
Base schema for searching cloud gateway logs.
The start time for the log search query. Must be in RFC-3339 format.
The end time for the log search query. Must be in RFC-3339 format.
A list of data plane node IDs to filter logs.
Specifies the sorting order for the logs in the response.
Show Child Parameters
Response
application/json
Response
Count of matching OTel CGW data plane logs
LogCountResponse
Represents the count response for log search queries.
The total number of logs matching the search criteria.
Authentication
Path Parameters
Body
Download cloud gateway logs as CSV
Download logs for a cloud gateway with filtering capabilities in CSV format
Path Parameters
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Body
application/json
Body
Request body for searching cloud gateway logs.
CGWLogSearchRequestSchema
Base schema for searching cloud gateway logs.
The start time for the log search query. Must be in RFC-3339 format.
The end time for the log search query. Must be in RFC-3339 format.
A list of data plane node IDs to filter logs.
Specifies the sorting order for the logs in the response.
Show Child Parameters
Response
text/csv
Response
CSV file containing matching OTel CGW data plane logs
CSV formatted log data