Spring Boot集成Azure Application Insights：自定义TelemetryInitializer不自动触发问题

针对你遇到的MyCustomTelemetryInitializer.initialize()仅手动调用trackRequest时生效的问题，结合你使用的2.6.4版本依赖，以下是排查和解决步骤：

1. 修正初始化器的注册逻辑 #

在2.x版本的applicationinsights-spring-boot-starter中，仅将TelemetryInitializer注册为Spring Bean不足以让其关联到全局遥测配置，需要手动将其添加到TelemetryConfiguration的初始化器列表：

@Configuration
public class AppInsightsConfig {

    // 注册自定义初始化器Bean
    @Bean
    public TelemetryInitializer myCustomTelemetryInitializer() {
        return new MyCustomTelemetryInitializer();
    }

    // 将初始化器绑定到全局TelemetryConfiguration
    @Bean
    public TelemetryConfiguration telemetryConfiguration(TelemetryInitializer customInitializer) {
        TelemetryConfiguration activeConfig = TelemetryConfiguration.getActive();
        // 避免重复添加
        if (!activeConfig.getTelemetryInitializers().contains(customInitializer)) {
            activeConfig.getTelemetryInitializers().add(customInitializer);
        }
        return activeConfig;
    }
}

2. 确保Web请求自动跟踪开启 #

检查application.properties或application.yml中的配置，确认Web请求的自动遥测采集已启用：

# 启用Application Insights核心功能
azure.application-insights.enabled=true
# 启用Web请求自动跟踪
azure.application-insights.web.enabled=true

3. 验证初始化器的实现逻辑 #

确保你的MyCustomTelemetryInitializer实现的是正确的接口（com.microsoft.applicationinsights.extensibility.TelemetryInitializer），并且覆盖所有需要处理的遥测类型（尤其是自动采集的RequestTelemetry）：

public class MyCustomTelemetryInitializer implements TelemetryInitializer {
    @Override
    public void initialize(Telemetry telemetry) {
        // 处理自动采集的Web请求遥测
        if (telemetry instanceof RequestTelemetry) {
            RequestTelemetry requestTelemetry = (RequestTelemetry) telemetry;
            // 设置自定义操作ID，示例生成唯一标识或从请求头获取
            String customOpId = "CUSTOM-" + UUID.randomUUID().toString();
            requestTelemetry.getContext().getOperation().setId(customOpId);
        }

        // 处理依赖调用、日志等其他遥测，确保操作ID上下文一致
        if (telemetry instanceof DependencyTelemetry) {
            DependencyTelemetry depTelemetry = (DependencyTelemetry) telemetry;
            String parentOpId = ThreadContext.get("operationId");
            if (parentOpId != null) {
                depTelemetry.getContext().getOperation().setId(parentOpId);
            }
        }
    }
}

4. 使用Spring容器管理的TelemetryClient #

确保代码中使用的TelemetryClient是通过Spring注入的，而非手动实例化——手动new的TelemetryClient不会关联到配置好的全局TelemetryConfiguration：

@RestController
public class HelloController {

    // 注入Spring管理的TelemetryClient
    @Autowired
    private TelemetryClient telemetryClient;

    @GetMapping("/api/hello")
    public String hello() {
        // 自动采集的请求遥测会触发自定义初始化器
        return "Hello World";
    }
}

更优实现方式（版本升级建议） #

2.6.4版本属于较旧分支，建议升级到最新的azure-spring-boot-starter-applicationinsights（3.x+版本）：

• 自定义TelemetryInitializer只需注册为Spring Bean即可自动生效
• 内置更完善的Web请求跟踪、上下文传递机制
• 支持更多遥测类型的自动采集和初始化

内容的提问来源于stack exchange，提问作者Half Blood Prince