Read logs

GET /networks/{network_identifier}/sensors/{sensor_identifier}/logs

Returns a sensor's logs in pages of 64 elements sorted ascendingly by creation_timestamp.

Path parameters

  • network_identifier string Required

    Format should match the following pattern: ^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$.

  • sensor_identifier string Required

    Format should match the following pattern: ^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$.

Query parameters

  • The direction of the page based on the cursor. If no cursor is provided, next returns the first page and previous returns the last page.

    Values are next or previous. Default value is next.

  • The cursor of the query. Depending on the direction, the request returns the next or previous elements. The element the cursor references is not included in the response.

Responses

  • OK

    Hide response attributes Show response attributes array[object]
    • revision integer

      Configurations are assigned monotonically increasing revision numbers. The revision is used as an identifier in the communication with the sensors and can clearly match configurations to measurements and logs.

    • message string
    • severity string

      Values are info, warning, or error.

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

GET /networks/{network_identifier}/sensors/{sensor_identifier}/logs
curl \
 -X GET https://example.com/networks/575a7328-4e2e-4b88-afcc-e0b5ed3920cc/sensors/575a7328-4e2e-4b88-afcc-e0b5ed3920cc/logs \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
[
  {
    "creation_timestamp": 1683644400.0,
    "revision": 42,
    "message": "The CPU is toasty; Get the marshmallows ready!",
    "severity": "warning"
  }
]
Response examples (200)
[
  {
    "creation_timestamp": 1683644400.0,
    "revision": 42,
    "message": "The CPU is toasty; Get the marshmallows ready!",
    "severity": "warning"
  }
]