.NET Core集成CorrelationId打印请求链路唯一标识,.NET Core集成SkyWalking+SkyAPM-dotne实现分布式链路追踪

.NET Core集成CorrelationId打印请求链路唯一标识

一,链路追踪

随着微服务架构的流行,一次请求会涉及多个服务的调用,并且服务本身也可能会依赖其他服务,整个请求路径会构成一个调用链,当某个节点发生异常时,整个调用链的稳定性都会受到影响,由此APM(应用性能管理)应运而生。

APM可以用于分布式追踪、性能指标分析、应用和服务依赖分析等,可以帮助理解系统行为和分析性能问题。

常见的APM有SkyWalking,Cat、Zipkin、Pinpoint等。其中,SkyWalking可以通过SkyAPM-dotnet集成,Zipkin可以通过zipkin4net集成,对SkyWalking有兴趣的童鞋可以看我另外一篇博文《.NET Core集成SkyWalking+SkyAPM-dotne实现分布式链路追踪》。

虽然APM可以捕捉到整个链路请求,但个人感觉在日志层面还是比较薄弱,更多的还是用于性能分析和追踪。

在实际的生产应用中,大部分的异常更多的是业务异常,APM并不能对日志的定位寻找产生太大帮助,最好的方案还是在日志中输出请求链路的唯一标识,利用唯一标识,我们可以很容易的在日志中心中把请求链路的所有日志检索出来。

二,CorrelationId

CorrelationId会在请求中产生一个唯一标识,并可以将唯一标识作为一个Header传递到下一请求,以此类推,从而整个链路都可以获取到这个标识,并自主打印到日志当中。

下面来看一下详细的实现:

安装nuget包CorrelationId

.NET Core集成CorrelationId打印请求链路唯一标识,.NET Core集成SkyWalking+SkyAPM-dotne实现分布式链路追踪

修改Startup.cs

1.注入组件,可不声明option,UpdateTraceIdentifier = true会自动更新httpcontext中TraceIdentifier字段

 1 services.AddDefaultCorrelationId(options =>
 2             { 
 3                 //options.CorrelationIdGenerator = () => "Foo";
 4                 //options.AddToLoggingScope = true;
 5                 //options.EnforceHeader = true;
 6                 //options.IgnoreRequestHeader = false;
 7                 //options.IncludeInResponse = true;
 8                 //options.RequestHeader = "My-Custom-Correlation-Id";
 9                 //options.ResponseHeader = "X-Correlation-Id";
10                 options.UpdateTraceIdentifier = true;
11             });

2.同一链路中所有节点需声明同一个Client名称,加入此句才能将CorrelationId传递出去

 services.AddHttpClient("MyClient")
         .AddCorrelationIdForwarding()

3.

app.UseCorrelationId();

到此,单个应用节点就已经配置完成了,是不是so easy。同理,其他应用节点也是这么配置。

下面,我们来使用这个唯一标识

声明ICorrelationContextAccessor对象,并通过构造函数注入

public class TransientClass
{
   private readonly ICorrelationContextAccessor _correlationContext;

   public TransientClass(ICorrelationContextAccessor correlationContext)
   {
      _correlationContext = correlationContext;
   }
   
    ...
}

通过_correlationContextAccessor对象即可获取到唯一标识,后续输出日志时,便可打印出来

_logger.LogInformation($"[{_correlationContextAccessor.CorrelationContext.CorrelationId}]我是A");

需要特别注意的是,如调用的是gRPC服务,header默认是空的,无法通过配置直接带过去,需要手动传递

 var header = new Grpc.Core.Metadata { { "X-Correlation-Id", _correlationContextAccessor.CorrelationContext.CorrelationId } };
 return await _queryClient.GetListAsync(request, header);

如设置UpdateTraceIdentifier = true,也可直接获取HttpContext中TraceIdentifier的字段,两者值是一样的

 _logger.LogInformation($"[{context.GetHttpContext().TraceIdentifier}]我是B");

最后,让我们看一下日志输出的效果:

.NET Core集成CorrelationId打印请求链路唯一标识,.NET Core集成SkyWalking+SkyAPM-dotne实现分布式链路追踪

附上GitHub中详细的使用文档:https://github.com/stevejgordon/CorrelationId/wiki

发表评论

相关文章