メトリックエクスポート用のデータ収集ルール (DCR) を作成する

2025-05-01

この記事では、Azure portal、Azure CLI、PowerShell、API、または ARM テンプレートを使用して、メトリックのエクスポート用のデータ収集規則 (DCR) を作成する方法について説明します。

重要

プラットフォームのテレメトリデータをストレージアカウントまたは Event Hubs に送信するには、リソース、データ収集ルール、送信先のストレージアカウントまたは Event Hubs がすべて、同じリージョンに存在する必要があります。

Azure portal の [監視] メニューで、[ データ収集ルール ] を選択し、[ 作成] を選択します。
プラットフォームのメトリックデータを収集する DCR を作成するには、ページの上部にあるリンクを選びます。
[ データ収集ルールの作成 ] ページで、規則名を入力し、DCR のサブスクリプション、 リソースグループ、および リージョン を選択します。
ストレージアカウントまたは Event Hubs にメトリックを送信する場合は、[ マネージド ID を有効にする] を選択 します。
[ 次へ] を選択します。
[ リソース ] ページで、[ リソースの追加 ] を選択して、メトリックを収集するリソースを追加します。
[ 次へ ] を選択して、[ 収集して配信 ] タブに移動します。
[ 新しいデータフローの追加] を選択します。
前のステップで選んだリソースのリソースの種類が自動的に選択されます。将来的に、このルールを使って複数のリソースの種類からメトリックを収集する場合は、リソースの種類をさらに追加します。
[ 次の変換先] を選択して、[ 変換先 ] タブに移動します。
Log Analytics ワークスペースにメトリックを送信するには、[宛先の種類] ドロップダウンから Azure Monitor ログを選択します。
1. メトリックを送信する サブスクリプション と Log Analytics ワークスペースを選択します。
メトリックを Event Hubs に送信するには、[宛先の種類] ドロップダウンから [イベントハブ] を選択します。
1. サブスクリプション、イベントハブ名前空間、およびイベントハブインスタンス名を選択します。
ストレージアカウントにメトリックを送信するには、[宛先の種類] ドロップダウンから [ストレージアカウント] を選択します。
1. メトリックを格納する サブスクリプション、 ストレージアカウント、 BLOB コンテナー を選択します。
注

メトリックをストレージアカウントまたは Event Hubs に送信するには、メトリック、DCR、ストレージアカウントまたはイベントハブを生成するリソースがすべて同じリージョンにある必要があります。

メトリックを Log Analytics ワークスペースに送信するには、DCR が Log Analytics ワークスペースと同じリージョンに存在する必要があります。メトリックを生成するリソースは、どのリージョンでもかまいません。

宛先としてストレージアカウントまたは Event Hubs を選ぶには、[基本] タブで DCR に対してマネージド ID を有効にする必要があります。
[ 保存] を選択し、[ 確認と作成] を選択します。

収集ルールの指定を含む 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'}" ]

ストレージアカウントと Event Hubs が宛先の場合は、--identity "{type:'SystemAssigned'}" を使って DCR のマネージド ID を有効にする必要があります。 Log Analytics ワークスペースには ID は必要ありません。

例：

 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 とリソースの間の関連付けを作成するためのロールの割り当てで使うので、DCR の id と principalId をコピーしておきます。

  "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"
  },

マネージドエンティティに書き込みアクセス許可を付与する

宛先がストレージアカウントまたは Event Hubs である場合、DCR によって使われるマネージド ID には、宛先への書き込みアクセス許可が必要です。ルールのマネージドエンティティにアクセス許可を付与するには、エンティティに適切なロールを割り当てます。

次の表に、各宛先の種類に必要なロールを示します。

変換先の種類	役割
Log Analytics ワークスペース	必須ではありません
Azure Storage アカウント	`Storage Blob Data Contributor`
Event Hubs	`Azure Event Hubs Data Sender`

ロールの割り当ての詳細については、「マネージド ID への Azure ロールの割り当て」を参照してください。 CLI を使ってマネージド ID にロールを割り当てるには、az role assignment create を使います。詳細については、「ロールの割り当て - 作成」を参照してください。

