仮想マシン クライアント データを Event Hubs と Storage に送信する (プレビュー)

Azure Monitor を使用して仮想マシン クライアントからデータ を収集する方法については、Azure Monitor を使用して仮想マシン (VM) からデータを収集する方法について説明します。 この記事では、Azure Storage と Event Hubs に説明されているデータを送信する方法について説明します。 現在、この機能はパブリック プレビュー段階にあります。

Important

機能の廃止

2026 年 2 月以降、この機能を使用して 新しい データ収集ルールを作成することはできなくなります。 このプレビュー機能は、2026 年 7 月 31 日に廃止されます。 この日付以降、この機能を使用する既存の構成はデータの送信を停止し、Microsoftは同じものをサポートしなくなります。

継続的なサポートを確保するには、AMA またはその他の Azure ソリューションを引き続き使用するために、以下の代替手段に更新する必要があります。このソリューションは、それぞれの宛先にデータを送信するために、より信頼性が高く、スケーラブルでパフォーマンスの高いソリューションを提供します。

影響を受けたリソースを特定する

Azure Resource Graph で次のクエリを実行して、次の手順を実行します。

この機能を使用してデータ収集ルールを一覧表示する

resources
| where type == "microsoft.insights/datacollectionrules"
| where kind == "AgentDirectToStore"

この機能を使用して、データ収集ルールに関連付けられている VM を一覧表示する

resources
| where type == "microsoft.insights/datacollectionrules"
| where kind == "AgentDirectToStore"
| project dcrId = id, dcrName = name, dcrLocation = location
| join kind=inner (
   insightsresources
   | where type == "microsoft.insights/datacollectionruleassociations"
   | extend dcrId = tostring(properties.dataCollectionRuleId)
   | extend parentResourceId = tolower(tostring(split(id, "/providers/microsoft.insights/datacollectionruleassociations")[0]))
   | project dcraId = id, dcraName = name, dcrId, parentResourceId,
             description = tostring(properties.description)
) on dcrId
| project dcraId, dcraName, dcrId, dcrName, dcrLocation, parentResourceId, description

代替オプションの更新

行き先 Alternatives
Azure Storage BLOB AMA を使用して長期的なストレージとコストを削減するためにデータをストレージに送信する場合は、コスト効率の高いログ記録とLog Analyticsの利点を追加するための低コストの補助プランを使用して、既存の AMA 構成を更新してカスタム テーブルにデータを送信します。
Azure Event Hubs AMA を使用して Event Hubs にデータを送信する場合は、既存の AMA 構成を更新してデータを Azure Monitor ログに送信し、データ エクスポート機能を利用して Event Hubs に送信します。 AMA から Event Hubs への直接アップロードに代わるものはありません。

サポートされているデータ型

この機能では、次の表のデータ型がサポートされています。 各ソースには、そのソースの詳細を説明する記事へのリンクがあります。

データ ソース オペレーティング システム サポートされている宛先
Windows イベント ログ ウィンドウズ Event Hubs
Storage
Syslog Linux Event Hubs
Storage
パフォーマンス カウンター ウィンドウズ
Linux
Event Hubs
Storage
IIS ログ ウィンドウズ
Linux
ストレージ BLOB
テキスト ログ ウィンドウズ
Linux
Event Hubs (Linux のみ)
Storage BLOB

次のログはサポートされていません。

  • ETW ログ。
  • Windows クラッシュ ダンプ。 Azure Monitor エージェントは、テレメトリ ログ用であり、大きなファイルの種類ではありません。
  • アプリケーション ログ。 これらは、DCR を使用しない Application Insights によって収集されます。
  • .NET イベント ソース ログ

注

この機能は、Azure VM でのみサポートされています。 Arc 対応 VM はサポートされていません。

権限

エージェント VM には、システム割り当てマネージド ID が有効になっているか、ユーザー割り当てマネージド ID が関連付けられている必要があります。 スケーラビリティとパフォーマンスを向上させるために、ユーザー割り当てマネージド ID をお勧めします。 Azure Monitor エージェントの要件の説明に従って、認証にマネージド ID を使用するようにエージェントを構成する必要があります。

