您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az monitor alert

管理经典基于指标的警报规则。

命令

az monitor alert create

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

az monitor alert delete

删除警报规则。

az monitor alert list

列出资源组中警报规则。

az monitor alert list-incidents

列出警报规则的所有事件。

az monitor alert show

显示警报规则。

az monitor alert show-incident

获取警报规则事件的详细信息。

az monitor alert update

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

az monitor alert create

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

az monitor alert create --condition
                        --name
                        --target
                        [--action]
                        [--description]
                        [--disabled {false, true}]
                        [--email-service-owners {false, true}]
                        [--location]
                        [--resource-group]
                        [--subscription]
                        [--tags]
                        [--target-namespace]
                        [--target-parent]
                        [--target-type]

示例

在 VM 上创建 CPU 使用率较高的警报,不执行任何操作。

az monitor alert create -n rule1 -g {ResourceGroup} --target {VirtualMachineID} --condition "Percentage CPU > 90 avg 5m"

使用电子邮件和 Webhook 操作在 VM 上创建 CPU 使用率较高的警报。

az monitor alert create -n rule1 -g {ResourceGroup} --target {VirtualMachineID} \
    --condition "Percentage CPU > 90 avg 5m" \
    --action email bob@contoso.comann@contoso.com --email-service-owners \
    --action webhook https://www.contoso.com/alerts?type=HighCPU \
    --action webhook https://alerts.contoso.com apiKey={APIKey} type=HighCPU

必需参数

--condition

触发规则的条件。

--name -n

警报规则的名称。

--target

目标资源的名称或 ID。

可选参数

--action -a

添加触发警报时要触发的操作。

--description

规则自由文本说明。 默认为条件表达式。

--disabled

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

接受的值: false, true
--email-service-owners

如果触发了警报,请发送电子邮件给服务所有者。

接受的值: false, true
--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--resource-group -g

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

--subscription

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

--tags

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

--target-namespace

目标资源提供程序命名空间。

--target-parent

目标资源父路径(如果适用)。

--target-type

目标资源类型。 还可以接受命名空间/类型格式 (例如:"Microsoft.Compute/virtualMachines") 。

az monitor alert delete

删除警报规则。

az monitor alert delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

示例

删除警报规则。 (自动生成)

az monitor 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 alert list

列出资源组中警报规则。

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

示例

列出资源组中警报规则。 (自动生成)

az monitor alert list --resource-group MyResourceGroup

必需参数

--resource-group -g

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

可选参数

--query-examples

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

--subscription

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

az monitor alert list-incidents

列出警报规则的所有事件。

az monitor alert list-incidents --resource-group
                                --rule-name
                                [--subscription]

示例

列出警报规则的所有事件。 (自动生成)

az monitor alert list-incidents --resource-group MyResourceGroup --rule-name MyRule

必需参数

--resource-group -g

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

--rule-name

警报规则的名称。

可选参数

--subscription

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

az monitor alert show

显示警报规则。

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

示例

显示警报规则。 (自动生成)

az monitor 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 alert show-incident

获取警报规则事件的详细信息。

az monitor alert show-incident [--ids]
                               [--name]
                               [--resource-group]
                               [--rule-name]
                               [--subscription]

可选参数

--ids

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

--name -n

要检索的事件的名称。

--resource-group -g

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

--rule-name

警报规则的名称。

--subscription

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

az monitor alert update

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

az monitor alert update [--add]
                        [--add-action]
                        [--aggregation {avg, last, max, min, total}]
                        [--condition]
                        [--description]
                        [--email-service-owners {false, true}]
                        [--enabled]
                        [--force-string]
                        [--ids]
                        [--metric]
                        [--name]
                        [--operator {<, <=, >, >=}]
                        [--period]
                        [--remove]
                        [--remove-action]
                        [--resource]
                        [--resource-group]
                        [--resource-namespace]
                        [--resource-parent]
                        [--resource-type]
                        [--set]
                        [--subscription]
                        [--tags]
                        [--threshold]

示例

更新经典基于指标的警报规则。 (自动生成)

az monitor alert update --email-service-owners true --name MyAlertRule --resource-group MyResourceGroup

更新经典基于指标的警报规则。 (自动生成)

az monitor alert update --name MyAlertRule --remove-action email bob@contoso.com --resource-group MyResourceGroup

更新经典基于指标的警报规则。 (自动生成)

az monitor alert update --name MyAlertRule --resource-group MyResourceGroup --set retentionPolicy.days=365

可选参数

--add

通过指定路径和键值对,将 对象添加到 对象列表。 示例:--add property.listProperty <key=value,字符串或 JSON 字符串>。

--add-action -a

添加触发警报时要触发的操作。

--aggregation

要基于 --period 应用聚合的类型。

接受的值: avg, last, max, min, total
--condition

触发规则的条件。

--description

规则的说明。

--email-service-owners

如果触发了警报,请发送电子邮件给服务所有者。

接受的值: false, true
--enabled
--force-string

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

--ids

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

--metric

要作为规则基础的指标的名称。

值来自: az monitor metrics list-definitions
--name -n

警报规则的名称。

--operator

如何将指标与阈值进行比较。

接受的值: <, <=, >, >=
--period

应用 --aggregation 的时间跨度,采用 nDnHnMnS 速记或完整 ISO8601 格式。

--remove

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

--remove-action -r

删除一个或多个操作。

--resource

目标资源的名称或 ID。

--resource-group -g

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

--resource-namespace

目标资源提供程序命名空间。

--resource-parent

目标资源父路径(如果适用)。

--resource-type

目标资源类型。 还可以接受命名空间/类型格式 (例如:"Microsoft.Compute/virtualMachines") 。

--set

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

--subscription

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

--tags

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

--threshold

触发警报的数值阈值。