Поделиться через

Обзор оповещений метрик на основе запросов (предварительная версия)

Вы можете создать правило генерации оповещений метрик в метриках Prometheus или пользовательских (OTel), хранящихся в рабочей области Azure Monitor, с условием оповещения метрик на основе запросов с помощью PromQL.

В этой статье дан обзор оповещений метрик, основанных на запросах в Azure Monitor, с акцентом на использование PromQL для создания правил оповещения для метрик Prometheus или пользовательских (OTel), хранящихся в рабочей области Azure Monitor.

Что такое PromQL?

PromQL — это язык запросов на основе открытого исходного кода:

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

Capabilities

  • Сферы действия правил, ориентированных на ресурсы и на рабочие пространства.
    • Ресурсо-ориентированные правила применяют запросы к метрикам из определенных ресурсов Azure, таких как Службы Azure Kubernetes (AKS) или виртуальные машины, с подробностью RBAC, требуя доступа только к отслеживаемому ресурсу.
    • Правила, ориентированные на рабочую область, позволяют авторизованным пользователям запрашивать любые метрики, поступившие в рабочую область от любых ресурсов, включая запросы к нескольким ресурсам одновременно.
  • Авторизация на основе управляемых удостоверений. Вы можете авторизовать доступ к рабочим областям с помощью управляемого удостоверения Azure. Управляемое удостоверение обеспечивает безопасный, управляемый Azure доступ к ресурсам, повышая степень детализации RBAC путем разделения прав доступа пользователей и правил. Оповещения метрик поддерживают удостоверения, назначенные пользователем и назначаемые системой.
  • Кастомизация настроек оповещений. Вы можете настроить оповещения метрик на основе запросов, чтобы включить более контекстные сведения, относящиеся к сценарию.

Замечание

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

Оповещения на основе запросов по метрикам по сравнению с группами правил в Prometheus

Оповещения метрик на основе запросов являются альтернативой оповещениям в группах правил Prometheus.

Преимущества использования оповещений метрик на основе запросов:

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

Различия в использовании правил генерации оповещений метрик на основе запросов и групп правил Prometheus

  • Ограничение области. В группах правил Prometheus можно ограничить область действия правил одним кластером AKS или ARC с помощью clusterName свойства. При использовании правил генерации оповещений метрик на основе запросов ограничение области до одного кластера (или любого другого ресурса) выполняется путем установки правила scope на определенный ресурс.
  • Условие правила. Свойство правила оповещения метрик query полностью эквивалентно свойству групп правил Prometheus expression и приведет к тем же результатам. Свойство for работает одинаково в обоих службах.
  • Обработка меток метрик. Оповещения метрик на основе запросов полностью поддерживают обработку и манипуляцию меток метрик Prometheus и OTel в соответствии со стандартом PromQL. Однако при срабатывании оповещения остальные метки метрик и их значения отображаются в теле сообщения, как dimensions, согласно терминологии, используемой в других оповещениях Azure и интерфейсах Azure Monitor.
  • Пользовательские метаданные и сведения. Вы можете определить пользовательские метки и аннотации, чтобы добавить динамические метаданные, информационный текст, ссылки runbook и многое другое в полезные данные правил оповещений группы правил Prometheus. В оповещениях метрик на основе запросов аналогичные функции предоставляются с помощью пользовательских свойств.

Управляемые идентификаторы для оповещений на основе запросов

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

Управляемое удостоверение должно иметь роль Мониторинг-читатель (или пользовательскую роль с эквивалентными разрешениями) на сфокусированном ресурсе или AMW.

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

Схема и свойства

В следующей таблице приведено описание схемы и свойств для правила генерации оповещений метрик на основе запросов.

Имя Обязательно Тип Description Примечания.
имя True струна Имя правила генерации оповещений
location True струна Расположение ресурса Из регионов, поддерживаемых в предварительной версии
идентичность.тип True струна Тип управляемого удостоверения Пользовательское назначение (UserAssigned) или системное назначение (SystemAssigned)
identity.userAssignedIdentities True струна Идентификатор ресурса управляемого удостоверения, назначаемого пользователем Требуется, если тип — UserAssigned
свойства.включено Неправда булевый Включить/отключить правило По умолчанию = истина
свойства.описание Неправда струна Описание правила генерации оповещений
properties.серьезность Неправда целое число Серьезность оповещения 0-4, по умолчанию — 3 (информационные)
properties.targetResourceType Неправда струна Тип целевого ресурса оповещения
свойства.области_видимости True строка[] Идентификатор ресурса Azure Идентификатор ресурса AMW (для правила, ориентированного на рабочую область) или другой идентификатор ресурса Azure, идентификатор группы ресурсов и идентификатор подписки (для правила, ориентированного на ресурсы). В настоящее время поддерживается только один элемент области.
свойства.частотаОценки True струна Интервал оценки правил Эквивалент интервала Prometheus.
properties.criteria.allOf[].name True струна Название условия
properties.criteria.allOf[].query True струна Запрос правила генерации оповещений Запрос PromQL, эквивалентный выражению правила генерации оповещений Prometheus
properties.criteria.allOf[].criteriaType Неправда струна Тип условия По умолчанию используется StaticThresholdCriterion (динамическое пороговое значение, не поддерживаемое в предварительной версии)
свойства.критерии.периодыОтказа.для Неправда струна Длительность, в течение которой условие остается истинным перед запуском оповещения Эквивалентно правилу генерации оповещений Prometheus "for". Значения — PT1M, PT5M и т. д. Значение по умолчанию — 0 (немедленное срабатывание)
properties.resolveConfigurations.autoResolved Неправда булевый Включено автоматическое разрешение оповещений По умолчанию = истина
properties.resolveConfigurations.timeToResolve Неправда струна Время ожидания автоматического решения уведомлений Default = "PT5M"
properties.actions[].actionGroupId false струна список идентификаторов групп действий массив групп действий, выполняемых при запуске или разрешении оповещения
свойства.actionProperties.ТемаПисьма false струна шаблон для настраиваемой темы электронной почты
properties.customProperties false струна Пары "ключ-значение" для пользовательских свойств оповещения

Поддерживаемые регионы

  • East US
  • West Europe
  • Восток США 2
  • North Europe
  • Central US
  • Западная часть США 2
  • UK South
  • Юго-Восточная Азия
  • Центральная Индия
  • West US
  • Западно-Центральная Германия
  • Japan East
  • Canada Central
  • Южно-Центральная часть США
  • East Asia
  • Australia East
  • Центральная Швеция
  • Switzerland North
  • Центральная Франция
  • UAE North
  • Norway East
  • Korea Central
  • Бразилия (Юг)
  • Западная часть США 3
  • Australia Southeast
  • Север Южной Африки

Дальнейшие шаги

  • Last updated on