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

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
                                [--acquire-policy-token]
                                [--action]
                                [--auto-mitigate {false, true}]
                                [--change-reference]
                                [--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

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

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

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--action -a

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

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

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

--auto-mitigate

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

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

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--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 [--acquire-policy-token]
                                [--change-reference]
                                [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Примеры

Удалите правило генерации оповещений на основе метрик.

az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup

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

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

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

Свойство Значение
Группа параметров: 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

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

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

--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

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

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

--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

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

Свойство Значение
Группа параметров: 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 [--acquire-policy-token]
                                [--add]
                                [--add-action --add-actions]
                                [--add-condition --add-conditions]
                                [--auto-mitigate {0, 1, f, false, n, no, t, true, y, yes}]
                                [--change-reference]
                                [--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

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

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--add

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

Свойство Значение
Группа параметров: Generic Update Arguments
--add-action --add-actions

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

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

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

Свойство Значение
Группа параметров: 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. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Condition Arguments
--auto-mitigate

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

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

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--description

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

--enabled

Включено ли правило генерации оповещений метрик.

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

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

--force-string

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

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

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

Свойство Значение
Группа параметров: Resource Id Arguments
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--remove

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

Свойство Значение
Группа параметров: Generic Update Arguments
--remove-actions

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

Свойство Значение
Группа параметров: Action Arguments
--remove-conditions

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

Свойство Значение
Группа параметров: Condition Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--scopes

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

--set

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

Свойство Значение
Группа параметров: Generic Update Arguments
--severity

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

--subscription

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

Свойство Значение
Группа параметров: 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