如何用OpenTelemetry排查ASP.NET Core HTTP请求耗时异常

以下是针对你遇到的问题（总耗时500ms但EF Core SQL仅占5-10ms，追踪存在大量空白）的补充instrumentation和配置建议：

1. 补全PostgreSQL专用Instrumentation #

你当前使用AddSqlClientInstrumentation仅针对SQL Server有效，PostgreSQL需要使用Npgsql官方的OpenTelemetry instrumentation来捕获连接建立、连接池等待、Postgres特定的执行阶段耗时：

// 首先安装NuGet包：Npgsql.OpenTelemetry
builder.Services.AddOpenTelemetry()
    .WithTracing(tracing => tracing
        .AddNpgsql());

2. 启用EF Core细粒度追踪 #

默认EF Core instrumentation仅记录SQL执行时间，开启全量事件可捕获上下文初始化、查询编译、连接池等待等关键阶段：

tracing.AddEntityFrameworkCoreInstrumentation(options =>
{
    options.IncludeAllEventData = true; // 开启EF Core所有事件追踪
    options.SetDbStatementForText = true; // 记录完整SQL文本
    options.EnrichWithDbContext = (activity, dbContext) =>
    {
        activity.SetTag("db.context", dbContext.GetType().FullName);
    };
    options.EnrichWithCommand = (activity, command) =>
    {
        activity.SetTag("db.command.param_count", command.Parameters?.Count.ToString());
    };
});

3. 添加运行时状态追踪 #

生产环境AKS中常见的线程池饥饿、GC停顿、CPU调度延迟等问题会导致追踪空白，启用Runtime instrumentation可捕获这些指标：

// 安装NuGet包：OpenTelemetry.Instrumentation.Runtime
tracing.AddRuntimeInstrumentation(options =>
{
    options.Metrics = RuntimeInstrumentationMetrics.All;
});

4. 增强HttpClient追踪粒度 #

如果API依赖外部服务，细化HttpClient追踪可捕获DNS解析、连接建立、请求传输等阶段的耗时：

tracing.AddHttpClientInstrumentation(options =>
{
    options.RecordException = true;
    options.IncludePendingRequests = true;
    options.EnrichWithHttpRequestMessage = (activity, request) =>
    {
        activity.SetTag("http.target_host", request.RequestUri.Host);
    };
});

5. 手动标记业务逻辑阶段 #

针对追踪中的空白段，在关键业务代码块手动创建Activity，填补追踪盲区：

// 先定义全局ActivitySource
private static readonly ActivitySource _activitySource = new ActivitySource("YourApi.BusinessLogic");

// 在业务逻辑处添加
using (var activity = _activitySource.StartActivity("OrderProcessing"))
{
    // 你的核心业务逻辑代码
}

额外排查方向 #

• 连接池检查：通过Npgsql的metrics或instrumentation查看是否存在连接等待，可添加AddNpgsqlMetrics监控连接池状态。
• AKS资源监控：查看Azure AKS节点的CPU、内存使用率，确认是否存在节点资源瓶颈导致进程调度延迟。
• 网络延迟验证：检查Pod到Postgres服务的网络连通性与延迟，可通过Azure Monitor的网络 metrics 辅助排查。

内容的提问来源于stack exchange，提问作者Petter Nordlander