go 语言的 openTracing 实践指南(译自: https://github.com/yurishkuro/opentracing-tutorial)

Tracing 统一翻译为链路追踪

目录

• 第一节 - Hello World
  • 实例化一个 Tracer
  • 创建一个简单的例子
  • 对 Trace 进行注释
• 第二节 - 上下文和追踪函数
  • 追踪独立函数
  • 在一个 trace 中联合多个 span
  • 在一个进程内传递上下文
• 第三节 - 追踪 RPC 请求
  • 在多个微服务中进行 trace 追踪
  • 使用 Inject 和 Extrace 在进程间传递上下文
  • 使用 OpenTracing 推荐的 tags
• 第四节 - Baggage(用于传输跨进程的全局数据)
  • 离家分布式上下文传输
  • 使用 baggage 在整个周期中传输数据

代码说明

随着文章一步步走的代码在 ./lesson0x/exercise 目录下,封装好的最终代码在 ./lesson0x/solution 中

安装 Jaeger

这篇指南使用 CNCF 基金会的 Jaeger(https://jaegertracing.io) 作为后端链路追踪系统，我们需要通过 Docker 启动一个默认内存存储的 Jaeger系统，只暴露必须的端口，并且将log模式设置为 debug。 docker pull jaegertracing/all-in-one:1.13

docker run \
  --rm \
  -p 6831:6831/udp \
  -p 6832:6832/udp \
  -p 16686:16686 \
  jaegertracing/all-in-one:1.13 \
  --log-level=debug

此外， 可以从 https://jaegertracing.io/download/ 下载不同平台的名为 all-in-one 的 Jaeger二进制执行程序，Jaeger启动后，可以 通过 http://localhost:16686 访问 Jaeger UI`.

运行项目示例

本仓库使用 go modules管理依赖，所以要求 GO 版本大于 1.11。
首先将代码克隆到 $GOPATH 路径下

mkdir -p $GOPATH/src/github.com/waterandair/
cd $GOPATH/src/github.com/waterandair/
git clone https://github.com/waterandair/opentracing-tutorial.git

然后, 安装依赖:

cd $GOPATH/src/github.com/waterandair/opentracing-tutorial/
make install

本教程的其他命令都相对于此目录运行