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

OTelLog

object

Represents a log entry based on the OpenTelemetry (OTel) data model.

span_idstring

Identifier of the span within a trace. Refers to the OTel SpanId field.

trace_idstring

Identifier of the trace. Refers to the OTel TraceId field.

timestampstring(date-time)required

The time at which the event occurred. Refers to the OTel Timestamp field.

observed_timestamp_nsinteger(int64)required

Unix epoch time when the event was observed by the collection system in nanoseconds

severity_textstring

Human-readable severity level of the log (e.g., ERROR, WARN). Refers to the OTel SeverityText field.

severity_numberinteger

Numeric representation of the severity level. Refers to the OTel SeverityNumber field.

bodystringrequired

The main content of the log entry. Refers to the OTel Body field.

attributesobjectrequired

Key-value pairs providing additional context for the log. Refers to the OTel Attributes field.

resourceobjectrequired

Resource information associated with the log, such as service name or version. Refers to the OTel Resource field.

Show Child Parameters
scopeobject

Scope information associated with the log. Refers to the OTel Scope field.

Show Child Parameters
Example

TraceCaptures

object

Represents the request/response captures associated with a trace

request_bodystring

The captured request body

request_headersobject

The captured request headers

response_bodystring

The captured response body

response_headersobject

The captured response headers

Example