在 Azure 監視器中建立和編輯資料收集規則 (DCR) 和關聯

發行項
09/25/2024

在 Azure 監視器中建立資料收集規則 (DCR)的方法有很多種。在某些情況下，Azure 監視器可根據您在 Azure 入口網站中設定的設定來建立和管理 DCR。在其他情況下，您需要建立自己的 DCR 來自定義特定案例。

本文說明建立和編輯 DCR 的不同方法。如需 DCR 本身的內容，請參閱 Azure 監視器中資料收集規則的結構。

權限

您需要下列權限才能建立 DCR 與關聯：

內建角色	範圍	原因
監視參與者	訂閱和/或資源群組和/或現有的 DCR	建立或編輯 DCR，將規則指派給機器，部署關聯。
虛擬機器參與者 Azure Connected Machine 資源管理員	虛擬機器、虛擬機器擴展集已啟用 Azure Arc 的伺服器 (英文)	在 VM 上部署代理程式延伸模組 (虛擬機器)。
包含動作 Microsoft.Resources/deployments/* 的任何角色	訂閱和/或資源群組和/或現有的 DCR	部署 Azure Resource Manager 範本。

建立 DCR 的自動化方法

下表列出使用為您建立 DCR 的 Azure 入口網站來建立資料收集案例的方法。在這些情況下，您不需要直接與 DCR 本身互動。

案例	資源	描述
監視虛擬機器	啟用 VM 深入解析的概觀	當您在 VM 上啟用 VM 深入解析時，會安裝 Azure 監視器代理程式建立 DCR，並與 VM 相關聯。此 DCR 會收集一組預先定義的效能計數器，且不應該修改。
容器深入解析	啟用容器深入解析	當您在 Kubernetes 叢集上啟用容器深入解析時，會安裝 Azure 監視器代理程式的容器化版本，並根據您選取的組態來建立與叢集相關聯的 DCR 來收集資料。您可能需要修改此 DCR 以新增轉換。
工作區轉換	使用 Azure 入口網站在工作區資料收集規則中新增轉換	建立 Log Analytics 工作區中任何已支援資料表的轉換。此轉換是在連結至工作區的 DCR 內指定。然後，轉換會套用至從尚未使用 DCR 的任何舊版工作負載傳送至該資料表的任何資料。

建立 DCR

若要使用 Azure CLI、PowerShell、API 或 ARM 範本建立資料收集規則，請從其中一個範例 DCR 開始建立 JSON 檔案。使用 Azure 監視器中資料收集規則結構中的資訊，修改特定環境和需求的 JSON 檔案。

重要

在與目的地 Log Analytics 工作區或 Azure 監視器工作區相同的區域中建立資料收集規則。您可以將資料收集規則與租用戶中任何訂閱或資源群組中的機器或容器產生關聯。若要跨租用戶傳送資料，您必須先啟用 Azure Lighthouse。

使用 Azure 入口網站建立

Azure 入口網站為虛擬機器和虛擬機器擴展集建立 DCR 提供了簡易化建立體驗。使用此方法時，您不需要了解 DCR 結構，除非您想要實作進階功能，例如轉換。使用各種資料來源建立此 DCR 的程序，在使用 Azure 監視器代理程式收集資料中提供說明。

重要

在Azure 入口網站的 [監視器] 功能表上，選取 [資料收集規則]>[建立] 以開啟 [DCR 建立] 頁面。

基本頁面包含 DCR 的基本資訊。

設定	描述
規則名稱	DCR 的名稱。名稱應該是可協助您識別規則的描述性文字。
訂用帳戶	用來儲存 DCR 的訂用帳戶。訂用帳戶不需要是與虛擬機器相同的訂用帳戶。
資源群組	用來儲存 DCR 的資源群組。資源群組不需要是與虛擬機器相同的資源群組。
區域	要儲存 DCR 的區域。該區域必須與 DCR 目的地中使用的任何 Log Analytics 工作區或 Azure 監視器工作區相同。如果您有不同區域中的工作區，請建立與同一組機器關聯的多個 DCR。
平台類型	指定 DCR 可用的資料來源類型，Windows 或 Linux。 None 允許兩者。 ¹
資料收集端點	指定用來收集資料的資料收集端點 (DCE)。 DCE 只有在您使用 Azure 監視器 Private Link 時才需要。此 DCE 必須位於與 DCR 相同的區域中。如需詳細資訊，請參閱如何根據您的部署設定資料收集端點。

¹ 此選項會在 DCR 中設定 kind 屬性。有其他值可以針對這個屬性設定，但這些值無法在入口網站中使用。

新增資源

[資源] 頁面可讓您新增將與 DCR 相關聯的資源。選取 [+ 新增資源] 以選取資源。 Azure 監視器代理程式會自動安裝在尚未安裝的任何資源上。

重要

除了現有的使用者指派身分識別以外 (若有)，入口網站也會在目標資源上啟用系統指派的受控識別。針對現有應用程式，除非您在要求中指定使用者指派的身分識別，否則機器預設會改用系統指派的身分識別。

如果您要監視的機器與目的地 Log Analytics 工作區不同，而且您正在收集需要 DCE 的資料類型，請選取 [啟用資料收集端點]，然後選取每個受監視機器區域中的端點。如果受監視的機器位於與目的地 Log Analytics 工作區相同的區域，或您不需要 DCE，請勿在 [資源] 索引標籤上選取資料收集端點。

新增資料來源

收集並傳遞 頁面可讓您新增和設定 DCR 的資料來源，以及每個資料來源的目的地。

螢幕元素	描述
資料來源	選取 [資料來源類型]，並根據您選取的資料來源類型定義相關欄位。如需設定每個資料來源類型的詳細資料，請參閱資料來源中的文章。
目的地	為每個資料來源新增一或多個目的地。您可以選取相同或不同類型的多個目的地。例如，您可以選取多個 Log Analytics 工作區，亦稱為多路連接。如需其支援的不同目的地，請參閱每個資料類型的詳細資料。

DCR 可以包含多個不同的資料來源，單一 DCR 中最高可達 10 個資料來源。您可以在相同的 DCR 中合併不同的資料來源，但通常您會希望針對不同的資料收集案例建立不同的 DCR。如需如何組織 DCR 的建議，請參閱 Azure 監視器中資料收集規則建立和 Azure 監視器管理的最佳做法。

注意

使用資料收集規則精靈建立資料收集規則時，最多可能需要 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/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr" --resource "subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/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/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/my-resource-group/providers/Microsoft.Compute/virtualMachines/my-vm' -DataCollectionRuleId '/subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr' -AssociationName 'my-vm-dcr-association'

使用 API 建立

使用 DCR 建立 API，從 JSON 檔案建立 DCR。您可以使用任何方法來呼叫 REST API，如下列範例所示。

$ResourceId = "/subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/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/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/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 監視器中資料收集規則的結構和 Azure 監視器中的範例資料收集規則 (DCR) 中的資訊定義 dcr-properties，進而建立 DCR。

{
    "$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/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/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/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/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 監視器記錄]。
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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "type": "systemAssigned"
  },

將寫入權限授與受控實體

當目的地是儲存體帳戶或事件中樞時，DCR 所使用的受控識別必須具有目的地的寫入權限。若要授與規則受控實體的權限，請將適當的角色指派給實體。

下表顯示每個目的地類型所需的角色：

目的地類型	角色
Log Analytics 工作區	不需要
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

下列範例會建立資料收集規則與 Key Vault 之間的關聯。

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 物件。

使用 New-AzDataCollectionRule 命令，使用 PowerShell 來建立計量的資料收集規則。如需詳細資訊，請參閱 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 工作區	不需要
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 ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0 -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>

下列範例會建立資料收集規則與 Key Vault 之間的關聯。

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 監視器進行驗證的詳細資訊，請參閱驗證 Azure 監視器要求。

使用下列端點，使用 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 工作區	不需要
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 監視器中監視 DCR 資料收集並進行疑難排解

傳送至 Log Analytics 工作區的計量會儲存在 AzureMetricsV2 資料表中。使用 Log Analytics 總管來檢視資料表，並確認正在擷取資料。如需詳細資訊，請參閱 Azure 監視器中的 Log Analytics 概觀。

共用方式為

在 Azure 監視器中建立和編輯資料收集規則 (DCR) 和關聯

權限

建立 DCR 的自動化方法

建立 DCR

使用 Azure 入口網站建立

新增資源

新增資料來源

使用 CLI 建立

使用 PowerShell 建立

使用 API 建立

使用 ARM 範本建立

DCR

DCR 關聯 - Azure VM

DCR 關聯 - 已啟用 Arc 的伺服器

編輯 DCR

建立計量匯出的 DCR

將寫入權限授與受控實體

建立資料收集規則關聯

將寫入權限授與受控實體

建立資料收集規則關聯

使用 REST API 建立資料收集規則

建立資料收集規則

將寫入權限授與受控實體

建立資料收集規則關聯

範本檔案

參數檔案

範例 DCR 範本：

驗證資料流和疑難排解

下一步

意見反應

其他資源