如何为Azure Data Factory的Bicep模板添加诊断设置？

要给ADF资源添加诊断设置，你需要在现有Bicep代码中新增一个Microsoft.Insights/diagnosticSettings资源，关联到已定义的ADF实例。以下是完整的更新代码，包含常见的日志和指标配置（你可以根据实际需求调整日志类别、保留天数和目标存储/分析服务）：

// 可根据实际场景定义参数，示例中包含必要的输入参数
param storageAccountId string
param name string
param environmentAbbreviation string
param location string

resource dataFactory 'Microsoft.DataFactory/factories@2018-06-01' = {
  name: name
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    globalParameters: {
      environment: {
        type: 'String'
        value: environmentAbbreviation
      }
    }
  }
  location: location
}

// 新增ADF诊断设置资源
resource adfDiagnosticSettings 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
  name: 'ADF-Diagnostic-Settings' // 自定义诊断设置名称
  scope: dataFactory // 关联到上方创建的ADF实例
  properties: {
    // 目标存储账户ID，若需发送到Log Analytics或事件中心，可替换为workspaceId或eventHubAuthorizationRuleId
    storageAccountId: storageAccountId
    // 按需启用需要采集的日志类别
    logs: [
      {
        category: 'ActivityRuns'
        enabled: true
        retentionPolicy: {
          days: 30 // 日志保留天数，设为0表示永久保留（需存储账户支持）
          enabled: true
        }
      }
      {
        category: 'PipelineRuns'
        enabled: true
        retentionPolicy: {
          days: 30
          enabled: true
        }
      }
      {
        category: 'TriggerRuns'
        enabled: true
        retentionPolicy: {
          days: 30
          enabled: true
        }
      }
      {
        category: 'DatasetRuns'
        enabled: true
        retentionPolicy: {
          days: 30
          enabled: true
        }
      }
    ]
    // 启用全量指标采集
    metrics: [
      {
        category: 'AllMetrics'
        enabled: true
        retentionPolicy: {
          days: 30
          enabled: true
        }
      }
    ]
  }
}

关键配置说明 #

• scope: dataFactory：明确诊断设置绑定到当前定义的ADF资源
• 目标存储/分析服务：除了存储账户，还可以配置workspaceId（Log Analytics工作区ID）或eventHubAuthorizationRuleId（事件中心授权规则ID）来接收诊断数据
• 日志类别：ADF支持的日志类别包括ActivityRuns、PipelineRuns、TriggerRuns等，可根据监控需求增减
• 保留策略：若不需要自动清理数据，可将retentionPolicy.enabled设为false

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