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

在 Azure Monitor 中创建和编辑数据收集规则 (DCR) 和关联

项目
09/25/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 本身交互。

场景	资源	说明
监视虚拟机	启用 VM 见解概述	在 VM 上启用 VM 见解后，将会安装 Azure Monitor 代理，然后创建 DCR 并将其与 VM 关联。此 DCR 收集一组预定义的性能计数器，不应对其进行修改。
容器见解	启用容器见解	在 Kubernetes 群集上启用容器见解后，将会安装 Azure Monitor 代理的容器化版本，并根据所选的配置创建与群集关联的 DCR 来收集数据。可能需要修改此 DCR 才能添加转换。
工作区转换	使用 Azure 门户在工作区数据收集规则中添加转换	为 Log Analytics 工作区中任何受支持的表创建转换。此转换是在链接到工作区的 DCR 中指定的。然后，此转换将应用于从任何尚未利用 DCR 的旧工作负载发送到该表的任何数据。

创建 DCR

若要使用 Azure CLI、PowerShell、API 或 ARM 模板创建数据收集规则，请从其中一个示例 DCR 开始创建 JSON 文件。使用 Azure Monitor 中的数据收集规则结构中的信息针对特定环境和要求修改 JSON 文件。

重要

在目标 Log Analytics 工作区或 Azure Monitor 工作区所在的同一区域中创建数据收集规则。可以将数据收集规则关联到租户中任何订阅或资源组中的计算机或容器。若要跨租户发送数据，必须先启用 Azure Lighthouse。

使用 Azure 门户进行创建

Azure 门户在为虚拟机和虚拟机规模集创建 DCR 方面提供了简化的体验。使用此方法时，除非想要实现转换等高级功能，否则无需了解 DCR 的结构。使用 Azure Monitor 代理收集数据中介绍了使用各种数据源创建此 DCR 的过程。

重要

在 Azure 门户中的“监视器”菜单上，选择“数据收集规则”>“创建”以打开 DCR 创建页面。

“基本”页面包含有关 DCR 的基本信息。

设置	说明
规则名称	DCR 的名称。此名称应该是有助于识别规则的描述性名称。
订阅	用于存储 DCR 的订阅。此订阅不需要与虚拟机订阅相同。
资源组	用于存储 DCR 的资源组。此资源组不需要是虚拟机所在的同一个资源组。
区域	存储 DCR 的区域。此区域必须与 DCR 目标中使用的任何 Log Analytics 工作区或 Azure Monitor 工作区相同。如果在不同的区域中有工作区，则可以创建与同一组计算机关联的多个 DCR。
平台类型	指定 DCR 可用的数据源类型，即 Windows 或 Linux。如果指定“无”，则可以使用两者。 ¹
数据收集终结点	指定用于收集数据的数据收集终结点 (DCE)。仅当使用 Azure Monitor 专用链接时，才需要 DCE。此 DCE 必须与 DCR 位于同一个区域。有关详细信息，请参阅如何根据部署设置数据收集终结点。

¹ 此选项设置 DCR 中的 kind 属性。可以为此属性设置其他值，但这些值在门户中不可用。

添加资源

“资源”页面允许添加将与 DCR 关联的资源。单击“+ 添加资源”以选择资源。 Azure Monitor 代理将自动安装在任何尚未安装它的资源上。

重要

门户可以在目标资源上启用系统分配的托管标识，还包括现有的用户分配的标识（如有）。对于现有应用程序，除非在请求中指定用户分配的标识，否则计算机将默认使用系统分配的标识。

如果监视的计算机与目标 Log Analytics 工作区不在同一区域，并且要收集需要 DCE 的数据类型，请选择“启用数据收集终结点”并选择每个受监视计算机所在区域中的终结点。如果受监视的计算机与目标 Log Analytics 工作区位于同一区域，或者如果不需要 DCE，请不要在“资源”选项卡上选择数据收集终结点。

添加数据源

“收集和传递”页面允许为 DCR 添加和配置数据源以及每个数据源的目标。

屏幕元素	说明
数据源	选择“数据源类型”，然后根据所选的数据源类型定义相关字段。有关配置每种数据源的详细信息，请参阅数据源中的文章。
目标	为每个数据源添加一个或多个目标。你可以选择多个相同或不同类型的目标。例如，你可以选择多个 Log Analytics 工作区，这也称为多宿主。请参阅每个数据类型的详细信息，了解它们支持的不同目标。

