API无法正确注册CosmosDB依赖到Application Insights的问题求助

核心修复步骤（无需自定义遥测） #

1. 升级相关NuGet包到最新稳定版 #

确保Microsoft.ApplicationInsights.AspNetCore和Microsoft.Azure.Cosmos两个包都更新至当前最新稳定版本。旧版本的自动依赖追踪逻辑存在连接复用场景下的捕获漏洞，新版本已修复此类问题，能正确识别复用连接后的CosmosDB调用并生成依赖日志。

2. 调整服务注册顺序 #

在Program.cs中，先注册Application Insights遥测服务，再注册CosmosDB客户端。自动拦截逻辑依赖DI容器的服务注册顺序，若Cosmos客户端先初始化，AI的调用拦截器无法注入到后续的客户端调用链中，导致仅首次调用被追踪。
示例代码：

// 优先注册Application Insights
builder.Services.AddApplicationInsightsTelemetry();

// 再注册CosmosDB客户端
builder.Services.AddSingleton<CosmosClient>(sp => 
    new CosmosClient(builder.Configuration["CosmosDb:ConnectionString"]));

3. 禁用Cosmos客户端的静态复用 #

若代码中使用了CosmosClient.CreateAndInitialize或依赖静态客户端实例，需改为通过DI容器获取客户端实例。静态客户端会绕过AI的自动拦截机制，导致仅首次调用生成依赖日志，后续复用连接时无法触发遥测捕获。

4. 显式配置CosmosDB追踪开关 #

在appsettings.json中显式启用CosmosDB的依赖项追踪，避免隐式配置或环境变量覆盖导致的功能失效：

"ApplicationInsights": {
  "InstrumentationKey": "你的仪表密钥",
  "EnableDependencyTracking": true,
  "DependencyTrackingOptions": {
    "EnableCosmosDbTracking": true
  }
}

5. 清理本地调试缓存 #

本地调试时，删除项目目录下的bin和obj文件夹，重新生成解决方案。旧编译缓存可能残留失效的拦截器实例，导致遥测行为异常。

部署版本验证 #

部署到Azure后，在Application Insights的依赖项面板中，筛选type == Azure Cosmos DB，确认连续请求均生成对应的依赖日志；同时检查是否存在重复的“幽灵”依赖项条目，验证问题是否完全修复。

内容的提问来源于stack exchange，提问作者José Albino