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

az monitor metrics alert

  • Ссылка

Управление правилами оповещений метрик почти в реальном времени.

Команды

Имя Описание Тип Состояние
az monitor metrics alert condition

Управление условиями правила генерации оповещений о метриках почти в реальном времени.

 Основные сведения Общедоступная версия
az monitor metrics alert condition create

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

 Основные сведения "Предварительная версия"
az monitor metrics alert create

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

 Основные сведения Общедоступная версия
az monitor metrics alert delete

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

 Основные сведения Общедоступная версия
az monitor metrics alert dimension

Управление измерениями правил генерации оповещений о метриках почти в реальном времени.

 Основные сведения Общедоступная версия
az monitor metrics alert dimension create

Создание измерения правила генерации оповещений метрик.

 Основные сведения "Предварительная версия"
az monitor metrics alert list

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

 Основные сведения Общедоступная версия
az monitor metrics alert show

Отображение правила генерации оповещений на основе метрик.

 Основные сведения Общедоступная версия
az monitor metrics alert update

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

 Основные сведения Общедоступная версия

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]
                                [--severity]
                                [--tags]
                                [--target-resource-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 [{=,!>=,>=,<<=}ПОРОГ] [{<,>,><}динамические НАРУШЕНИЯ КОНФИДЕНЦИАЛЬНОСТИ ОЦЕНКИ [с ДАТЫ И ВРЕМЕНИ]] [где ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] [и ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] ...]] [с skipmetricvalidation]

Чувствительность может быть "низкой", "средней", "высокой".

Нарушения могут быть числом нарушений для активации оповещения. Он должен быть меньше или равен оценке.

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

Datetime может быть датой, с которой начать обучение исторических данных метрик и вычислять динамические пороговые значения (в формате ISO8601).

Измерения можно запрашивать, добавив ключевое слово where и несколько измерений, объединив их с ключевое слово .

Значения METRIC, DIMENSION и соответствующие значения THRESHOLD можно получить из az monitor metrics list-definitions команды.

Из-за ограничения сервера, если правило генерации оповещений содержит несколько критериев, использование измерений ограничено одним значением для каждого измерения в каждом критерии.

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

--name -n

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

--resource-group -g

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

--scopes

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

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

--action -a

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

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

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

--auto-mitigate

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

допустимые значения: false, true
--description

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

--disabled

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

допустимые значения: false, true
значение по умолчанию: False
--evaluation-frequency

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

значение по умолчанию: 1m
--region --target-resource-region

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

--severity

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

значение по умолчанию: 2
--tags

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

--target-resource-type --type

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

--window-size

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

значение по умолчанию: 5m
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

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

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

--ids

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

--name -n

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

--resource-group -g

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

--subscription

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

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.

--name -n

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

--resource-group -g

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

--subscription

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az monitor metrics alert update

Изменить

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

az monitor metrics alert update [--add]
                                [--add-action]
                                [--add-condition]
                                [--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

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

--add

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

--add-action --add-actions

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

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

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

--add-condition --add-conditions

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

Использование: --add-condition {avg,min,max,total,count} [NAMESPACE.] METRIC [{=,!>=,>=,<<=}ПОРОГ] [{<,>,><}динамические НАРУШЕНИЯ КОНФИДЕНЦИАЛЬНОСТИ ОЦЕНКИ [с ДАТЫ И ВРЕМЕНИ]] [где ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] [и ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] ...]]

Чувствительность может быть "низкой", "средней", "высокой".

Нарушения могут быть числом нарушений для активации оповещения. Он должен быть меньше или равен оценке.

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

Datetime может быть датой, с которой начать обучение исторических данных метрик и вычислять динамические пороговые значения (в формате ISO8601).

Измерения можно запрашивать, добавив ключевое слово where и несколько измерений, объединив их с ключевое слово .

Значения METRIC, DIMENSION и соответствующие значения THRESHOLD можно получить из az monitor metrics list-definitions команды.

Из-за ограничения сервера, если правило генерации оповещений содержит несколько критериев, использование измерений ограничено одним значением для каждого измерения в каждом критерии.

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

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--ids

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

--name -n

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

--remove

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

--remove-actions

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

--remove-conditions

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

--resource-group -g

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

--scopes

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

--set

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

--severity

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

--subscription

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

--tags

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

--window-size

Время, в течение которого следует агрегировать метрики в ##h##m##s формате.

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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