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

resources/outerMetrics.png

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

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

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

resources/PrometheusParams.png

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

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

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

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

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

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

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

resources/lables.png

При этом:

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

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

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

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

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

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

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

resources/innerMetrics.png

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

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

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

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

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

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

resources/actions.png

resources/actions2.png

resources/actionsPeriod.png

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

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

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

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

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

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

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

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

resources/result.png

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

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

resources/config_outer.png

Обновление значений внешних метрик происходит после обновления основных метрик с заданным интервалом (по умолчанию 3 минуты):

resources/period_outer.png

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