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


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

Обязательные параметры

--condition

Условие, которое активирует правило. Его можно создать с помощью команды 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 аргументов.

--name -n

Имя правила генерации оповещений.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--scopes

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

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--action -a

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

Использование: --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Несколько групп действий можно указать с помощью нескольких --action аргументов.

--auto-mitigate

Автоматически разрешать оповещение.

Свойство Значение
Допустимые значения: false, true
--description

Описание правила в свободном тексте.

--disabled

Создайте правило в отключенном состоянии.

Свойство Значение
Default value: False
Допустимые значения: false, true
--evaluation-frequency

Частота вычисления правила в формате "##h##m##s".

Свойство Значение
Default value: 1m
--region --target-resource-region

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

--severity

Серьезность оповещения от 0 (критического) до 4 (подробно).

Свойство Значение
Default value: 2
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--target-resource-type --type

Тип ресурса целевого ресурса в областях. Это необходимо указать, если области являются группами ресурсов или подпиской.

--window-size

Время агрегирования метрик в формате ##h##m##s.

Свойство Значение
Default value: 5m
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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.

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Parameter group: Resource Id Arguments
--name -n

Имя правила генерации оповещений.

Свойство Значение
Parameter group: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Parameter group: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Parameter group: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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.

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Parameter group: Resource Id Arguments
--name -n

Имя правила генерации оповещений.

Свойство Значение
Parameter group: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Parameter group: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Parameter group: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Свойство Значение
Parameter group: Generic Update Arguments
--add-action --add-actions

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

Использование: --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Несколько групп действий можно указать с помощью нескольких --add-action аргументов. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Parameter group: Action Arguments
--add-condition --add-conditions

Добавьте условие, которое активирует правило.

Использование: --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
--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

Частота вычисления правила в ##h##m##s формате.

--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Свойство Значение
Parameter group: Generic Update Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Parameter group: Resource Id Arguments
--name -n

Имя правила генерации оповещений.

Свойство Значение
Parameter group: Resource Id Arguments
--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Свойство Значение
Parameter group: Generic Update Arguments
--remove-actions

Список имен групп действий, разделенных пробелами для удаления. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Parameter group: Action Arguments
--remove-conditions

Разделенный пробелами список имен условий для удаления. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Parameter group: Condition Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Parameter group: Resource Id Arguments
--scopes

Разделенный пробелами список областей, к которые применяется правило. Ресурсы, указанные в этом параметре, должны иметь одинаковый тип и существовать в том же расположении. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Свойство Значение
Parameter group: Generic Update Arguments
--severity

Серьезность оповещения от 0 (критического) до 4 (подробно).

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Parameter group: Resource Id Arguments
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--window-size

Время агрегирования метрик в ##h##m##s формате.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False