jaegertracing/example-hotrod

Hot R.O.D. - 按需乘车服务

这是一个包含多个微服务的演示应用，展示了OpenTelemetry API和SDK的使用。它可以独立运行，但需要Jaeger后端来查看追踪数据。提供以下教程/演练：

• 博客文章 Take Jaeger for a HotROD ride
• 视频 OpenShift Commons Briefing: Distributed Tracing with Jaeger & Prometheus on Kubernetes

自Jaeger v1.42.0起，此应用已升级为使用OpenTelemetry SDK进行追踪。

特性

• 通过数据驱动的依赖图发现整个系统的架构
• 查看请求时间线和错误，了解应用工作原理
• 查找延迟来源和并发问题
• 高上下文日志
• 使用上下文传播（baggage propagation）
  • 诊断请求间竞争（排队）
  • 归因服务中的耗时
• 使用https://github.com/open-telemetry/opentelemetry-go-contrib开源库，以最小的代码更改对HTTP和gRPC请求进行instrumentation

运行

💥💥💥 试试Jaeger v2！ 参见 cmd/jaeger。

通过docker compose运行所有组件

• 从https://github.com/jaegertracing/jaeger/blob/main/examples/hotrod/docker-compose.yml下载`docker-compose.yml`
• 可选：查找最新的Jaeger版本（参见https://www.jaegertracing.io/download/），并通过环境变量`JAEGER_VERSION`传递。否则`docker compose将使用latest标签，首次下载镜像时没问题，但本地镜像仓库中的latest`标签不会更新，可能导致运行过时（且可能不兼容）的Jaeger和HotROD应用版本。
• 运行Jaeger后端和HotROD演示，例如：
  • JAEGER_VERSION=1.52 docker compose -f path-to-yml-file up
• 在http://localhost:***访问Jaeger UI，在http://localhost:8080访问HotROD应用
• 使用docker compose -f path-to-yml-file down关闭/清理

在Kubernetes中运行所有组件

bash
kustomize build ./kubernetes | kubectl apply -f -
kubectl port-forward -n example-hotrod service/example-hotrod 8080:frontend
# 在另一个终端
kubectl port-forward -n example-hotrod service/jaeger 16686:frontend

# 清理
kustomize build ./kubernetes | kubectl delete -f -

访问Jaeger UI：http://localhost:***，HotROD应用：http://localhost:8080

运行Jaeger后端

一体化Jaeger后端打包为Docker容器，使用内存存储。

bash
docker run \
  --rm \
  --name jaeger \
  -p4318:4318 \
  -p16686:16686 \
  -p14268:14268 \
docker.xuanyuan.run/jaegertracing/all-in-one:latest

Jaeger UI可通过http://localhost:***访问。

从源码运行HotROD

bash
git clone git@github.com:jaegertracing/jaeger.git jaeger
cd jaeger
go run ./examples/hotrod/main.go all

从Docker运行HotROD

bash
docker run \
  --rm \
  --link jaeger \
  --env OTEL_EXPORTER_OTLP_ENDPOINT=http://jaeger:4318 \
  -p8080-8083:8080-8083 \
docker.xuanyuan.run/jaegertracing/example-hotrod:latest \
all

然后打开[***]

指标

应用暴露指标，默认使用Go的expvar格式，也可通过-m prometheus标志启用Prometheus格式。

• expvar：curl http://127.0.0.1:8080/debug/vars
• Prometheus：curl http://127.0.0.1:8080/metrics

链接到追踪

HotROD UI可以生成指向Jaeger UI的链接，以查找每个执行请求对应的追踪数据。默认使用标准Jaeger UI地址http://localhost:***，若Jaeger UI运行在其他地址，可通过-j <地址>标志自定义，例如：

go run ./examples/hotrod/main.go all -j http://jaeger-ui:16686