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

在 Azure Monitor 中创建和编辑数据收集规则

项目
04/08/2024

有多种方法可在 Azure Monitor 中创建数据收集规则 (DCR)。在某些情况下，Azure Monitor 会根据你在 Azure 门户中配置的设置创建和管理 DCR。在其他情况下，可能需要创建自己的 DCR 来自定义特定方案。

本文介绍用于创建和编辑 DCR 的不同方法。有关 DCR 本身的内容，请参阅 Azure Monitor 中的数据收集规则的结构。

权限

需要以下权限才能创建 DCR 和关联：

内置角色	作用域	原因
监视参与者	订阅和/或资源组和/或现有 DCR	创建或编辑 DCR，将规则分配给计算机，部署关联。
虚拟机参与者 Azure Connected Machine 资源管理员	虚拟机、虚拟机规模集已启用 Azure Arc 的服务器	在 VM 上部署代理扩展。
负责关于 Microsoft.Resources/deployments/ 操作的任何角色	订阅和/或资源组和/或现有 DCR	部署 Azure 资源管理器模板。

用于创建 DCR 的自动化方法

下表列出了使用 Azure 门户创建数据收集方案的方法，其中会为你创建 DCR。在这些情况下，无需直接与 DCR 本身交互。

方案	资源	说明
Azure Monitor 代理	为 Azure Monitor 代理配置数据收集	使用 Azure 门户创建一个 DCR，它指定要从装有 Azure Monitor 代理的计算机收集的事件和性能计数器。然后将该规则与一个或多个虚拟机相关联。 Azure Monitor 代理将安装在目前未安装它的任何计算机上。
	启用 VM 见解概述	在 VM 上启用 VM 见解时，会安装 Azure Monitor 代理，并创建一个 DCR 来收集预定义的性能计数器集。不应修改此 DCR。
容器见解	启用容器见解	在 Kubernetes 群集上启用容器见解时，会安装 Azure Monitor 代理的容器化版本，并根据所选的配置创建 DCR 来收集数据。可能需要修改此 DCR 才能添加转换。
文本或 JSON 日志	使用 Azure Monitor 代理从文本或 JSON 文件收集日志	使用 Azure 门户创建 DCR，以使用 Azure Monitor 代理从计算机上的文本日志中收集条目。

手动创建 DCR

若要手动创建 DCR，请使用要配置的数据收集的相应配置创建 JSON 文件。从示例 DCR 之一，并使用 Azure Monitor 中数据收集规则结构中的信息来为特定环境和要求修改 JSON 文件。

创建 JSON 文件后，可以使用以下任一方法创建 DCR：

使用 az monitor data-collection rule create 命令通过 Azure CLI 从 JSON 文件创建 DCR，如以下示例所示。

az monitor data-collection rule create --location 'eastus' --resource-group 'my-resource-group' --name 'myDCRName' --rule-file 'C:\MyNewDCR.json' --description 'This is my new DCR'

使用 New-AzDataCollectionRule cmdlet 通过 PowerShell 从 JSON 文件创建 DCR，如以下示例所示。

New-AzDataCollectionRule -Location 'east-us' -ResourceGroupName 'my-resource-group' -RuleName 'myDCRName' -RuleFile 'C:\MyNewDCR.json' -Description 'This is my new DCR'

使用 DCR 创建 API 从 JSON 文件创建 DCR。可以使用任何方法调用 REST API，如以下示例所示。

$ResourceId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
$FilePath = ".\my-dcr.json"
$DCRContent = Get-Content $FilePath -Raw 
Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method PUT -Payload $DCRContent

ResourceId="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
FilePath="my-dcr.json"
az rest --method put --url $ResourceId"?api-version=2022-06-01" --body @$FilePath

有关在模板中定义 DCR 和关联的信息，请参阅以下参考资料。

数据收集规则
数据收集规则关联

使用以下模板，采用“Azure Monitor 中的数据收集规则的结构”和“Azure Monitor 中的示例数据收集规则 (DCR)”中的信息创建 DCR，以定义 dcr-properties。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "dataCollectionRuleName": {
            "type": "string",
            "metadata": {
                "description": "Specifies the name of the Data Collection Rule to create."
            }
        },
        "location": {
            "type": "string",
            "metadata": {
                "description": "Specifies the location in which to create the Data Collection Rule."
            }
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "name": "[parameters('dataCollectionRuleName')]",
            "location": "[parameters('location')]",
            "apiVersion": "2021-09-01-preview",
            "properties": {
                "<dcr-properties>"
            }
        }
    ]
}

DCR 关联 - Azure VM

下面的示例在 Azure 虚拟机和数据收集规则之间创建关联。

Bicep 模板文件

@description('The name of the virtual machine.')
param vmName string

@description('The name of the association.')
param associationName string

@description('The resource ID of the data collection rule.')
param dataCollectionRuleId string

resource vm 'Microsoft.Compute/virtualMachines@2021-11-01' existing = {
  name: vmName
}

resource association 'Microsoft.Insights/dataCollectionRuleAssociations@2021-09-01-preview' = {
  name: associationName
  scope: vm
  properties: {
    description: 'Association of data collection rule. Deleting this association will break the data collection for this virtual machine.'
    dataCollectionRuleId: dataCollectionRuleId
  }
}

ARM 模板文件

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of the virtual machine."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "The name of the association."
      }
    },
    "dataCollectionRuleId": {
      "type": "string",
      "metadata": {
        "description": "The resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
      "name": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

参数文件

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "value": "my-azure-vm"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

DCR 关联 - 已启用 Arc 的服务器

下面的示例在启用了 Azure Arc 的服务器和数据收集规则之间创建关联。

Bicep 模板文件

@description('The name of the virtual machine.')
param vmName string

@description('The name of the association.')
param associationName string

@description('The resource ID of the data collection rule.')
param dataCollectionRuleId string

resource vm 'Microsoft.HybridCompute/machines@2021-11-01' existing = {
  name: vmName
}

resource association 'Microsoft.Insights/dataCollectionRuleAssociations@2021-09-01-preview' = {
  name: associationName
  scope: vm
  properties: {
    description: 'Association of data collection rule. Deleting this association will break the data collection for this Arc server.'
    dataCollectionRuleId: dataCollectionRuleId
  }
}

ARM 模板文件

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of the virtual machine."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "The name of the association."
      }
    },
    "dataCollectionRuleId": {
      "type": "string",
      "metadata": {
        "description": "The resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.HybridCompute/machines/{0}', parameters('vmName'))]",
      "name": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this Arc server.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

参数文件

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "value": "my-hybrid-vm"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

编辑 DCR

若要编辑 DCR，可以使用上一部分中介绍的任何方法，以使用修改后的 JSON 版本创建 DCR。

如果需要检索现有 DCR 的 JSON，则可以从 Azure 门户中 DCR 的 JSON 视图复制它。还可以使用 API 调用来检索它，如以下 PowerShell 示例所示。

$ResourceId = "<ResourceId>" # Resource ID of the DCR to edit
$FilePath = "<FilePath>" # Store DCR content in this file
$DCR = Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method GET
$DCR.Content | ConvertFrom-Json | ConvertTo-Json -Depth 20 | Out-File -FilePath $FilePath

有关演练检索和编辑现有 DCR 的教程，请参阅教程：编辑数据收集规则 (DCR)。