DCR 可以包含多个不同的数据源，单个 DCR 最多可包含 10 个数据源。可以将不同的数据源合并到同一 DCR 中，但通常需要为不同的数据收集方案创建不同的 DCR。有关如何整理 DCR 的建议，请参阅在 Azure Monitor 中创建和管理数据收集规则的最佳做法。

注意

使用数据收集规则向导创建数据收集规则后，最多可能需要 5 分钟才能将数据发送到目标。

使用 CLI 创建

使用 az monitor data-collection rule create 命令根据 JSON 文件创建 DCR。

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

使用 az monitor data-collection rule association create 命令在 DCR 和资源之间创建关联。

az monitor data-collection rule association create --name "my-vm-dcr-association" --rule-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr" --resource "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Compute/virtualMachines/my-vm"

使用 PowerShell 创建

使用 New-AzDataCollectionRule cmdlet 根据 JSON 文件创建 DCR。

New-AzDataCollectionRule -Name 'my-dcr' -ResourceGroupName 'my-resource-group' -JsonFilePath 'C:\MyNewDCR.json'

使用 New-AzDataCollectionRuleAssociation 命令在 DCR 和资源之间创建关联。

 New-AzDataCollectionRuleAssociation -TargetResourceId '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Compute/virtualMachines/my-vm' -DataCollectionRuleId '/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr' -AssociationName 'my-vm-dcr-association'

使用 API 创建

使用 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

使用 ARM 模板创建

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

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

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)。

为指标导出创建 DCR

若要为指标导出创建数据收集规则，请使用 Azure 门户、Azure CLI、PowerShell、API 或 ARM 模板。

重要

若要将平台遥测数据发送到存储帐户或事件中心，资源、数据收集规则和目标存储帐户或事件中心必须全部位于同一区域中。

在 Azure 门户的“监视”菜单中，选择“数据收集规则”，然后选择“创建”。
若要创建 DCR 以收集平台指标数据，请选择页面顶部的链接。
在“创建数据收集规则”页上，输入规则名称，为该 DCR 选择一个订阅、资源组和区域。
如果要将指标发送到存储帐户或事件中心，请选择“启用托管标识”。
选择下一个
在“资源”页上，选择“添加资源”以添加要从中收集指标的资源。
选择“下一步”以前进到“收集和传递”选项卡。
选择“添加新数据集”。
将自动选择你在上一步中选择的资源的资源类型。如果你想在将来使用此规则从多个资源类型收集指标，请添加更多资源类型。
选择“下一步: 目标”以前进到“目标”选项卡。
若要将指标发送到 Log Analytics 工作区，请从“目标类型”下拉列表中选择“Azure Monitor 日志”。
1. 选择要将指标发送到的订阅和 Log Analytics 工作区。
若要将指标发送到事件中心，请从“目标类型”下拉列表中选择“事件中心”。
1. 选择订阅、事件中心命名空间和事件中心实例名称。
若要将指标发送到存储帐户，请从“目标类型”下拉列表中选择“存储帐户”。
1. 选择要在其中存储指标的订阅、存储帐户和 Blob 容器。
注意

若要将指标发送到存储帐户或事件中心，生成指标的资源，DCR 和存储帐户或事件中心必须全部位于同一区域中。
若要将指标发送到 Log Analytics 工作区，DCR 必须与 Log Analytics 工作区位于同一区域中。生成指标的资源可以位于任何区域中。

若要选择存储帐户或事件中心作为目标，必须在“基本信息”选项卡上为 DCR 启用托管标识。
选择“保存”，然后选择“查看 + 创建”。

创建一个包含收集规则规范的 JSON 文件。有关详细信息，请参阅 DCR 规范。有关示例 JSON 文件，请参阅示例指标导出 JSON 对象。

重要

规则文件的格式与用于 PowerShell 和 REST API 的格式相同，但该文件不得包含 identity、location 或 kind。这些参数是在 az monitor data-collection rule create 命令中指定的。

通过 Azure CLI 使用以下命令为指标创建数据收集规则。

az monitor data-collection rule create 
        --name 
        --resource-group 
        --location
        --kind PlatformTelemetry 
        --rule-file
        [--identity "{type:'SystemAssigned'}" ]

