使用Prometheus和Grafana监控Spring Boot应用_Java教程

1 简介

每个部署到生产环境的应用程序都需要监控方式来评估其性能情况，这可以帮助开发人员判断应用程序是否按预期运行，是否需要采取措施以达到期望的性能水平。这些数据被称为应用程序性能指标（APM），现在有许多商业工具如Newrelic、Datadog APM等提供这些功能的SAAS服务。

本文介绍两个开源工具：Grafana和Prometheus。Prometheus以时间序列格式收集和存储指标数据，而Grafana使用Prometheus作为数据源，在仪表板上可视化这些数据。

我们从创建一个应用程序并使用Grafana进行监控开始。

2 创建Spring Boot应用程序

访问https://start.spring.io，创建一个带有以下依赖项的简单应用程序。

Spring Boot Actuator（运维）
Prometheus（可观测性）
Spring Web（可选：仅用于创建一个简单的REST控制器。）

接下来，需要通过一个管理端点暴露出来，Prometheus将使用该端点以Prometheus可理解的格式收集指标数据。为此，添加以下属性。

management:
  endpoints:
    web:
      exposure:
        include:
        - prometheus

然后，添加一个简单的控制器，用于生成一些警告日志。将使用它来监控收到的警告数量。

@RestController
@SpringBootApplication
public class PrometheusIntegrationApplication {

    final static Logger logger = LoggerFactory.getLogger(PrometheusIntegrationApplication.class);

    public static void main(String[] args) {
        SpringApplication.run(PrometheusIntegrationApplication.class, args);
    }

    @GetMapping("/something")
    public ResponseEntity<String> createLogs() {
        logger.warn("Just checking");
        return ResponseEntity.ok().body("All Ok");
    }

有了这些，来启动应用程序并打开以下URL。

http://localhost:8080/actuator/prometheus

3 理解指标数据

在打开上述端点后，会发现以下格式的一些指标数据：

jvm_memory_used_bytes{area="heap",id="G1 Survivor Space",} 1005592.0

第一部分jvm_memory_used_bytes被称为标签（label），而花括号内的字段被称为属性（attribute）。每个标签代表一个特定的指标，属性提供了一种查询方式，以获取值。

接下来，配置Prometheus来读取这些数据。

4 配置Prometheus

为了启动Prometheus，使用一个Prometheus Docker镜像，并提供一些配置来从应用程序中收集指标数据。它通过创建作业来从端点抓取数据。因此，在prometheus.yaml配置文件中定义作业，如下所示。

scrape_configs:
  - job_name: 'Spring Boot Application input'
    metrics_path: '/actuator/prometheus'
    scrape_interval: 2s
    static_configs:
      - targets: ['localhost:8000']
        labels:
          application: "My Spring Boot Application"

在这里，定义了一个作业，每2秒调用应用程序上的管理端点以获取指标数据。

接下来，创建一个docker-compose文件，用于启动和运行Prometheus Docker镜像。

services:
  prometheus:
      image: prom/prometheus:v2.35.0
      network_mode: host
      container_name: prometheus
      restart: unless-stopped
      volumes:
        - ./data/prometheus/config:/etc/prometheus/
      command:
        - "--config.file=/etc/prometheus/prometheus.yaml"

在这里，将配置文件挂载到/etc/prometheus位置，并将配置文件的位置作为命令的参数。为了简单起见，使用了主机网络模式，这样Prometheus可以直接访问应用程序端点。

有了这些，使用docker compose up启动docker镜像，并在浏览器上打开URL http://localhost:9090。

现在搜索标签logback_events_total。

使用Prometheus和Grafana监控Spring Boot应用图片

正如所看到的，可以看到Prometheus在特定时间收集的指标。

如果找不到该标签，可以通过导航到“Status > Targets”来检查作业是否正在运行。应该看到状态为“UP”，如下所示。

使用Prometheus和Grafana监控Spring Boot应用图片

因此，通过这种方式，数据每2秒就会被摄入到Prometheus中。

现在使用Grafana来可视化这些数据。

5 在Grafana中可视化指标

使用Grafana的Docker镜像，将其添加到docker-compose文件中。

grafana:
    image: grafana/grafana-oss:8.5.2
    pull_policy: always
    network_mode: host
    container_name: grafana
    restart: unless-stopped
    links:
      - prometheus:prometheus
    volumes:
      - ./data/grafana:/var/lib/grafana
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin
      - GF_SERVER_DOMAIN=localhost

在这里，也使用了主机网络模式，以便和Grafana可以轻松访问Prometheus端点。

接下来，打开URL http://localhost:3000，使用用户名和密码“admin”访问Grafana。