Browser Telemetry

List OTLP destinations

Changed on

List customer-visible OTLP export destinations in the authenticated organization. Project-scoped credentials can list these destinations for selection by workloads in their project. Non-dashboard reads return header values redacted.

get/telemetry/destinations

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/telemetry/destinations
  • Auth
    HTTP bearer

Query parameters

limitinteger

Limit the number of destinations to return.

offsetinteger

Offset the number of destinations to return.

querystring

Case-insensitive substring match against destination name or endpoint. IDs match by exact value.

namestring

Exact-match filter on destination name using the database collation. In production, matching is case- and accent-insensitive.

Response

List of OTLP destinations

consecutive_failuresinteger required

Failed deliveries since the last success, as observed by the relay process that wrote the latest outcome. Zero means the most recently recorded outcome succeeded.

created_atstring date-time required
descriptionstring
endpointstring required

OTLP/HTTP endpoint telemetry is sent to.

headersobject required

Headers sent with each export request. Names are returned in canonical form (Authorization, not authorization). Non-dashboard reads return values redacted as empty strings, so the keys are visible but the credentials are not. Dashboard reads return the stored values.

idstring required
last_errorstring

Sanitized class of the delivery failure recorded at last_error_at. It is retained after a later success, so its presence does not mean the destination is currently failing. Response bodies, endpoint URLs, credentials, and raw transport errors are never returned.

last_error_atstring date-time

Timestamp of the most recent failed delivery. It is retained after a later success, so it can predate last_export_at. Read consecutive_failures to tell whether the destination is currently failing.

last_export_atstring date-time

Timestamp of the most recent successful delivery. Moves only on success.

namestring required

Unique within the organization. Usable in place of the ID when selecting a destination, so it cannot be shaped like an ID.

updated_atstring date-time required

Changes