Skip to content
  • Auto
  • Light
  • Dark
Get Started

List

List
get/v1/telemetry/traces

Get OpenTelemetry traces 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.

Query Parameters
limitnumber

Maximum items to return in each paginated response

minimum1
maximum100
branch_idsarray of string
optional

Branch IDs to filter by

endstring
optional

End date of the time window (latest time)

formatdate-time
file_idstring
optional

Include only resources from a given file identified by its ID

formatuuid
startstring
optional

Start date of the time window (earliest time)

formatdate-time
Returns
dataarray of object
Hide ParametersShow Parameters
attributesarray of object
Hide ParametersShow Parameters
keystring
valueobject
Hide ParametersShow Parameters
arrayValueunknown
optional
boolValueboolean
optional
bytesValuestring
optional
doubleValuenumber
optional
intValuestring
optional
kvlistValueunknown
optional
stringValuestring
optional
endTimeUnixNanostring
namestring
startTimeUnixNanostring
statusobject
Hide ParametersShow Parameters
codenumber
messagestring
traceIdstring
curl https://api.val.town/v1/telemetry/traces \
    -d '{}'
200 Example
{
  "data": [
    {
      "attributes": [
        {
          "key": "key",
          "value": {
            "arrayValue": {},
            "boolValue": true,
            "bytesValue": "bytesValue",
            "doubleValue": 0,
            "intValue": "intValue",
            "kvlistValue": {},
            "stringValue": "stringValue"
          }
        }
      ],
      "endTimeUnixNano": "endTimeUnixNano",
      "name": "name",
      "startTimeUnixNano": "startTimeUnixNano",
      "status": {
        "code": 0,
        "message": "message"
      },
      "traceId": "traceId"
    }
  ],
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "prev": "https://example.com"
  }
}