.NET Core中APM结合ELK实现方法级代码追踪的技术问询

1. 手动添加方法级Span埋点 #

默认APM Agent通常只自动追踪框架层面的操作（控制器请求、EF Core数据库查询等），自定义业务方法需要手动埋点来纳入追踪链路。以Elastic APM为例，直接使用Agent的API创建Span：

public async Task<Order> GetOrderById(int id)
{
    using (var span = Agent.Tracer.StartSpan(nameof(GetOrderById), "business", "order-processing"))
    {
        var order = await _dbContext.Orders.FindAsync(id);
        
        // 嵌套子方法也可以添加Span
        using (var validateSpan = Agent.Tracer.StartSpan(nameof(ValidateOrder), "business", "validation"))
        {
            ValidateOrder(order);
            validateSpan.End();
        }
        
        span.End();
        return order;
    }
}

这样自定义方法的执行耗时、调用关系会被APM捕获，展示在追踪时间线中。

2. 配置Agent自动注入方法追踪 #

多数主流APM工具支持通过配置或特性标记实现自动追踪，无需手动写埋点代码。比如Elastic APM可以在appsettings.json中指定要追踪的方法范围：

{
  "ElasticApm": {
    "ServiceName": "YourServiceName",
    "ServerUrl": "http://your-apm-server:8200",
    "Instrumentation": {
      "Methods": [
        {
          "Name": "YourProject.Services.*",
          "Type": "Span"
        },
        {
          "Name": "YourProject.BusinessLogic.*",
          "Type": "Span"
        }
      ]
    }
  }
}

通过通配符匹配目标命名空间或类下的所有方法，Agent会自动为这些方法创建Span，加入追踪链路。

3. 检查Agent的Instrumentation生效状态 #

不同APM工具的默认追踪范围不同，需要确认配置是否生效：

• 确保Agent版本是最新的，旧版本可能缺失部分自动追踪特性；
• 比如Datadog可以通过环境变量DD_TRACE_CUSTOM_METHODS指定要追踪的方法（格式：Namespace.Class.Method）；
• 查看Agent的日志，确认没有报错或配置加载失败的信息。

4. 结合结构化日志补充指标 #

如果APM追踪仍有遗漏，可以在关键方法的入口和出口添加结构化日志，通过TraceId关联APM链路：

private readonly ILogger<PaymentService> _logger;

public void ProcessPayment(PaymentDto payment)
{
    var traceId = Agent.Tracer.CurrentTransaction?.TraceId ?? Guid.NewGuid().ToString();
    _logger.LogInformation("TraceId: {TraceId} | 开始执行ProcessPayment，PaymentId: {PaymentId}", traceId, payment.Id);
    
    var startTime = Stopwatch.StartNew();
    // 业务逻辑执行
    startTime.Stop();
    
    _logger.LogInformation("TraceId: {TraceId} | 完成ProcessPayment，耗时: {ElapsedMs}ms，PaymentId: {PaymentId}", 
        traceId, startTime.Elapsed.TotalMilliseconds, payment.Id);
}

之后可以在ELK中通过TraceId关联APM追踪数据和日志，统计方法的运行指标。

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