您现在访问的是微软AZURE全睃版技术文档网站,若需覝访问由世纪互蝔违蝥的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

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]
                                [--subscription]
                                [--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"命令创建。

--name -n

警报规则的名称。

--resource-group -g

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

--scopes

规则适用的作用域的空格分隔列表。 此参数中指定的资源必须具有相同的类型,并且存在于同一位置。

可选参数

--action -a

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

--auto-mitigate

自动解决警报。

接受的值: false, true
--description

规则自由文本说明。

--disabled

创建处于禁用状态的规则。

接受的值: false, true
--evaluation-frequency

以"##h##m##s"格式评估规则的频率。

默认值: 1m
--region --target-resource-region

目标资源区域 () 范围内。 当范围是资源组或订阅时,必须提供此功能。

--severity

警报的严重性,从 0 (严重) 到 4 (详细) 。

默认值: 2
--subscription

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

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用""清除现有标记。

--target-resource-type --type

目标资源的资源类型 () 范围内。 当范围是资源组或订阅时,必须提供此功能。

--window-size

以"##h##m##s"格式聚合指标的时间。

默认值: 5m

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。 应提供 --ids 或其他"资源 ID"参数。

--name -n

警报规则的名称。

--resource-group -g

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

--subscription

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

az monitor metrics alert list

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

az monitor metrics alert list [--query-examples]
                              [--resource-group]
                              [--subscription]

示例

列出基于指标的警报规则。 (自动生成)

az monitor metrics alert list --resource-group MyResourceGroup

可选参数

--query-examples

建议使用 JMESPath 字符串。 可以复制其中一个查询并将其粘贴到 --query 参数的双引号内,以查看结果。 可以添加一个或多个位置关键字,以便我们可以基于这些关键字提供建议。

--resource-group -g

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

--subscription

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

az monitor metrics alert show

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

az monitor metrics alert show [--ids]
                              [--name]
                              [--query-examples]
                              [--resource-group]
                              [--subscription]

示例

显示基于指标的警报规则。 (自动生成)

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

可选参数

--ids

一个或多个资源 (以空格分隔) 。 它应该是包含"资源 ID"参数所有信息的完整资源 ID。 应提供 --ids 或其他"资源 ID"参数。

--name -n

警报规则的名称。

--query-examples

建议使用 JMESPath 字符串。 可以复制其中一个查询并将其粘贴到 --query 参数的双引号内,以查看结果。 可以添加一个或多个位置关键字,以便我们可以基于这些关键字提供建议。

--resource-group -g

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

--subscription

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

az monitor metrics alert update

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

az monitor metrics alert update [--add]
                                [--add-action]
                                [--add-condition]
                                [--auto-mitigate {false, true}]
                                [--description]
                                [--enabled {false, true}]
                                [--evaluation-frequency]
                                [--force-string]
                                [--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,字符串或 JSON 字符串>。

--add-action

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

--add-condition

添加触发规则的条件。

--auto-mitigate

自动解决警报。

接受的值: false, true
--description

规则自由文本说明。

--enabled

是否启用指标警报规则。

接受的值: false, true
--evaluation-frequency

以"##h##m##s"格式评估规则的频率。

--force-string

使用"set"或"add"时,请保留字符串文本,而不是尝试转换为 JSON。

--ids

一个或多个资源 (以空格分隔) 。 它应该是包含"资源 ID"参数所有信息的完整资源 ID。 应提供 --ids 或其他"资源 ID"参数。

--name -n

警报规则的名称。

--remove

从列表中删除属性或元素。 示例:--remove property.list OR --remove propertyToRemove。

--remove-actions

要删除的操作组名称的空格分隔列表。

--remove-conditions

要删除的条件名称的空格分隔列表。

--resource-group -g

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

--scopes

规则适用的作用域的空格分隔列表。 此参数中指定的资源必须具有相同的类型,并且存在于同一位置。

--set

通过指定要设置的属性路径和值来更新 对象。 示例: --set property1.property2=.

--severity

警报的严重性,从 0 (严重) 到 4 (详细) 。

--subscription

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

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用""清除现有标记。

--window-size

以"##h##m##s"格式聚合指标的时间。