Spring Cloud GCP Trace采样概率配置不生效问题求助

问题背景 #

尝试将GCP追踪的采样概率设置为100%，但配置management.tracing.sampling.probability=1.0未生效，仅约0.1%的请求出现在GCP Trace Explorer中。所有请求已分配traceId，且带有X-B3-Sampled=1请求头的请求100%会显示在Trace Explorer中。

环境配置：

• Spring Boot 3.2.6
• Micrometer实现可观测性
• spring-cloud-gcp 5.4.3

原因分析 #

在Spring Cloud GCP 5.x版本中，GCP Trace的采样逻辑会覆盖Spring Boot通用的management.tracing配置。默认情况下，GCP Trace自身采样器的默认采样率为0.1%，与观测到的现象匹配。

解决方案 #

1. 使用GCP Trace专属采样配置 #

替换通用配置为Spring Cloud GCP Trace的专属配置，在application.yaml中添加：

spring:
  cloud:
    gcp:
      trace:
        sampling:
          probability: 1.0

该配置直接控制GCP Trace采样器的采样概率，优先级高于通用的management.tracing.sampling.probability。

2. 强制自定义采样器（若上述配置仍不生效） #

如果专属配置无效，可通过自定义Sampler Bean强制100%采样：

import io.micrometer.tracing.Sampler;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TracingConfig {

    @Bean
    public Sampler sampler() {
        return Sampler.ALWAYS_SAMPLE;
    }
}

该Bean会覆盖默认采样器，确保所有请求都被采样并发送至GCP Trace。

3. 排查依赖冲突 #

确认spring-cloud-gcp-starter-trace依赖未排除采样相关关键组件，同时检查项目中是否引入其他Trace类依赖（如Zipkin）导致采样逻辑冲突。

验证方法 #

修改配置后重启服务，发送测试请求，检查GCP Trace Explorer中是否所有请求均被追踪；也可通过日志查看X-B3-Sampled头是否自动设置为1，确认采样逻辑生效。

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