【Azure 應用程序看法】 Application Insights 對App Service的支持問題

問題描述

Web App 發佈後, Application Insights 收集不到數據了

 

問題分析

在應用服務(App Service)中收集應用的監控數據(如Request，Exception，Trace等）時經過Agent(Application Insight Site Extension)來實現的。因更新迭代的關係，有些版本再也不，或尚未被支持。如Agent(Application Insight Site Extension 2.8.38)支持.NET Core 2.1 and 3.1, 而 .Net Core 2.2再也不被繼續支持，而.Net 5卻尚未被支持。

 

解決辦法

一：使用基於代理（agent-based)模式修改.Net Core的版本和Application Agent版本。如：

•  ApplicationInsightsAgent_EXTENSIONVERSION=~2 同時 升級至.NET Core 3.1
•  ApplicationInsightsAgent_EXTENSIONVERSION=2.8.37 同時 繼續使用.NET Core 2.2

 

二：使用基於代碼模式的Application Insighs:

• 升級至.NET 5 並更新項目依賴：https://docs.microsoft.com/en-us/azure/azure-monitor/app/asp-net-core

2.1 安裝Application Insights SDK，建議一直使用最新的穩定版 Application Insights SDK NuGet package for ASP.NET Core。打開項目中的.csproj文件，以以下示例爲參考添加Package引用。

   <ItemGroup>
      <PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.16.0" />
    </ItemGroup>

 

2.2 在項目的Startup類中的 ConfigureServices()方法中，添加 services.AddApplicationInsightsTelemetry()。啓動Application Insights

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        // The following line enables Application Insights telemetry collection.
 services.AddApplicationInsightsTelemetry();

        // This code adds other services for your application.
        services.AddMvc();
    }

 

2.3 設置Application Insights的 instrumentation Connection String。 這裏有多種方式來設置Connection String， Connection String的值由Azure Application門戶提供

a)  使用系統級環境變量

在系統中添加環境變量參數：APPLICATIONINSIGHTS_CONNECTION_STRING。

 

b)  在代碼設置，使用TelemetryConfiguration對象或ApplicationInsightsServiceOptions

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        var configuration = new TelemetryConfiguration
        {
            ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
        };
        
        // The following line enables Application Insights telemetry collection.
        services.AddApplicationInsightsTelemetry(configuration);

        // This code adds other services for your application.
        services.AddMvc();
    }

或者

    public void ConfigureServices(IServiceCollection services)
    {
        var options = new ApplicationInsightsServiceOptions { ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;" };
        services.AddApplicationInsightsTelemetry(options: options);
    }

 

c)  使用配置文件(官方推薦方式)

XML

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000</ConnectionString>
</ApplicationInsights>

JSON(config.json)

{
  "ApplicationInsights": {
    "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
    }
  }

 

 

參考資料

How to set a connection string: https://docs.microsoft.com/en-us/azure/azure-monitor/app/sdk-connection-string?tabs=net#how-to-set-a-connection-string

Enable Application Insights server-side telemetry (no Visual Studio): https://docs.microsoft.com/en-us/azure/azure-monitor/app/asp-net-core#enable-application-insights-server-side-telemetry-no-visual-studio

Enable agent-based monitoring:https://docs.microsoft.com/en-us/azure/azure-monitor/app/azure-web-apps?tabs=netcore#enable-agent-based-monitoring

Microsoft.ApplicationInsights.AspNetCore package: https://www.nuget.org/packages/Microsoft.ApplicationInsights.AspNetCore