DCR のマネージド ID に適切なロールを割り当てます。

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>

次の例では、ストレージアカウントの DCR のマネージド ID に Storage Blob Data Contributor ロールを割り当てています。

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"

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 とリソースの間の関連付けを作成するためのロールの割り当てで使うので、DCR の id と IdentityPrincipalId をコピーしておきます。

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              : {
                                            }

マネージドエンティティに書き込みアクセス許可を付与する

次の表に、各宛先の種類に必要なロールを示します。

変換先の種類	役割
Log Analytics ワークスペース	必須ではありません
Azure Storage アカウント	`Storage Blob Data Contributor`
Event Hubs	`Azure Event Hubs Data Sender`

詳細については、「マネージド ID に Azure ロールを割り当てる」を参照してください。 PowerShell を使用してマネージド ID にロールを割り当てるには、「 New-AzRoleAssignment」を参照してください。

New-AzRoleAssignment を使って、DCR のマネージド ID に適切なロールを割り当てます。

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

次の例では、サブスクリプションレベルで DCR のマネージド ID に Azure Event Hubs Data Sender ロールを割り当てています。

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 オブジェクト」を参照してください。

マネージドエンティティに書き込みアクセス許可を付与する

次の表に、各宛先の種類に必要なロールを示します。

変換先の種類	役割
Log Analytics ワークスペース	必須ではありません
Azure Storage アカウント	`Storage Blob Data Contributor`
Event Hubs	`Azure Event Hubs Data Sender`

詳細については、「マネージド ID に Azure ロールを割り当てる」を参照してください。

REST を使用してマネージド ID にロールを割り当てるには、「ロールの割り当て - 作成」を参照してください。

データ収集ルールの関連付けを作成する

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 を作成した後、最初のプラットフォームメトリックデータが Log Analytics ワークスペースに表示されるまで、最大 30 分かかります。データのフローが始まると、Log Analytics ワークスペース、ストレージアカウント、または Event Hubs に流れるプラットフォームメトリックの時系列の待ち時間は、リソースの種類によりますが、約 3 分です。

データの収集の確認とトラブルシューティング

DCR をインストールした後、変更が有効になり、更新された DCR でデータが収集されるまで、数分かかる場合があります。データが収集されない場合、問題の根本原因の特定が難しいことがあります。トラブルシューティングに役立つメトリックとログを含む DCR 監視機能を使用します。

DCR メトリックはすべての DCR に対して自動的に収集され、他の Azure リソースのプラットフォームメトリックなどのメトリックエクスプローラーを使用して分析できます。データ処理が成功しなかった場合に詳細なエラー情報を取得するには、 DCR エラーログを有効にします。

収集されているデータが表示されない場合は、次の基本的な手順に従って問題のトラブルシューティングを行います。

Logs Ingestion Bytes per Min や Logs Rows Received per Min などのメトリックを確認し、データが Azure Monitor に到達していることを確認します。そうでない場合は、データソースを確認して、想定どおりにデータが送信されていることを確認します。
Logs Rows Dropped per Min を参照し、行が削除されているかどうかを確認します。変換によって行が削除される可能性があるため、これにエラーが示されない可能性があります。ただし、削除された行が Logs Rows Dropped per Min と同じ場合、ワークスペースにデータは取り込まれません。 Logs Transformation Errors per Min を調べて、変換エラーがあるかどうかを確認します。
Logs Transformation Errors per Min を確認し、受信データに適用された変換のエラーがあるかどうかを判断します。これは、データ構造または変換自体の変更が原因である可能性があります。
DCRLogErrors テーブルで、ログに記録されている可能性があるインジェストエラーを調べます。これにより、問題の根本原因を特定するための詳細が提供されます。

次の方法で共有

メトリック エクスポート用のデータ収集ルール (DCR) を作成する

データの収集の確認とトラブルシューティング

次のステップ

フィードバック

その他のリソース

メトリックエクスポート用のデータ収集ルール (DCR) を作成する