Telemetry Messages

Once registered, devices can start sending telemetry messages to the cloud. Telemetry messages are collections of key/value pairs describing the state of the device.

The messages are sent as flat JSON objects. The information sent is determined by the device’s manufacturer and can be of any type (integers, strings, and Booleans).

Telemetry messages should be sent in the following two flows:

1. Periodic - Each device should send telemetry messages to the server periodically (every ~1 minute or less). This allows the cloud service to know that the device is online and functioning, as well as to reply with commands and other data for the device.

2. Event-based - When an event happens on a device, it is recommended to immediately update the server. For example, an event-based telemetry message should be sent when a temperature sensor measures a range that could affect the performance of the hardware.

A detailed guide to the telemetry API can be found HERE.