对于存储帐户和事件中心目标，必须使用 --identity "{type:'SystemAssigned'}" 为 DCR 启用托管标识。对于 Log Analytics 工作区，标识不是必需的。

例如，

 az monitor data-collection rule create
    --name cli-dcr-001 
    --resource-group rg-001 
    --location centralus 
    --kind PlatformTelemetry 
    --identity "{type:'SystemAssigned'}" 
    --rule-file cli-dcr.json

复制 DCR 的 id 和 principalId 以用于分配角色，从而在 DCR 和资源之间创建关联。

  "id": "/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/resourceGroups/rg-001/providers/Microsoft.Insights/dataCollectionRules/cli-dcr-001",
  "identity": {
    "principalId": "eeeeeeee-ffff-aaaa-5555-666666666666",
    "tenantId": "0000aaaa-11bb-cccc-dd22-eeeeee333333",
    "type": "systemAssigned"
  },

向托管标识授予写入权限

当目标为存储帐户或事件中心时，DCR 使用的托管标识必须对目标具有写入权限。若要为规则的托管实体授予权限，请将合适的角色分配给该实体。

下表显示了每种目标类型所需的角色。

目标类型	角色
Log Analytics 工作区	或 VPN
Azure 存储帐户	`Storage Blob Data Contributor`
事件中心	`Azure Event Hubs Data Sender`

有关分配角色的详细信息，请参阅将 Azure 角色分配给托管标识。若要使用 CLI 将角色分配给托管标识，请使用 az role assignment create。有关详细信息，请参阅角色分配 - 创建。

将合适的角色分配给 DCR 的托管标识。


az role assignment create --assignee <system assigned principal ID> \
                          --role <`Storage Blob Data Contributor` or `Azure Event Hubs Data Sender`  \
                          --scope <storage account ID or eventhub ID>

以下示例将 Storage Blob Data Contributor 角色分配给存储帐户的 DCR 的托管标识。


az role assignment create --assignee eeeeeeee-ffff-aaaa-5555-666666666666 \
    --role "Storage Blob Data Contributor" \
    --scope /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/ed-rg-DCRTest/providers/Microsoft.Storage/storageAccounts/metricsexport001

创建数据收集规则关联

创建数据收集规则后，创建一个数据收集规则关联 (DCRA)，以将规则与要监视的资源相关联。有关详细信息，请参阅数据收集规则关联 - 创建。

使用 az monitor data-collection rule association create 在数据收集规则与资源之间创建关联。

az monitor data-collection rule association create --name 
                                                  --rule-id 
                                                  --resource

下面的示例在数据收集规则与密钥保管库之间创建关联。

az monitor data-collection rule association create --name "keyValut-001" \
    --rule-id "/subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-dcr/providers/Microsoft.Insights/dataCollectionRules/dcr-cli-001" \
    --resource "/subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-dcr/providers/Microsoft.KeyVault/vaults/keyVault-001"

创建一个包含收集规则规范的 JSON 文件。有关详细信息，请参阅 DCR 规范。有关示例 JSON 文件，请参阅示例指标导出 JSON 对象。

通过 PowerShell 使用 New-AzDataCollectionRule 命令为指标创建数据收集规则。有关详细信息，请参阅 New-AzDataCollectionRule。

New-AzDataCollectionRule -Name 
                         -ResourceGroupName 
                         -JsonFilePath

例如，

 New-AzDataCollectionRule -Name dcr-powershell-hub -ResourceGroupName rg-001 -JsonFilePath dcr-storage-account.json

复制 DCR 的 id 和 IdentityPrincipalId 以用于分配角色，从而在 DCR 和资源之间创建关联。

Id                                        : /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-001/providers/Microsoft.Insights/dataCollectionRules/dcr-powershell-hub
IdentityPrincipalId                       : eeeeeeee-ffff-aaaa-5555-666666666666
IdentityTenantId                          : 0000aaaa-11bb-cccc-dd22-eeeeee333333
IdentityType                              : systemAssigned
IdentityUserAssignedIdentity              : {
                                            }

向托管标识授予写入权限

当目标为存储帐户或事件中心时，DCR 使用的托管标识必须对目标具有写入权限。若要为规则的托管实体授予权限，请将合适的角色分配给该实体。

下表显示了每种目标类型所需的角色。

