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

创建基于查询的指标警报（预览版）

本文介绍如何使用 PromQL 在 Azure Monitor 中创建基于查询的指标警报规则，包括先决条件、规则配置选项、托管标识要求、部署方法以及如何在 Azure 门户中查看和管理警报。

先决条件

阅读基于查询的指标警报概述。
系统分配的或用户分配的托管标识。若要将用户分配的托管标识与基于查询的指标警报规则一起使用，请提前创建托管标识，并在规则范围内使用 “监视读取者 ”角色（或等效权限）对其进行配置。有关创建和使用托管标识的详细信息，请参阅 Azure 托管标识。
一个向 Azure Monitor 工作区 (AMW) 发出基于 Prometheus 或 OTel 的指标的资源。当前支持的资源是 Azure Kubernetes 服务（AKS）、Azure 虚拟机、ARC 服务器或已启用 ARC 的群集。此外，还支持由工作负荷直接发出到 AMW 的自定义 OTel 指标。
- 请参阅为 Prometheus 启用 Azure Monitor 托管服务。
- 有关详细信息，请参阅“启用 Prometheus”和“Grafana ”。
若要创建以资源为中心的警报规则，Azure Monitor 工作区必须支持以资源为中心的标记和访问。

启用以资源为中心的工作区标记和访问权限

可以通过以下两种方式之一为工作区启用以资源为中心的标记和访问：

使用 PUT 请求

使用 PUT 请求。

PUT https://management.azure.com/subscriptions/{{subscription}}/resourcegroups/{{resource_name}}/providers/microsoft.monitor/accounts/{{account_name}}}?api-version=2025-05-03-preview
Authorization: Bearer {{token}}
Content-Type: application/json
{
  "location": "eastus",
  "properties": {
    "metrics": {
      "enableAccessUsingResourcePermissions": true
    }
  }
}

部署基于查询的指标警报

Azure 门户
ARM 模板
CLI

注释

一次只能在 Azure 门户中选择一个资源类型。例如，不能选择虚拟机和 Kubernetes 服务。

在 “创建警报规则 ”页中：

选择 选择范围。此时会显示“选择资源”屏幕。
从 “订阅 ”下拉列表中，选中一个或多个订阅复选框。将显示该所选订阅中的所有资源组。
从“资源类型”下拉列表中，筛选 虚拟机、 Azure Monitor 工作区、 Kubernetes 服务 或选择整个资源组或订阅。
选中要使用的资源旁边的复选框。
选择应用。
选择“ 下一步：条件 ”或“ 条件 ”选项卡。
从 “信号” 下拉列表中，选择以下任一选项：
- 查看所有信号以使用以前创建的 PromQL 查询，然后选择要使用的查询。 PromQL 字段已经填入了查询。然后，继续编辑编辑器字段中的查询。
- 自定义 PromQL 查询（用于创建新的）。 PromQL 字段显示为空，并已准备好进行查询编辑。在字段中输入 PromQL 查询。
选择“警报”选项：
1. 从 “检查每个 下拉列表”中，选择检查间隔。
2. 在 “等待 下拉列表中，选择警报的延迟时间。默认设置为无延迟。
在此处配置警报，就像配置任何其他警报一样。请参阅文档中的其他警报创建指南。

在 Azure 门户中查看基于查询的警报

查看已触发的基于查询的指标报警

可以在 Azure 门户中查看已触发和解析的基于查询的指标警报以及所有其他警报类型：

在 Azure 门户的“监视”菜单上，选择“ 警报”。
如果 监视器服务 未显示为筛选器选项，请选择 “添加筛选器 ”并将其添加。
将 监视服务筛选器 设置为 度量查询。
选择 警报名称 以查看特定已触发或已解决警报的详细信息。

还可以查看针对特定资源触发的警报。在 Azure 门户的资源菜单上，选择“警报”。然后，您可以筛选Metric Query监视服务。

在 Azure 门户中查看警报规则详细信息

可以在 Azure 门户中查看基于查询的指标警报规则以及所有其他警报规则。仅筛选基于查询的指标规则，将 信号类型 筛选器设置为 “指标 ”以查看所有指标警报规则，包括基于查询的规则。

