Метрики, трекеры, фильтры, группировка

---

Виджет строится из рядов - источников данных (вкладка «Данные» редактора). Ряд бывает двух видов:

• метрика - данные с сервера;
• константа - фиксированное число, например целевой порог.

Чтобы добавить ряд, нажмите внизу вкладки кнопку «Метрика» или «Константа».

Ряд-метрика

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

Источник

Переключатель «Метрика» / «Трекер»:

• Метрика: нажмите на поле «Выберите метрику...» - откроется каталог с поиском и группировкой по типам (Уязвимости, Устройства, Коллекторы и т.д.). Кнопка «Лейблы метрики» рядом с выбранной метрикой показывает её лейблы и возможные значения.
• Трекер: нажмите «Выберите трекер...» - откроется таблица трекеров с поиском; источником данных станет метрика выбранного трекера, а ряд получит его имя.

Фильтры по лейблам

Фильтры сужают данные (например, только критичные уязвимости). Нажмите «Фильтр»:

• «Имя лейбла» - по какому полю фильтровать (список подсказывает лейблы выбранной метрики);
• Оператор - кнопки = («Равно»), ≠ («Не равно») и =~ («Шаблон regexp»);
• «Значение» (для =~ - «Шаблон regexp», можно выбрать несколько введя |) - выберите из списка значений лейбла. В этом же списке доступны глобальные фильтры дашборда ($имя_переменной) - см. Глобальные фильтры. Панель «Возможные лейблы» внизу диалога подсказывает, какие лейблы и значения есть у метрики.

Нажмите «Добавить» (или «Сохранить» при редактировании). Добавленные фильтры отображаются чипами: клик по чипу - редактирование, крестик - удаление.

Агрегация

Как сервер сворачивает данные: Sum (суммирует), Last (берёт последнее значение) или «Откл.» (сырые данные).

Группировка

• «Группировать по лейблам» (доступно при включённой агрегации) - разбивает метрику на несколько серий (например, по критичности: отдельная линия/сегмент на каждое значение). Отдельный пункт «По группам безопасности» делит данные по группам безопасности.
• «Серии по лейблу» - какой лейбл использовать для подписи серий. Появляется, когда агрегация отключена (одиночный выбор, по умолчанию «Авто») или когда выбрано несколько лейблов группировки (выбор нескольких, по умолчанию используются все).

Если подписи серий выглядят как {лейбл="значение", ...}

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

• добавьте фильтры, чтобы оставить только нужные данные;
• включите агрегацию (Sum/Last), чтобы свернуть серии в одну;
• выберите лейбл в «Группировать по лейблам» или «Серии по лейблу», чтобы серии получили осмысленные подписи.

Ряд-константа

Задайте «Значение» - число, которое отрисуется на графике. Для «Столбцов» дополнительно выберите «Отображение»:

• «Линия» - горизонтальная линия-порог поверх столбцов (удобно для SLA-таргета);
• «Столбец» - дополнительный столбец в каждой категории.

Константы поддерживаются только типами «Линии» и «Столбцы» (включая горизонтальные).

Управление рядами

У каждого ряда в шапке:

• имя ряда - кликните по названию, чтобы переименовать (используется в легенде);
• иконка глаза - скрыть/показать ряд на графике, не удаляя его;
• «Дублировать» - создать копию ряда;
• «Удалить» - убрать ряд;
• ручка справа - перетащите, чтобы поменять порядок рядов.