Модуль Суммарная статистика, статистические функции для программ-логгеров

Последняя версия: 5.0.1 build 1126. November 28, 2025.

Плагин Summary Statistics добавляет автоматическое вычисление статистических данных во все наши логгеры. Он предоставляет ключевые показатели, такие как сумма, среднее, минимум, максимум, первое значение, последнее значение и качество обслуживания за настраиваемые интервалы времени. Вы можете применять эти вычисления к любой числовой переменной парсера, включая переменные, заданным по маске, и экспортировать результаты как новые переменные парсера дополнительными суффиксами. Это помогает получить статистику прихода и обработки данных в виде структурированных сводных записей, готовые для архивирования, панелей мониторинга или дальнейшей обработки во внешних системах.

Скачать  | PDF руководство

Настройка плагина проста. Вы задаете одну или несколько переменных парсера, выбираете размер интервала и затем указываете статистические итоги, которые требуется вычислить. Для каждой настроенной переменной плагин создает набор производных переменных, таких как VALUE1_MIN, VALUE1_MAX, VALUE1_AVG, VALUE1_SUM, VALUE1_FIRST, VALUE1_LAST, VALUE1_TSS, VALUE1_TSE и VALUE1_QOS. Эти производные переменные проходят через логгер так же, как обычные переменные парсера, и могут использоваться в экспортах, скриптах или уведомлениях.

Плагин также оценивает качество данных с помощью метрики качества обслуживания. Вы указываете ожидаемое число значений в интервале, и модуль вычисляет отношение обработанных к ожидаемым значениям. Это дает мгновенную информацию о полноте данных и может указывать на сбои устройств, проблемы связи или пропуски в сборе данных. Когда ожидаемое значение установлено равным нулю, та же переменная качества возвращает фактическое число обработанных значений в интервале.

В типичных сценариях плагин Summary Statistics помогает преобразовать потоки показаний сенсоров, счетчиков устройств или значения регистров в компактные сводные записи. Например, вы можете вычислять энергопотребление по устройству за час, контролировать минимальные и максимальные температуры каждые 15 минут или рассчитывать среднее время отклика за день. Результаты можно экспортировать в CSV, базы данных или брокеры MQTT с помощью существующих модулей экспорта в наших логгерах, что обеспечивает интеграцию со SCADA, MES или BI платформами.

Пример интеграция с Advanced Serial Data Logger

Рассмотрим производственную линию, где устройство отправляет числовое значение температуры каждые 10 секунд через RS232. Advanced Serial Data Logger получает необработанные строки, например:

2025-01-02 08:00:00;DEVICE01;TEMP=21.3
2025-01-02 08:00:10;DEVICE01;TEMP=21.7
2025-01-02 08:00:20;DEVICE01;TEMP=22.0
2025-01-02 08:00:30;DEVICE01;TEMP=22.4
...

Модуль парсинга извлекает DATE_TIME_STAMP, DEVICE_ID и TEMP как переменные парсера. Вы настраиваете плагин Summary Statistics следующим образом:

• Переменные парсера: TEMP
• Интервал: Фиксированный, 30 минут
• Итоги: Минимум, Максимум, Среднее, Первое значение, Последнее значение, Время начала, Время окончания, Качество
• Ожидаемое число значений в интервале: 180 (одно считывание каждые 10 секунд)

В интервале с 2025-01-02 08:00:00 по 2025-01-02 08:30:00, предположим, устройство отправило 170 корректных значений. В 2025-01-02 08:30:00 плагин экспортирует одну сводную строку. Внутренние переменные парсера в момент экспорта могут выглядеть так:

DATE_TIME_STAMP = 2025-01-02 08:30:00
DEVICE_ID       = DEVICE01
TEMP_MIN        = 21.3
TEMP_MAX        = 24.8
TEMP_AVG        = 23.1
TEMP_FIRST      = 21.3
TEMP_LAST       = 24.2
TEMP_TSS        = 2025-01-02 08:00:00
TEMP_TSE        = 2025-01-02 08:30:00
TEMP_QOS        = 0.9444

Если включить опцию "Экспорт только значений статистики", то логгер не будет пересылать отдельные измерения TEMP в последующие модули. Только сводная запись будет передана в другие модули фильтрации, в модули записи в базу данных, в CSV или другое место назначения. Это значительно уменьшает объем промежуточных данных, получая только суммарную статистику. Если оставить эту опцию отключенной, можно сохранить как необработанные, так и агрегированные данные, что обеспечивает максимальную гибкость для анализа и поиска неисправностей.

Ключевые возможности

• Гибкие варианты настройки интервалов, включая Без интервала, Фиксированный и Расписание Cron.
• Поддержка нескольких переменных парсера или масок для больших групп переменных.
• Вычисление минимума, максимума, среднего, суммы, первого значения, последнего значения и границ по времени.
• Расчет качества обслуживания на основе ожидаемого или фактического числа значений.
• Статистика отдельно по нескольким устройствам если есть переменная парсера с идентификатором устройства.
• Возможность экспортировать только сводные значения или дополнять данные сохраняя исходные значения.

Итог

Плагин Summary Statistics вычисляет сжатые структурированные сводные записи, которые проще хранить, анализировать и визуализировать. Благодаря настраиваемым интервалам, группировке по устройству и метрике качества обслуживания он подходит как для простых задач логирования, так и для сложного промышленного мониторинга.

Скачать  | PDF руководство

Как включить модуль

На рисунке ниже вы можете увидеть, как включить данных модуль в настройках программы на странице "Модули".

Как настроить модуль

На рисунке ниже показан пример настроек модуля. Вы можете ознакомиться с файлом справки по ссылке выше, для получения более подробной информации.