此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.4.0！spring-doc.cn

驱动器

Spring Boot 包括 Spring Boot Actuator。本节回答了使用它时经常出现的问题。spring-doc.cn

更改 Actuator 端点的 HTTP 端口或地址

在独立应用程序中，Actuator HTTP 端口默认与主 HTTP 端口相同。要使应用程序侦听其他端口，请设置 external 属性：。要侦听完全不同的网络地址（例如，当您有一个用于管理的内部网络和一个用于用户应用程序的外部网络时），您还可以设置为服务器能够绑定到的有效 IP 地址。management.server.portmanagement.server.addressspring-doc.cn

有关更多详细信息，请参阅 ManagementServerProperties 源代码和“生产就绪功能”部分中的自定义 Management Server 端口。spring-doc.cn

自定义 Sanitization

要控制清理，请定义 SanitizingFunction bean。调用函数时使用的 SanitizableData 提供对键和值以及它们来自的 PropertySource 的访问。例如，这允许您清理来自特定属性源的每个值。每个 SanitizingFunction 都会按顺序调用，直到函数更改可清理数据的值。spring-doc.cn

将运行状况指示器映射到 Micrometer Metrics

Spring Boot 运行状况指示器返回 Status 类型以指示整体系统运行状况。如果要监控特定应用程序的运行状况级别或发出警报，可以使用 Micrometer 将这些状态导出为指标。默认情况下，Spring Boot 使用状态代码 “UP”、“DOWN”、“OUT_OF_SERVICE” 和 “UNKNOWN”。要导出这些，您需要将这些状态转换为一组数字，以便它们可以与 Micrometer Gauge 一起使用。spring-doc.cn

以下示例显示了编写此类 exporter 的一种方法：spring-doc.cn

Javaspring-doc.cn
Kotlinspring-doc.cn

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
	}

}