快捷導(dǎo)航

Spring Boot Actuator自定義健康檢查教程

更新時(shí)間：2021年07月23日 08:48:48 作者：夢(mèng)想畫(huà)家

這篇文章主要介紹了Spring Boot Actuator自定義健康檢查教程，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教

健康檢查是Spring Boot Actuator中重要端點(diǎn)之一，可以非常容易查看應(yīng)用運(yùn)行至狀態(tài)。本文在前文的基礎(chǔ)上介紹如何自定義健康檢查。

1. 概述

本節(jié)我們簡(jiǎn)單說(shuō)明下依賴及啟用配置，展示缺省健康信息。首先需要引入依賴：

compile("org.springframework.boot:spring-boot-starter-actuator")

現(xiàn)在通過(guò)http://localhost:8080/actuator/health端點(diǎn)進(jìn)行驗(yàn)證：

{"status":"UP"}

缺省該端點(diǎn)返回應(yīng)用中很多組件的匯總健康信息，但可以修改屬性配置展示詳細(xì)內(nèi)容：

management:
  endpoint:
    health:
      show-details: always

現(xiàn)在再次訪問(wèn)返回結(jié)果如下：

{
  "status": "UP",
  "components": {
    "diskSpace": {
      "status": "UP",
      "details": {
        "total": 214748360704,
        "free": 112483500032,
        "threshold": 10485760,
        "exists": true
      }
    },
    "ping": {
      "status": "UP"
    }
  }
}

查看DiskSpaceHealthIndicatorProperties文件的源碼：

@ConfigurationProperties(prefix = "management.health.diskspace")
public class DiskSpaceHealthIndicatorProperties {
 /**
  * Path used to compute the available disk space.
  */
 private File path = new File(".");
 /**
  * Minimum disk space that should be available.
  */
 private DataSize threshold = DataSize.ofMegabytes(10);
 public File getPath() {
  return this.path;
 }
 public void setPath(File path) {
  this.path = path;
 }
 public DataSize getThreshold() {
  return this.threshold;
 }
 public void setThreshold(DataSize threshold) {
  Assert.isTrue(!threshold.isNegative(), "threshold must be greater than or equal to 0");
  this.threshold = threshold;
 }
}

上面結(jié)果顯示當(dāng)前項(xiàng)目啟動(dòng)的路徑 . ，報(bào)警值為10M ，這些屬性都可以通過(guò)配置進(jìn)行修改。

2. 預(yù)定義健康指標(biāo)

上面Json響應(yīng)顯示“ping”和“diskSpace”檢查。這些檢查也稱為健康指標(biāo)，如果應(yīng)用引用了數(shù)據(jù)源，Spring會(huì)增加db健康指標(biāo)；同時(shí)“diskSpace”是缺省配置。

Spring Boot包括很多預(yù)定義的健康指標(biāo)，下面列出其中一部分：

DataSourceHealthIndicator
MongoHealthIndicator
Neo4jHealthIndicator
CassandraHealthIndicator
RedisHealthIndicator
CassandraHealthIndicator
RabbitHealthIndicator
CouchbaseHealthIndicator
DiskSpaceHealthIndicator (見(jiàn)上面示例)
ElasticsearchHealthIndicator
InfluxDbHealthIndicator
JmsHealthIndicator
MailHealthIndicator
SolrHealthIndicator

如果在Spring Boot應(yīng)用中使用Mongo或Solr等，則Spring Boot會(huì)自動(dòng)增加相應(yīng)健康指標(biāo)。

3. 自定義健康指標(biāo)

Spring Boot提供了一捆預(yù)定義健康指標(biāo)，但并沒(méi)有阻止你增加自己的健康指標(biāo)。一般有兩種自定義類型檢查：

單個(gè)健康指標(biāo)組件和組合健康指標(biāo)組件。

3.1 自定義單個(gè)指標(biāo)組件

