Java SpringBoot Prometheus Grafana

一、背景

SpringBoot的应用监控方案比较多,SpringBoot+Prometheus+Grafana是目前比较常用的方案之一。它们三者之间的关系大概如下图:
关系图

二、开发SpringBoot应用

首先,创建一个SpringBoot项目,pom文件如下:

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-actuator</artifactId>
  4. </dependency>
  5. <dependency>
  6. <groupId>org.springframework.boot</groupId>
  7. <artifactId>spring-boot-starter-web</artifactId>
  8. </dependency>
  9. <dependency>
  10. <groupId>org.projectlombok</groupId>
  11. <artifactId>lombok</artifactId>
  12. <optional>true</optional>
  13. </dependency>
  14. <!-- https://mvnrepository.com/artifact/io.prometheus/simpleclient_spring_boot -->
  15. <dependency>
  16. <groupId>io.prometheus</groupId>
  17. <artifactId>simpleclient_spring_boot</artifactId>
  18. <version>0.8.1</version>
  19. </dependency>
  20. <dependency>
  21. <groupId>org.springframework.boot</groupId>
  22. <artifactId>spring-boot-starter-security</artifactId>
  23. </dependency>

注意: 这里的SpringBoot版本是1.5.7.RELEASE,之所以不用最新的2.X是因为最新的simpleclient_spring_boot只支持1.5.X,不确定2.X版本的能否支持。
MonitorDemoApplication启动类增加注解

  1. import io.prometheus.client.spring.boot.EnablePrometheusEndpoint;
  2. import io.prometheus.client.spring.boot.EnableSpringBootMetricsCollector;
  3. import org.springframework.boot.SpringApplication;
  4. import org.springframework.boot.autoconfigure.SpringBootApplication;
  5. @EnablePrometheusEndpoint
  6. @EnableSpringBootMetricsCollector
  7. @SpringBootApplication
  8. public class MonitorDemoApplication {
  9. public static void main(String[] args) {
  10. SpringApplication.run(MonitorDemoApplication.class, args);
  11. }
  12. }

配置文件application.yml

  1. server:
  2. port: 8848
  3. spring:
  4. application:
  5. name: monitor-demo
  6. security:
  7. user:
  8. name: admin
  9. password: 1234
  10. basic:
  11. enabled: true
  12. # 安全路径列表,逗号分隔,此处只针对/admin路径进行认证
  13. path: /admin
  14. # actuator暴露接口的前缀
  15. management:
  16. context-path: /admin
  17. # actuator暴露接口使用的端口,为了和api接口使用的端口进行分离
  18. port: 8888
  19. security:
  20. enabled: true
  21. roles: SUPERUSER

测试代码TestController

  1. @RequestMapping("/heap/test")
  2. @RestController
  3. public class TestController {
  4. public static final Map<String, Object> map = new ConcurrentHashMap<>();
  5. @RequestMapping("")
  6. public String testHeapUsed() {
  7. for (int i = 0; i < 10000000; i++) {
  8. map.put(i + "", new Object());
  9. }
  10. return "ok";
  11. }
  12. }

这里的逻辑就是在请求这个接口后,创建大量对象保存到map中增加堆内存使用量,方便后面测试邮件报警。
启动项目后,可以在IDEA中看到有很多Endpoints,如图:
Spring Boot   Prometheus   Grafana 打造可视化监控 - 图2
启动完毕,访问http://localhost:8888/admin/prometheus就可以看到服务暴露的那些监控指标了。
监控指标
注意:由于开启了安全认证,所以访问这个URL的需要提示输入账号/密码,如果提示404请检查下请求地址是否正确,如果不设置management.context-path则默认地址是http://ip:port/prometheus

三、安装Prometheus

