Spring Boot 4使用Opentelemetry OTLP协议快速集成Jaeger + Prometheus + loki 实现指标监控，链路追踪，日志聚合

效果图：

描述

在现代云原生架构中，可观测性不再是可选项，而是一项基本要求。你需要通过指标了解应用程序的运行情况，通过跟踪了解请求的流向，并通过日志了解应用程序的运行状态。

什么是Opentelemetry

官方：https://opentelemetry.io

OpenTelemetry（简称 OTel） 是一个开源的、厂商中立的 可观测性（Observability）框架和工具集，旨在统一和标准化应用程序的 指标（Metrics）、日志（Logs）和分布式追踪（Traces） 的生成、收集、处理与导出。
它由 Cloud Native Computing Foundation（CNCF） 托管，是目前云原生生态中最主流、最推荐的可观测性标准，被广泛用于微服务、Kubernetes、Serverless 等现代架构中。

为什么使用Jaeger，Prometheus，Loki

Jaeger官方描述与安装：https://www.jaegertracing.io/

prometheus官方描述与安装：https://prometheus.io/

Loki官方描述与安装：https://grafana.com/docs/loki/latest/

使用 Jaeger + Prometheus + Loki的组合，是构建现代云原生应用可观测性（Observability）体系中一种非常经典且高效的方案。它们分别专注于可观测性的不同维度，互补性强，尤其适合微服务、Kubernetes 等分布式系统环境。

Jaeger，Prometheus，Loki 原生支持OTLP协议，大大简化了配置流程，不需要中间转换，减少性能消耗

并且加入Grafana + Loki，形成 “PLGJ” 栈（Prometheus + Loki + Grafana + Jaeger），成为 CNCF 推荐的云原生可观测性黄金组合。

使用 Spring 团队提供的 OpenTelemetry Spring Boot Starter

官方描述和文档：https://spring.io/blog/2025/11/18/opentelemetry-with-spring-boot
Spring Boot 4.0 通过官方 spring-boot-starter-opentelemetry 提供了 开箱即用、协议优先（OTLP）、与 Micrometer 深度集成 的 OpenTelemetry 支持。
开发者只需少量配置，即可实现 Metrics、Traces、Logs 三位一体的可观测性，且能灵活对接任意 OTel 兼容后端。

虽然日志集成仍需手动步骤，但整体体验已非常接近“无缝”

代码

pom

只需要spring-boot-starter-opentelemetry 就可以实现 Metrics + Traces + Logs三合一

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-opentelemetry</artifactId></dependency><dependency><groupId>io.opentelemetry.instrumentation</groupId><artifactId>opentelemetry-logback-appender-1.0</artifactId><version>2.21.0-alpha</version></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-webflux</artifactId></dependency></dependencies>

配置

使用Prometheus + Jaeger otlp协议来收集数据， 可以配置Loki 用来日志收集

Prometheus开启otlp协议需要额外配置一个参数

配置地址：https://prometheus.io/docs/guides/opentelemetry/#enable-the-otlp-receiver

server: port: 8090 spring: application: name: test-service management: otlp: metrics: export: url: http://localhost:9090/api/v1/otlp/v1/metrics #Prometheus otlp协议 http地址 step: 30s opentelemetry: tracing: export: otlp: endpoint: http://localhost:4317/v1/traces #Jaeger otlp协议 grpc地址 transport: grpc # endpoint: http://localhost:4318/v1/traces # transport: http logging: export: otlp: endpoint: http://localhost:3100/otlp/v1/logs #Loki otlp协议 http地址 

采集配置

手动配置一个采集的参数

@Configuration(proxyBeanMethods =false)publicclassOpenTelemetryConfiguration{@BeanOpenTelemetryServerRequestObservationConventionopenTelemetryServerRequestObservationConvention(){returnnewOpenTelemetryServerRequestObservationConvention();}@BeanOpenTelemetryJvmCpuMeterConventionsopenTelemetryJvmCpuMeterConventions(){returnnewOpenTelemetryJvmCpuMeterConventions(Tags.empty());}@BeanProcessorMetricsprocessorMetrics(){returnnewProcessorMetrics(List.of(),newOpenTelemetryJvmCpuMeterConventions(Tags.empty()));}@BeanJvmMemoryMetricsjvmMemoryMetrics(){returnnewJvmMemoryMetrics(List.of(),newOpenTelemetryJvmMemoryMeterConventions(Tags.empty()));}@BeanJvmThreadMetricsjvmThreadMetrics(){returnnewJvmThreadMetrics(List.of(),newOpenTelemetryJvmThreadMeterConventions(Tags.empty()));}@BeanClassLoaderMetricsclassLoaderMetrics(){returnnewClassLoaderMetrics(newOpenTelemetryJvmClassLoadingMeterConventions());}}

日志配置

1. 创建 src/main/resources/logback-spring.xml:

<?xml version="1.0" encoding="UTF-8"?><configuration><includeresource="org/springframework/boot/logging/logback/base.xml"/><appendername="OTEL"class="io.opentelemetry.instrumentation.logback.appender.v1_0.OpenTelemetryAppender"></appender><rootlevel="INFO"><appender-refref="CONSOLE"/><appender-refref="OTEL"/></root></configuration>

2. 配置

@ComponentclassInstallOpenTelemetryAppenderimplementsInitializingBean{privatefinalOpenTelemetry openTelemetry;InstallOpenTelemetryAppender(OpenTelemetry openTelemetry){this.openTelemetry = openTelemetry;}@OverridepublicvoidafterPropertiesSet(){OpenTelemetryAppender.install(this.openTelemetry);}}

@ComponentclassTraceIdFilterimplementsWebFilter{privatefinalTracer tracer;TraceIdFilter(Tracer tracer){this.tracer = tracer;}@OverridepublicMono<Void>filter(ServerWebExchange exchange,WebFilterChain chain){String traceId =getTraceId();if(traceId !=null){ exchange.getRequest().mutate().header("X-Trace-Id", traceId).build();}return chain.filter(exchange);}private@NullableStringgetTraceId(){TraceContext context =this.tracer.currentTraceContext().context();return context !=null? context.traceId():null;}}

实现一个接口

@RestControllerpublicclassTestController{@GetMapping("/test")publicMono<String>test(){returnMono.just("Hello World!");}}

多运行几次接口

效果