Azure Data Factory管道失败指标告警PowerShell配置冲突问题

问题根源 #

你遇到的矛盾错误核心是未正确配置指标维度。PipelineFailedRuns指标确实归属Microsoft.DataFactory/factories命名空间，但当你未指定PipelineName维度时，系统会误引导你使用不存在的子命名空间，导致冲突。

正确的PowerShell配置方案 #

以下是创建ADF管道失败告警的完整正确代码，重点关注命名空间、指标维度的配置：

1. 定义基础参数

$resourceGroupName = "你的资源组名称"
$dataFactoryName = "你的ADF实例名称"
$alertRuleName = "ADF-Pipeline-Failed-Alert"
$actionGroupName = "你的动作组名称"

2. 获取目标资源与动作组ID

$dataFactoryResourceId = (Get-AzDataFactoryV2 -ResourceGroupName $resourceGroupName -Name $dataFactoryName).Id
$actionGroupId = (Get-AzActionGroup -ResourceGroupName $resourceGroupName -Name $actionGroupName).Id

3. 创建V2版本指标告警规则

New-AzMetricAlertRuleV2 -ResourceGroupName $resourceGroupName `
  -Name $alertRuleName `
  -WindowSize 00:15:00 `
  -Frequency 00:15:00 `
  -TargetResourceId $dataFactoryResourceId `
  -MetricNamespace "Microsoft.DataFactory/factories" `
  -MetricName "PipelineFailedRuns" `
  -Operator GreaterThan `
  -Threshold 0 `
  -TimeAggregation Total `
  -Dimension @{Name="PipelineName"; Operator="Include"; Values=@("*")} `
  -ActionGroup $actionGroupId `
  -Severity 2

关键注意事项 #

• 命名空间：严格使用Microsoft.DataFactory/factories，与官方文档要求一致。
• 维度配置：PipelineName是必填维度，*表示监控所有管道，也可指定具体管道名称；省略该维度会触发系统的错误命名空间引导。
• 告警版本：必须使用New-AzMetricAlertRuleV2（V2版本），旧版cmdlet对维度和命名空间的处理逻辑存在缺陷，易引发冲突。

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