Azure告警规则dev部署正常 tst环境条件变量缺失问题问询

当前正在测试告警规则（Alerts Rules）、告警条件（Conditions）和操作组（Action Groups）的部署流程，首批共部署3条告警规则。

• 告警规则及条件在dev环境可按预期正常部署，但部署到tst环境时，所有3条告警规则的部分条件变量均出现空值/null的异常。
• 流水线脚本未返回任何报错，代码中大部分逻辑块均已添加try/catch异常捕获。

配置示例对比 #

dev环境告警规则与条件配置 #

tst环境告警规则与条件配置 #

核心部署代码 #

Try {
    $dim1 = New-AzMetricAlertRuleV2DimensionSelection -DimensionName $dimentionName -ValuesToInclude $dimentionValue

    $condition = New-AzMetricAlertRuleV2Criteria `
        -MetricName $metricName `
        -MetricNameSpace $metricNameSpace `
        -TimeAggregation $timeAggregation `
        -Operator $operator `
        -Threshold $threshold `
        -DimensionSelection $dim1
}
catch {
    Write-Output "${alertName}: set condition Error"
}

Try {
    Add-AzMetricAlertRuleV2 `
    -Name $alertName  `
    -resourceGroupName $mgnResourceGroup `
    -WindowSize $aggregationGranularity `
    -Frequency $frequencyofEvaluation `
    -TargetresourceId $targetResourceId `
    -Condition $condition `
    -AutoMitigate $autoMitigate `
    -ActionGroupId $actionGroupId `
    -Description $alertDescription  `
    -Severity $severity `
}
catch
{
    Write-Output "${alertName}: add alert Error"
}    

两侧环境基础ARM模板对比结果如下：

dev环境ARM模板 #

tst环境ARM模板 #

按优先级从高到低排查：

1. 先修复脚本的错误捕获逻辑，定位参数传值问题
   • 你当前脚本的catch块只打印固定错误文案，没有输出实际错误信息，且PowerShell默认$ErrorActionPreference = Continue配置下，Az模块大部分参数校验错误属于非终止错误，根本不会进入catch块，这是脚本无报错但配置异常的核心原因。先在脚本最开头加上$ErrorActionPreference = 'Stop'，将非终止错误转为终止错误，同时把两个catch块的输出改为Write-Output "${alertName}: 执行错误, 错误信息: $_"，才能拿到真实报错。
   • 在创建维度对象、创建条件对象、创建告警规则三个节点前，分别打印所有传入参数的值，同时将生成的$dim1、$condition对象用ConvertTo-Json -Depth 10序列化后打印，和dev环境同位置打印的结果逐字段对比，优先确认tst环境执行时，是不是参数在传入命令前就已经是空值：
     • 重点检查流水线变量组配置：90%的跨环境配置差异问题都是tst环境变量组漏填参数、变量名拼写错误导致。注意你代码里维度名变量写的是$dimentionName（正确拼写为dimension），如果tst环境流水线变量用了正确拼写命名，就会导致变量传空。
     • 检查$dimentionValue的类型：该参数要求传入字符串数组，如果tst环境传入的是单个字符串、空字符串或者$null，旧版本Az.Monitor模块不会抛错，只会生成空的维度配置。
2. 排查执行环境的Az模块版本差异
   • 在流水线执行步骤里加Get-Module Az.Monitor | Select-Object Version,Name打印版本，确认dev和tst环境构建代理安装的Az.Monitor模块版本一致。New-AzMetricAlertRuleV2Criteria在2.x及更早版本的Az.Monitor模块中存在参数校验bug，遇到空参数、格式不符合要求的参数时不会直接报错，会生成带空字段的条件对象传给后续创建命令，最终导致落库配置缺项。
3. 排查tst环境的权限与资源提供程序状态
   • 确认流水线执行用的服务主体，在tst环境订阅下有目标资源的Microsoft.Insights/metricAlerts/write权限，同时目标资源对应的资源提供程序（如虚拟机对应Microsoft.Compute、存储账户对应Microsoft.Storage）已经在tst订阅下完成注册。权限不足、RP未注册的场景下，部分Azure资源管理接口会返回请求成功但部分字段落库失败的静默异常。
   • 对比两边环境目标资源的位置、资源类型、资源ID格式完全一致，部分指标命名空间、维度值存在区域支持差异，传入tst环境不支持的指标配置时，也会出现字段被自动置空的情况。

内容的提问来源于stack exchange，提问作者Aaron C