Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Правила в Prometheus действуют по мере сбора данных либо для предварительной компиляции значений, хранящихся в временных рядах, либо для оповещения о предопределенных условиях в собранных метриках. Azure Monitor управляемая служба для Prometheus (Managed Prometheus) предоставляет предопределенные наборы каждого типа правила и поддерживает создание пользовательских правил и управление ими с помощью портала Azure.
Необходимые условия
- Существующая рабочая область Azure Monitor.
- Кластер Kubernetes, подключенный к рабочей области Azure Monitor, и отправка метрик Prometheus. Дополнительные сведения см. в разделе "Включение мониторинга для кластеров Kubernetes".
- Azure разрешения на управление доступом на основе ролей (RBAC) для создания групп правил, таких как роль участника мониторинга в целевой группе ресурсов.
Типы групп правил
Группа правил Prometheus — это коллекция правил генерации оповещений и правил записи, которые оцениваются вместе. Каждое правило должно быть членом одной группы правил. Группы правил определяют область применения всех правил в группе и частоту их оценки.
Существует два типа правил Prometheus.
| Тип | Описание |
|---|---|
| Предупреждение | Alert rules позволяет создавать оповещение Azure Monitor на основе результатов запроса Prometheus Query Language (PromQL). Оповещения, созданные правилами генерации оповещений Managed Prometheus, обрабатываются и активируют уведомления аналогично другим оповещениям Azure Monitor. |
| Запись | Правила записи позволяют предварительно вычислять часто необходимые или вычислительно обширные выражения и хранить их результат в новом наборе временных рядов. Временные ряды, созданные правилами записи, возвращаются в рабочую область Azure Monitor в качестве новых метрик Prometheus. |
Управляемые группы правил Prometheus соответствуют структуре и терминологии групп правил Prometheus с открытым кодом. Azure поддерживает имена правил, выражения, метки и заметки.
Управляемые группы правил Prometheus отличаются от групп правил Prometheus с открытым кодом. Управляемые группы правил Prometheus управляются как Azure ресурсы и включают сведения, необходимые для управления ресурсами, например подписку и группу ресурсов, в которой должна находиться группа правил Azure. Правила генерации оповещений включают выделенные свойства, такие как серьезность оповещений, сопоставление групп действий и настройка автоматического восстановления оповещений, которые позволяют обрабатывать оповещения, такие как другие оповещения Azure Monitor.
Область группы правил
Область группы правил в Managed Prometheus определяет ресурсы, к которым применяются правила в группе. Нельзя применять отдельные правила непосредственно к кластеру Kubernetes. В следующей таблице описаны различные области групп правил.
| Scope | Описание |
|---|---|
| Все кластеры в рабочей области | Все включенные правила в группе будут применены ко всем кластерам, подключенным к рабочей области Azure Monitor. |
| Конкретный кластер — имя кластера | Все включенные правила в группе будут применяться только к выбранному кластеру. |
| Конкретный кластер — имя кластера в запросе | Все включенные правила в группе применяются к кластерам с указанным текстом в их имени. |
Просмотр групп правил Prometheus
Существует несколько способов просмотра групп правил Prometheus и их правил на портале Azure.
Правила в рабочей области Azure Monitor
Выберите группы Rule из рабочей области Azure Monitor на портале Azure, чтобы просмотреть все группы правил в этой рабочей области. Разверните любую группу правил, чтобы просмотреть список правил в этой группе. Выберите любую группу или правило, чтобы просмотреть ее сведения.
Все правила
На странице "Оповещения" в меню "Монитор" на портале Azure выберите группы правил Prometheus, чтобы просмотреть все группы правил в подписках, к которых у вас есть доступ.
В этом представлении показана рабочая область, в которой расположена группа правил, включена ли она, и кластер, если группа правил ограничена определенной областью кластера. Используйте фильтры в верхней части экрана, чтобы сузить список групп правил по различным свойствам. Чтобы удалить несколько групп правил, выберите их и нажмите кнопку "Удалить". Это действие полезно, например, для очистки групп правил, которые больше не требуются после удаления кластера.
Подсказка
Перейдите к этому же представлению на странице "Оповещения " кластера Kubernetes. Это действие задает начальный фильтр группам правил, определенным в этом кластере.
Создание групп и правил Prometheus
- портал Azure
- CLI
- PowerShell
- Шаблон ARM (JSON)
- Bicep
Откройте представление "Все правила" , описанное ранее, и нажмите кнопку "+ Создать".
Scope
| Setting | Описание |
|---|---|
| Рабочая область Azure Monitor | Рабочая область Azure Monitor, из которой группа правил будет запрашивать данные. Это значение нельзя изменить для существующей группы правил. |
| Местоположение | Расположение выбранной рабочей области Azure Monitor. |
| Cluster | Указывает, применяется ли группа правил ко всем кластерам в рабочей области или конкретному кластеру. Выберите определенный кластер или введите текст для сопоставления с именами кластеров. |
Details
| Setting | Описание |
|---|---|
| Subscription | Подписка, в которой будет создан ресурс группы правил. Это значение нельзя изменить для существующей группы правил. |
| Группа ресурсов | Группа ресурсов, в которой будет создан ресурс группы правил. Это значение нельзя изменить для существующей группы правил. |
| Имя | Имя ресурса группы правил. Это имя должно быть уникальным в выбранной группе ресурсов. Это значение нельзя изменить для существующей группы правил. |
| Описание | Описание группы правил. |
| Оценивать каждого | Частота оценки правил в группе. Значение по умолчанию — 1 минута. |
| Включен | Включите или отключите группу правил. Отключенные группы правил по-прежнему будут созданы, но правила будут выполняться только в том случае, если группа включена. |
| Наклейки | Необязательные пары ключей и значений меток для правила. Эти метки добавляются в метрику, созданную правилом. |
Правила
Выберите "Добавить правило записи" или "Добавить правило генерации оповещений ", чтобы добавить правила в группу. Каждый тип правила имеет разные параметры, как описано ниже.
Правила записи
| Setting | Описание |
|---|---|
| Имя | Имя правила записи. Это имя используется для метрики, созданной правилом. |
| Включен | Указывает, включено ли или отключено правило. Отключенные правила будут созданы, но оцениваться они не будут до тех пор, пока не будут включены. |
| Expression | Выражение PromQL, определяющее правило. Выберите "Выполнить запрос" , чтобы просмотреть результаты запроса выражения, визуализированного на диаграмме предварительного просмотра. Измените диапазон времени предварительного просмотра, чтобы увеличить или уменьшить журнал результатов выражения. |
Правила оповещения
| Setting | Описание |
|---|---|
| Имя | Имя правила генерации оповещений. Это имя используется для оповещений, запущенных правилом. |
| Severity | Значение серьезности для оповещений, запущенных этим правилом. |
| Expression | Выражение PromQL, определяющее правило. Выберите "Выполнить запрос" , чтобы просмотреть результаты запроса выражения, визуализированного на диаграмме предварительного просмотра. Измените диапазон времени предварительного просмотра, чтобы увеличить или уменьшить журнал результатов выражения. |
| Подождать | Период времени между тем, когда выражение оповещения сначала становится истинным, и до тех пор, пока оповещение не срабатывает. |
| Наклейки | Необязательные пары ключей и значений меток для правила. Эти метки присваиваются оповещениям, сгенерированным правилом. |
| Annotations | Необязательные пары ключей и значений аннотации для правила. Эти аннотации добавляются к оповещениям, запущенным правилом. |
| Группы действий | Группы действий , определяющие ответ на запущенное оповещение. |
| Включен | Указывает, включено ли или отключено правило. Отключенные правила будут созданы, но оцениваться они не будут до тех пор, пока не будут включены. |
| Автоматическое разрешение предупреждений | Автоматически разрешите оповещения, если в течение периода автоматического разрешения условие правила больше не выполняется. |
Настройка области группы правил
На вкладке "Область ":
Выберите рабочую область Azure Monitor из списка рабочих областей, доступных в подписках. Правила этой группы запрашивают данные из этого рабочего пространства.
Чтобы ограничить группу правил областью кластера, выберите параметр "Конкретный кластер ".
- Выберите кластер из списка кластеров, которые уже подключены к выбранной рабочей области Azure Monitor.
- Для вас вводится значение имени кластера по умолчанию. Измените это значение, только если вы изменили значение метки кластера с помощью cluster_alias.
Нажмите кнопку "Далее ", чтобы настроить сведения о группе правил.
Преобразование файла правил Prometheus в группу правил Managed Prometheus
Если у вас есть файл конфигурации правил Prometheus в формате YAML, используйте служебную программу az-prom-rules-converter , чтобы преобразовать ее в шаблон ARM для группы правил Managed Prometheus. Файл правил может содержать определение одной или нескольких групп правил.
В дополнение к файлу правил программа требует других свойств, необходимых для создания групп правил Managed Prometheus, включая подписку, группу ресурсов, расположение, целевую Azure Monitor рабочую область, идентификатор целевого кластера и имя кластера, а также группы действий. Программа создает файл шаблона, который развертывается с помощью стандартных методов для развертывания шаблонов ARM.
Ограничение правил в определенном кластере
При необходимости ограничьте правила в группе правил для запроса данных, исходящих из одного конкретного кластера, добавив область кластера в группу правил или используя свойство группы clusterName правил.
Ограничить правила одним кластером, если рабочая область Azure Monitor содержит большой объем данных из нескольких кластеров. В таком случае выполнение одного набора правил для всех данных может вызвать проблемы с производительностью или регулированием. Используйте область кластера для создания нескольких групп правил, каждая из которых настроена с одинаковыми правилами, причем каждая группа охватывает другой кластер.
Чтобы ограничить область применения группы правил кластером с использованием шаблона ARM, добавьте значение идентификатора ресурса вашего кластера в список группы правил. Список областей по-прежнему должен содержать идентификатор ресурса рабочей области Azure Monitor. Следующие типы ресурсов кластера поддерживаются в качестве области кластера:
- кластеры Служба Azure Kubernetes (
Microsoft.ContainerService/managedClusters) - кластеры Kubernetes с поддержкой Azure Arc (
Microsoft.kubernetes/connectedClusters) - подключенные устройства Azure (
Microsoft.ResourceConnector/appliances)
Помимо идентификатора кластера настройте clusterName свойство группы правил. Свойство clusterName должно соответствовать метке cluster, которая добавляется к вашим метрикам при сборе из определенного кластера. По умолчанию эта метка имеет значение последней части (имя ресурса) идентификатора кластера. Если вы изменили эту метку с помощью параметра cluster_alias в вашей ConfigMap настройки для сбора данных кластера, необходимо включить обновленное значение в свойство clusterName группы правил. Если при очистке используется значение метки по умолчанию cluster, свойство clusterName является необязательным.
Ниже приведен пример настройки группы правил для ограничения запросов к конкретному кластеру:
{
"name": "sampleRuleGroup",
"type": "Microsoft.AlertsManagement/prometheusRuleGroups",
"apiVersion": "2023-03-01",
"location": "northcentralus",
"properties": {
"description": "Sample Prometheus Rule Group limited to a specific cluster",
"scopes": [
"/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.monitor/accounts/<azure-monitor-workspace-name>",
"/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.containerservice/managedclusters/<myClusterName>"
],
"clusterName": "<myClusterName>",
"rules": [
{
...
}
]
}
}
Если область clusterName и свойство идентификатора кластера не указаны для группы правил, правила в данных запроса группы из всех кластеров в рабочей области.
Настройка сведений о группе правил
Замечание
Для правил генерации оповещений запрос выражения обычно возвращает только временные ряды, которые соответствуют условию выражения. Если диаграмма предварительного просмотра не отображается, и вы получите сообщение "Запрос не вернул результата", скорее всего, условие не было выполнено в диапазоне времени предварительного просмотра.
Завершите создание группы правил
На вкладке Tags задайте все необходимые теги ресурсов Azure для добавления в ресурс группы правил.
На вкладке "Просмотр и создание " портал проверяет группу правил и сообщает о любых проблемах. На этой вкладке выберите параметр шаблона автоматизации представления и скачайте шаблон для создаваемой группы.
После прохождения проверки и просмотра параметров нажмите кнопку "Создать".
Выполните дальнейшие действия по развертыванию группы правил, чтобы убедиться, что она успешно завершена или будет уведомлена об ошибке.
Просмотрите состояния здоровья ресурсов в группах правил Prometheus
Просмотрите состояние работоспособности ресурсов группы правил Prometheus на портале, чтобы обнаружить проблемы в группах правил, например неправильные настройки или проблемы регулирования запросов.
На портале перейдите к обзору группы правил Prometheus, которую вы хотите отслеживать.
На левой панели в разделе "Справка" выберите "Работоспособности ресурсов".
На панели работоспособности ресурсов просмотрите текущее состояние доступности группы правил. Также доступна история последних событий работоспособности ресурсов до последних 30 дней.
- Если группа правил помечена как доступная, она работает должным образом.
- Если группа правил помечена как "Пониженная", одно или несколько правил в группе не работают должным образом. Запрос правила может ограничиваться, или другие проблемы могут привести к сбою оценки правила. Разверните запись состояния для получения дополнительных сведений об обнаруженной проблеме, предложениях по её устранению или дальнейшему поиску решения.
- Если группа правил помечена как недоступной, вся группа правил не работает должным образом. Может возникнуть проблема с конфигурацией (например, не удается обнаружить рабочую область Azure Monitor) или внутренние проблемы со службой. Разверните запись состояния для получения дополнительных сведений об обнаруженной проблеме, предложениях по её устранению или дальнейшему поиску решения.
- Если группа правил помечена как "Неизвестно", вся группа правил отключена или находится в неизвестном состоянии.
Отключение и включение групп правил
Чтобы включить или отключить правило, выберите группу правил на портале Azure. Выберите "Включить" или "Отключить", чтобы изменить его состояние.