Основные принципы работы с виджетами

13 октября 2026

ID 265231

Принцип отображения данных на веб-виджете зависит от типа графика. В KUMA доступны следующие типы графиков:

Круговая диаграмма ().
Счетчик ().
Таблица ().
Столбчатая диаграмма ().
Календарная диаграмма ().
Линейная диаграмма.

Основные принципы работы со всеми виджетами

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

Под названием виджета отображается список тенантов, для которых представлены данные.

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

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

Вы можете изменить период отображения данных на виджете, нажав на значок периода и выбрав точную дату или относительный период в открывшемся окне. Если вы хотите отобразить на виджете данные за период, выбранный для макета, вы можете нажать на кнопку Сбросить. При изменении периода отображения данных на макете, также изменится отображаемый на виджете период.

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

Слева от значка периода отображается кнопка CSV. Вы можете скачать данные, которые отображаются на виджете, в формате CSV (кодировка UTF-8). Имя скачиваемого файла имеет формат <название виджета>_<дата скачивания (ГГГГММДД)>_<время скачивания (ЧЧММСС)>.CSV.

виджет отображает данные за период, выбранный в параметрах виджета или макета, только для тенантов, указанных в параметрах виджета или макета.

Если вы при настройке виджета включили переключатель Итоговые значения, на виджете отображается значение Всего, но при выгрузке виджета в формате CSV значение Всего не отображается. Для отображения значения Всего в отчете, вы можете воспользоваться формулами Excel или переписать итоговое значение с виджета.

Основные принципы работы с графиками типа Круговая диаграмма

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

При переходе из легенды виджета в раздел событий для детализации информации обратите внимание на текст элемента легенды, по которому вы переходите в раздел событий. Если в тексте используется символы \ или ', то они будут экранированы в тексте SQL-запроса. При этом символ / не экранируется.

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

Примеры:

На виджете Алерты по статусу под значком периода отображается количество алертов, сгруппированных по статусам Новый, Открыт, Назначен или Эскалирован.
Если вы хотите просмотреть в легенде алерты только со статусами Открыт и Назначен, вы можете снять флажки слева от статусов Новый и Эскалирован.
На виджете События, для которого указан SQL-запрос SELECT count(ID) AS `metric`, Name AS `value` FROM `events` GROUP BY Name ORDER BY `metric` DESC LIMIT 10, под значком периода отображается 10 событий, сгруппированных по имени и отсортированных в порядке убывания.
Если вы хотите просмотреть в легенде события с определенными именами, вы можете снять флажки слева от имен событий, которые не должны отображаться в легенде.

Основные принципы работы с графиками типа Счетчик

На графиках этого типа отображается сумма выбранных данных.

Пример 1

На виджете Количество активов отображается общее количество активов, добавленных в KUMA.

Пример 2

Если вы хотите посмотреть тренды для сравнения текущих данных с данными за прошлый период, вы можете создать виджет с отображением восходящих или нисходящих трендов. Тренды настраиваются в следующих виджетах:

Активы → Количество активов.
Активы → Пользовательский виджет.
Алерты → Активные алерты.
Алерты → Неназначенные алерты.
Инциденты → Активные инциденты.
Инциденты → Неназначенные инциденты.
Инциденты → Все инциденты.
Пользователи → Количество пользователей AD.
Чтобы настроить отображение трендов, необходимо включить переключатель Показать данные за предыдущий период, а затем выбрать тренд на вкладке Внешний вид. Если значение в процентах не может быть вычислено или если значения равны, отображается значок . Если выбран параметр Восходящий - лучше, зеленая стрелка на графике указывает на восходящий тренд, красная – на нисходящий. Если выбран параметр Нисходящий - лучше, красная стрелка на графике указывает на восходящий тренд, зеленая – на нисходящий.

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

Основные принципы работы с графиками типа Таблица

На графиках этого типа данные отображаются в виде таблицы.

Пример:

На виджете События, для которого указан SQL-запрос SELECT TenantID, Timestamp, Name, DeviceProduct, DeviceVendor FROM `events` LIMIT 10, отображается таблица событий со столбцами TenantID, Timestamp, Name, DeviceProduct, DeviceVendor. Таблица содержит 10 строк.