在 Azure 门户中编辑规则

若要在 Azure 门户中编辑基于查询的指标警报规则，请执行以下作：

在 Azure 门户的主屏幕上，搜索或选择“监视”。此时会显示 Azure Monitor 主屏幕。
选择“警报”。将显示你有权访问的所有警报的列表。
选择要处理的警报。此时会显示警报属性屏幕。
选择 转到警报规则。此时会显示警报规则屏幕。
选择编辑。此时会显示警报编辑屏幕。
请像创建新警报规则时一样继续。

可以使用 ARM 模板创建和配置基于查询的指标警报规则。步骤如下：

使用 JSON 模板。根据需要添加特定于环境的参数。
使用任何部署方法（例如 Azure CLI、Azure PowerShell 或 Azure 资源管理器 Rest API）部署模板。

以下部分将讨论一些必需的参数，并提供了一个模板示例，你可以从中开始。

用户分配的管理标识

在将用户分配的托管标识添加到规则配置之前，先创建该标识并为其配置权限。将 identity->type 设置为 UserAssigned，并在 identity->userAssignedIdentities 中包含 MI 资源 ID，如以下示例所示：

{
"identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
        "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-ua-mi":{}
    }
  }
}

注释

如果托管标识未正确配置所需的权限/角色，则警报规则可能会成功创建，但警报评估会失败，因为无法访问指标。

系统分配托管标识

指标警报规则支持系统分配的托管标识的自动角色分配。

此功能简化了向托管标识授予权限的过程，并允许警报规则在创建后立即运行。

若要使自动角色分配成功，必须在规则范围中具有以下角色之一：

Owner
用户访问管理员
具有 Microsoft.Authorization/roleAssignments/write 权限的 自定义角色
目标范围的委派管理员权限。若要创建使用系统分配的托管标识的指标预警规则，你必须具有在目标范围内授予“监视读取者”角色的权限。

注释

如果尝试使用系统分配的 AI 创建规则，并且没有自动角色分配的权限，则创建规则会失败。将 identity-type> 属性设置为 SystemAssigned，如以下示例所示：

{
"identity": {
    "type": "SystemAssigned"
  }
}

使用规则创建新的系统分配的 MI。

基于查询的规则条件

若要配置基于查询的指标警报规则，应将条件属性 odata.type 设置为 Microsoft.Azure.Monitor.PromQLCriteria

若要创建基于查询的规则条件， odata.type 应设置为 Microsoft.Azure.Monitor.PromQLCriteria。在这种情况下，条件是在新的查询属性中使用 PromQL 表达式定义的。

可选属性 for 会导致警报规则在首次触发警报之前满足条件后等待特定持续时间。例如，如果 for 设置为 10 分钟，则必须在每次评估 10 分钟内满足警报规则条件，然后才能最终触发警报。

注释

指标预警规则的 query 和 for 属性分别等价于 Prometheus 预警规则的 expression 和 for 子句。

以资源为中心的和以工作区为中心的规则范围类型

基于查询的指标警报规则支持两种类型的查询范围：

资源范围（以资源为中心的规则）

可以通过以下方法查询发送到任何工作区的指标：

特定的 Azure 资源，或通过来自同一订阅的多个资源，或
一个资源组，例如 Azure Kubernetes 群集（AKS）或
虚拟机（VM）。

对于以资源为中心的规则，支持以下范围选项：

单个资源 - 在 Scopes[] 列表中包括单个 Azure 资源管理器资源 ID。示例：

"scopes": ["/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.containerservice/managedclusters/<myClusterName>"]

资源组 - 在 Scopes[] 列表中包括资源组 ID。示例：