目标类型	角色
Log Analytics 工作区	或 VPN
Azure 存储帐户	`Storage Blob Data Contributor`
事件中心	`Azure Event Hubs Data Sender`

有关详细信息，请参阅将 Azure 角色分配给托管标识。若要使用 PowerShell 将角色分配给托管标识，请参阅 New-AzRoleAssignment

使用 New-AzRoleAssignment 将合适的角色分配给 DCR 的托管标识。

New-AzRoleAssignment -ObjectId <objectId> -RoleDefinitionName <roleName> -Scope /subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/<providerName>/<resourceType>/<resourceSubType>/<resourceName>

以下示例在订阅级别将 Azure Event Hubs Data Sender 角色分配给 DCR 的托管标识。

New-AzRoleAssignment -ObjectId eeeeeeee-ffff-aaaa-5555-666666666666 -RoleDefinitionName "Azure Event Hubs Data Sender" -Scope /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f

创建数据收集规则关联

创建数据收集规则后，创建一个数据收集规则关联 (DCRA)，以将规则与要监视的资源相关联。使用 New-AzDataCollectionRuleAssociation 在数据收集规则与资源之间创建关联。有关详细信息，请参阅 New-AzDataCollectionRuleAssociation

New-AzDataCollectionRuleAssociation
   -AssociationName <String>
   -ResourceUri <String>
   -DataCollectionRuleId <String>

下面的示例在数据收集规则与密钥保管库之间创建关联。

New-AzDataCollectionRuleAssociation 
        -AssociationName keyVault-001-association
        -ResourceUri /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-dcr/providers/Microsoft.KeyVault/vaults/keyVault-001 
        -DataCollectionRuleId /subscriptions/bbbb1b1b-cc2c-DD3D-ee4e-ffffff5f5f5f/resourceGroups/rg-dcr/providers/Microsoft.Insights/dataCollectionRules/vaultsDCR001

使用 REST API 创建数据收集规则

为指标创建数据收集规则需要以下步骤：

创建数据收集规则。
向规则的托管实体授予向目标写入数据的权限
创建数据收集规则关联。

创建数据收集规则

若要使用 REST API 创建 DCR，必须使用持有者令牌发出经过身份验证的请求。有关使用 Azure Monitor 进行身份验证的详细信息，请参阅对 Azure Monitor 请求进行身份验证。

通过 REST API 使用以下终结点为指标创建数据收集规则。有关详细信息，请参阅数据收集规则 - 创建。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}?api-version=2023-03-11

例如

https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.Insights/dataCollectionRules/dcr-001?api-version=2023-03-11

有效负载是定义收集规则的 JSON 对象。有效负载是在请求的正文中发送的。有关 JSON 结构的详细信息，请参阅 DCR 规范。有关示例 DCR JSON 对象，请参阅示例指标导出 JSON 对象。

向托管标识授予写入权限

当目标为存储帐户或事件中心时，DCR 使用的托管标识必须对目标具有写入权限。若要为规则的托管实体授予权限，请将合适的角色分配给该实体。

下表显示了每种目标类型所需的角色。

目标类型	角色
Log Analytics 工作区	或 VPN
Azure 存储帐户	`Storage Blob Data Contributor`
事件中心	`Azure Event Hubs Data Sender`

有关详细信息，请参阅将 Azure 角色分配给托管标识。若要使用 REST 将角色分配给托管标识，请参阅角色分配 - 创建

创建数据收集规则关联

创建数据收集规则后，创建一个数据收集规则关联 (DCRA)，以将规则与要监视的资源相关联。有关详细信息，请参阅数据收集规则关联 - 创建。

若要使用 REST API 创建 DCRA，请使用以下终结点和有效负载：

PUT https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/dataCollectionRuleAssociations/{associationName}?api-version=2022-06-0

正文：

{ 
        "properties":  
        { 
          "description": "<DCRA description>", 
          "dataCollectionRuleId": "/subscriptions/{subscriptionId}/resourceGroups/{resource group name}/providers/Microsoft.Insights/dataCollectionRules/{DCR name}" 
        } 
}

例如，

https://management.azure.com//subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/Microsoft.Compute/virtualMachines/vm002/providers/Microsoft.Insights/dataCollectionRuleAssociations/dcr-la-ws-vm002?api-version=2023-03-11

