Возможности
- до 12 серий в одном виджете;
- линии, столбцы, столбцы с накоплением, смешанный вид и кольцевая диаграмма;
- источники из текущего рабочего пространства и виртуальные датчики Node-RED;
- левая и правая оси Y;
- среднее, минимум, максимум, сумма, последнее значение и изменение счётчика;
- периоды: последний час, 24 часа, 7 дней и 30 дней;
- индивидуальные цвет, единица измерения, множитель и смещение для каждой серии;
- интерактивная легенда и общая подсказка для всех серий;
- автоматическое обновление данных раз в минуту.
Добавление на рабочее поле
- Откройте нужное рабочее поле и вкладку.
- Включите режим редактирования.
- Нажмите «Добавить иконку».
- В разделе «Продвинутые виджеты» найдите «График энергии».
Нажмите на карточку «График энергии». Виджет появится на текущей вкладке рабочего поля. Переместите его в нужное место.
Щёлкните по виджету правой кнопкой мыши. На сенсорном экране используйте длительное нажатие. Откроется панель «Свойства».
Общие параметры
| Параметр | Назначение |
|---|---|
| Название | Заголовок виджета на рабочем поле. |
| Тип | Системный тип energyGraph. Поле доступно только для чтения. |
| Ширина, Высота | Размер виджета в пикселях. Минимальная рекомендуемая ширина — 300 px, высота — 220 px. |
| Вид графика | Общий способ отображения серий. |
| Период | Диапазон истории, отсчитываемый назад от текущего времени. |
| Знаков после запятой | Точность значений в подсказке: от 0 до 6 знаков. |
| Показывать легенду | Отображает названия серий под графиком. Нажатие на название временно скрывает или возвращает серию. |
Период и автоматический интервал
RealIoT автоматически выбирает интервал агрегации в зависимости от периода. Это ограничивает количество точек и снижает нагрузку на Raspberry Pi.
| Выбранный период | Интервал одной точки |
|---|---|
| Последний час | 5 минут |
| Последние 24 часа | 1 час |
| Последние 7 дней | 6 часов |
| Последние 30 дней | 1 день |
Добавление серии
Нажмите «Добавить серию». В одном виджете можно создать не более 12 серий.
- Введите понятную подпись, например «Фаза A».
- Выберите тип источника: «Устройства» или «Узлы Node-RED».
- Откройте поле «Источник».
- Введите часть имени или Device SN в строке поиска внутри списка.
- Выберите найденный источник и затем его параметр.
Параметры серии
| Параметр | Назначение |
|---|---|
| Подпись | Название в легенде и подсказке. |
| Тип источника | Устройство рабочего пространства или виртуальный источник Node-RED. |
| Источник | Конкретное физическое или виртуальное устройство. |
| Параметр | Числовое значение, история которого будет построена. |
| Агрегация | Способ расчёта одной точки внутри временного интервала. |
| Тип серии | Линия или столбцы. Используется в смешанном виде. |
| Ось Y | Левая или правая вертикальная ось. |
| Группа накопления | Имя группы для объединения столбцов в режиме «Столбцы с накоплением». |
| Цвет | Цвет линии или столбцов. |
| Единица | Подпись оси и значений, например Вт, кВт·ч, В, А или ₽. |
| Множитель | Умножает каждое исходное значение. Например, 0,001 переводит Вт в кВт. |
| Смещение | Прибавляется после умножения. |
| Накопительный счётчик | Используется вместе с агрегацией «Изменение счётчика» и контролирует сброс показаний. |
| Серия включена | Позволяет временно исключить серию без удаления её настроек. |
Источники данных
| Тип источника | Что отображается | Что требуется |
|---|---|---|
| Устройства | Физические и виртуальные устройства текущего рабочего пространства. | Устройство должно иметь Device SN, а параметр — историю. |
| Узлы Node-RED | Виртуальные датчики Node-RED, относящиеся к текущему рабочему пространству. | Для выбранного Device SN и параметра должны сохраняться исторические точки RealIoT. |
Агрегация
| Режим | Результат для каждого интервала | Применение |
|---|---|---|
| Среднее | Среднее арифметическое значений. | Мощность, напряжение, ток, температура. |
| Минимум | Наименьшее значение. | Нижняя граница показателя. |
| Максимум | Наибольшее значение. | Пиковая нагрузка или верхняя граница. |
| Сумма | Сумма всех сохранённых значений. | Интервальные порции или импульсы. Не используйте для частых мгновенных измерений. |
| Последнее значение | Последняя запись по времени. | Состояние показателя к концу интервала. |
| Изменение счётчика | Сумма последовательных разностей показаний. | Расход накопительного счётчика электроэнергии, воды или тепла. |
Накопительный счётчик и сброс показаний
Для накопительного счётчика выберите агрегацию «Изменение счётчика» и включите «Накопительный счётчик». RealIoT использует последнюю точку перед началом периода, поэтому расход первого интервала также рассчитывается корректно.
Если новое показание меньше предыдущего, RealIoT считает это сбросом счётчика, не добавляет отрицательный расход и выводит предупреждение вида «Обнаружено сбросов счётчика: N».
Виды графика
| Вид | Поведение |
|---|---|
| Линии | Все серии отображаются линиями. |
| Столбцы | Все серии отображаются отдельными столбцами. |
| Столбцы с накоплением | Серии с одинаковой группой накопления складываются в один столбец. |
| Смешанный | Каждая серия использует собственный тип: линия или столбцы. |
| Кольцевая диаграмма | Сравнивает итоговые значения серий за выбранный период. |
Оси Y
Каждую серию можно назначить левой или правой оси. Это позволяет совместить параметры с разными единицами и диапазонами, например мощность в ваттах и напряжение в вольтах.
Примеры настройки
Активная мощность трёх фаз
- вид: «Столбцы с накоплением»;
- серии: фазы A, B и C;
- агрегация: «Среднее»;
- группа накопления: одинаковое значение, например
active; - единица: Вт;
- период: последние 24 часа.
Расход электроэнергии по фазам
- источник: накопительные значения энергии;
- агрегация: «Изменение счётчика»;
- параметр «Накопительный счётчик» включён;
- единица: кВт·ч.
Столбцы и линия итога
- вид: «Смешанный»;
- фазы A, B и C: тип серии «Столбцы»;
- итоговая серия: тип «Линия»;
- для итоговой серии можно выбрать агрегацию «Максимум».
Производительность
Агрегация выполняется на сервере, а браузер получает уже подготовленные точки. Это уменьшает сетевой трафик и нагрузку на клиентское устройство.
- код виджета и панели свойств загружается только при наличии виджета на рабочем поле;
- для одного графика разрешено не более 12 серий;
- одна серия обрабатывает не более 100 000 исходных точек за запрос;
- данные автоматически обновляются раз в минуту;
- при длительном периоде автоматически используется более крупный интервал.
Решение проблем
На виджете написано «Добавьте серии в свойствах графика»
Откройте свойства и нажмите «Добавить серию». Выберите источник и параметр.
За выбранный период нет данных
- Проверьте, записывается ли параметр в историю RealIoT.
- Проверьте Device SN и название параметра.
- Выберите более длительный период.
- Если запись истории включена недавно, дождитесь поступления новых точек.
На графике только одна точка
Все имеющиеся записи попали в один интервал агрегации. Например, для периода 24 часа одна точка соответствует одному часу. График заполнится по мере накопления истории.
Узлы Node-RED не появились в списке
Убедитесь, что виртуальный датчик Node-RED относится к текущему рабочему пространству и имеет Device SN. После этого закройте и снова откройте свойства виджета.
Одна серия почти не видна рядом с другой
Назначьте её правой оси Y либо используйте множитель для приведения значений к удобному диапазону.
Появилось сообщение о сбросе счётчика
RealIoT обнаружил уменьшение накопительного значения. Проверьте исходные данные и правильность выбора параметра. Отрицательное изменение не добавляется к расходу.
График показывает разрывы
В эти интервалы не было исторических данных. Виджет не подставляет вымышленные значения и сохраняет разрывы, чтобы отсутствие связи было видно.