gin集成jaeger中间件实现链路追踪

最新推荐文章于 2025-06-25 11:24:08 发布

原创

最新推荐文章于 2025-06-25 11:24:08 发布 · 1.2k 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#gin #中间件 #jaeger #链路追踪

1. 背景

新业务线带来新项目启动，需要改进原有项目的基础框架和组件能力，以提升后续开发和维护效率。项目搭建主要包括技术选型、框架搭建、基础服务搭建等。这其中就涉及到链路追踪的内容，结合其中的踩坑情况，用一篇文章来说明完整的链路搭建过程。

2. 技术选型

2.1 方案对比

图【1】来自网络，请自行对比验证

图 1

2.2 选型

本项目基于golang和gin框架，以及链路中间件对比，选择jaeger作为工具进行集成。

3. 核心实现

3.1 jaeger服务搭建

这里就借助网上的all-in-one的docker方式搭建即可，无需多费力。

docker run --rm --name jaeger \
  -e COLLECTOR_ZIPKIN_HOST_PORT=:9411 \
  -p 6831:6831/udp \
  -p 6832:6832/udp \
  -p 5778:5778 \
  -p 16686:16686 \
  -p 4317:4317 \
  -p 4318:4318 \
  -p 14250:14250 \
  -p 14268:14268 \
  -p 14269:14269 \
  -p 9411:9411 \
  jaegertracing/all-in-one:1.60

这里启动了很多端口，详细的自查即可，这里两个比较重要的端口如下：

16686：服务前端端口，ip:port 可访问UI
6831：项目中连接端口

jaeger界面图【2】所示。

图 2

3.2 protoc编译器及语言插件安装

protobuf协议，是一种跨语言、跨平台的数据结构序列化和反序列化框架，类似于thrift协议

1 编写 .proto ⽂件，⽬的是为了定义结构对象（message）及属性内容。
2 使⽤ protoc 编译器编译 .proto ⽂件，⽣成⼀系列接⼝代码，存放在新⽣成头⽂件和源⽂件中。
3 依赖⽣成的接⼝，将编译⽣成的头⽂件包含进我们的代码中，实现对 .proto ⽂件中定义的字段进行设置和获取，和对 message 对象进行序列化和反序列化

安装

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

编写proto文件

syntax = "proto3";

option go_package = "./proto";
package helloworld;

service Greeter {
   
   
  rpc SayHello (HelloReq) returns (HelloResp);
}

message HelloReq {
   
   
  string name =