【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
&n