Sign in
telemetry

Get OpenTelemetry logs within a specified time window with flexible pagination options: Pass in only the end time to paginate backwards from there. Pass in a start time to paginate backwards from now until the start time. Pass in both to get resources within the time window. Filter additionally by branch_ids or file_id.

get/v1/telemetry/logs

Query parameters

trace_idsstring[]
file_idstring uuid

Include only resources from a given file identified by its ID

branch_idsstring[]

Branch IDs to filter by

direction'asc' | 'desc' required

Sort direction for the traces. Defaults to descending order of timestamp.

startstring date-time

Start date of the time window (earliest time)

endstring date-time

End date of the time window (latest time)

limitinteger required

Maximum items to return in each paginated response

Response

A paginated result set

Changes

Changed in 4 of the 46 revisions of this API.25

  • dc1b3c9e3b2a12See the full diff
    • ▲

      the query request parameter direction was restricted to a list of enum values

      request-parameter-became-enum

    • ○

      added the new enum value asc to the query request parameter direction

      request-parameter-enum-value-added

    • ○

      added the new enum value desc to the query request parameter direction

      request-parameter-enum-value-added

  • 6b03e553fa2e1See the full diff
    • ▲

      added the new required query request parameter direction

      new-required-request-parameter

  • 1f786c78e4682See the full diff
    • ○

      the query request parameter trace_ids became optional

      request-parameter-became-optional

    • ○

      removed the non-success response with the status 400

      response-non-success-status-removed

  • a09036acdbe91See the full diff
    • ○

      endpoint added

      endpoint-added