Вы можете настроить отображение данных в таблице с помощью градиентной заливки – двухцветной (красно-зеленая) или трехцветной (красно-желто-зеленая). После того как вы выберете тип градиента, вы можете настроить направление заливки, нажав на значок переключения направления ( swap_arrow_icon ), а также задать пороговые значения. Для двухцветного градиента задаются два значения, для трехцветного – три. Эти значения отображаются в легенде и определяют, какого цвета маркер будет добавлен в ячейку выбранного столбца. Столбец задается в раскрывающемся списке Поле с индикатором градиента.

Основные принципы работы с графиками типа Столбчатая диаграмма

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

Пример:

На виджете Netflow top internal IPs, для которого указан SQL-запрос SELECT sum(BytesIn) AS metric, DestinationAddress AS value FROM `events` WHERE (DeviceProduct = 'netflow' OR DeviceProduct = 'sflow') AND (inSubnet(DestinationAddress, '10.0.0.0/8') OR inSubnet(DestinationAddress, '172.16.0.0/12') OR inSubnet(DestinationAddress, '192.168.0.0/16')) GROUP BY DestinationAddress ORDER BY metric DESC LIMIT 10, на оси X диаграммы отображается сумма трафика в байтах, на оси Y диаграммы отображаются адреса портов назначения. Данные сгруппированы по адресам назначения в порядке убывания суммы трафика.

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

Основные принципы работы с графиками типа Календарная диаграмма

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

Если при создании виджета с графиком типа Календарная диаграмма выбран вид диаграммы Столбчатая диаграмма, вы можете настроить отображение столбцов диаграммы с помощью градиентной заливки – двухцветной (красно-зеленая) или трехцветной (красно-желто-зеленая). После того как вы выберете тип градиента, вы можете настроить направление заливки, нажав на значок переключения направления ( swap_arrow_icon ), а также задать пороговые значения. Для двухцветного градиента задаются два значения, для трехцветного – три. Эти значения отображаются в легенде и определяют, как будут окрашены столбцы диаграммы.

Пример:

SELECT count(ID) AS `metric`, Timestamp AS `value`

FROM `events`

GROUP BY Timestamp

ORDER BY `metric` DESC

LIMIT 250

На диаграмме по оси X отсчитывается дата создания события, по оси Y диаграммы отображается количество событий. Столбцы диаграммы расположены слева направо в порядке убывания количества событий.

Если в SQL-запросе используется дополнительное поле с псевдонимом category, столбчатая диаграмма отображается в виде сложенной диаграммы. В этом случае градиентная заливка не применяется.

Пример:

SELECT count(ID) AS `metric`, Timestamp AS `category`, Type AS `value`

FROM `events`

GROUP BY Timestamp, Type

ORDER BY metric DESC

LIMIT 250

На диаграмме по оси X отображаются временные интервалы, по оси Y – количество событий. Каждая часть столбца соответствует значению поля, отмеченного как Type.

Если при создании виджета с графиком типа Календарная диаграмма выбран вид диаграммы Линейная диаграмма, возможны два варианта отображения графика: одна линия (если в запросе указаны только поля metric и value) и несколько линий (если используется дополнительное поле с псевдонимом category). Это позволяет сравнивать между собой значения по различным группам, в зависимости от того, по какому полю выполняется группировка в запросе. Например, это могут быть корреляционные правила, пользователи, устройства. Градиентная заливка к такому графику не применяется.

Пример:

SELECT count(ID) AS `metric`, Timestamp AS `category`, CorrelationRuleName AS `value`

FROM `events`

WHERE Type = 3

GROUP BY Timestamp, CorrelationRuleName

ORDER BY metric DESC

LIMIT 250

На диаграмме по оси X отображаются временные интервалы (поле, отмеченное как category). По оси Y отображается количество срабатываний правил корреляции (поле, отмеченное как metric). Каждая линия на графике соответствует уникальному значению поля value (в этом случае, названию правила корреляции).

Для группировки вы можете использовать в календарной диаграмме следующие поля времени:

