將雲端服務、虛擬機器或 Service Fabric 診斷資料傳送至 Application Insights

發行項
10/29/2024

雲端服務、虛擬機器、虛擬機器擴展集和 Service Fabric 全都使用 Azure 診斷擴充功能來收集資料。 Azure 診斷會將資料傳送至 Azure 儲存體資料表。不過，您也可以使用 Azure 診斷擴充功能 1.5 或更新版本，將所有資料或一部分資料傳送至其他位置。

本文說明如何將資料從 Azure 診斷擴充功能傳送至 Application Insights。

說明診斷組態

Azure 診斷擴充功能 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"
                    }
                ]
            }
        }
    ]
}

Sink name 屬性是可唯一識別接收器的字串值。
ApplicationInsights 元素指定 Azure 診斷資料送出的 Application Insights 資源的檢測金鑰。
- 如果您沒有現有的 Application Insights 資源，請參閱建立新的 Application Insights 資源。
- 如果您要使用 Azure SDK 2.8 和更新版本開發雲端服務，則會自動填入此檢測密鑰。此值是以封裝雲端服務專案時APPINSIGHTS_INSTRUMENTATIONKEY服務組態設定為基礎，請參閱搭配雲端服務使用 Application Insights。
Channels 元素包含一個或多個 Channel 元素。
- name屬性可唯一參考該通道。
- loglevel 屬性可讓您指定通道允許的記錄等級。可用的記錄等級從最多到最少資訊依序為：
  - 詳細資訊
  - 資訊
  - 警告
  - 錯誤
  - 重大

通道就像篩選條件，可讓您選取要傳送至目標接收器的特定記錄等級。例如，您可以收集詳細記錄，將它們傳送至儲存體，但只將「錯誤」傳送至接收器。

下圖顯示此關聯性。

下圖摘要說明設定值及其運作方式。您可以在組態中的不同階層等級中包含多個接收器。在最上層指定的接收器會成為全域設定，而在個別元素指定的接收器就形同覆寫該全域設定。

完整接收器組態範例

以下是公用組態檔的完整範例：

將所有錯誤傳送至 Application Insights（在 DiagnosticMonitorConfiguration 節點指定）。
也會傳送應用程式記錄檔的詳細資訊層級記錄（在 [記錄 ] 節點指定）。

<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 診斷收集的所有數據

<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 診斷所收集項目的記錄層級。 例如，您無法在 Logs 元素中收集應用程式記錄錯誤，並嘗試將詳細資訊記錄傳送至 Application Insight 接收。 scheduledTransferLogLevelFilter 屬性必須一律收集相等或更多的記錄，而不是您嘗試傳送至接收的記錄。
您無法將 Azure 診斷擴充功能收集的 Blob 數據傳送至 Application Insights。 例如，Directories 節點下指定的任何項目。針對損毀傾印，實際的損毀傾印會傳送至 Blob 記憶體，而且只會將損毀傾印產生的通知傳送至 Application Insights。

後續步驟

了解如何在 Application Insights 中檢視您的 Azure 診斷資訊。
使用 PowerShell 來為您的應用程式啟用 Azure 診斷擴充。
使用 Visual Studio 為您的應用程式啟用 Azure 診斷擴充功能。

共用方式為