Event Logs
Last updated
Last updated
For each event type extends the general EventType. Please refer to the schema documentation for the available attributes.
Event Logs support pagination which is described here. Event response are sorted chronologically descending.
Additional parameters
These examples will fetch 1000 connection logs for all of your devices in the last month. See above for other event types. Min and max dates should not exceed 1 month.
Response Example
This returns a url which you can use to download the results in a csv format. The url will expire in 1 hour. Max 10000 lines or 28 seconds of execution.
Response example
This request will fetch state logs for a specified device in a csv format using graphQL. In these examples we want to get the external IP address each time it comes online to track the device location.
Response Example
This request will return a url for a CSV download. The url will expire in 1 hour. Max 10000 lines or 28 seconds of execution. Min and max dates should not exceed 1 month.
Response Example
Attribute
Description
id
Event ID
timestamp
DateTime of the Event in ISO 8601 format Date String
type
Event Type
actor
User who initiated the event. This is currently only applicable for DEVICE_SHARE and DEVICE_CONNECT. You can get user ID and email
owner
User who owns the device when the event affects a device/service. You can get user ID and email
users
An array of users affected by the event. For example on a DEVICE_SHARE it is the users whose access to a device/service was added or removed. On a DEVICESTATE event it is the users who were notified of the event.
state
The service state (online or offline)
target
The services affected by the event. For example the services that changed state, the services that where share access was changed, or the services connected
Parameter
Type
Description
Default
types
Array of EventTypes
"DEVICE_STATE", "DEVICE_CONNECT", "DEVICE_SHARE"
More types will be become available. Please refer to the schema for current list
All
maxDate
DateTime
The last date you wish to be included in the result set. Accepts ISO 8601 format Date String with or without the timestamp
Today with 1000 events being the max size
minDate
DateTime
The first date you wish to be included in the result set. Accepts ISO 8601 format Date String with or without the timestamp
1 month ago with 1000 events being the max size