GKE部署的Spring Boot应用无法将Trace数据上报至GCP Cloud Trace如何排查

• 采样率配置：Spring Cloud Sleuth和Spring Cloud GCP Trace默认采样率较低，甚至部分版本默认关闭上报采样，需要添加两组配置确认采样正常开启（测试环境可设为1.0全采样，生产按需调低）：

spring.sleuth.sampler.probability=1.0
spring.cloud.gcp.trace.sample-probability=1.0

• PubSub链路传播配置：使用Spring Stream Binder集成PubSub的场景，需要额外开启消息链路传播配置，确保消费、发布消息生成的Span会被捕获：

spring.sleuth.messaging.enabled=true
spring.sleuth.messaging.pubsub.enabled=true

• GKE工作负载权限配置：GKE节点或Pod绑定的服务账号必须拥有roles/cloudtrace.agent权限，才能将Trace数据上报到Cloud Trace，异步上报的权限错误默认不会抛出业务异常。可通过GKE Workload Identity为单独Pod绑定权限，或直接给GKE节点服务账号授予对应权限。
• 依赖冲突检查：确认Spring Cloud GCP版本与Spring Boot、Spring Cloud版本匹配，同时排查项目中是否引入了Zipkin等其他链路追踪依赖产生冲突，不需要额外引入Zipkin相关Starter即可完成Cloud Trace上报。
• 自动配置排除检查：检查启动类@SpringBootApplication注解的exclude参数，以及配置文件的spring.autoconfigure.exclude配置，是否排除了GcpTraceAutoConfiguration相关自动配置类，如有请删除对应排除规则。

• 本地调试验证：本地启动应用，挂载拥有Cloud Trace写入权限的服务账号密钥，添加配置spring.cloud.gcp.credentials.location=file:///本地密钥文件路径，同时开启Trace相关DEBUG日志：

logging.level.com.google.cloud.spring.trace=DEBUG
logging.level.brave=DEBUG

运行后查看日志，确认是否有Span生成、是否发起上报请求、上报是否有错误返回。

• 确认GCP侧配置：登录GCP控制台，检查目标项目的Cloud Trace API是否已启用，未启用的情况下上报请求会被静默丢弃。
• GKE Pod日志排查：部署到GKE的应用开启DEBUG日志级别后，查看Pod的标准输出/错误日志，排查是否有权限、网络相关的上报错误。
• 链路ID格式校验：核对Stackdriver日志中打印的traceId格式，Cloud Trace要求traceId为16字节长度的十六进制字符串，格式不合法的Trace数据会被服务端直接丢弃。

内容的提问来源于stack exchange，提问作者aneri