自定義需要實(shí)現(xiàn)HealthIndicator接口并重新health()方法，同時(shí)增加@Component注解。假設(shè)示例應(yīng)用程序與服務(wù)A(啟動(dòng))和服務(wù)B(關(guān)閉)通信。如果任一服務(wù)宕機(jī)，應(yīng)用程序?qū)⒈灰暈殄礄C(jī)。因此，我們將寫(xiě)入兩個(gè)運(yùn)行狀況指標(biāo)。

@Component
public class ServiceAHealthIndicator implements HealthIndicator {
    private final String message_key = "Service A";
    @Override
    public Health health() {
        if (!isRunningServiceA()) {
            return Health.down().withDetail(message_key, "Not Available").build();
        }
        return Health.up().withDetail(message_key, "Available").build();
    }
    private Boolean isRunningServiceA() {
        Boolean isRunning = true;
        // Logic Skipped
        return isRunning;
    }
}

@Component
public class ServiceBHealthIndicator implements HealthIndicator {
    private final String message_key = "Service B";
    @Override
    public Health health() {
        if (!isRunningServiceB()) {
            return Health.down().withDetail(message_key, "Not Available").build();
        }
        return Health.up().withDetail(message_key, "Available").build();
    }
    private Boolean isRunningServiceB() {
        Boolean isRunning = false;
        // Logic Skipped
        return isRunning;
    }
}

現(xiàn)在，我們看到健康監(jiān)控響應(yīng)中增加的指標(biāo)。ServerA狀態(tài)是UP，ServiceB是DOWN,因此整個(gè)監(jiān)控檢測(cè)狀態(tài)為DOWN.

{
  "status": "DOWN",
  "components": {
    "diskSpace": {
      "status": "UP",
      "details": {
        "total": 214748360704,
        "free": 112483229696,
        "threshold": 10485760,
        "exists": true
      }
    },
    "ping": {
      "status": "UP"
    },
    "serviceA": {
      "status": "UP",
      "details": {
        "Service A": "Available"
      }
    },
    "serviceB": {
      "status": "DOWN",
      "details": {
        "Service B": "Not Available"
      }
    }
  }
}

3.2 自定義組合健康檢查

前面示例很容易查看各個(gè)指標(biāo)各自的狀態(tài)。但有時(shí)需要基于幾個(gè)指標(biāo)查看資源的狀態(tài)，則需要使用 HealthContributor ，該接口沒(méi)有定義方法，僅用于標(biāo)記。如果一個(gè)服務(wù)有另外兩個(gè)動(dòng)作組合進(jìn)行實(shí)現(xiàn)，只有兩者同時(shí)工作該服務(wù)狀態(tài)才算正常。最后使用 CompositeHealthContributors組合多個(gè)指標(biāo)：

public class ServiceAHealthIndicator 
    implements HealthIndicator, HealthContributor {
...
}

下面定義組合健康檢查指標(biāo)：

@Component("UserServiceAPI")
public class UserServiceAPIHealthContributor 
    implements CompositeHealthContributor {
  
  private Map<String, HealthContributor> 
          contributors = new LinkedHashMap<>();
  @Autowired
  public UserServiceAPIHealthContributor(
      ServiceAHealthIndicator serviceAHealthIndicator, ServiceBHealthIndicator serviceBHealthIndicator) {
  
    contributors.put("serverA",  serviceAHealthIndicator);
    contributors.put("serverB", serviceBHealthIndicator);
  }
  /**
   *  return list of health contributors
   */
  @Override
  public Iterator<NamedContributor<HealthContributor>> iterator() {
    return contributors.entrySet().stream()
       .map((entry) -> NamedContributor.of(entry.getKey(), entry.getValue())).iterator();
  }
  
  @Override
  public HealthContributor getContributor(String name) {
    return contributors.get(name);
  }
}

現(xiàn)在我們使用serverA和serverB組合新的檢查UserServiceAPI。