Gone框架介绍15 - 使用traceId追踪日志

我从头到尾实现了一个Golang的依赖注入框架,并且集成了gin、xorm、redis、cron、消息中间件等功能;自己觉得还挺好用的,并且打算长期维护!
github地址:https://github.com/gone-io/gone
文档地址:https://goner.fun/
请帮忙在github上点个 ⭐️吧,这对我很重要 ;万分感谢!!

使用traceId追踪日志

在Web应用中,一次请求可能会经过很多业务流程的处理;为了方便排查问题,我们希望所有业务流程打印的日志拥有一个统一的traceId;拥有traceId,就可以将整个业务流程的日志都串起来,回溯和分析问题出在哪个业务环节。
在其他开源框架中,一般采用策略是在所有的函数中都增加context.Context参数,golang官方也是这样推荐的。然而我们认为这样平白无故的多打一些代码实在很难受,我们希望不用在每个函数中传递额外参数实现打印日志中附件traceId。为此,我们在Gone中提供了一个内置的Goner来提供这样的功能。

将相关Goners埋葬到Cemetery

tip: 了解Gone的核心概念和术语请阅读:Gone的核心概念

在这里,我们采用github.com/gone-io/gone/tree/main/goner包中的 BasePriest 来完成相关Goners的埋葬。在BasePriest中会将 tracerconfiglogrus 相关的Goners同埋葬到Cemetery,这三个包一般一起使用。


func MasterPriest(cemetery gone.Cemetery) error {
	_ = goner.BasePriest(cemetery)

	//埋葬其他Goners
	return nil
}

简单使用

在埋葬了tracer的情况下,我们通过注入的logrus.Logger接口打印日志时,日志中会自动添加一串traceId。

//...

type service struct {
    gone.Flag
    log logrus.Logger `gone:"gone-logger"` //具名注入到 嵌套的log属性上
}

func (svc *service) Business(input string) (string, error) {

    //打印日志
	svc.log.Infof("input content is %s", input)

	return input, nil
}

//...

如下,其中061ad00f-8c0d-479c-bc4c-393e0cf2cca2为traceId:

2024-05-11 09:09:57.784|INFO|**/Users/jim/go/pkg/mod/github.com/gone-io/gone@v0.1.4/goner/gin/server.go:46**|061ad00f-8c0d-479c-bc4c-393e0cf2cca2|Server Listen At :8080

跨协程(goroutine)传递traceId

前面例子中,如果没有新开协程是正常的,如果使用关键词go开一个新的协程,会发现协程打印的日志没有traceId。
怎么解决,注入tracer.Tracer接口,使用之前的Go方法来代替go关键词来新开协程,如下:

//...
type service struct {
    gone.Flag
    log logrus.Logger `gone:"gone-logger"` //具名注入到 嵌套的log属性上
    tracer.Tracer `gone:"gone-tracer"` //注入tracer
}

func (svc *service) Business(input string) (string, error) {

	svc.Go(func() {
        //新协程中打印日志
		svc.log.Infof("log in new goroutine")
	})

	return input, nil
}
//...

跨进程/服务传递traceId

在微服务中,一个web请求一般会跨域多个微服务,跨域微服务的方式一般会通过:

  1. 消息中间件
    为实现traceId在消息中间件中传递和更方便的使用消息中间件传递业务事件,我们开源了https://github.com/gone-io/emitter仓库,在这个仓库中实现了Rocket MQ的适配,后续计划适配KafkaRabbitMQ等主流的消息中间件。
  2. RPC调用/内部http调用
    通过Gone内置的Goner urllib 来给Gone Web程序发送http请求,traceId会自动在服务间传递。另外使用内置的 grpc 来实现gRpc调用也能自动传递traceId。后续会支持更多的rpc调用。

多语言支持

在http请求中传递traceId,是通过在请求头中增加了一个特殊的头X-Trace-ID来携带traceId。所以如果使用了多种开发语言,不同服务间只要遵守“在Client端请求时附件X-Trace-ID,在Server端处理请求时解析X-Trace-ID”,就能实现让traceId跨域不同语言开发的微服务。
后续会开发其他语言的包支持其他语言无缝接入。

我从头到尾实现了一个Golang的依赖注入框架,并且集成了gin、xorm、redis、cron、消息中间件等功能;自己觉得还挺好用的,并且打算长期维护!
github地址:https://github.com/gone-io/gone
文档地址:https://goner.fun/
请帮忙在github上点个 ⭐️吧,这对我很重要 ;万分感谢!!

上一篇:Gone框架介绍14 -日志输出

相关推荐

  1. Gone框架介绍15 - 使用traceId追踪

    2024-05-13 05:00:11       31 阅读
  2. Gone框架介绍16 - 自动生成Priest

    2024-05-13 05:00:11       31 阅读
  3. Gone框架介绍27 - 再讲 Goner 和 依赖注入

    2024-05-13 05:00:11       35 阅读
  4. Gone框架介绍19 -如何进行单元测试?

    2024-05-13 05:00:11       30 阅读

最近更新

  1. docker php8.1+nginx base 镜像 dockerfile 配置

    2024-05-13 05:00:11       94 阅读
  2. Could not load dynamic library ‘cudart64_100.dll‘

    2024-05-13 05:00:11       101 阅读
  3. 在Django里面运行非项目文件

    2024-05-13 05:00:11       82 阅读
  4. Python语言-面向对象

    2024-05-13 05:00:11       91 阅读

热门阅读

  1. Nginx使用详解

    2024-05-13 05:00:11       35 阅读
  2. Agent AI智能体:未来社会的角色、发展与挑战

    2024-05-13 05:00:11       30 阅读
  3. 算法训练营day34

    2024-05-13 05:00:11       30 阅读
  4. Qt 类的设计思路详解

    2024-05-13 05:00:11       34 阅读
  5. 8.Redis

    8.Redis

    2024-05-13 05:00:11      33 阅读
  6. 【面经】Linux

    2024-05-13 05:00:11       33 阅读
  7. LeetCode 每日一题 2024/5/6-2024/5/12

    2024-05-13 05:00:11       30 阅读