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
Authentication
Path Parameters
Body
Search Distinct Values in Cloud Gateway Logs
Search distinct values in specified logs attributes for cloud gateway logs in a control plane
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 cloud gateway logs by distinct values. Currently, only “node_id” is supported.
Allowed values:node_id
Example:node_id
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
Distinct values for the specified attributes in the cloud gateway logs
LogsDistinctValuesResponse
Represents the distinct values for a specific attribute in the logs.
A list of distinct values for the specified attribute in the logs.