Prometheus Grafana OpenTelemetry 体系笔记

在Spring Boot 3中使用Grafana、OpenTelemetry和Prometheus实现分布式链路追踪监控可按以下步骤进行： ### 技术选型与理由 - **Spring Boot**：提供快速、便捷的微服务开发框架，拥有庞大的社区和成熟的生态，与监控组件集成方便。 - **OpenTelemetry (OTel)**：CNCF的重点项目，整合了OpenTracing和OpenCensus，提供标准化、厂商中立的遥测数据（Traces, Metrics, Logs）采集方案。其Java Agent的自动插桩能力降低了接入成本，且不被特定监控后端绑定，未来可灵活切换监控系统 [^1]。 - **Prometheus**：强大的数据模型和查询语言（PromQL）适合处理高基数的指标数据，是云原生监控领域的事实标准之一 [^1]。 - **Grafana**：提供强大的可视化定制能力，可将Prometheus采集的数据进行直观展示 [^1]。 ### 关键实现步骤 #### 1. 引入依赖 在`pom.xml`中添加相关依赖： ```xml <dependencies> <!-- Spring Boot Actuator for metrics --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <!-- OpenTelemetry for tracing and metrics --> <dependency> <groupId>io.micrometer</groupId> <artifactId>micrometer-tracing-bridge-opentelemetry</artifactId> </dependency> <dependency> <groupId>io.opentelemetry</groupId> <artifactId>opentelemetry-exporter-prometheus</artifactId> </dependency> <!-- Prometheus support --> <dependency> <groupId>io.micrometer</groupId> <artifactId>micrometer-registry-prometheus</artifactId> </dependency> </dependencies> ``` #### 2. 配置OpenTelemetry 可通过配置文件或Java代码进行配置。以下是配置文件示例`application.properties`： ```properties # Enable OpenTelemetry management.tracing.enabled=true # Configure OpenTelemetry exporter for Prometheus management.metrics.export.prometheus.enabled=true ``` #### 3. 配置Prometheus 创建`prometheus.yml`文件，配置Prometheus以采集Spring Boot应用的指标： ```yaml global: scrape_interval: 15s scrape_configs: - job_name: 'spring-boot-app' metrics_path: '/actuator/prometheus' static_configs: - targets: ['localhost:8080'] ``` #### 4. 启动Prometheus 在命令行中启动Prometheus： ```sh prometheus --config.file=prometheus.yml ``` #### 5. 配置Grafana - 启动Grafana服务。 - 登录Grafana控制台，添加Prometheus作为数据源。 - 创建仪表盘，使用Grafana的可视化定制能力展示Prometheus采集的指标和OpenTelemetry的链路追踪数据。 #### 6. 集成Jaeger（可选） 如果需要更强大的链路追踪可视化和分析功能，可集成Jaeger： - 引入Jaeger依赖： ```xml <dependency> <groupId>io.opentelemetry</groupId> <artifactId>opentelemetry-exporter-jaeger</artifactId> </dependency> ``` - 配置Jaeger exporter： ```properties otel.traces.exporter=jaeger otel.exporter.jaeger.endpoint=http://localhost:14250 ``` ### 代码详解 Spring Boot 3.x官方推荐集成OpenTelemetry实现分布式追踪，替代Spring Cloud Sleuth，具有零侵入、轻量级、高性能的特点 [^2]。通过OpenTelemetry的Java Agent自动插桩，可降低接入成本，采集应用的Traces、Metrics和Logs数据。Prometheus采集这些指标数据，Grafana进行可视化展示，当Prometheus的指标告警时，可在Grafana面板上关联到Jaeger的链路追踪数据，方便定位问题 [^1]。