使用Telemetry Client时App Insights中自定义指标不显示问题

可能的原因及对应的解决方案 #

1. Azure App Service内置Application Insights集成配置冲突 #

Azure App Service提供了内置的Application Insights集成功能，如果该功能未正确关联你的AI资源，或者自动配置逻辑异常，会导致TelemetryConfiguration的DisableTelemetry被设为true，同时Instrumentation Key无法正确加载。

• 解决步骤：
  • 登录Azure门户，进入目标App Service实例；
  • 左侧导航栏选择「监视」->「Application Insights」；
  • 确认已正确关联到目标Application Insights资源：未关联则点击「链接」选择对应资源；已关联则尝试关闭「自动检测」开关，手动配置连接字符串。

2. 配置优先级与部署问题 #

ASP.NET Core配置加载遵循优先级规则，Azure App Service的「应用设置」会覆盖本地appsettings.json配置。如果App Service应用设置中未正确配置Application Insights相关项，会导致配置加载失败。

• 解决步骤：
  • 在App Service的「配置」->「应用设置」中，添加APPLICATIONINSIGHTS_CONNECTION_STRING项，值设置为你的Application Insights资源连接字符串；
  • 确认部署包中的appsettings.json包含正确的连接字符串，避免部署时文件被篡改或遗漏；
  • 注意：若同时设置InstrumentationKey和ConnectionString，后者会覆盖前者，建议统一使用连接字符串。

3. NuGet包版本兼容性问题 #

你使用的Microsoft.ApplicationInsights.AspNetCore 2.21.0版本发布于2021年，与ASP.NET Core 6存在兼容性差距，可能导致配置加载逻辑失效。

• 解决步骤：
  • 在项目中升级Microsoft.ApplicationInsights.AspNetCore包到兼容ASP.NET Core 6的稳定版本（如2.22.0及以上，建议使用最新稳定版）；
  • 升级后重新部署应用到App Service。

4. 代码中配置加载逻辑问题 #

ASP.NET Core 6的启动模式与旧版本不同，若Application Insights服务注册逻辑不正确，会导致配置无法被正确读取。

• 解决步骤：
  • 检查Program.cs中的服务注册代码，确保正确添加Application Insights并读取配置：

    var builder = WebApplication.CreateBuilder(args);
    // 确保此行代码正确添加，从配置中读取Application Insights设置
    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration);
    

  • 排查代码中是否有其他地方修改了TelemetryConfiguration的DisableTelemetry属性，比如中间件、其他服务中是否存在TelemetryConfiguration.Active.DisableTelemetry = true这类代码。

5. 应用服务运行环境限制 #

部分App Service定价层或配置可能限制了Application Insights功能，或者网络隔离导致无法上报数据。

• 解决步骤：
  • 确认App Service定价层支持Application Insights功能（免费层可能存在限制）；
  • 检查App Service网络配置，确保出站流量可访问Application Insights端点（默认无需额外配置，但若开启VNet集成或防火墙，需允许对应域名访问）。

内容的提问来源于stack exchange，提问作者ashwanth sreedharan