ControlPlaneLogsOrderBy

object

Specifies the sorting order for the logs in the response.

fieldstring

The field to sort by. Can be either timestamp.

Allowed values:timestamp

directionstring

The sorting direction. Can be asc for ascending or desc for descending order.

Allowed values:ascdesc

Example

LogsDistinctValuesResponse

object

Represents the distinct values for a specific attribute in the logs.

dataarray[string]requiredunique-items

A list of distinct values for the specified attribute in the logs.

Example

LogSearchRequest

object

Represents the request payload for searching logs in a debug session.

startstring(date-time)

The start time for the log search query. Must be in RFC-3339 format.

endstring(date-time)

The end time for the log search query. Must be in RFC-3339 format.

node_idarray[string](uuid)unique-items

A list of data plane node IDs to filter logs.

span_idarray[string]unique-items

A list of identifier of the span within a trace to filter logs.

trace_idarray[string]unique-items

A list of identifier of the trace to filter logs.

severity_textarray[string]unique-items

A list of severity levels to filter logs (e.g., ERROR, WARN).

severity_numberarray[integer]unique-items

A list of numeric severity levels to filter logs (e.g., 17 for ERROR, 15 for WARN).

attributesobject

Key-value pairs to filter logs based on specific attributes.

* Additional properties are NOT allowed.
Show Child Parameters
order_byobject

Specifies the sorting order for the logs in the response.

Show Child Parameters
Example

KeyValueFilter

object

Represents a filter for key-value pairs, allowing equality, inequality, inclusion, or exclusion conditions.

* Additional properties are NOT allowed.
eq

Specifies a value that the key must be equal to.

neq

Specifies a value that the key must not be equal to.

inarray

Specifies a list of values that the key must be included in.

ninarray

Specifies a list of values that the key must not be included in.

Example

LogSearchResponse

object
metaobject
Show Child Parameters
logsarray[object]required

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
Example