Плагин Polystat#

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

Предусловия#

Плагин должен предустановлен в компоненте GRAF

Правила эксплуатации#

• Запрещено отображать в полигонах напрямую конфиденциальные данные (персональные данные, учетные данные, токены, внутренние IP-адреса и т.д.).

• Все действия по созданию и изменению панелей с Polystat фиксируются в системе аудита:

• Регулярно проверяйте логи на предмет попыток добавления недоверенных URL

• Устанавливайте ограничение на количество отображаемых полигонов (Display Limit) при работе с большими наборами данных (рекомендуется не более 200).

• Функция Sanitize URL должна быть включена по умолчанию для предотвращения XSS-атак.

• Обновления плагина Polystat осуществляются только в рамках обновления дистрибутива PLUG.

Последовательность выполнения#

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

1. Убедитесь, что плагин визуализации Polystat установлен в продукте PVV.

2. Откройте дашборд визуализации в интерфейсе PVV.

3. Выберите тип визуализации «Polystat».

4. Настройте параметры конфигурации Polystat

   

5. Нажмите кнопку «Save Dashboard», чтобы отобразить визуализацию панели.

Параметры конфигурации#

Layout#

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

В качестве альтернативы можно указать количество столбцов и строк вручную или автоматизировать только один из них.

Sizing#

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

В этом разделе также предоставляется возможность установить границу для каждого полигона (значение по умолчанию - 2 пикселя).

Размер границы для каждого полигона можно задать в этом разделе. Используемый цвет можно найти в разделе «Глобальный».

Text#

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

Вручную установите цвет шрифта с помощью средства выбора цвета

Sorting#

Порядок отображаемых полигонов (слева направо) можно задать с помощью параметров сортировки.

Поддерживаются следующие направления:

И следующие поля:

Tooltips#

Global#

Следующие настройки доступны в разделе «Global» и подробно описаны ниже.

Global Aliasing#

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

Если у вас есть эти 3 запроса, возвращающие последовательность: Foo-A, значения 1,2,3 Bar-B, значения 4,5,6 Misc, значения 7,8,9

Добавив регулярное выражение: /(Foo|Bar)/, отобразится:

Overrides#

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

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

То же самое переопределение с добавлением пороговых значений:

Конечный результат вышеуказанного переопределения с примененными пороговыми значениями:

Composites#

Составные элементы позволяют объединить несколько показателей в единое представление, которое отражает «наихудшее» состояние из всех показателей вместе взятых. Это полезно в качестве сводного представления более сложных систем, за которыми ведется мониторинг.

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

Вот как выглядят два композита после их рендеринга:

Это всплывающая подсказка, которая отображается при наведении курсора мыши на композит:

instructions-plugins-polystat-composites-polystat-v2-composite-with-tooltip.png

Standard options#

Вычислить минимальное максимальное значение для каждого поля

Value mappings#

Это встроенная опция в Grafana, назначение цветов игнорируется, применяются только пороговые цвета.

Подробные сведения о пороговых значениях#

Этот плагин поддерживает «ранжированные» состояния.

Ожидается, что пороговые значения будут отсортированы по возрастанию, где

T0 = наименьшее десятичное значение в любом состоянии
TN = наивысшее десятичное значение в любом состоянии

Начальное состояние установлено на «ок» Сравнение выполняется с использованием значения «больше или равно», если value >= thresholdValue state = X

Сравнения выполняются в обратном порядке, используя диапазон между N-м (включающим) порогом и N+1 (исключающим) значением

  Включающее значение = T(n).value
  Исключающее значение = T(n+1).value

Когда нет порога n+1, самого высокого порогового значения T(n), выполняется простое сравнение с включением >=

Пример 1: (типичный линейный)

  T0 - 5, ok
    T1 - 10, warning
    T2 - 20, critical

  Value >= 20 (Value >= T2)
  10 <= Value < 20  (T1 <= Value < T2)
  5 <= Value < 10   (T0 <= Value < T1)

Пример 2: (обратный линейный)

    T0 - 50, critical
    T1 - 90, warning
    T2 - 100, ok

  Value >= 100
  90 <= value < 100
  50 <= value < 90

Пример 3: (ограниченный)

    T0 - 50, critical
    T1 - 60, warning
    T2 - 70, ok
    T3 - 80, warning
    T4 - 90, critical

    Value >= 90
    80 <= Value < 90
    70 <= Value < 80
    60 <= Value < 70
    50 <= Value < 60

«Наихудшее» состояние возвращается после проверки каждого порогового диапазона

Результат#

После успешной настройки плагина Polystat в Grafana вы получаете возможность:

• Визуализировать метрики в виде шестиугольных ячеек (сот): Каждая метрика отображается в виде отдельного полигона, что обеспечивает компактное и наглядное представление большого объема данных.

• Группировать метрики в составные показатели: С помощью функции Composites можно объединять несколько метрик в один составной элемент, отражающий общее состояние системы на основе «наихудшего» значения (например, критическое, если хотя бы одна метрика в состоянии тревоги).

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

• Применять пороговые значения и цветовую индикацию: На основе заданных порогов (например, «normal», «warning», «critical») полигоны меняют цвет, что позволяет быстро оценивать состояние системы визуально.

• Использовать переопределения (Overrides): Настраивать индивидуальные параметры отображения для конкретных метрик, включая единицы измерения, форматирование, ссылки и пороги.

• Добавлять кликабельные ссылки: Настройка перехода по URL (в текущей или новой вкладке) при клике на полигон позволяет интегрировать дашборды с другими системами мониторинга или детализированными панелями.

• Применять регулярные выражения для алиасов: Упрощать отображение имен метрик с помощью глобального или локального сопоставления, оставляя только значимую часть названия.

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

• Создавать адаптивные и информативные дашборды: Polystat идеально подходит для мониторинга состояния множества узлов, сервисов или хостов в режиме реального времени — например, в системах управления инфраструктурой, телеком-сетях или распределенных приложениях.