下载地址https://prometheus.io/download/,本文下载的是Windows版本prometheus-2.17.2.windows-amd64.tar.gz。
解压后修改prometheus.yml文件,配置数据采集的目标信息。

  1. scrape_configs:
  2. # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
  3. # - job_name: 'prometheus'
  4. # metrics_path defaults to '/metrics'
  5. # scheme defaults to 'http'.
  6. # static_configs:
  7. # - targets: ['localhost:9090']
  8. - job_name: 'monitor-demo'
  9. scrape_interval: 5s # 刮取的时间间隔
  10. scrape_timeout: 5s
  11. metrics_path: /admin/prometheus
  12. scheme: http
  13. basic_auth: #认证信息
  14. username: admin
  15. password: 1234
  16. static_configs:
  17. - targets:
  18. - 127.0.0.1:8888 #此处填写 Spring Boot 应用的 IP + 端口号

更多配置信息请查看官方文档。
现在可以启动Prometheus了,命令行输入:prometheus.exe --config.file=prometheus.yml 访问http://localhost:9090/targets,查看Spring Boot采集状态是否正常。
Spring Boot   Prometheus   Grafana 打造可视化监控 - 图4
采集目标信息

四、安装Grafana

下载地址https://grafana.com/grafana/download,这里用到的是Windows版本grafana-6.3.3.windows-amd64.zip。
解压后运行bin目录下的grafana-server.exe启动,游览器访问http://localhost:3000即可看到登录页面,默认账号密码是admin/admin。
现在开始创建自己的可视化监控面板。

1.设置数据源

Spring Boot   Prometheus   Grafana 打造可视化监控 - 图5

2. 创建一个Dashboard

Spring Boot   Prometheus   Grafana 打造可视化监控 - 图6
Spring Boot   Prometheus   Grafana 打造可视化监控 - 图7

3. 填写采集的指标点

Spring Boot   Prometheus   Grafana 打造可视化监控 - 图8
注意: 这里的指标点不能随便填,必须是已有的可以在 Prometheus看到。
采集指标

4.选择图表样式

Spring Boot   Prometheus   Grafana 打造可视化监控 - 图10

5.填写标题描述

Spring Boot   Prometheus   Grafana 打造可视化监控 - 图11
最后点击右上角的保存,输入Dashboad的名称即可。
结果展示
Tips: 这里的图表布局是可以用鼠标拖动的

五、添加邮件报警

在实际项目中当监控的某的个指标超过阈值(比如CPU使用率过高),希望监控系统自动通过短信、钉钉和邮件等方式报警及时通知运维人员,Grafana就支持该功能。

第一步: 点击[Alerting]——>[Notification channels]添加通知通道

创建通道
编辑
这里的Type有很多选项,包括webhook、钉钉等,这里以邮件为例。

第二步: 邮箱配置

Grafana默认使用conf目录下defaults.ini作为配置文件运行,根据官方的建议不要更改defaults.ini而是在同级目录下新建一个配置文件custom.ini。以腾讯企业邮箱为例,配置如下:

  1. #################################### SMTP / Emailing #####################
  2. [smtp]
  3. enabled = true
  4. host = smtp.exmail.qq.com:465
  5. user = xxxx@ininin.com
  6. # If the password contains # or ; you have to wrap it with triple quotes. Ex """#password;"""
  7. password = XXX
  8. cert_file =
  9. key_file =
  10. skip_verify = true
  11. from_address = xxxx@ininin.com
  12. from_name = Grafana
  13. ehlo_identity = ininin.com

然后需要重启Grafana,命令grafana-server.exe -config=E:\file\grafana-6.3.3\conf\custom.ini

第三步: 为指标添加alert

配置预警规则
配置预警规则
配置通知方式和信息
配置通知方式和信息

Evaluate every 表示检测评率,这里为了测试效果,改为1秒 For 如果警报规则配置了For,并且查询违反了配置的阈值,那么它将首先从OK变为Pending。从OK到Pending Grafana不会发送任何通知。一旦警报规则的触发时间超过持续时间,它将更改为Alerting并发送警报通知。 Conditions when 表示什么时间,of 表示条件,is above 表示触发值 同时,设置了is above后会有一条红线。 If no data or all values are null 如果没有数据或所有值都为空,这里选择触发报警 If execution error or timeout 如果执行错误或超时,这里选择触发报警

注意: 下一次触发,比如10秒后,它不会再次触发,防止报警风暴产生!

第四步: 测试

请求http://localhost:8848/heap/test接口后,内存升高大于设置的阈值,然后就收到报警邮件。
报警邮件