Device History Events

Device history is captured through three types of events: ​ ​DEVICE_STATE_UPDATED, DEVICE_BULK_DATE_STATE_UPDATED, and DEVICE_NOTIFICATION_REPORTED

DEVICE_STATE_UPDATED Schema:​

... on DeviceStateUpdatedEvent {
eventType
createdAt
deviceId
fieldName
traitName
value
} 

DEVICE_BULK_DATE_STATE_UPDATED Schema:​

... on DeviceBulkDataStateUpdatedEvent {
eventType
deviceId
createdAt
traitName
url
} 

DEVICE_NOTIFICATION_REPORTED Schema:​

.. on DeviceNotificationReportedEvent {
eventType
deviceId
notificationName
notificationType
message
sampledAt
createdAt
traitName
} 

The DEVICE_STATE_UPDATED and DEVICE_BULK_DATE_STATE_UPDATED events report changes in device states as defined in the trait design. These events capture state updates and bulk state updates, respectively. The time the event took place on the device is not available for these events.

The DEVICE_NOTIFICATION_REPORTED event reports more transient changes on a device. Notifications within this event are categorized as either info or warning, similar to audits and alerts. The time these events took place in the device is expected to be available.