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

Caution

Предварительно провижиненные data source-managed оповещения Loki и Prometheus устарели в Grafana Cloud и не могут быть созданы в новых стеках. Новые стеки Grafana Cloud будут по умолчанию использовать Grafana-managed alerting (GMA). Datasource-managed alerting (DMA) не провижинится в новых стеках. Существующие стеки не затронуты.

Это относится к источникам данных Grafana Cloud Loki и Prometheus по умолчанию, управляемым Grafana Labs и Cloud Alertmanager, которые не будут доступны, и Grafana не будет провижинить для них источник данных. Если вы добавите свои собственные источники данных Mimir, Loki или Alertmanager, вы сможете продолжать использовать data source-managed оповещения.

Пользователи Cloud могут импортировать правила DMA в правила GMA с помощью инструмента импорта. См. документацию по импорту data source-managed оповещений в Grafana-managed оповещения, чтобы узнать, как это сделать.

Настройка data source-managed правил оповещений

Data source-managed правила оповещений — это правила оповещений, которые хранятся в источнике данных, таком как Prometheus или Loki, а не в Grafana.

В Grafana Alerting вы можете:

  1. Создавать и редактировать data source-managed правила для источников данных Grafana Mimir и Grafana Loki.
  2. Просматривать правила из источников данных Prometheus, когда включена опция Manage alerts via Alerting UI. Однако вы не можете создавать или редактировать эти правила в Grafana.
  3. Импортировать data source-managed правила из Loki, Mimir и Prometheus в Grafana-managed правила.

Note

Data source-managed правила поддерживаются для горизонтальной масштабируемости, но они могут привнести больше операционной сложности, чем Grafana-managed правила оповещений.

Мы рекомендуем использовать Grafana-managed правила оповещений везде, где это возможно, так как они предоставляют более богатый набор возможностей и лучшую интеграцию с полным рабочим процессом Grafana Alerting.

Сравнение с Grafana-managed правилами

Приведённая ниже таблица сравнивает Grafana-managed и data source-managed правила оповещений.

Возможность
Grafana-managed правило оповещения
Data source-managed правило оповещения
Поддерживаемые источники данных Все серверные источники данных, включающие опцию alerting Поддерживает создание правил только для источников данных Mimir и Loki
Смешивание источников данных Да Нет
Добавление выражений для преобразования ваших данных и задания условий оповещения Да Нет
Состояния No data и error Да Нет
Устаревшие экземпляры оповещений Да Нет
Изображения в уведомлениях об оповещениях Да Нет
Управление доступом на основе ролей Да Нет
История состояний оповещений Да Нет
История версий оповещений Да Нет
Провижининг через Terraform Да Нет
Recording-правила Да Да
Организация Организация и управление доступом через папки Использование пространств имён
Вычисление правил оповещений Вычисление оповещений выполняется в Grafana Вычисление правил оповещений выполняется в источнике данных и допускает горизонтальное масштабирование
Масштабирование Правила оповещений хранятся в базе данных Grafana. Правила оповещений хранятся в источнике данных и допускают горизонтальное масштабирование

Приведённая ниже схема показывает архитектуру установки Mimir, использующей data source-managed правила оповещений.

Data source-managed alerting architecture based on Grafana Mimir

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

Чтобы создать или отредактировать data source-managed правила оповещений, следуйте этим инструкциям.

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

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

Включение Ruler API

Дополнительные сведения см. в разделе Mimir Ruler API или Loki Ruler API.

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

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

Разрешения

Правила оповещений для экземпляров Mimir или Loki могут редактировать или удалять пользователи с ролями Editor или Admin.

Если вы не хотите управлять правилами оповещений для конкретного источника данных, перейдите в его настройки и снимите флажок Manage alerts via Alerting UI.

Задание имени правила оповещения

Warning

[ru] DOCS_SHARED: "docs/grafana/latest/alerting/alerting-rules/create-data-source-managed-rule.ru.md" ("/hugo/content/docs/grafana/latest/alerting/alerting-rules/create-data-source-managed-rule.ru.md:214:1") shared directory "docs/grafana/latest/shared" not found

Определение запроса и условия

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

Note

По умолчанию новые правила оповещений являются Grafana-managed. Чтобы переключиться на Data source-managed, следуйте этим инструкциям.

  1. Выберите основанный на Prometheus источник данных из выпадающего списка.

    Вы также можете нажать Open advanced data source picker, чтобы найти дополнительные опции.

  2. Введите запрос PromQL или LogQL, включая условие оповещения.

  3. В опции Rule type выберите Data source-managed.

  4. Нажмите Preview alerts.

Настройка поведения вычисления оповещений

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

  1. Выберите пространство имён или нажмите + New namespace.

  2. Выберите группу вычисления или нажмите + New evaluation group.

    Если вы создаёте новую группу вычисления, укажите интервал для группы.

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

  3. Введите период ожидания.

    Период ожидания — это период, в течение которого правило оповещения может находиться в нарушении условия до того, как сработает.

    После выполнения условия оповещение переходит в состояние Pending. Если условие остаётся активным в течение указанной длительности, оповещение переходит в состояние Firing, иначе оно возвращается в состояние Normal.

Настройка меток и уведомлений

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

Все правила и экземпляры оповещений, независимо от их меток, соответствуют политике уведомлений по умолчанию. Если вложенных политик нет или ни одна из вложенных политик не соответствует меткам в правиле или экземпляре оповещения, то политика уведомлений по умолчанию является подходящей политикой.

  1. Добавьте метки, если хотите изменить способ маршрутизации ваших уведомлений.

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

Настройка уведомительного сообщения

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

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

Grafana предоставляет несколько необязательных аннотаций.

  1. Необязательно: добавьте summary.

    Краткая сводка того, что произошло и почему.

  2. Необязательно: добавьте description.

    Описание того, что делает правило оповещения.

  3. Необязательно: добавьте Runbook URL.

    Веб-страница, где вы храните ваш runbook для оповещения

  4. Необязательно: добавьте пользовательскую аннотацию.

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

  5. Необязательно: Link dashboard and panel.

    Привяжите правило оповещения к панели, чтобы упростить расследование оповещения.

  6. Нажмите Save rule.