telemetry

Changed on

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

Request

  • Base URL
    https://api.val.town
  • URL
    https://api.val.town/v1/telemetry/logs
  • Auth
    none declared

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

  • dc1b3c9e3b2aRevision changes
    • breaking

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

    • info

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

    • info

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

  • 6b03e553fa2eRevision changes
    • breaking

      added the new required query request parameter direction