>文章首發於公眾號《程式設計師果果》
>地址：https://mp.weixin.qq.com/s/MWQImwMhcFglmHZ4lIcxVA

## 簡介
Spring Boot 自帶監控功能 Actuator，可以幫助實現對程式內部執行情況監控，比如監控狀況、Bean載入情況、環境變數、日誌資訊、執行緒資訊等。這一節結合 Prometheus 、Grafana 來更加直觀的展示這些資訊。

## 實驗
### 說明

|服務名 | 地址 | 埠 |
|:------ | :------: | :------: |
|Prometheus | 172.16.2.101 | 9090 | 
|Grafana | 172.16.2.101| 3000 |
|Spring Boot Demo | 172.16.2.204| 8080 |

### 建立專案
建立用於測試的 Spring Boot 專案，主要程式碼如下。

#### pom.xml
```xml
<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-actuator</artifactid>
</dependency>
<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-web</artifactid>
</dependency>
<dependency>
    <groupid>io.micrometer</groupid>
    <artifactid>micrometer-registry-prometheus</artifactid>
</dependency>

<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-test</artifactid>
    <scope>test</scope>
</dependency>
```

#### application.yml
```yml
management:
  endpoints:
    web:
      exposure:
        include: '*'

endpoint:
    health:
      show-details: always

metrics:
    tags:
      application: actuator-demo
```

- management.endpoints.web.exposure.include：大多數actuator的埠都不會透過http公開，* 代表公開所有這些端點。對於生產環境，應該仔細選擇要公開的端點。
- management.metrics.tags.application：為應用設定 tag ，方便區分不同的應用。

#### 啟動類
```java
@SpringBootApplication
@RestController
public class SpringbootActuatorPrometheusDemoApplication {

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

@RequestMapping(value = "/hello")
    public String  sayHello() {
        for (int i = 1 ; i <= 10 ; i++) {
            Thread t = new Thread(() -> {
                try {
                    Thread.sleep(5000);
                } catch (InterruptedException e) {
                    e.printStackTrace();
                }
            } , "HelloThread - " + i);
            t.start();
        }
        return "ok";
    }

/**
    @Bean
    MeterRegistryCustomizer<meterregistry> metricsCommonTags() {
        return registry -> registry.config().commonTags("application", "springboot-actuator-prometheus-demo");
    }
    */

}
```

### 配置 Prometheus 和 Grafana
在 prometheus.yml 中新增針對該 Spring Boot 應用 的監控 job

```
- job_name: 'actuator-demo'
    metrics_path: '/prometheus'
    static_configs:
    - targets: ['172.16.2.204:8080']
```

執行 Prometheus 和 Grafana：

```shell
docker start prometheus grafana
```

訪問 Prometheus UI http://172.16.2.101:9090 ，檢視 targets ，可以看到 job 處於 UP 狀態，說明配置成功了。

![](http://img.blog.itpub.net/blog/2019/10/22/b97f7ed7da7ca9cc.png?x-oss-process=style/bb)

Grafana UI http://172.16.2.101:3000，透過Grafana的 **+**  圖示匯入(Import) JVM (Micrometer) dashboard：

- grafana id = 4701
- 注意選中prometheus資料來源

檢視JVM (Micormeter) dashboard：

![](http://img.blog.itpub.net/blog/2019/10/22/b5d3b38e78e83a1e.png?x-oss-process=style/bb)

可以看到應用的 JVM 的 堆疊、 執行緒、 IO 等等資訊。

## 原始碼
https://github.com/gf-huanchupk/SpringBootLearning/tree/master/springboot-actuator-prometheus

## 參考
https://micrometer.io/docs/registry/prometheus  
https://prometheus.io/docs/prometheus

## 往期內容
- [Prometheus 入門](https://mp.weixin.qq.com/s/BjZyNcWEgflJMnjfceiluw)
- [Prometheus 與 Grafana 整合](https://mp.weixin.qq.com/s/GImvM_F2XlMjO0a5xnJuFg)
- [Prometheus 整合 AlertManager](https://mp.weixin.qq.com/s/wkfIQc3IQD_6y7eCsGd_Rw)
- [Prometheus 整合 Node Exporter](https://mp.weixin.qq.com/s/40ULB9UWbXVA21MxqnjBxw)</meterregistry>

Spring Boot Actuator 整合 Prometheus

相關文章