ONonkernel
Browser Telemetry

Get OTLP destination by ID or name

Changed on

Retrieve a customer-visible OTLP destination in the authenticated organization by its ID or name. Project-scoped credentials can retrieve these destinations for selection by workloads in their project. Non-dashboard reads return header values redacted.

get/telemetry/destinations/{id_or_name}

Request

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

Path parameters

id_or_namestring required

OTLP destination ID or name

Response

OTLP destination details

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

  • 0a840df52279Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

  • a4ba6928596aRevision changes
    • info

      added the non-success response with the status