跳到主要内容

与 Actuator 集成

DeepSeek V3 中英对照 Integrating with Actuator

Spring Boot Actuator 在存在 META-INF/build-info.properties 文件时,会显示与构建相关的信息。build-info 目标会生成一个包含项目坐标和构建时间的文件。它还允许您添加任意数量的附加属性,如下例所示:

<project>
<modelVersion>4.0.0</modelVersion>
<artifactId>build-info</artifactId>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<executions>
<execution>
<goals>
<goal>build-info</goal>
</goals>
<configuration>
<additionalProperties>
<encoding.source>UTF-8</encoding.source>
<encoding.reporting>UTF-8</encoding.reporting>
<java.version>${java.version}</java.version>
</additionalProperties>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
xml

此配置将在预期位置生成一个 build-info.properties 文件,并包含三个额外的键。

备注

java.version 预计是项目中可用的常规属性。它会按照你的预期进行插值。

spring-boot:build-info

org.springframework.boot:spring-boot-maven-plugin:3.4.2

根据当前 MavenProject 的内容生成一个 build-info.properties 文件。

可选参数

名称类型默认值
additionalPropertiesMap
excludeInfoPropertiesList
outputFileFile${project.build.outputDirectory}/META-INF/build-info.properties
skipbooleanfalse
timeString${project.build.outputTimestamp}

参数详情

additionalProperties

要在 build-info.properties 文件中存储的额外属性。生成的 build-info.properties 文件中的每个条目都以前缀 build. 开头。

名称additionalProperties
类型java.util.Map
默认值
用户属性
自版本

excludeInfoProperties

应从 build-info.properties 文件中排除的属性。可用于排除标准的 groupartifactnameversiontime 属性,以及 additionalProperties 中的项目。

名称excludeInfoProperties
类型java.util.List
默认值
用户属性
自版本

outputFile

生成 build-info.properties 文件的位置。

名称outputFile
类型java.io.File
默认值${project.build.outputDirectory}/META-INF/build-info.properties
用户属性

skip

跳过执行。

名称skip
类型boolean
默认值false
用户属性spring-boot.build-info.skip
自版本3.1.0

time

用于 build.time 属性的值,格式适合 Instant#parse(CharSequence)。默认为 project.build.outputTimestamp,如果未设置则使用 session.request.startTime。若要完全禁用 build.time 属性,可使用 'off' 或将其添加到 excludeInfoProperties 中。

名称time
类型java.lang.String
默认值${project.build.outputTimestamp}
用户属性
自版本2.2.0