Windows Azure Diagnostics 拡張機能から Azure Event Hubs にデータを送信する

[アーティクル]
10/15/2024

Azure Diagnostics 拡張機能は Azure Monitor のエージェントで、ゲストオペレーティングシステムと Azure 仮想マシンと他のコンピューティングリソースのワークロードから監視データを収集します。この記事では、Azure の外部の場所にデータを転送できるように、Windows Azure Diagnostic (WAD) 拡張機能から Azure Event Hubs にデータを送信する方法について説明します。

サポートされるデータ

以下のデータをゲストオペレーティングシステムから収集して Event Hubs に送信できます。 IIS ログやクラッシュダンプなど、WAD によって収集される他のデータソースは、Event Hubs に送信できません。

Windows イベントトレーシング (ETW) イベント
パフォーマンスカウンター
Windows イベントログ (Windows イベントログのアプリケーションログを含む)
Azure Diagnostics インフラストラクチャログ

前提条件

Windows Diagnostics 拡張機能 1.6 以降。サポートされているリソースについては、「Azure Diagnostics 拡張機能の構成スキーマのバージョンと履歴」と「Azure Diagnostics 拡張機能の概要」を参照してください。
Event Hubs 名前空間が、常にプロビジョニングされている必要があります。「Event Hubs の使用」を参照してください。
イベントハブは、Standard レベル以上である必要があります。 Basic レベルはサポートされていません。

構成スキーマ

Diagnostics 拡張機能を有効にして構成するためのさまざまなオプションについては「Windows Azure Diagnostics 拡張機能 (WAD) をインストールして構成する」を参照し、構成スキーマのリファレンスについては「Azure Diagnostics の構成スキーマ」を参照してください。この記事の残りの部分では、この構成を使用してイベントハブにデータを送信する方法について説明します。

Azure Diagnostics では常に、ログとメトリックが Azure Storage アカウントに送信されます。追加の場所にデータを送信する "データシンク" を 1 つ以上構成できます。各シンクはパブリック構成の SinksConfig 要素で定義し、機密情報はプライベート構成で定義します。イベントハブのこの構成では、次の表の値を使用します。

プロパティ	内容
名前	シンクのわかりやすい名前。シンクに送信するデータソースを指定するために構成で使用します。
url	イベントハブの URL。形式は <イベントハブの名前空間>.servicebus.windows.net/<イベントハブ名> です。
SharedAccessKeyName	イベントハブに対する少なくとも送信権限を持つ共有アクセスポリシーの名前。
SharedAccessKey	イベントハブに対する共有アクセスポリシーのプライマリキーまたはセカンダリキー。

パブリック構成とプライベート構成の例を次に示します。これは、イベントハブデータシンクの構成方法と使用方法を説明するために、1 つのパフォーマンスカウンターとイベントログを含む最小構成です。より複雑な例については、「Azure Diagnostics の構成スキーマ」を参照してください。

パブリック構成

{
    "WadCfg": {
        "DiagnosticMonitorConfiguration": {
            "overallQuotaInMB": 5120,
            "PerformanceCounters": {
                "scheduledTransferPeriod": "PT1M",
                "sinks": "myEventHub",
                "PerformanceCounterConfiguration": [
                    {
                        "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
                        "sampleRate": "PT3M"
                    }
                ]
            },
            "WindowsEventLog": {
                "scheduledTransferPeriod": "PT1M",
                "sinks": "myEventHub",
                    "DataSource": [
                    {
                        "name": "Application!*[System[(Level=1 or Level=2 or Level=3)]]"
                    }
                ]
            }
        },
        "SinksConfig": {
            "Sink": [
                {
                    "name": "myEventHub",
                    "EventHub": {
                        "Url": "https://diags-mycompany-ns.servicebus.windows.net/diageventhub",
                        "SharedAccessKeyName": "SendRule"
                    }
                }
            ]
        }
    },
    "StorageAccount": "mystorageaccount",
}

プライベート構成

{
    "storageAccountName": "mystorageaccount",
    "storageAccountKey": "{base64 encoded key}",
    "storageAccountEndPoint": "https://core.windows.net",
    "EventHub": {
        "Url": "https://diags-mycompany-ns.servicebus.windows.net/diageventhub",
        "SharedAccessKeyName": "SendRule",
        "SharedAccessKey": "{base64 encoded key}"
    }
}

構成オプション

データシンクにデータを送信するには、データソースのノードで sinks 属性を指定します。 sinks 属性を配置する場所によって、割り当てのスコープが決まります。次の例では、sinks 属性が PerformanceCounters ノードに対して定義されているため、すべての子パフォーマンスカウンターがイベントハブに送信されます。

"PerformanceCounters": {
    "scheduledTransferPeriod": "PT1M",
    "sinks": "MyEventHub",
    "PerformanceCounterConfiguration": [
        {
            "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
            "sampleRate": "PT3M"
        },
        {
            "counterSpecifier": "\\Memory\\Available MBytes",
            "sampleRate": "PT3M"
        },
        {
            "counterSpecifier": "\\Web Service(_Total)\\ISAPI Extension Requests/sec",
            "sampleRate": "PT3M"
        }
    ]
}

次の例では、sinks 属性が 3 つのカウンターに直接適用されているため、それらのパフォーマンスカウンターだけがイベントハブに送信されます。

"PerformanceCounters": {
    "scheduledTransferPeriod": "PT1M",
    "PerformanceCounterConfiguration": [
        {
            "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
            "sampleRate": "PT3M",
            "sinks": "MyEventHub"
        },
        {
            "counterSpecifier": "\\Memory\\Available MBytes",
            "sampleRate": "PT3M"
        },
        {
            "counterSpecifier": "\\Web Service(_Total)\\ISAPI Extension Requests/sec",
            "sampleRate": "PT3M"
        },
        {
            "counterSpecifier": "\\ASP.NET\\Requests Rejected",
            "sampleRate": "PT3M",
            "sinks": "MyEventHub"
        },
        {
            "counterSpecifier": "\\ASP.NET\\Requests Queued",
            "sampleRate": "PT3M",
            "sinks": "MyEventHub"
        }
    ]
}

構成を検証する

さまざまな方法を使用して、データがイベントハブに送信されることを検証できます。簡単な方法は、「Azure Event Hubs で Azure Blob Storage または Azure Data Lake Storage にイベントをキャプチャする」で説明されている Event Hubs キャプチャを使用することです。

Event Hubs シンクのトラブルシューティング

Azure Diagnostics 自体のログとエラーが含まれる Azure Storage のテーブル WADDiagnosticInfrastructureLogsTable を確認します。 1 つの方法は、 Azure Storage Explorer などのツールを利用してこのストレージアカウントに接続して、このテーブルを表示し、過去 24 時間の TimeStamp のクエリを追加することです。ツールを使用して .csv ファイルをエクスポートし、Microsoft Excel などのアプリケーションで開くことができます。 Excel を使用すると、 EventHubsのようなコーリングカード文字列を簡単に検索して、報告されたエラーを確認できます。
イベントハブが正しくプロビジョニングされていることを確認してください。構成の PrivateConfig セクションのすべての接続情報は、ポータルに表示されるリソースの値に一致している必要があります。ポータルで SAS ポリシー (この例では SendRule) が定義されていること、および "送信" アクセス許可が付与されていることを確認します。

次の方法で共有