Spring Boot 3.4.2集成OpenTelemetry日志导出配置问题排查

1. 确认Maven依赖完整性与版本兼容性 #

首先检查依赖是否覆盖了所有必要组件，Spring Boot 3.4.2需匹配对应的OpenTelemetry版本（建议1.30.x以上）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-actuator-autoconfigure</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry.instrumentation</groupId>
    <artifactId>opentelemetry-logback-appender-1.0</artifactId>
    <version>1.30.0</version>
</dependency>

注意：若自定义了依赖管理，需确保OpenTelemetry相关版本与Spring Boot的依赖约束兼容，避免版本冲突导致自动配置失效。

2. 验证核心配置是否生效 #

management.otlp.logs.enabled默认是false，这是最容易忽略的点，必须显式开启并配置完整属性：

# 强制开启OTLP日志导出
management.otlp.logs.enabled=true
# 配置OTLP Collector的HTTP端点（根据实际部署地址调整）
management.otlp.logs.endpoint=http://localhost:4318/v1/logs
# 指定导出协议（默认http/protobuf，无需修改除非有特殊需求）
management.otlp.logs.protocol=http/protobuf
# 设置服务标识，便于日志溯源
spring.application.name=your-service-id

若使用YAML配置，需保证缩进和键名拼写完全正确，避免语法错误导致配置不加载。

3. 检查Logback Appender配置正确性 #

确保OpenTelemetryAppender被正确关联到目标Logger，常见错误包括类路径写错、未绑定到Logger：

<configuration>
    <appender name="OTEL" class="io.opentelemetry.instrumentation.logback.appender.v1_0.OpenTelemetryAppender">
        <!-- 可选：同步导出（默认异步，若需调试可临时开启） -->
        <sync>false</sync>
    </appender>

    <!-- 将OTEL Appender绑定到根Logger，或指定业务Logger -->
    <root level="INFO">
        <appender-ref ref="OTEL"/>
        <appender-ref ref="CONSOLE"/> <!-- 保留控制台输出便于调试 -->
    </root>
</configuration>

额外注意：若Logger级别设置过高（比如root设为ERROR），INFO级别的业务日志不会流入OTEL Appender。

4. 排查自动配置类是否被禁用 #

Spring Boot的OTLP日志自动配置类是OtlpLogsAutoConfiguration，需确保未被排除：

• 检查启动类的@SpringBootApplication注解是否有exclude属性排除该类
• 检查配置文件中spring.autoconfigure.exclude是否包含该类

若自动配置被意外排除，可手动注入OtlpHttpLogRecordExporter：

@Configuration
public class OtelLogCustomConfig {
    @Bean
    public OtlpHttpLogRecordExporter otlpHttpLogRecordExporter(OtlpLogsProperties properties) {
        return OtlpHttpLogRecordExporter.builder()
                .setEndpoint(properties.getEndpoint())
                .setProtocol(properties.getProtocol())
                .build();
    }
}

5. 调试定位Bean注入问题 #

若OtlpHttpLogRecordExporter未被注入，可通过以下方式排查：

• 开启调试日志，查看自动配置加载情况：

logging.level.org.springframework.boot.autoconfigure=DEBUG
logging.level.io.opentelemetry=DEBUG

启动后搜索OtlpLogsAutoConfiguration，确认其是否被激活，以及OtlpHttpLogRecordExporter的创建日志。

• 手动触发日志输出（比如在启动类中添加logger.info("Test OTEL log")），抓包验证是否有HTTP请求发送到配置的OTLP端点。

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