📊 Данные
Архитектура данных
От датчика до графика.
Поток данных сверху вниз
Путь метрики короткий.
1. Датчик → контроллер
Опрос по UART.
2. Контроллер → Mosquitto
Публикация в топик датчика.
3. Брокер → сервер
Подписка на все топики.
4. Сервер: запись + поток + правила
Запись, поток и правила.
ℹ️
Мост и хранилище включаются опционально.
Топики и форматы MQTT
| Топик | Что публикуется | Кто пишет |
|---|---|---|
| iot/<deviceId>/sensors/<key> | Показание датчика | Контроллер |
| iot/<deviceId>/status | Жизненные показатели устройства | Контроллер |
| iot/<deviceId>/commands | Команда устройству | Сервер |
Показание датчика
{
"device_id": "esp32c3_001",
"sensor": "bmp280_temperature",
"timestamp": 1727985000000,
"value": 23.45,
"unit": "degC"
}
timestamp в миллисекундах UTC, value — число.
Команда устройству
iot/esp32c3_001/commands> {"command":"relay","state":"on"}
Короткая строка, которую понимает прошивка.
Хранилище: JSONL и роллапы
Каждая точка — строка в JSONL.
data/ingest/
├── raw/
│ └── esp32c3_001/
│ └── bmp280_temperature/
│ ├── 2026-10-07T14.jsonl {"t":1727984700000,"v":23.41,"u":"degC"}
│ ├── 2026-10-07T15.jsonl {"t":1727988300000,"v":23.52,"u":"degC"}
│ └── ...
└── rollup/
└── esp32c3_001/
├── bmp280_temperature.jsonl {"h":"2026-10-07T14","count":60,"min":23.1,"max":24.0,
│ "sum":1395.2,"avg":23.25,"first_t":...,"last_t":...}
└── temperature.jsonl ...
Роллап — статистика закрытого часа.
Синхронная допись, кэш последних значений.
🧠
Точечная история старых часов — из raw-файлов.
Живой поток: SSE /api/v1/stream
Метрики отдаёт SSE.
event: hello data: {"version":"0.4.1","telemetry":{"esp32c3_001":{"temp":{"t":...}}}}
event: metric data: {"deviceId":"esp32c3_001","sensor":"temp","t":...,"v":23.45,"u":"degC"}
event: status data: {"deviceId":"esp32c3_001","status":"online","rssi":-61}
event: rule data: {"rule":{...},"action":"mqtt_command","topic":"iot/esp32c3_001/cmd"}
event: cmd data: {"deviceId":"esp32c3_001","command":"relay:on","ts":...}
hello со снимком, потом только живые события.
🔌
SSE требует авторизацию.
История: /api/v1/sensors
| Метод и путь | Что возвращает |
|---|---|
| GET /api/v1/sensors/latest | Последние значения |
| GET /api/v1/sensors/<deviceId>/<sensor>/history | Временной ряд |
GET /api/v1/sensors/esp32c3_001/temp/history?from=1727982000000&to=1728014400000&points=200
{
"ok": true,
"deviceId": "esp32c3_001",
"sensor": "temp",
"series": [ { "t": 1727982000000, "v": 23.41, "u": "degC" }, ... ]
}
24 часа, до 120 точек, понижение частоты.
Движок правил
Правила оцениваются и на сервере.
| Триггер | Когда срабатывает |
|---|---|
| threshold_above / threshold_below | Значение пересекает порог |
| online / offline | Статус устройства |
| no_data | Тишина устройства |
Команда или уведомление, кулдаун по умолчанию.
Ручная команда через API.
Настройка
| Переменная | По умолчанию | Что задаёт |
|---|---|---|
| MQTT_ENABLED | 0 | Включает MQTT-мост |
| MQTT_HOST / MQTT_PORT | 127.0.0.1 / 1883 | Адрес брокера |
| MQTT_USER / MQTT_PASSWORD | — | Учётные данные брокера |
| MQTT_TOPIC | iot/+/# | Фильтр подписки |
| INGEST_DIR | data/ingest | Директория хранилища |
| INGEST_FLUSH_SECONDS | 60 | Частота сброса |
🔑
Пароли брокера — секреты.
💬
Нашли неточность?