Cloud Services、Virtual Machines、または Service Fabric の診断データを Application Insights に送信する

[アーティクル]
06/01/2023

Cloud Services、Virtual Machines、Virtual Machine Scale Sets、および Service Fabric では、Azure Diagnostics 拡張機能を使用してデータを収集します。 Azure Diagnostics のデータは、Azure Storage のテーブルに送信されます。ただし、Azure Diagnostics 拡張機能 1.5 以降を使用して、すべてのデータまたはデータのサブセットを他の場所にパイプすることもできます。

この記事では、Azure Diagnostics 拡張機能から Application Insights にデータを送信する方法について説明します。

診断構成の説明

Azure Diagnostics 拡張機能 1.5 では、シンクが導入されました。シンクとは、診断データを送信できるその他の場所のことです。

Application Insights のシンクの構成の例を以下に示します。

<SinksConfig>
    <Sink name="ApplicationInsights">
      <ApplicationInsights>{Insert InstrumentationKey}</ApplicationInsights>
      <Channels>
        <Channel logLevel="Error" name="MyTopDiagData"  />
        <Channel logLevel="Verbose" name="MyLogData"  />
      </Channels>
    </Sink>
</SinksConfig>

"SinksConfig": {
    "Sink": [
        {
            "name": "ApplicationInsights",
            "ApplicationInsights": "{Insert InstrumentationKey}",
            "Channels": {
                "Channel": [
                    {
                        "logLevel": "Error",
                        "name": "MyTopDiagData"
                    },
                    {
                        "logLevel": "Error",
                        "name": "MyLogData"
                    }
                ]
            }
        }
    ]
}

シンクの name 属性は、シンクを一意に識別する文字列値です。
ApplicationInsights 要素では、Azure Diagnostics データの送信先となる Application Insights リソースのインストルメンテーションキーを指定します。
- 既存の Application Insights リソースがない場合、リソースの作成方法とインストルメンテーションキーの取得方法の詳細については、「新しい Application Insights リソースを作成する」を参照してください。
- Azure SDK 2.8 以降でクラウドサービスを開発する場合、このインストルメンテーションキーが自動的に設定されます。この値は、クラウドサービスプロジェクトをパッケージ化するときの APPINSIGHTS_INSTRUMENTATIONKEY サービス構成設定に基づきます。 Cloud Services での Application Insights の使用に関するページを参照してください。
Channels 要素には、1 つ以上の Channel 要素が含まれます。
- name 属性は、そのチャンネルを一意に参照します。
- loglevel 属性では、チャンネルで許可されるログレベルを指定できます。使用可能なログレベルを情報の多い順に並べると、次のようになります。
  - 詳細
  - Information
  - 警告
  - エラー
  - Critical

チャンネルはフィルターのように機能し、対象のシンクに送信する特定のログレベルを選択するために使用できます。たとえば、詳細ログを収集してストレージに送信し、シンクにはエラーのみを送信することができます。

次の図にこの関係を示します。

次の図は、構成値とそのしくみについてまとめたものです。構成の階層内のさまざまなレベルに複数のシンクを含めることができます。最上位のシンクはグローバルな設定として機能し、個々の要素のレベルに指定されたシンクはそのグローバル設定をオーバーライドします。

完全なシンクの構成例

パブリック構成ファイルの完全な例を以下に紹介します。

Application Insights にすべてのエラーを送信する (DiagnosticMonitorConfiguration ノードで指定)。
アプリケーションログにも詳細レベルのログを送信する (Logs ノードで指定)。

<WadCfg>
  <DiagnosticMonitorConfiguration overallQuotaInMB="4096"
       sinks="ApplicationInsights.MyTopDiagData"> <!-- All info below sent to this channel -->
    <DiagnosticInfrastructureLogs />
    <PerformanceCounters>
      <PerformanceCounterConfiguration counterSpecifier="\Processor(_Total)\% Processor Time" sampleRate="PT3M" />
      <PerformanceCounterConfiguration counterSpecifier="\Memory\Available MBytes" sampleRate="PT3M" />
    </PerformanceCounters>
    <WindowsEventLog scheduledTransferPeriod="PT1M">
      <DataSource name="Application!*" />
    </WindowsEventLog>
    <Logs scheduledTransferPeriod="PT1M" scheduledTransferLogLevelFilter="Verbose"
            sinks="ApplicationInsights.MyLogData"/> <!-- This specific info sent to this channel -->
  </DiagnosticMonitorConfiguration>

