Не исправляйте график множителем, пока не установлена единица источника. Снимите один payload, одновременно прочитайте показание на самом устройстве и проверьте документацию прошивки. Число 68 может быть 68 °F, 68 % или уже нормализованным значением; правдоподобность не подтверждает размерность.
Сохраняйте исходные value, unit, timestamp, device ID и schema version без изменения. Рядом пишите canonical value и canonical unit, полученные конкретной версией конвертера. Тогда ошибочное правило можно пересчитать, не восстанавливая сырьё из округлённого графика.
Одна запись содержит наблюдение и его смысл
{
"sensor": "room-demo-7/temperature",
"value": 68.0,
"unit": "degF",
"observed_at": "2026-10-01T19:00:00Z",
"schema_version": 3,
"message_id": "demo-1042"
}Формат условный. В SenML RFC 8428 единица задаётся полем unit или наследуется от base unit; отсутствие обоих допустимо только когда значение единицы однозначно задаёт контекст приложения. Для интеграции нескольких производителей скрытый контекст слишком хрупок — unit лучше передавать явно.
Scale и offset применяются в фиксированном порядке
| Источник | Канон | Преобразование |
|---|---|---|
| миллисекунды | секунды | value × 0.001 |
| киловатты | ватты | value × 1000 |
| °F | °C | (value − 32) × 5/9 |
| сырой ADC | физическая величина | только по калибровке конкретной модели |
RFC 8798 описывает secondary units через scale и offset относительно единицы SenML: сначала умножение, затем смещение. Температурная формула выше дана как понятный пример и не следует автоматически из произвольного поля unit. Для калибровочной кривой храните её ID, диапазон и дату действия.
Datastream не меняет единицу молча
OGC SensorThings связывает Datastream с одним Sensor и ObservedProperty и задаёт unitOfMeasurement с name, symbol и definition. Если прошивка стала присылать другую единицу, создайте новую версию контракта или datastream; смешивать два смысла под одной серией опасно даже при одинаковом типе числа.
- Allowlist содержит допустимые unit для конкретной observed property.
- Неизвестная unit отправляет запись в quarantine, а не превращает её в ноль.
- Schema version выбирает преобразование, а не текущее имя модели устройства.
- Canonical unit фиксирована для аналитики и правил оповещения.
- Отображаемая unit выбирается в UI и не меняет сохранённый канон.
message_id защищает от повторной доставки. Повторный payload с тем же ID и тем же содержимым подтверждается без второй точки; тот же ID с другим unit считается конфликтом. Это позволяет отличить сетевой retry от изменения данных устройством.
Историю исправляют новым производным рядом
Не переписывайте raw-ряд на месте. Создайте новую canonical series или колонку с converter_version, пересчитайте ограниченный интервал и сравните выборку с эталонными точками. После проверки переключите чтение, оставив старую производную доступной для аудита и отката.
Учитывайте округление и диапазон сенсора. Сначала конвертируйте с достаточной точностью, затем округляйте для отображения. Значения за физическим диапазоном, NaN и резкий скачок помечаются качеством; автоматическая коррекция не должна скрывать неисправный датчик.
Пять тестов ловят путаницу единиц
- Отправить граничные значения для каждой разрешённой unit и сравнить формулу.
- Передать неизвестную unit и увидеть quarantine без точки на рабочем графике.
- Повторить message ID и не получить дубль.
- Обновить schema version и не изменить смысл старых записей.
- Пересчитать небольшой исторический диапазон и сверить raw, canonical и converter version.
Для диагностики нужны три обезличенных payload, модель и версия прошивки, выдержка из паспорта, конфигурация ingestion и ожидаемая каноническая единица. Токены broker и реальные адреса устройств удалите. С таким набором видно, ошибка появилась в прошивке, mapping, конвертере или только в подписи графика.