自定义Spring Boot Actuator端点
内容提要
本文介绍了如何创建自定义的Spring Boot Actuator端点，以便导出自己的指标和事件。首先需要添加spring-boot-starter-actuator依赖，并在application.properties文件中添加management.endpoints.web.exposure.include=*配置。然后使用@Component和@Endpoint注解创建自定义端点，并使用@ReadOperation注解暴露事件。最后，访问/actuator/hypersistence-optimizer路径可以获取Hypersistence Optimizer的事件列表。Spring Boot Actuator是一个非常有用的工具，可以为Spring应用程序提供各种指标，并且可以通过自定义端点暴露自己的事件。
延伸解读
自定义端点的实现机制
文章通过一个具体示例展示了如何创建自定义 Actuator 端点。使用 @Component 和 @Endpoint 注解定义端点类，并通过 @ReadOperation 暴露只读操作。示例中注入了 EntityManagerFactory，并在 @PostConstruct 中初始化 Hypersistence Optimizer，最终将事件描述以列表形式返回。这为读者提供了可复用的代码模式。
暴露所有端点的安全考量
文章建议在 application.properties 中设置 management.endpoints.web.exposure.include=* 来暴露所有可用指标。虽然这便于开发和调试，但在生产环境中可能带来安全风险，因为所有端点（包括敏感信息）都会通过 Web 公开。读者应根据实际需求限制暴露的端点。
输出内容的实际价值
访问 /actuator/hypersistence-optimizer 路径后，返回的是 Hypersistence Optimizer 检测到的具体性能问题列表，例如实体使用 IdentityGenerator 导致无法批量插入、建议升级 Hibernate 方言、调整批处理大小等。这些信息直接指向可优化的配置项，帮助开发者快速定位 JPA 和 Hibernate 的性能瓶颈。
Q&A
如何在Spring Boot中添加Actuator依赖？
在pom.xml文件中添加<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency>。
如何配置Spring Boot Actuator以暴露所有指标？
在application.properties文件中添加management.endpoints.web.exposure.include=*配置。
如何创建自定义的Spring Boot Actuator端点？
使用@Component和@Endpoint注解创建自定义端点，并使用@ReadOperation注解暴露事件。
访问自定义端点后会得到什么样的响应？
访问/actuator/hypersistence-optimizer路径将返回Hypersistence Optimizer的事件列表。
Spring Boot Actuator的主要功能是什么？
Spring Boot Actuator提供支持跟踪和监控的功能，包括各种健康检查和指标。
Hypersistence Optimizer在Spring Boot中有什么作用？
Hypersistence Optimizer提供Java持久性和Hibernate性能调优建议，可以通过自定义端点导出相关事件。