Timestamp
DeviceCustomDate1
DeviceCustomDate2
EndTime
FileCreateTime
FileModificationTime
FlexDate1
OldFileCreateTime
OldFileModificationTime
DeviceReceiptTime
StartTime
Для полноценной работы с данными, рекомендуется округлять с помощью поддерживаемых функций ClickHouse значения в поле времени (отмеченное как Timestamp) до нужного временного интервала (например, 1 час, 1 день).

Для виджета с графиком типа Календарная диаграмма с видом диаграммы Линейная диаграмма вы также можете настроить параметры для отображения среднего значения. Для этого на вкладке Внешний вид для параметра Регрессия требуется выбрать LOESS.

Основные принципы работы с графиками типа Линейная диаграмма

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

Пример:

На виджете События, для которого указан SQL-запрос SELECT count(ID) AS `metric`, SourcePort AS `value` FROM `events` GROUP BY SourcePort ORDER BY `value` ASC LIMIT 250, на оси X диаграммы представлен примерный номер порта, на оси Y диаграммы отображаются количество событий. Данные сгруппированы по номеру порта в порядке возрастания.

Для виджета с графиком типа Линейная диаграмма вы также можете настроить параметры для отображения среднего значения. Для этого на вкладке Внешний вид для параметра Регрессия требуется выбрать Линейная. Если на графике отображается несколько категорий, для каждой категории отображается среднее значение.

Основные принципы работы с графиками типа Сложенная столбчатая диаграмма

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

Столбцы имеют разную интерпретацию высоты в зависимости от значения параметра Формат:

Если выбран формат Абсолютные значения, то высота столбцов соответствует сумме значений измеряемого показателя.
Если выбран формат Относительные значения, %, то все столбцы имеют одинаковую высоту 100%, а размеры подкрашенных областей столбца соответствуют процентному соотношению между значениями показателя.

Если при создании пользовательского виджета на основе сложенной столбчатой диаграммы выбран параметр Показывать данные за предыдущий период и в запросе указаны стандартные псевдонимы value, category, metric, то на диаграмме отдельными столбцами показываются данные предыдущего периода. Если же в запросе вместо стандартной метрики metric применяется пользовательский расчет метрик с нестандартными псевдонимами, то параметр Показывать данные за предыдущий период не будет учитываться при построении диаграммы (см. примеры запросов ниже).

Примеры:

При создании пользовательского виджета с графиком типа Сложенная столбчатая диаграмма на основе SQL-запроса для виджета События действуют следующие правила:

Поле в запросе, отмеченное как псевдоним value (должно быть указано обязательно), будет использоваться на диаграмме как поле, по которому строится легенда и столбцы делятся на категории.
Поле в запросе, отмеченное как псевдоним category (должно быть указано обязательно), будет использоваться на диаграмме как поле, по значениям которого будут расположены столбцы по оси X.
Поле в запросе, отмеченное как псевдоним metric, будет использоваться на диаграмме как поле, по которому должен вестись количественный подсчет частей столбцов. В этом случае количественное распределение будет производиться автоматически.

При этом вы можете самостоятельно управлять подсчетом, используя в качестве метрик стандартные функции агрегации sum, avg, min, max, count и собственные псевдонимы с произвольным названием вместо стандартного псевдонима metric (в этом случае не будет поддерживаться отображение данных за предыдущий период).

Пример 1:

В виджете События указан следующий SQL-запрос со стандартными псевдонимами, при создании виджета выбран параметр Показывать данные за предыдущий период:

SELECT count(ID) AS `metric`,

Type AS `value`,

TenantID AS `category`

FROM `events`

GROUP BY value, category

ORDER BY metric DESC

На диаграмме по оси X отображаются соответствующие тенанты (поле, отмеченное как category), по оси Y отображается количество событий определенного типа (поле, отмеченное как value). В каждом столбце количество, соответствующее определенному типу, отображается отдельным цветом. В легенде в качестве категорий отображаются названия типов событий, по которым разбиваются столбцы. Каждой категории соответствует цвет, автоматически присвоенный ей на столбце. Если вы хотите просмотреть на диаграмме события только с определенными типами, вы можете снять или установить флажки слева от соответствующих типов событий в легенде.

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

