此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.4.0! |
驱动器
Spring Boot 包括 Spring Boot Actuator。 本节回答了使用它时经常出现的问题。
更改 Actuator 端点的 HTTP 端口或地址
在独立应用程序中,Actuator HTTP 端口默认与主 HTTP 端口相同。
要使应用程序侦听其他端口,请设置 external 属性:management.server.port
.
要侦听完全不同的网络地址(例如,当您有一个用于管理的内部网络和一个用于用户应用程序的外部网络时),您还可以设置management.server.address
设置为服务器能够绑定到的有效 IP 地址。
有关更多详细信息,请参阅ManagementServerProperties
源代码和自定义 Management Server 端口。
自定义 Sanitization
要控制清理,请定义一个SanitizingFunction
豆。
这SanitizableData
调用函数时,提供对 key 和 value 的访问,以及PropertySource
他们从那里来。
例如,这允许您清理来自特定属性源的每个值。
每SanitizingFunction
的顺序调用,直到函数更改可清理数据的值。
将运行状况指示器映射到 Micrometer Metrics
Spring Boot 运行状况指示器返回一个Status
键入以指示整体系统运行状况。
如果要监控特定应用程序的运行状况级别或发出警报,可以使用 Micrometer 将这些状态导出为指标。
默认情况下,Spring Boot 使用状态代码 “UP”、“DOWN”、“OUT_OF_SERVICE” 和 “UNKNOWN”。
要导出这些,您需要将这些状态转换为一组数字,以便它们可以与 Micrometer 一起使用Gauge
.
以下示例显示了编写此类 exporter 的一种方法:
-
Java
-
Kotlin
import io.micrometer.core.instrument.Gauge;
import io.micrometer.core.instrument.MeterRegistry;
import org.springframework.boot.actuate.health.HealthEndpoint;
import org.springframework.boot.actuate.health.Status;
import org.springframework.context.annotation.Configuration;
@Configuration(proxyBeanMethods = false)
public class MyHealthMetricsExportConfiguration {
public MyHealthMetricsExportConfiguration(MeterRegistry registry, HealthEndpoint healthEndpoint) {
// This example presumes common tags (such as the app) are applied elsewhere
Gauge.builder("health", healthEndpoint, this::getStatusCode).strongReference(true).register(registry);
}
private int getStatusCode(HealthEndpoint health) {
Status status = health.health().getStatus();
if (Status.UP.equals(status)) {
return 3;
}
if (Status.OUT_OF_SERVICE.equals(status)) {
return 2;
}
if (Status.DOWN.equals(status)) {
return 1;
}
return 0;
}
}
import io.micrometer.core.instrument.Gauge
import io.micrometer.core.instrument.MeterRegistry
import org.springframework.boot.actuate.health.HealthEndpoint
import org.springframework.boot.actuate.health.Status
import org.springframework.context.annotation.Configuration
@Configuration(proxyBeanMethods = false)
class MyHealthMetricsExportConfiguration(registry: MeterRegistry, healthEndpoint: HealthEndpoint) {
init {
// This example presumes common tags (such as the app) are applied elsewhere
Gauge.builder("health", healthEndpoint) { health ->
getStatusCode(health).toDouble()
}.strongReference(true).register(registry)
}
private fun getStatusCode(health: HealthEndpoint) = when (health.health().status) {
Status.UP -> 3
Status.OUT_OF_SERVICE -> 2
Status.DOWN -> 1
else -> 0
}
}