Sensors & cold chain: how it works
Sensors & cold chain receives readings from your devices (fridge, freezer and room loggers, fuel-tank gauges) through the API with a key per device, raises an alert in the app, by push and by e-mail when a reading stays outside its range or a device goes silent, and shows each device’s curve with the minimum, maximum, average and the time in range.
Lesson 5 of 12 · How it works
How it works
Open Sensors & cold chain and add a device with its serial (the id the device sends). A fridge gets the range 2–8 °C and a freezer at most −18 °C at once; change the ranges on the device page.
On the device page choose «Create key». The key is shown once: put it into the device or its gateway. It can only post readings of this device.
The device posts to /api/v1/sensors/readings with up to 500 readings per request (temperature, humidity, fuel level or any number) and an Idempotency-Key header, so a retry is never counted twice. The help center has a curl example.
Each range has a delay: a reading outside it for longer than the delay opens an alert, and the people with the sensors rights get it in the app, by push and by e-mail. Back inside the range, the alert closes and they hear that too. A device silent for longer than its set minutes raises a «silent» alert.
Acknowledge an alert with a note of what was done (goods moved, door closed). The note stays with the alert for audits.
The device page shows the curve of 24 hours, 7 or 30 days with the allowed band, the minimum, maximum, average, the share of time in range and the excursions.
Raw readings are kept the number of days you set (30 by default) and then summarized per hour, so long periods stay quick. A device can also fill the log of a cold-chain unit of Inventory → Cold chain automatically.
Where to find it
- Sensors & cold chain
/admin/sensors
Settings that change it
- Sensors & cold chain → Retention
/admin/sensors
Checklist
Before you move on, check that you can:
- Open Sensors & cold chain
- Open Sensors & cold chain and add a device with its serial (the id the device sends).
- On the device page choose Create key.
- The device posts to /api/v1/sensors/readings with up to 500 readings per request (temperature, humidity,…
- Each range has a delay: a reading outside it for longer than the delay opens an alert, and the people with…
Tips and common mistakes
- Give the range a delay of a few minutes so a door opened for loading does not alert.
- Retire a device you no longer use: its key stops at once and its readings stay.
- A key for one device is safest; a general key with the sensors:write scope must name the device serial in every upload.