Внешние метрики для Prometheus#

Данный раздел доступен для всех ролей пользователей.

resources/outerMetrics.png

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

Конфигурирование внешних метрик#

Для конфигурирования внешней метрики необходимо нажать на кнопку Добавить метрику, затем resources/outerMetrics.png и заполнить стандартные поля для метрик Prometheus:

resources/outmetrics1.png

  • Название — название метрики (Metric names and labels);

  • Описание — описание метрики help;

  • Единицы измерения — единицы измерения unit (необязательное поле);

  • Описание — поле подробного описания метрики (необязательное поле);

  • Тип метрики — раскрывающийся список с выбором метрик: Counter и Gauge;

  • Лейблы — дополнительные атрибуты метрики в Prometheus типа ключ-значение (key-value).

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

resources/outmetrics2.png

При этом:

  • ключи не должны повторяться;

  • регулярное выражение для ключей лейблов, названий и единиц измерения: [a-zA-Z_:][a-zA-Z0-9_:]*

  • не использовать два подчеркивания подряд — зарезервированная комбинация для внутренних метрик;

  • метрика может иметь состояние «Включено/Отключено».

Выбор исходных метрик#

Необходимо указать, на основе каких исходных метрик строятся внешние.

Для конфигурирования исходных метрик предусмотрен отдельный интерфейс:

resources/outmetrics3.png

  • Название метрики — указать название метрики;

  • Путь к узлу — указать путь к выбранной метрике (так как названия метрик могут быть одинаковыми для разных узлов, например, брокера и топик);

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

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

Преобразование исходных метрик#

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

resources/outmetrics4.png

Действие над исходными метриками:

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

  • Последнее — последнее значение;

  • Среднее — среднеарифметическое за период значение;

  • Максимальное — максимальное за период значение;

  • Минимальное — минимальное за период значение.

Временной интервал группировки — задается по какому интервалу группировать значения.

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

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

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

resources/outmetrics5.png

Обновление не происходит автоматически (необходимо обновить страницу). Данный механизм реализован для быстрой проверки получаемого результата.

Выгрузка конфигураций#

Выгрузка конфигураций внешних метрик осуществляется в формате JSON:

resources/config_outer.png

Редактирование конфигураций внешних метрик доступно пользователю с ролью Администратор мониторинга.