Jaeger 原生追踪

Jaeger 追踪沙箱展示了 Envoy 的 请求追踪 能力,它使用 Jaeger 作为追踪的提供者,并且使用 Jaeger 的原生 C++ 客户端 作为插件。使用 Jaeger 及其原生客户端替代 Envoy 内置的 Zipkin 客户端有以下优势:

  • Jaeger 可使追踪传播(trace propagation)与其他服务一起工作而无需进行配置 更改
  • 可以使用各种不同的 采样策略,包括可以从 Jaeger 后端集中控制的概率采样策略和远程采样策略。
  • Spans 以更高效的二进制编码发送到采集器。

此沙箱与上述前端代理体系结构非常相似,但有一点不同:在返回响应之前,service1 会对 service2 进行一次 API 调用。这三个容器将被部署在名为 envoymesh 的虚拟网络中。(注意:沙箱只能在 x86-64 上运行)。

所有传入的请求都通过前端 envoy 进行路由,该 envoy 充当位于 envoymesh 网络边缘的反向代理。端口 80 被 docker compose 映射到端口 8000(参见/examples/jaeger-native-tracing/docker-compose.yml)。请注意,所有的 envoy 都被配置为收集请求跟踪信息(例如,/examples/jaeger-native-tracing/front-envoy-jaeger.yaml 中配置的 http_connection_manager/config/tracing),并将 Jaeger 追踪器生成的 span 传播到 Jaeger 集群中(跟踪驱动在 /examples/jaeger-native-tracing/front-envoy-jaeger.yaml 中配置)。

在将请求路由到相应的服务 envoy 或应用之前,Envoy 将负责为追踪生成恰当的 span(父/子上下文 span)。在高层次上,每个 span 将记录上游 API 调用的延迟以及将该 span 与其他相关 span 进行关联所需的信息(例如 trace ID)。

Envoy 追踪最重要的好处之一是它将负责将追踪行为传播到 Jaeger 服务集群中。然而,为了充分利用追踪机制,在对其余服务进行请求时,应用必须传播 Envoy 生成的追踪 header。在我们提供的沙箱中,一个简单的 flask 应用(请参阅追踪函数 /examples/front-proxy/service.py)将作为 service1,在对外请求 service2 时传播追踪 header。

运行沙箱

以下文档按照上图描述对一个 envoy 集群的配置过程进行了演练。

步骤1:建立沙箱

要构建这个沙箱示例并启动示例应用程序,请运行以下命令:

  1. $ pwd
  2. envoy/examples/jaeger-native-tracing
  3. $ docker-compose up --build -d
  4. $ docker-compose ps
  5. Name Command State Ports
  6. -------------------------------------------------------------------------------------------------------------
  7. jaegertracing_service1_1 /bin/sh -c /usr/local/bin/ ... Up 80/tcp
  8. jaegertracing_service2_1 /bin/sh -c /usr/local/bin/ ... Up 80/tcp
  9. jaegertracing_front-envoy_1 /bin/sh -c /usr/local/bin/ ... Up 0.0.0.0:8000->80/tcp, 0.0.0.0:8001->8001/tcp

步骤2:生成一些负载

您现在可以通过前端 envoy(front-envoy)向 service1 发送请求,如下所示:

  1. $ curl -v $(docker-machine ip default):8000/trace/1
  2. * Trying 192.168.99.100...
  3. * Connected to 192.168.99.100 (192.168.99.100) port 8000 (#0)
  4. > GET /trace/1 HTTP/1.1
  5. > Host: 192.168.99.100:8000
  6. > User-Agent: curl/7.43.0
  7. > Accept: */*
  8. >
  9. < HTTP/1.1 200 OK
  10. < content-type: text/html; charset=utf-8
  11. < content-length: 89
  12. < x-envoy-upstream-service-time: 1
  13. < server: envoy
  14. < date: Fri, 26 Aug 2016 19:39:19 GMT
  15. < x-envoy-protocol-version: HTTP/1.1
  16. <
  17. Hello from behind Envoy (service 1)! hostname: f26027f1ce28 resolvedhostname: 172.19.0.6
  18. * Connection #0 to host 192.168.99.100 left intact

步骤3:在 Jaeger UI 中查看追踪

在浏览器中打开 http://localhost:16686。您应该可以看到 Jaeger 仪表盘。设置服务为 “front-proxy” 并点击 ‘Find Traces’。您应该可以看到从 front-proxy 发起的追踪信息。请单击一个追踪来查看从 front-proxy 到 service1 再到 service2 的请求路径,以及每一跳产生的延迟。