Пример 2:

В виджете События указан следующий SQL-запрос с пользовательскими метриками, отмеченными как псевдонимы Base и Audit вместо стандартного metric:

SELECT SUM(IF (Type = 1,1,0)) AS `Base`,

SUM(IF (Type = 4,1,0)) AS `Audit`,

TenantID as `category`

FROM `events`

GROUP BY category

На диаграмме по оси X отображаются соответствующие тенанты (поле, отмеченное как category), по оси Y отображается количество событий каждого типа (пользовательские метрики, отмеченные как псевдонимы Base и Audit). В каждом столбце количество, соответствующее определенной метрике, отображается отдельным цветом. В легенде в качестве названий категорий отображаются метрики Base и Audit, по которым столбцы делятся на категории. Каждой категории соответствует цвет, автоматически присвоенный ей на столбце. Если вы хотите просмотреть на диаграмме события, соответствующие только определенной метрике, вы можете снять или установить флажки слева от нужной метрики в легенде.

Дополнительный столбец с данными за прошлый период для запроса с пользовательскими метриками не отображается, даже если при создании виджета выбран параметр Показывать данные за предыдущий период.

Пример 3:

В виджете События указан следующий SQL-запрос со стандартными псевдонимами:

SELECT count(ID) AS `metric`,

TenantID as `value`,

Type as `category`

FROM events

GROUP BY value, category

ORDER BY metric DESC

В отличие от схожего запроса в примере 1, в этом случае на диаграмме по оси X отображаются соответствующие типы событий (поле, отмеченное как category), а тенантам (поле, отмеченное как value) соответствуют области значений в столбцах (по оси X) и соответствующие подписи в легенде.

Пример 4:

В виджете События указан следующий SQL-запрос со стандартными псевдонимами:

SELECT count(ID) AS `metric`,

CAST(fromUnixTimestamp64Milli(Timestamp) AS DATE) AS `category`,

Type as `value`

FROM `events`

GROUP BY category, value

ORDER BY category DESC

На диаграмме по оси X отображаются дни месяца (поле, отмеченное как category). По оси Y отображается количество событий определенного типа (поле, отмеченное как value).

Чтобы построить подобный график с расположением столбцов по дате и/или времени, используйте в запросе группировку и сортировку по следующим полям с типом timestamp:

Timestamp
DeviceCustomDate1
DeviceCustomDate2
EndTime
FileCreateTime
FileModificationTime
FlexDate1
OldFileCreateTime
OldFileModificationTime
DeviceReceiptTime
StartTime
Для полноценной работы с данными, расположенными по дате и/или времени, рекомендуется использовать тип графиков Календарная диаграмма.

Основные принципы работы с графиками типа Спидометр

На графиках этого типа отображается процентное отношение количества объектов выбранной категории к общему количеству объектов за определенный период. Спидометр строится для следующих объектов:

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

Значение на графике отображается в процентах с цветовой градацией по настроенным интервалам значений. По умолчанию указаны следующие интервалы процентных значений: 0–30, 30–70, 70–100.

Пример 1:

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

Пример 2:

На виджете Алерты тип Спидометр можно выбрать для категорий Активные алерты и Неназначенные алерты. Для алертов выбираются тенант и период для анализа. По умолчанию эти значения соответствуют значениям, указанным в применимой панели мониторинга. В общем количестве алертов можно также показать данные за предыдущий период.

Аналогичным образом рассчитывается процентное значение для категорий Активные инциденты и Неназначенные инциденты на виджете Инциденты.

Пример 3:

На виджете События для типа Спидометр пользователь указывает тенанта, период для анализа, а также хранилище данных о событиях. SQL-запрос к базе данных отображается в следующем виде:

SELECT count(ID) AS `metric`, SourcePort AS `value` FROM `events` GROUP BY SourcePort ORDER BY value ASC LIMIT 250

Вам помогла эта статья?

Что нам нужно улучшить?

Спасибо за ваш отзыв, вы помогаете нам становиться лучше!