ASP.NET Core 3.1 Web API无法在Application Insights捕获性能日志

问题核心 #

配置Application Insights后无法自动捕获API请求性能日志，但手动注册UseApplicationInsightsMiddleware即可正常工作，说明自动配置流程存在冲突或遗漏。

排查与修复步骤 #

1. 解决配置冲突问题 #

你的代码中同时存在两处Application Insights配置，且手动将ConnectionString设为空，导致遥测服务无法正确连接：

• 修改Startup.cs中的日志配置：移除手动设置的空ConnectionString，改用配置文件中的有效连接字符串，同时无需单独指定InstrumentationKey（ConnectionString已包含该信息）：

services.AddTransfastLogger((log4Net_Options) =>
{
    log4Net_Options.ConfriguationFileName = config.Log4Net;
}, (applicationInsightsOptions) =>
{
    applicationInsightsOptions.ConnectionString = Configuration["ApplicationInsights:ConnectionString"];
    applicationInsightsOptions.LiveMetricsAuthenticationApiKey = config.ApplicationInsightsLiveMetricsApiKey;
});

• 清理重复配置：删除appsettings.Development.json中LoggingConfiguration下的ApplicationInsights字段，避免重复定义：

"LoggingConfiguration": {
    "Log4Net": "log4net.config",
    "ApplicationInsightsLiveMetricsApiKey": "xxxxxxxxxxxxxxxxxxxxxxx"
}

2. 显式启用请求跟踪 #

默认情况下AddApplicationInsightsTelemetry会自动启用请求跟踪，但可显式配置确保功能生效：

services.AddApplicationInsightsTelemetry(options =>
{
    options.EnableRequestTracking = true;
    options.ConnectionString = Configuration["ApplicationInsights:ConnectionString"];
});

注意：确保AddApplicationInsightsTelemetry在AddControllers之前调用，避免配置被覆盖。

3. 检查中间件管道顺序 #

如果自动注册仍失效，可保留手动注册中间件，但需确保其在路由中间件之前：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 其他中间件（如异常处理、静态文件等）...
    
    var telemetryClient = app.ApplicationServices.GetRequiredService<TelemetryClient>();
    app.UseApplicationInsightsMiddleware<ApplicationInsightsMiddleware>(telemetryClient);
    
    app.UseRouting();
    app.UseAuthorization();
    
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

4. 排查第三方日志组件干扰 #

AddTransfastLogger作为自定义/第三方日志组件，可能覆盖了Application Insights的默认遥测配置：

• 暂时注释掉AddTransfastLogger的注册代码，测试是否能正常收集性能日志。
• 如果测试有效，查看该组件的官方文档，确认与Application Insights的兼容配置方式，避免两者冲突。

总结 #

问题根源在于配置重复冲突和第三方日志组件的干扰，通过统一连接字符串配置、显式启用请求跟踪、调整中间件顺序或排查组件兼容性，即可实现自动捕获API请求性能日志的需求。

内容的提问来源于stack exchange，提问作者Neeraj Kumar Gupta