<SinksConfig>
    <Sink name="ApplicationInsights">
      <ApplicationInsights>{Insert InstrumentationKey}</ApplicationInsights>
      <Channels>
        <Channel logLevel="Error" name="MyTopDiagData"  />
        <Channel logLevel="Verbose" name="MyLogData"  />
      </Channels>
    </Sink>
  </SinksConfig>
</WadCfg>

"WadCfg": {
    "DiagnosticMonitorConfiguration": {
        "overallQuotaInMB": 4096,
        "sinks": "ApplicationInsights.MyTopDiagData", "_comment": "All info below sent to this channel",
        "DiagnosticInfrastructureLogs": {
        },
        "PerformanceCounters": {
            "PerformanceCounterConfiguration": [
                {
                    "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
                    "sampleRate": "PT3M"
                },
                {
                    "counterSpecifier": "\\Memory\\Available MBytes",
                    "sampleRate": "PT3M"
                }
            ]
        },
        "WindowsEventLog": {
            "scheduledTransferPeriod": "PT1M",
            "DataSource": [
                {
                    "name": "Application!*"
                }
            ]
        },
        "Logs": {
            "scheduledTransferPeriod": "PT1M",
            "scheduledTransferLogLevelFilter": "Verbose",
            "sinks": "ApplicationInsights.MyLogData", "_comment": "This specific info sent to this channel"
        }
    },
    "SinksConfig": {
        "Sink": [
            {
                "name": "ApplicationInsights",
                "ApplicationInsights": "{Insert InstrumentationKey}",
                "Channels": {
                    "Channel": [
                        {
                            "logLevel": "Error",
                            "name": "MyTopDiagData"
                        },
                        {
                            "logLevel": "Verbose",
                            "name": "MyLogData"
                        }
                    ]
                }
            }
        ]
    }
}

前の構成の以下の行には、次の意味があります。

Azure Diagnostics によって収集されているすべてのデータを送信する

<DiagnosticMonitorConfiguration overallQuotaInMB="4096" sinks="ApplicationInsights">

"DiagnosticMonitorConfiguration": {
    "overallQuotaInMB": 4096,
    "sinks": "ApplicationInsights",
}

Application Insights のシンクにエラーログのみを送信する

<DiagnosticMonitorConfiguration overallQuotaInMB="4096" sinks="ApplicationInsights.MyTopDiagdata">

"DiagnosticMonitorConfiguration": {
    "overallQuotaInMB": 4096,
    "sinks": "ApplicationInsights.MyTopDiagData",
}

Application Insights に詳細なアプリケーションログを送信する

<Logs scheduledTransferPeriod="PT1M" scheduledTransferLogLevelFilter="Verbose" sinks="ApplicationInsights.MyLogData"/>

"DiagnosticMonitorConfiguration": {
    "overallQuotaInMB": 4096,
    "sinks": "ApplicationInsights.MyLogData",
}

制限事項

チャンネルでは、種類のみがログに記録されます。パフォーマンスカウンターは記録されません。 パフォーマンスカウンターの要素を含むチャンネルを指定した場合、そのチャンネルは無視されます。
チャネルのログレベルには、Azure Diagnostics によって収集されるデータのログレベルを超えるログを指定することはできません。 たとえば、Logs 要素でアプリケーションログのエラーを収集できないため、Application Insight シンクに "詳細" ログを送信することにします。 scheduledTransferLogLevelFilter 属性では、シンクに送信するログと同じかそれを超えるレベルのログを常に収集する必要があります。
Azure Diagnostics の拡張機能によって収集される BLOB データは Application Insights に送信できません。 たとえば、Directories ノードの下で指定されたデータがこれに該当します。クラッシュダンプの場合、実際のクラッシュダンプは Blob Storage に送信され、Application Insights にはクラッシュダンプが生成されたという通知のみが送信されます。

次の手順

Application Insights で Azure Diagnostics 情報を表示する方法について説明します。
PowerShell を使用して、アプリケーションの Azure Diagnostics の拡張機能を有効にします。
Visual Studio を使用して、アプリケーションの Azure Diagnostics の拡張機能を有効にします。