UnitX Cloud: регистрация, устройства и история

UnitX Cloud — небольшой сервис для приёма и просмотра телеметрии. Сервис показывает последние данные устройств, обновляет карточки без перезагрузки страницы, хранит ограниченную историю и позволяет выгрузить её в JSON.

Регистрации здесь не требуется. Начало работы — это создание пары токенов:

• токен чтения (read-токен) открывает панель и разрешает читать данные;
• токен записи (write-токен) разрешает устройствам отправлять данные.

Быстрый старт

1. Откройте cloud.unitx.pro.
2. Нажмите «Создать новую пару токенов».
3. Сразу сохраните read- и write-токены в надёжном месте.
4. Укажите write-токен в устройстве или программе, которая передаёт телеметрию.
5. Вернитесь в панель с read-токеном и проверьте карточку устройства.

Для USB WatchDog токены можно создать и сохранить прямо в wdtmon4. Краткая последовательность подключения и проверка сброса по графику приведены в инструкции WatchDog.

Регистрация и первый вход

Стартовый экран

На стартовом экране расположены:

Для новой панели нажмите «Создать новую пару токенов». Адрес электронной почты, телефон и пароль вводить не требуется.

Сохранение токенов

После регистрации сервис показывает два разных ключа:

Кнопка с двумя прямоугольниками справа от каждого поля копирует токен в буфер обмена.

Сохраните оба токена сразу. Когда появится первое устройство, блок с write-токеном исчезнет с панели. При повторном входе по read-токену восстановить write-токен через интерфейс нельзя.

Кнопка выхода в правом верхнем углу удаляет текущий read-токен из локального хранилища браузера, но не отключает сам токен. Для следующего входа его нужно вставить на стартовом экране.

Не публикуйте токены в документации, репозитории, журналах и скриншотах. Если токен попал к постороннему, создайте новую пару и перенастройте устройства.

Панель устройств

После первой успешной записи карточка появляется автоматически. Обновлять страницу вручную не нужно.

Карточки с активным признаком alert показываются первыми, остальные — по времени последнего обновления. На каждой карточке есть:

Статус меняется автоматически:

• Онлайн — обновление было менее 6 минут назад;
• Недавно онлайн — от 6 до 15 минут назад;
• Устарело — от 15 минут до часа;
• Офлайн — более часа назад.

Цвет RSSI соответствует качеству сигнала: от отличного при -45 dBm и выше до плохого ниже -80 dBm. Если поле r не передано, индикатор сигнала не показывается.

Кнопка с солнцем или луной в верхней панели меняет тему. Кнопка со стрелкой вправо завершает сеанс в этом браузере.

Аварийные сообщения

Если устройство передало признак alert, открытая панель показывает всплывающее сообщение и выделяет карточку красным.

В окне указаны имя устройства и время аварийной точки. Крестик закрывает сообщение, но не сбрасывает состояние устройства. Значок Alert и красная полоса останутся на карточке, пока устройство не отправит следующую запись без аварийного сигнала.

История и экспорт

Нажмите кнопку с графиком в правом нижнем углу карточки.

Окно истории содержит:

• имя выбранного устройства;
• количество сохранённых точек;
• графики одного или двух параметров и RSSI, если эти поля есть в данных;
• подсказку с точным временем и значением при наведении на точку;
• кнопку «Экспорт».

Экспорт сохраняет файл <device_id>-history.json. В нём есть идентификатор устройства и массив последних точек:

{
  "device": "server-room",
  "points": [
    {
      "ty": 1,
      "v1": 23.8,
      "v2": 55,
      "r": -48,
      "a": false,
      "at": 180,
      "ts": 1785072221
    }
  ]
}

Обычная пара токенов хранит до 100 последних точек на устройство. Частота публикации определяет длительность окна истории: при отправке раз в минуту это около 100 минут, раз в 10 минут — около 16 часов 40 минут. Для постоянного архива сохраняйте данные в своей системе или запросите расширенную версию сервиса.

Закрыть окно истории можно клавишей Esc или щелчком вне окна.

Повторный вход и чтение API

Для повторного входа вставьте read-токен на стартовом экране и нажмите «Открыть панель». Write-токен для этого не подходит.

Текущее состояние можно получить программно:

CLOUD_READ_TOKEN='utx1_...'

curl --fail --silent --show-error \
  -H "Authorization: Bearer $CLOUD_READ_TOKEN" \
  -H 'Accept: application/json' \
  https://cloud.unitx.pro/current-state

История конкретного устройства:

curl --fail --silent --show-error \
  -H "Authorization: Bearer $CLOUD_READ_TOKEN" \
  -H 'Accept: application/json' \
  https://cloud.unitx.pro/history/server-room

Передавайте токены в заголовке Authorization, а не в параметрах запроса URL.

Ограничения лёгкой версии сервиса

Для обычной новой пары токенов действуют следующие пределы:

Лёгкая версия подходит для текущего контроля, отладки и небольших инсталляций. Для юридических лиц доступна расширенная HTTP/MQTT-версия с постоянной историей, экспортом и уведомлениями. Запрос можно отправить на mail@unitx.pro.

Если данные не появились

1. Проверьте, что устройство отправляет данные с write-токеном, а панель открыта парным read-токеном.
2. Убедитесь, что HTTP-запрос получил статус 204.
3. Проверьте device_id: только латинские буквы, цифры, _ и -.
4. Если сервер вернул 403 forbidden_scope, перепутаны read- и write-токены.
5. Ошибка 429 device_limit_exceeded означает, что достигнут предел числа устройств; 429 rate_limited — превышена частота запросов.