Не исправляйте график множителем, пока не установлена единица источника. Снимите один 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 и резкий скачок помечаются качеством; автоматическая коррекция не должна скрывать неисправный датчик.

Пять тестов ловят путаницу единиц

  1. Отправить граничные значения для каждой разрешённой unit и сравнить формулу.
  2. Передать неизвестную unit и увидеть quarantine без точки на рабочем графике.
  3. Повторить message ID и не получить дубль.
  4. Обновить schema version и не изменить смысл старых записей.
  5. Пересчитать небольшой исторический диапазон и сверить raw, canonical и converter version.

Для диагностики нужны три обезличенных payload, модель и версия прошивки, выдержка из паспорта, конфигурация ingestion и ожидаемая каноническая единица. Токены broker и реальные адреса устройств удалите. С таким набором видно, ошибка появилась в прошивке, mapping, конвертере или только в подписи графика.

Проверенные источники