Skip to content
  • Auto
  • Light
  • Dark
Get Started

List

List
get/v1/telemetry/logs

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.

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
trace_idsarray of string
optional
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
bodyobject
Hide ParametersShow Parameters
arrayValueunknown
optional
boolValueboolean
optional
bytesValuestring
optional
doubleValuenumber
optional
intValuestring
optional
kvlistValueunknown
optional
stringValuestring
optional
severityTextstring
timeUnixNanostring
traceIdstring
curl https://api.val.town/v1/telemetry/logs \
    -d '{}'
200 Example
{
  "data": [
    {
      "attributes": [
        {
          "key": "key",
          "value": {
            "arrayValue": {},
            "boolValue": true,
            "bytesValue": "bytesValue",
            "doubleValue": 0,
            "intValue": "intValue",
            "kvlistValue": {},
            "stringValue": "stringValue"
          }
        }
      ],
      "body": {
        "arrayValue": {},
        "boolValue": true,
        "bytesValue": "bytesValue",
        "doubleValue": 0,
        "intValue": "intValue",
        "kvlistValue": {},
        "stringValue": "stringValue"
      },
      "severityText": "severityText",
      "timeUnixNano": "timeUnixNano",
      "traceId": "traceId"
    }
  ],
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "prev": "https://example.com"
  }
}