|
此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.3.4！ |
|
此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.3.4！ |
Spring Boot 包括 Spring Boot Actuator。 本节回答了使用它时经常出现的问题。
更改 Actuator 端点的 HTTP 端口或地址
在独立应用程序中，Actuator HTTP 端口默认与主 HTTP 端口相同。
要使应用程序侦听其他端口，请设置 external 属性： 。
要侦听完全不同的网络地址（例如，当您有一个用于管理的内部网络和一个用于用户应用程序的外部网络时），您还可以设置为服务器能够绑定到的有效 IP 地址。management.server.portmanagement.server.address
有关更多详细信息，请参阅源代码和“生产就绪功能”部分中的自定义管理服务器端口。ManagementServerProperties
自定义 'whitelabel' 错误页面
Spring Boot 会安装一个“whitelabel”错误页面，如果您遇到服务器错误，您会在浏览器客户端中看到该页面（使用 JSON 和其他媒体类型的机器客户端应该看到带有正确错误代码的合理响应）。
设置为关闭默认错误页面。
这样做将恢复您正在使用的 Servlet 容器的默认值。
请注意， Spring Boot 仍然尝试解决错误视图，因此您可能应该添加自己的错误页面，而不是完全禁用它。server.error.whitelabel.enabled=false |
用您自己的页面覆盖错误页面取决于您使用的模板技术。
例如，如果使用 Thymeleaf，则可以添加模板。
如果您使用 FreeMarker，则可以添加模板。
通常，您需要使用 name 解析的 a 或处理路径的 a。
除非你替换了一些默认配置，否则你应该在你的 中找到 a，所以 a named 将是实现此目的的一种方式。
有关更多选项，请参阅 ErrorMvcAutoConfiguration 。error.htmlerror.ftlhViewerror@Controller/errorBeanNameViewResolverApplicationContext@Beanerror
有关如何在 servlet 容器中注册处理程序的详细信息，另请参阅错误处理部分。
设置为关闭默认错误页面。
这样做将恢复您正在使用的 Servlet 容器的默认值。
请注意， Spring Boot 仍然尝试解决错误视图，因此您可能应该添加自己的错误页面，而不是完全禁用它。server.error.whitelabel.enabled=false |
自定义 Sanitization
要控制清理，请定义一个 bean。
调用函数时使用的 提供对键和值以及它们的来源的访问。
例如，这允许您清理来自特定属性源的每个值。
每个 Cookie 都会按顺序调用，直到函数更改可清理数据的值。SanitizingFunctionSanitizableDataPropertySourceSanitizingFunction
将运行状况指示器映射到 Micrometer Metrics
Spring Boot 运行状况指示器返回一个类型来指示整体系统运行状况。
如果要监控特定应用程序的运行状况级别或发出警报，可以使用 Micrometer 将这些状态导出为指标。
默认情况下，Spring Boot 使用状态代码 “UP”、“DOWN”、“OUT_OF_SERVICE” 和 “UNKNOWN”。
要导出这些值，您需要将这些状态转换为一组数字，以便它们可以与 Micrometer 一起使用。StatusGauge
以下示例显示了编写此类 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
}
}