如何使用gRPC、Istio、Jaeger在Java Spring Boot项目中实现全链路追踪

你认为grpc-spring-boot-starter无需手动透传链路头即可实现追踪的猜测是成立的，前提是依赖、Istio配置、代码实现均符合规范，以下是完整排查和解决方案：

1. 依赖配置校验 #

• 若你使用的是net.devh社区版grpc-spring-boot-starter，需额外引入链路追踪适配组件才能触发自动头透传：
  • 基于OpenTelemetry体系：引入opentelemetry-instrumentation-grpc和对应Spring Boot自动配置依赖
  • 基于Spring Cloud Sleuth体系：引入spring-cloud-starter-sleuth+spring-cloud-sleuth-otel-autoconfigure，版本需与Spring Boot版本严格对齐
• 全链路需统一链路协议：Istio默认使用W3C tracecontext协议，不要混用老旧的B3协议，避免链路ID无法串联

2. Istio 集群配置校验 #

• 确认所有gRPC服务的Pod已完成Istio sidecar注入，执行kubectl get pods -n <你的命名空间>，正常运行的Pod容器数应为2（业务容器+istio-proxy容器）
• 调整Istio追踪采样率：Istio默认采样率为1%，低流量场景下大概率无法采集到链路，可临时将采样率调至100%用于测试，在MeshConfig中新增配置defaultConfig.tracing.sampling=100.0
• 确认Istio gRPC追踪开关已开启，不要在Istio安装配置中显式设置enableGrpcTracing: false，同时确认Istio追踪导出地址配置为正确的Jaeger Collector地址

3. 代码实现校验 #

• 不要手动编写gRPC拦截器透传链路头，同时确保你自定义的gRPC拦截器不会过滤traceparent、tracestate、x-request-id等Istio注入的标准链路头
• 跨服务gRPC调用必须使用@GrpcClient注解注入的Stub实例，手动构造的Stub不会触发链路头自动注入逻辑
• 若你在服务中新增了异步线程逻辑，需确保链路上下文可以正确传递到子线程，使用Spring Sleuth的TraceableExecutorService等封装类处理异步场景即可

4. 快速排查步骤 #

• 在gRPC服务接口中打印所有请求头，确认请求入口已携带traceparent参数：若不存在则排查上游服务的Istio注入配置，若存在则排查Jaeger采集逻辑是否正常
• 查看istio-proxy容器的日志，确认是否存在追踪数据导出失败的报错，如有则修正Jaeger访问配置

内容的提问来源于stack exchange，提问作者Никита Чернышев