"scopes": ["/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>”]

订阅 - 在 Scopes[] 列表中包括订阅 ID。示例：

"scopes": ["/subscriptions/<subscription-id>”]

系统查找资源指标所在的工作区。规则查询只能引用范围资源发出的指标。

Azure Monitor 工作区范围（以工作区为中心的规则）

不论是由哪个资源发送的，都可以查询传输到特定 Azure Monitor 工作区中的指标。

对于工作区范围，请在 Scopes[] 列表中包括工作区 Azure 资源管理器 ID。示例：

"scopes": ["/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.monitor/accounts/<myAMWName>"]

规则查询可以引用 Azure Monitor 工作区中存储的任何指标。

ARM 模板示例

以下模板将 Azure Kubernetes 服务 (AKS) 作为其范围，使用用户分配的托管标识，创建基于查询的以资源为中心的指标警报规则。

对其进行编辑，以包含特定范围、位置、查询、操作组和其他参数。

{ 
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", 
    "contentVersion": "1.0.0.0", 
    "parameters": {}, 
    "variables": {}, 
    "resources": [ 
        { 
            "name": "Sample query based alert rule", 
            "type": "Microsoft.Insights/metricAlerts", 
            "apiVersion": "2024-03-01-preview", 
            "location": "eastus", 
            "identity": { 
                "type": "UserAssigned", 
                "userAssignedIdentities": { 
                    "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>>/providers/ Microsoft.ManagedIdentity/userAssignedIdentities/<user-assigned-mi-name>": {} 
                } 
            }, 
            "properties": { 
                "enabled": true, 
                "description": "Sample query-based metric alert rule", 
                "severity": 3, 
                "targetResourceType": "microsoft.monitor/accounts", 
                "scopes": [ 
                    "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.containerservice/managedclusters/<myClusterName>" 
                ], 
                "evaluationFrequency": "PT1M", 
                "criteria": { 
                    "allOf": [ 
                        { 
                            "name": "KubeContainerOOMKilledCount", 
                            "query": "sum by (cluster,container,controller,namespace)(kube_pod_container_status_last_terminated_reason{reason=\"OOMKilled\"} * on(cluster,namespace,pod) group_left(controller) label_replace(kube_pod_owner, \"controller\", \"$1\", \"owner_name\", \"(.*)\")) > 0", 
                            "criterionType": "StaticThresholdCriterion", 
                        } 
                    ], 
                    "odata.type": "Microsoft.Azure.Monitor.PromQLCriteria", 
                    "failingPeriods": { 
                        "for": "PT5M" 
                    } 
                }, 
                "resolveConfiguration": { 
                    "autoResolved": true, 
                    "timeToResolve": "PT2M" 
                }, 
                "actions": [ 
                    { 
                        "actionGroupId": "<actionGroupId>" 
                    } 
                ], 
                "actionProperties": { 
                    "Email.Subject": "Prometheus alert - Container killed due to OOM in cluster: ${data.alertContext.condition.allOf[0].dimensions.cluster} in pod: ${data.alertContext.condition.allOf[0].dimensions.pod} container: ${data.alertContext.condition.allOf[0].dimensions.container}" 
                }, 
                "customProperties": { 
                    "Alert Summary": "“Prometheus alert - Container killed due to OOM in cluster: ${.alertContext.condition.allOf[0].dimensions.cluster} in pod: $(data.alertContext data.condition.allOf[0].dimensions.pod) container: ${data.alertContext.condition.allOf[0].dimensions.container}" 
                } 
            } 
        } 
    ] 
}

修改基于查询的警报

若要修改订阅中的现有规则，请编辑模板文件并重复部署过程。

可以使用 CLI 部署指标警报模板。

打开终端或命令提示符。
登录或认证到 Azure。
使用订阅名称或 ID 将订阅设置为要使用的订阅。
- 使用订阅名称更改活动订阅。 az account set --subscription "My Demos"
- 使用订阅 ID 更改活动订阅。 az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
部署模板。

az deployment group create --name ExampleDeployment --resource-group ExampleGroup --template-file <path-to-template> --parameters storageAccountType=Standard_GRS
检查更新的规则（可选）。使用模板中设置的名称。

az resource show --ids /subscriptions/<subscriptionId>/resourceGroups/<resource group name>/providers/Microsoft.Insights/metricAlerts/<rule name>

在门户中查看或修改基于查询的指标警报

若要在 Azure 门户中查看或修改基于查询的指标警报，请参阅本文档的 Azure 门户选项卡。

反馈

此页面是否有帮助？

Last updated on 2025-11-12