az monitor metrics alert
Управление правилами оповещений метрик почти в реальном времени.
Команды
| Имя | Описание | Тип | Состояние |
|---|---|---|---|
| az monitor metrics alert condition |
Управление условиями правила генерации оповещений о метриках почти в реальном времени. |
Core | GA |
| az monitor metrics alert condition create |
Создайте условие правила генерации оповещений метрик. |
Core | Preview |
| az monitor metrics alert create |
Создайте правило генерации оповещений на основе метрик. |
Core | GA |
| az monitor metrics alert delete |
Удалите правило генерации оповещений на основе метрик. |
Core | GA |
| az monitor metrics alert dimension |
Управление измерениями правил генерации оповещений о метриках почти в реальном времени. |
Core | GA |
| az monitor metrics alert dimension create |
Создание измерения правила генерации оповещений метрик. |
Core | Preview |
| az monitor metrics alert list |
Список правил генерации оповещений на основе метрик. |
Core | GA |
| az monitor metrics alert show |
Отображение правила генерации оповещений на основе метрик. |
Core | GA |
| az monitor metrics alert update |
Обновите правило генерации оповещений на основе метрик. |
Core | GA |
az monitor metrics alert create
Создайте правило генерации оповещений на основе метрик.
az monitor metrics alert create --condition
--name
--resource-group
--scopes
[--action]
[--auto-mitigate {false, true}]
[--description]
[--disabled {false, true}]
[--evaluation-frequency]
[--region --target-resource-region]
[--severity]
[--tags]
[--target-resource-type --type]
[--window-size]
Примеры
Создайте оповещение об использовании ЦП на виртуальной машине без действий.
az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"
Создайте оповещение об использовании ЦП на виртуальной машине с действиями электронной почты и веб-перехватчика.
az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} \
--condition "avg Percentage CPU > 90" --window-size 5m --evaluation-frequency 1m \
--action "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/actionGroups/<actionGroupName>" apiKey={APIKey} type=HighCPU \
--description "High CPU"
Создайте оповещение, когда учетная запись хранения отображает большое количество медленных транзакций с помощью многомерных фильтров.
az monitor metrics alert create -g {ResourceGroup} -n alert1 --scopes {StorageAccountId} \
--description "Storage Slow Transactions" \
--condition "total transactions > 5 where ResponseType includes Success" \
--condition "avg SuccessE2ELatency > 250 where ApiName includes GetBlob"
Создайте правило генерации оповещений на основе метрик, которое отслеживает пользовательскую метрику.
az monitor metrics alert create -n "metric alert rule on a custom metric" -g "Demos" --scopes {VirtualMachineID} \
--condition "max Azure.VM.Windows.GuestMetrics.Memory\Available Bytes > 90" \
--window-size 5m --evaluation-frequency 1m
Создайте оповещение об использовании ЦП на нескольких виртуальных машинах без действий.
az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
--condition "avg Percentage CPU > 90" --description "High CPU" --region westus
Создайте динамическое оповещение об использовании ЦП на нескольких виртуальных машинах без действий.
az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
--condition "avg Percentage CPU > dynamic medium 2 of 4 since 2020-10-01T10:23:00.000Z"
--description "Dynamic CPU"
--window-size 5m
--region westus
Обязательные параметры
Условие, которое активирует правило. Его можно создать с помощью команды az monitor metrics alert condition create.
Использование: --condition {avg,min,max,total,count} [NAMESPACE.]METRIC [{=,!=,>,>=,<,<=} ПОРОГ] [{>,><,<} динамические НАРУШЕНИЯ КОНФИДЕНЦИАЛЬНОСТИ ОЦЕНКИ [с DATETIME]] [где ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] [и ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] ...]] [с skipmetricvalidation]
Чувствительность может быть "низкой", "средней", "высокой".
Нарушения могут быть числом нарушений для активации оповещения. Он должен быть меньше или равен оценке.
Оценки могут быть числом периодов оценки для динамического порогового значения.
Datetime может быть датой, с которой начать обучение исторических данных метрик и вычислять динамические пороговые значения (в формате ISO8601).
Измерения можно запрашивать, добавив ключевое слово where и несколько измерений, комбинируя их с ключевым словом "и".
Значения METRIC, DIMENSION и соответствующие значения THRESHOLD можно получить из команды az monitor metrics list-definitions.
Из-за ограничения сервера, если правило генерации оповещений содержит несколько критериев, использование измерений ограничено одним значением для каждого измерения в каждом критерии.
Несколько условий можно указать с помощью нескольких --condition аргументов.
Имя правила генерации оповещений.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Разделенный пробелами список областей, к которые применяется правило. Ресурсы, указанные в этом параметре, должны иметь одинаковый тип и существовать в том же расположении.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Добавьте группу действий и необязательные свойства веб-перехватчика, чтобы активировать оповещение.
Использование: --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]
Несколько групп действий можно указать с помощью нескольких --action аргументов.
Автоматически разрешать оповещение.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Описание правила в свободном тексте.
Создайте правило в отключенном состоянии.
| Свойство | Значение |
|---|---|
| Default value: | False |
| Допустимые значения: | false, true |
Частота вычисления правила в формате "##h##m##s".
| Свойство | Значение |
|---|---|
| Default value: | 1m |
Область целевых ресурсов в областях. Это необходимо указать, если области являются группами ресурсов или подпиской.
Серьезность оповещения от 0 (критического) до 4 (подробно).
| Свойство | Значение |
|---|---|
| Default value: | 2 |
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Тип ресурса целевого ресурса в областях. Это необходимо указать, если области являются группами ресурсов или подпиской.
Время агрегирования метрик в формате ##h##m##s.
| Свойство | Значение |
|---|---|
| Default value: | 5m |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az monitor metrics alert delete
Удалите правило генерации оповещений на основе метрик.
az monitor metrics alert delete [--ids]
[--name]
[--resource-group]
[--subscription]
Примеры
Удалите правило генерации оповещений на основе метрик.
az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Имя правила генерации оповещений.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az monitor metrics alert list
Список правил генерации оповещений на основе метрик.
az monitor metrics alert list [--resource-group]
Примеры
Список правил генерации оповещений на основе метрик.
az monitor metrics alert list --resource-group MyResourceGroup
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az monitor metrics alert show
Отображение правила генерации оповещений на основе метрик.
az monitor metrics alert show [--ids]
[--name]
[--resource-group]
[--subscription]
Примеры
Отображение правила генерации оповещений на основе метрик.
az --name MyAlertRule --resource-group MyResourceGroup
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Имя правила генерации оповещений.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az monitor metrics alert update
Обновите правило генерации оповещений на основе метрик.
az monitor metrics alert update [--add]
[--add-action --add-actions]
[--add-condition --add-conditions]
[--auto-mitigate {0, 1, f, false, n, no, t, true, y, yes}]
[--description]
[--enabled {0, 1, f, false, n, no, t, true, y, yes}]
[--evaluation-frequency]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--name]
[--remove]
[--remove-actions]
[--remove-conditions]
[--resource-group]
[--scopes]
[--set]
[--severity]
[--subscription]
[--tags]
[--window-size]
Примеры
Отключить или включить правило генерации оповещений на основе метрик.
az monitor metrics alert update --enabled false --name MyAlertRule --resource-group MyResourceGroup
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.
| Свойство | Значение |
|---|---|
| Parameter group: | Generic Update Arguments |
Добавьте группу действий и необязательные свойства веб-перехватчика, чтобы активировать оповещение.
Использование: --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]
Несколько групп действий можно указать с помощью нескольких --add-action аргументов. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Parameter group: | Action Arguments |
Добавьте условие, которое активирует правило.
Использование: --add-condition {avg,min,max,total,count} [NAMESPACE.]METRIC [{=,!=,>,>=,<,<=} ПОРОГ] [{>,><,<} динамические НАРУШЕНИЯ КОНФИДЕНЦИАЛЬНОСТИ ОЦЕНКИ [с DATETIME]] [где ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] [и ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] ...]]
Чувствительность может быть "низкой", "средней", "высокой".
Нарушения могут быть числом нарушений для активации оповещения. Он должен быть меньше или равен оценке.
Оценки могут быть числом периодов оценки для динамического порогового значения.
Datetime может быть датой, с которой начать обучение исторических данных метрик и вычислять динамические пороговые значения (в формате ISO8601).
Измерения можно запрашивать, добавив ключевое слово where и несколько измерений, комбинируя их с ключевым словом "и".
Значения METRIC, DIMENSION и соответствующие значения THRESHOLD можно получить из команды az monitor metrics list-definitions.
Из-за ограничения сервера, если правило генерации оповещений содержит несколько критериев, использование измерений ограничено одним значением для каждого измерения в каждом критерии.
Несколько условий можно указать с помощью нескольких --add-condition аргументов. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Parameter group: | Condition Arguments |
Автоматически разрешать оповещение.
| Свойство | Значение |
|---|---|
| Допустимые значения: | 0, 1, f, false, n, no, t, true, y, yes |
Описание правила в свободном тексте.
Включено ли правило генерации оповещений метрик.
| Свойство | Значение |
|---|---|
| Допустимые значения: | 0, 1, f, false, n, no, t, true, y, yes |
Частота вычисления правила в ##h##m##s формате.
При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.
| Свойство | Значение |
|---|---|
| Parameter group: | Generic Update Arguments |
| Допустимые значения: | 0, 1, f, false, n, no, t, true, y, yes |
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Имя правила генерации оповещений.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.
| Свойство | Значение |
|---|---|
| Parameter group: | Generic Update Arguments |
Список имен групп действий, разделенных пробелами для удаления. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Parameter group: | Action Arguments |
Разделенный пробелами список имен условий для удаления. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Parameter group: | Condition Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Разделенный пробелами список областей, к которые применяется правило. Ресурсы, указанные в этом параметре, должны иметь одинаковый тип и существовать в том же расположении. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.
| Свойство | Значение |
|---|---|
| Parameter group: | Generic Update Arguments |
Серьезность оповещения от 0 (критического) до 4 (подробно).
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
| Свойство | Значение |
|---|---|
| Parameter group: | Resource Id Arguments |
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
Время агрегирования метрик в ##h##m##s формате.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |