Доступ к агрегированным историческим данным

Пути доступа к агрегированным историческим данным различны в зависимости от методов агрегации.

Доступ к статистике в кольцевой БД

Функция Статистика контекста Утилиты возвращает агрегированные данные, находящиеся в кольцевой БД.

Функция принимает множество параметров:

  • Маска исходных контекстов и имя статистического канала

  • Время агрегирования

  • Настройки, определяющие, какие агрегированные показатели должны быть возвращены (например, минимальные или суммарные величины)

Данная функция возвращает таблицу данных, содержащую агрегированные данные, сгруппированные по временному периоду. Таблица может напрямую использоваться любыми инструментами обработки и визуализации данных.

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

Вот как выглядит выход функции Статистика:

Начало периода

Конец периода

Агрегированное числовое значение (Среднее, Минимум или Максимум)

Пример выражения, которое возвращает средние, минимальные и максимальные часовые значения для статистического канала temperature, определенного для устройства users.admin.devices.meter:

{utilities:statistics("users.admin.devices.meter", "temperature", null, "hour", true, true, true, true)}

Доступ к истории, хранящейся в гранулах

Поскольку гранулы хранятся в виде событий, их можно получить с помощью функции Get Event History контекста Events.

Это выражение возвращает все гранулы randomGranule, сохраненные для контекста users.admin.devices.virtual:

callFunction("events", "get", "users.admin.devices.virtual", "randomGranule")