启用 Actuator 端点
添加并公开 Actuator 端点
启用 Actuator 端点 是 CoddyKit 上的免费 Spring Boot 4 Microservices & REST APIs 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Spring Boot 4 Microservices & REST APIs 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Spring Boot 4 Microservices & REST APIs 课程共包含 4 节课。
本课时的部分内容尚未翻译，以英文显示。
What Actuator Provides
Spring Boot Actuator adds production-ready endpoints that expose the internal state of your running app: health, metrics, environment, beans, mappings, and more.
It turns a black-box service into something you can observe and operate without writing custom plumbing.
Adding the Starter
Enable Actuator by adding a single dependency. Auto-configuration registers the endpoints; no extra code is required.
<!-- pom.xml -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>The /actuator Base Path
By default endpoints live under /actuator. Visiting the base path returns a discovery document listing the exposed endpoints and their links.
GET /actuator
# returns links to exposed endpoints: health, info, ...Default Exposure
Out of the box, only a few endpoints are exposed over HTTP — most notably health. Others exist but are hidden until you opt in, which is a safe default for production.
Exposing More Endpoints
Control HTTP exposure with management.endpoints.web.exposure.include. List specific endpoints by id, or use * to expose all (use with care).
management:
endpoints:
web:
exposure:
include: health,info,metrics,envExcluding Endpoints
You can include broadly and then carve out sensitive endpoints with exclude, which takes precedence over include.
management:
endpoints:
web:
exposure:
include: "*"
exclude: env,beans,heapdumpEnabling and Disabling Endpoints
Exposure differs from being enabled. An endpoint can be enabled but not exposed. Toggle availability with management.endpoint.<id>.enabled.
management:
endpoint:
shutdown:
enabled: true # disabled by default
health:
enabled: trueThe Info Endpoint
The info endpoint surfaces arbitrary metadata about your build. Populate it from application.yml or build-time properties like git and build info.
info:
app:
name: orders-service
version: 2.4.0
management:
info:
env:
enabled: trueChanging the Base Path
You can relocate endpoints by changing management.endpoints.web.base-path, for example to /manage, to fit gateway or routing conventions.
management:
endpoints:
web:
base-path: /manage
# now: /manage/healthA Separate Management Port
For isolation, run Actuator on its own port with management.server.port. This lets you keep operational endpoints off the public application port entirely.
management:
server:
port: 8081Operational Mindset
Actuator is the foundation of observability. Expose what operators need, hide what attackers could abuse, and treat the management surface as part of your security perimeter.
Quick Check
Test your understanding of exposure.
Recap
Actuator makes your app observable.
- Add
spring-boot-starter-actuator - Endpoints live under
/actuator; onlyhealthis exposed by default - Control HTTP exposure with
exposure.include/exclude - Enable/disable endpoints individually
- Optionally use a separate management port
常见问题解答
「启用 Actuator 端点」课时是免费的吗？
是的 — 「启用 Actuator 端点」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Spring Boot 4 Microservices & REST APIs 课程的其余内容，请升级到 CoddyKit PRO。 Spring Boot 4 Microservices & REST APIs 课程共包含 4 节课。
「启用 Actuator 端点」这节课中我会学到什么？
添加并公开 Actuator 端点 你通过在浏览器中直接运行的动手代码来练习 Spring Boot 4 Microservices & REST APIs，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Spring Boot 4 Microservices & REST APIs 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Spring Boot 4 Microservices & REST APIs 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「启用 Actuator 端点」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Spring Boot 4 Microservices & REST APIs 课中编写并运行代码吗？
能。每节 Spring Boot 4 Microservices & REST APIs 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 启用 Actuator 端点
- 健康指标
- 使用 Micrometer 自定义指标
- 保护 Actuator 端点