Control Plane Logs
Control Plane Logs APIs
Search Control Plane Logs
Search logs for a specific control plane 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 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 body for searching control plane logs
ControlPlaneLogSearchResponseSchema
Show Child Parameters
Represents a control plane log message
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Body
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"}}}