你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az monitor metrics alert

  • 参考

管理准实时指标警报规则。

命令

名称 说明 类型 状态
az monitor metrics alert condition

管理准实时指标警报规则条件。

 核心 GA
az monitor metrics alert condition create

生成指标警报规则条件。

 核心 预览版
az monitor metrics alert create

创建基于指标的警报规则。

 核心 GA
az monitor metrics alert delete

删除基于指标的警报规则。

 核心 GA
az monitor metrics alert dimension

管理准实时指标警报规则维度。

 核心 GA
az monitor metrics alert dimension create

生成指标警报规则维度。

 核心 预览版
az monitor metrics alert list

列出基于指标的警报规则。

 核心 GA
az monitor metrics alert show

显示基于指标的警报规则。

 核心 GA
az monitor metrics alert update

更新基于指标的警报规则。

 核心 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]
                                [--severity]
                                [--tags]
                                [--target-resource-type]
                                [--window-size]

示例

在没有操作的 VM 上创建高 CPU 使用率警报。

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"

使用电子邮件和 Webhook 操作在 VM 上创建高 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

在未执行任何操作的多个 VM 上创建高 CPU 使用率警报。

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > 90" --description "High CPU" --region westus

在未执行任何操作的多个 VM 上创建动态 CPU 使用率警报。

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 [{=，！=，，>=>，<，<=} THRESHOLD] [{<，>，><} 动态标准版NSITIVITY 冲突评估 [自 DATETIME]] [where DIMENSION {includes，excludes} VALUE [or VALUE ...][和 DIMENSION {includes，excludes} VALUE [or VALUE ...] ][使用 skipmetricvalidation]

敏感度可以是“low”、“medium”、“high”。

冲突可以是触发警报的冲突数。 它应更小或等于计算。

评估可以是动态阈值的计算周期数。

日期时间可以是开始学习指标历史数据的日期，并计算动态阈值（ISO8601格式）。

可以通过添加“where”关键字 (keyword)和多个维度来查询维度，方法是将它们与“and”关键字 (keyword)组合在一起。

可以从命令获取 az monitor metrics list-definitions METRIC、DIMENSION 和适当的 THRESHOLD 值的值。

由于服务器限制，当警报规则包含多个条件时，每个条件中的维度的使用限制为每个维度的一个值。

可以使用多个 --condition 参数来指定多个条件。

--name -n

警报规则的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--scopes

规则适用的范围的空间分隔列表。 此参数中指定的资源的类型必须相同，并且位于同一位置。

可选参数

--action -a

添加操作组和可选的 Webhook 属性，以在触发警报时触发。

用法：--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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

警报规则的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

警报规则的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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 字符串>。

--add-action --add-actions

添加操作组和可选的 Webhook 属性，以在触发警报时触发。

用法：--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 [{=，！=，，>=>，<，<=} THRESHOLD] [{<，>，><} 动态标准版NSITIVITY 冲突评估 [自 DATETIME]] [where DIMENSION {includes，excludes} VALUE [or VALUE ...][和 DIMENSION {includes，excludes} VALUE [or VALUE ...] ]

敏感度可以是“low”、“medium”、“high”。

冲突可以是触发警报的冲突数。 它应更小或等于计算。

评估可以是动态阈值的计算周期数。

日期时间可以是开始学习指标历史数据的日期，并计算动态阈值（ISO8601格式）。

可以通过添加“where”关键字 (keyword)和多个维度来查询维度，方法是将它们与“and”关键字 (keyword)组合在一起。

可以从命令获取 az monitor metrics list-definitions METRIC、DIMENSION 和适当的 THRESHOLD 值的值。

由于服务器限制，当警报规则包含多个条件时，每个条件中的维度的使用限制为每个维度的一个值。

可以使用多个 --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

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。