使用しているデータの宛先に応じて、次の RBAC ロールをマネージド ID に割り当てる必要があります。

行き先 RBAC の役割
ストレージ テーブル Storage Table Data Contributor
ストレージ・ブロブ Storage Blob Data Contributor
イベント ハブ Azure Event Hubs Data Sender

データ収集ルールを作成する

ヒント

Azure portal を使用して Event Hubs またはストレージにデータを送信するデータ収集規則 (DCR) を作成するプレビュー機能が追加されました。 データ収集ルールの作成を参照してください。

現在、Event Hubs またはストレージにデータを送信するデータ収集規則 (DCR) を作成するための UI エクスペリエンスはありません。 次のプロセスでは、Azure portal で ARM テンプレートを使用して DCR を作成する手順について説明します。 または、このサンプル DCR を使用して、他の メソッドを使用して新しい DCR を作成することもできます。

警告

Azure Monitor で仮想マシン クライアントからデータを収集して Event Hubs またはストレージを追加して作成した既存の DCR を編集しないでください。 これらの宛先には、kind の AgentDirectToStore を持つ DCR が必要です。 代わりに、異なる宛先に送信する同じデータ ソースを使用して、複数の DCR を作成します。

  1. Azure portal の検索ボックスに、テンプレート と入力して、[カスタム テンプレートのデプロイ] を選択します。 独自のテンプレートをエディターに作成を選択します。

    Azure portal のスクリーンショット。検索ボックスに「template」と入力されていて、検索結果で [カスタム テンプレートのデプロイ] が強調表示されています。

  2. 次のテンプレート定義をエディターに貼り付けます。

    {
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "location": {
        "type": "String",
        "defaultValue": "[resourceGroup().location]",
        "metadata": {
            "description": "Location for all resources."
        }
        },
        "dataCollectionRulesName": {
        "defaultValue": "[concat(resourceGroup().name, 'DCR')]",
        "type": "String"
        },
        "storageAccountName": {
        "defaultValue": "[concat(resourceGroup().name, 'sa')]",
        "type": "String"
        },
        "eventHubNamespaceName": {
        "defaultValue": "[concat(resourceGroup().name, 'eh')]",
        "type": "String"
        },
        "eventHubInstanceName": {
        "defaultValue": "[concat(resourceGroup().name, 'ehins')]",
        "type": "String"
        }
    },
    "resources": [
        {
        "type": "Microsoft.Insights/dataCollectionRules",
        "apiVersion": "2022-06-01",
        "name": "[parameters('dataCollectionRulesName')]",
        "location": "[parameters('location')]",
        "kind": "AgentDirectToStore",
        "properties": {
            "dataSources": {
                "performanceCounters": [
                    {
                    "streams": [
                        "Microsoft-Perf"
                    ],
                    "samplingFrequencyInSeconds": 10,
                    "counterSpecifiers": [
                        "\\Process(_Total)\\Working Set - Private",
                        "\\Memory\\% Committed Bytes In Use",
                        "\\LogicalDisk(_Total)\\% Free Space",
                        "\\Network Interface(*)\\Bytes Total/sec"
                    ],
                    "name": "perfCounterDataSource10"
                    }
                ],
                "windowsEventLogs": [
                    {
                    "streams": [
                        "Microsoft-Event"
                    ],
                    "xPathQueries": [
                        "Application!*[System[(Level=2)]]",
                        "System!*[System[(Level=2)]]"
                    ],
                    "name": "eventLogsDataSource"
                    }
                ],
                "iisLogs": [
                    {
                    "streams": [
                        "Microsoft-W3CIISLog"
                    ],
                    "logDirectories": [
                        "C:\\inetpub\\logs\\LogFiles\\W3SVC1\\"
                    ],
                    "name": "myIisLogsDataSource"
                    }
                ],
                "logFiles": [
                    {
                    "streams": [
                        "Custom-Text-logs"
                    ],
                    "filePatterns": [
                        "C:\\JavaLogs\\*.log"
                    ],
                    "format": "text",
                    "settings": {
                        "text": {
                        "recordStartTimestampFormat": "ISO 8601"
                        }
                    },
                    "name": "myTextLogs"
                    }
                ]
            },
            "destinations": {
            "eventHubsDirect": [
                {
                "eventHubResourceId": "[resourceId('Microsoft.EventHub/namespaces/eventhubs', parameters('eventHubNamespaceName'), parameters('eventHubInstanceName'))]",
                "name": "myEh1"
                }
            ],
            "storageBlobsDirect": [
                {
                "storageAccountResourceId": "[resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName'))]",
                "name": "blobNamedPerf",
                "containerName": "PerfBlob"
                },
                {
                "storageAccountResourceId": "[resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName'))]",
                "name": "blobNamedWin",
                "containerName": "WinEventBlob"
                },
                {
                "storageAccountResourceId": "[resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName'))]",
                "name": "blobNamedIIS",
                "containerName": "IISBlob"
                },
                {
                "storageAccountResourceId": "[resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName'))]",
                "name": "blobNamedTextLogs",
                "containerName": "TxtLogBlob"
                }
            ],
            "storageTablesDirect": [
                {
                "storageAccountResourceId": "[resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName'))]",
                "name": "tableNamedPerf",
                "tableName": "PerfTable"
                },
                {
                "storageAccountResourceId": "[resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName'))]",
                "name": "tableNamedWin",
                "tableName": "WinTable"
                },
                {
                "storageAccountResourceId": "[resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName'))]",
                "name": "tableUnnamed"
                }
            ]
            },
            "dataFlows": [
            {
                "streams": [
                    "Microsoft-Perf"
                ],
                "destinations": [
                    "myEh1",
                    "blobNamedPerf",
                    "tableNamedPerf",
                    "tableUnnamed"
                ]
            },
            {
                "streams": [
                    "Microsoft-Event"
                ],
                "destinations": [
                    "myEh1",
                    "blobNamedWin",
                    "tableNamedWin",
                    "tableUnnamed"
                ]
            },
            {
                "streams": [
                    "Microsoft-W3CIISLog"
                ],
                "destinations": [
                    "blobNamedIIS"
                ]
            },
            {
                "streams": [
                    "Custom-Text-logs"
                ],
                "destinations": [
                    "blobNamedTextLogs"
                ]
            }
            ]
        }
        }
    ]
    }
    
  3. 次の表の DCR セクションの詳細を使用して、要件に従ってテンプレートを編集します。 このテンプレートでは、パラメーターを使用してストレージ アカウントとイベント ハブの名前を受け入れるため、テンプレートを保存するときに、またはテンプレートのデプロイ方法に応じてパラメーター ファイルにこれらを指定できます。 DCR 構造の詳細については、Azure Monitor のデータ収集規則 (DCR) の構造に関するページを参照してください。

    価値 説明
    dataSources DCR によって収集された各データ ソースのエントリ。 サンプル テンプレートには、ログとパフォーマンス カウンターの定義が含まれています。 これらのデータ ソースの構成や、テンプレートに追加できるその他のデータ ソースの構成の詳細については、 Azure Monitor のデータ収集規則 (DCR) サンプル を参照してください。
    destinations 宛先ごとに 1 つのエントリ。

    イベントハブ
    イベント ハブに直接アップロードするには、eventHubsDirect を使用します。 eventHubResourceId には、イベント ハブ インスタンスのリソース ID が含まれています。

    ストレージ BLOB
    BLOB ストレージに直接アップロードするには、storageBlobsDirect を使用します。 storageAccountResourceId には、ストレージ アカウントのリソース ID が含まれています。 containerName には、コンテナーの名前が含まれています。

    ストレージ テーブル
    テーブル ストレージに直接アップロードするには、storageTablesDirect を使用します。 storageAccountResourceId には、ストレージ アカウントのリソース ID が含まれています。 tableName には、テーブルの省略可能な名前が含まれています。
    dataFlows 各受信ストリームを少なくとも 1 つの宛先と照合する dataflow 。 そのソースからのデータは、データ フロー内の各宛先に送信されます。
  4. [ 保存] を 選択し、必要なパラメーターの値を指定します。

