Search Distinct Values in Logs

Search distinct values in specified logs attributes for a specific debug session in a control plane

post

Path Parameters

controlPlaneIdstring(uuid)required

The UUID of your control plane. This variable is available in the Konnect manager.

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

debugSessionIdstring(uuid)required

Debug Session identifier

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

logFieldFilterstringrequired

Field to filter logs by distinct values. Currently, only “severity_text” is supported.

Allowed values:severity_text

Example:severity_text

Body

application/json

LogSearchRequest

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

Response

application/json

Distinct values for the specified attributes in the logs

LogsDistinctValuesResponse

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.

post/control-planes/{controlPlaneId}/o11y/debug-sessions/{debugSessionId}/logs/distinct-values/{logFieldFilter}

Body

{ "start": "2025-04-22T00:00:00Z", "end": "2025-04-22T23:59:59Z", "node_id": [ "d32d905a-ed33-46a3-a093-d8f536af9a8a", "ae853602-23c7-4218-9071-82fdef3a1efe" ], "span_id": [ "090a0b0c0d0e0f00" ], "trace_id": [ "ff0102030405060708090a0b0c0d0e0f" ], "severity_text": [ "ERROR", "WARN" ], "severity_number": [ 17, 15 ], "attributes": { "log_type": { "neq": "access" }, "introspection_name": { "in": [ "request", "response" ] }, "plugin_name": { "eq": "my-plugin" } }, "order_by": { "field": "timestamp", "direction": "desc" } }
 
application/json

Session Profiles

Debug Session Profiles APIs

Get CPU profile for a debug session

Get CPU profile for a debug session with support for multiple formats (otel/flamegraph/frames)

get

Query Parameters

formatstring

The format in which cpu profile should be returned

Allowed values:framesflamegraphotel

Default:frames

Path Parameters

controlPlaneIdstring(uuid)required

The UUID of your control plane. This variable is available in the Konnect manager.

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

debugSessionIdstring(uuid)required

Debug Session identifier

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

Response

application/json

Returns cpu profile belonging to a session

metadataobjectrequired

Represents the metadata for the cpu profile

Show Child Parameters
framesarray[object]

Represents a frame in a cpu profile

Show Child Parameters
flamegraphobject

Represents the flamegraph representation of a cpu profile

Show Child Parameters
get/control-planes/{controlPlaneId}/o11y/debug-sessions/{debugSessionId}/profiles/cpu
 
application/json

Organization Settings

Organization Settings APIs

Update DPA settings for an organization

Update Data Protection Addendum (DPA) settings for an organization

put

Body

application/json

Request body for updating DPA settings for an organization.

consent_bystring

The optional settings consent by.

consent_statusstringrequired

The consent status for DPA.

Allowed values:APPROVEDREVOKED

Response

application/json

Response body for retrieving DPA settings

DPASettings

Represents the settings for Data Protection Addendum (DPA) for an organization.

idstring(uuid)requiredread-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

namestring

The optional settings name.

consent_bystring

The optional settings consent by.

consent_statusstringrequired

The consent status for DPA.

Allowed values:APPROVEDREVOKED

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

put/o11y/org-settings/dpa

Body

{ "consent_by": "Jane Doe", "consent_status": "REVOKED" }
 
application/json