Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Оповещенияbreadcrumb arrow Настройка правил оповещенийbreadcrumb arrow Настройка recording-правилbreadcrumb arrow Создание data source-managed recording-правил

Создание data source-managed recording-правил

Recording-правила позволяют периодически заранее вычислять часто используемые или ресурсоёмкие запросы, сохраняя результаты как новую метрику временной серии.

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

Data source-managed recording-правила могут выполнять запросы к основанным на Prometheus источникам данных, таким как Mimir или Loki. Дополнительные сведения о recording-правилах в Prometheus см. в разделе Определение recording-правил в Prometheus.

Обратите внимание, что в data source-managed группах правила оповещений и recording-правила внутри одной группы вычисления вычисляются последовательно. Это полезно, чтобы гарантировать, что recording-правило вычисляется раньше, чем любое другое правило оповещения запросит заранее вычисленную метрику.

Перед началом

  • Убедитесь, что у вас есть разрешение на запись в источник данных Prometheus или Loki. Иначе вы не сможете создавать или обновлять управляемые Grafana Mimir правила оповещений.

  • Для источников данных Grafana Mimir и Loki включите API ruler, настроив соответствующие их сервисы.

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

    • Mimir — используйте префикс /prometheus. Источник данных Prometheus поддерживает как Grafana Mimir, так и Prometheus, и Grafana ожидает, что как Query API, так и Ruler API находятся по одному URL. Вы не можете указать отдельный URL для Ruler API.

Добавление нового recording-правила

Чтобы создать новое data source-managed recording-правило:

  1. Нажмите Alerts & IRM -> Alerting -> Alert rules.
  2. В верхней части страницы Alert rules нажмите More -> New Data source recording rule.

Ввод имени recording-правила

Имя recording-правила должно быть именем метрики Prometheus и не содержать пробелов.

Определение recording-правила

Выберите ваш источник данных и введите запрос. Запросы, используемые в data source-managed recording-правилах, всегда выполняются как instant-запросы.

Добавление пространства имён и группы

  1. В выпадающем списке Namespace выберите существующее пространство имён правил или добавьте новое.

    Пространства имён могут содержать одну или несколько групп правил и имеют только организационное назначение.

  2. В выпадающем списке Group выберите существующую группу в выбранном пространстве имён или добавьте новую.

    Правила внутри группы выполняются последовательно с регулярным интервалом и с одинаковым временем вычисления.

    Новые созданные правила добавляются в конец группы, и вы можете изменить их порядок на странице Alert rules.

Добавление меток

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

Запрос новой метрики в дашбордах или правилах оповещений

Нажмите Save rule или Save rule and exit, чтобы сохранить правило.

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