{ 
        "properties":  
        { 
          "description": "Association of platform telemetry DCR with VM vm002", 
          "dataCollectionRuleId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.Insights/dataCollectionRules/dcr-la-ws" 
        } 
}

使用以下模板创建 DCR。有关详细信息，请参阅 Microsoft.Insights dataCollectionRules

模板文件

{
    "$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')]",
            "kind": "PlatformTelemetry",
              "identity": {
                 "type": "userassigned" | "systemAssigned", 
                 "userAssignedIdentities": { 
		        			 "type": "string"
                   }    
                 },
            "location": "[parameters('location')]",
            "apiVersion": "2023-03-11",
            "properties": {
                "dataSources": {
                    "platformTelemetry": [
                        {
                            "streams": [
                                 "<resourcetype>:<metric name> | Metrics-Group-All"
                            ],
                            "name": "myPlatformTelemetryDataSource"
                        }
                    ]
                },
                "destinations": {
                    "logAnalytics": [
                        {
                            "workspaceResourceId": "[parameters('workspaceId')]",
                            "name": "myDestination"
                        }
                    ]
                },
                "dataFlows": [
                    {
                        "streams": [
                            "<resourcetype>:<metric name> | Metrics-Group-All"
                        ],
                        "destinations": [
                            "myDestination"
                        ]
                    }
                ]
            }
        }
    ]
}

参数文件

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "dataCollectionRuleName": {
            "value": "metrics-dcr-001"
        },
        "workspaceId": {
            "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/azuremonitorworkspaceinsights/providers/microsoft.operationalinsights/workspaces/amw-insight-ws"
        },
        "location": {
            "value": "eastus"
        }    
    }
}

示例 DCR 模板：

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "apiVersion": "2023-03-11",
            "name": "[parameters('dataCollectionRuleName')]",
            "location": "[parameters('location')]",
            "kind": "PlatformTelemetry",
            "identity": {
                "type": "SystemAssigned"
            },
            "properties": {
                "dataSources": {
                    "platformTelemetry": [
                        {
                            "streams": [
                                "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                                "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                                "Microsoft.Cache/redis:Metrics-Group-All",
                                "Microsoft.keyvault/vaults:Metrics-Group-All"
                            ],
                            "name": "myPlatformTelemetryDataSource"
                        }
                    ]
                },
                "destinations": {
                    "logAnalytics": [
                        {
                            "workspaceResourceId": "[parameters('workspaceId')]",
                            "name": "myDestination"
                        }
                    ]
                },
                "dataFlows": [
                    {
                        "streams": [
                            "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                            "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                            "Microsoft.Cache/redis:Metrics-Group-All",
                            "Microsoft.keyvault/vaults:Metrics-Group-All"
                        ],
                        "destinations": [
                            "myDestination"
                        ]
                    }
                ]
            }
        }
    ]
}

创建 DCR 和 DCRA 后，第一个平台指标数据最多需要 30 分钟才会出现在 Log Analytics 工作区中。在数据开始流动后，流向 Log Analytics 工作区、存储帐户或事件中心的平台指标时序的延迟约为 3 分钟，具体取决于资源类型。

验证数据流和故障排除

将为所有 DCR 自动收集 DCR 指标，可使用指标资源管理器分析这些指标，如其他 Azure 资源的平台指标。有关详细信息，请参阅在 Azure Monitor 中监视和排查 DCR 数据收集问题

发送到 Log Analytics 工作区的指标存储在 AzureMetricsV2 表中。请使用 Log Analytics 资源管理器查看该表并确认是否正在引入数据。有关详细信息，请参阅 Azure Monitor 中的 Log Analytics 概述。

通过

在 Azure Monitor 中创建和编辑数据收集规则 (DCR) 和关联

权限

用于创建 DCR 的自动化方法

创建 DCR

使用 Azure 门户进行创建

添加资源

添加数据源

使用 CLI 创建

使用 PowerShell 创建

使用 API 创建

使用 ARM 模板创建

DCR

DCR 关联 - Azure VM

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

编辑 DCR

为指标导出创建 DCR

向托管标识授予写入权限

创建数据收集规则关联

向托管标识授予写入权限

创建数据收集规则关联

使用 REST API 创建数据收集规则

创建数据收集规则

向托管标识授予写入权限

创建数据收集规则关联

模板文件

参数文件

示例 DCR 模板：

验证数据流和故障排除

后续步骤

反馈

其他资源