DCR の関連付けを作成し、Azure Monitor Agent をデプロイする

DCR を使用するには、Azure Monitor エージェント (AMA) がインストールされている 1 つ以上の仮想マシンとのデータ収集規則関連付け (DCRA) が必要です。 Azure Monitor エージェントのインストールと管理に関するさまざまなオプションについては、Azure Monitor エージェントのインストールと管理を参照し、DCRA を作成するさまざまなオプションについては、Azure Monitor でのデータ収集ルールの関連付けの管理を参照してください。

次の ARM テンプレートを使用して、Azure Monitor エージェントをデプロイして、特定の VM の DCRA を作成できます。 このテンプレートでは、認証にユーザー割り当てマネージド ID (UAI) が使用されます。 テンプレートをデプロイする前に、UAI を作成する必要があります。 システム割り当てマネージド ID を使用することもできますが、運用環境のワークロードには推奨されません。

上記のプロセスまたはその他の有効な方法を使用して、このテンプレートをデプロイします。 これには、VM と DCR を識別するために必要な値のパラメーターが含まれているため、テンプレート自体を変更する必要はありません。

{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
    "vmName": {
    "defaultValue": "[concat(resourceGroup().name, 'vm')]",
    "type": "String"
    },
    "location": {
    "type": "String",
    "defaultValue": "[resourceGroup().location]",
    "metadata": {
        "description": "Location for all resources."
    }
    },
    "dataCollectionRulesName": {
    "defaultValue": "[concat(resourceGroup().name, 'DCR')]",
    "type": "String",
    "metadata": {
        "description": "Data Collection Rule Name"
    }
    },
    "dcraName": {
    "type": "String",
    "defaultValue": "[concat(uniquestring(resourceGroup().id), 'DCRLink')]",
    "metadata": {
        "description": "Name of the association."
    }
    },
    "identityName": {
    "type": "String",
    "defaultValue": "[concat(resourceGroup().name, 'UAI')]",
    "metadata": {
        "description": "Managed Identity"
    }
    }
},
"resources": [
    {
    "type": "Microsoft.Compute/virtualMachines/providers/dataCollectionRuleAssociations",
    "name": "[concat(parameters('vmName'),'/microsoft.insights/', parameters('dcraName'))]",
    "apiVersion": "2021-04-01",
    "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
        "dataCollectionRuleId": "[resourceID('Microsoft.Insights/dataCollectionRules',parameters('dataCollectionRulesName'))]"
    }
    },
    {
    "type": "Microsoft.Compute/virtualMachines/extensions",
    "name": "[concat(parameters('vmName'), '/AMAExtension')]",
    "apiVersion": "2020-06-01",
    "location": "[parameters('location')]",
    "dependsOn": [
        "[resourceId('Microsoft.Compute/virtualMachines/providers/dataCollectionRuleAssociations', parameters('vmName'), 'Microsoft.Insights', parameters('dcraName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.Azure.Monitor",
        "type": "AzureMonitorWindowsAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
        "authentication": {
            "managedIdentity": {
            "identifier-name": "mi_res_id",
            "identifier-value": "[resourceID('Microsoft.ManagedIdentity/userAssignedIdentities/',parameters('identityName'))]"
            }
        }
        }
    }
    }
]
}

トラブルシューティング

データが Event Hubs またはストレージに送信されていない場合は、次の項目を確認します。

  • [ アクセス許可] に一覧表示されている適切な組み込みロールには、ストレージ アカウントまたはイベント ハブのマネージド ID が割り当てられます。
  • マネージド ID が VM に割り当てられます。
  • AMA 設定にはマネージド ID パラメーターがあります。

こちらも参照ください