Actuator REST API
该 API 文档描述了 Spring Boot Actuator 的 Web 端点。
在继续之前,您应阅读以下主题:
为了获得下面记录的正确 JSON 响应,必须提供 Jackson。
URLs
默认情况下,所有 Web 端点都位于路径 /actuator 下,其 URL 格式为 /actuator/{id}。可以通过 management.endpoints.web.base-path 属性来配置 /actuator 基础路径,如下例所示:
management.endpoints.web.base-path=/manage
前面的 application.properties 示例将端点 URL 的形式从 /actuator/{id} 更改为 /manage/{id}。例如,info 端点的 URL 将变为 /manage/info。
时间戳
所有由端点消费的时间戳,无论是作为查询参数还是在请求体中,都必须按照 ISO 8601 中规定的偏移日期时间格式进行格式化。
章节总结
📄️ Audit Events (auditevents)
auditevents 端点提供有关应用程序审计事件的信息。
📄️ Beans (beans)
beans 端点提供有关应用程序的 beans 的信息。
📄️ 缓存(caches)
caches 端点提供对应用程序缓存的访问。
📄️ 条件评估报告(conditions)
conditions 端点提供了有关配置类和自动配置类上条件评估的信息。
📄️ 配置属性(configprops)
configprops 端点提供有关应用程序的 @ConfigurationProperties bean 的信息。
📄️ Environment (env)
env 端点提供有关应用程序 Environment 的信息。
📄️ Flyway (flyway)
flyway 端点提供有关 Flyway 执行的数据库迁移的信息。
📄️ 健康(health)
健康端点提供了有关应用程序健康状况的详细信息。
📄️ 堆转储(heapdump)
heapdump 端点提供应用程序 JVM 的堆转储。
📄️ HTTP Exchanges (httpexchanges)
httpexchanges 端点提供有关 HTTP 请求-响应交换的信息。
📄️ Info (info)
info 端点提供有关应用程序的一般信息。
📄️ Spring Integration Graph(integrationgraph)
integrationgraph 端点暴露了一个包含所有 Spring Integration 组件的图。
📄️ Liquibase (liquibase)
liquibase 端点提供有关 Liquibase 应用的数据库变更集的信息。
📄️ 日志文件(logfile)
logfile 端点提供对应用程序日志文件内容的访问。
📄️ Loggers (loggers)
loggers 端点提供了对应用程序的日志记录器及其日志级别配置的访问。
📄️ Mappings (mappings)
mappings 端点提供有关应用程序请求映射的信息。
📄️ Metrics(metrics)
metrics 端点提供对应用程序指标的访问,用于诊断应用程序所记录的指标。该端点不应在生产环境中被“抓取”(scraped)或用作指标后端。其目的是展示当前已注册的指标,以便用户可以查看有哪些指标可用、它们当前的值是多少,以及触发某些操作是否会导致特定值发生变化。如果你想通过应用程序收集的指标来诊断应用,应使用外部的指标后端。在这种情况下,metrics 端点仍然可能很有用。
📄️ Prometheus (prometheus)
Prometheus 端点以 Prometheus 服务器抓取所需的格式提供 Spring Boot 应用程序的指标。
📄️ Quartz (quartz)
quartz 端点提供了有关由 Quartz Scheduler 管理的作业和触发器的信息。
📄️ Software Bill of Materials (SBOM)
sbom 端点提供有关软件物料清单(SBOM)的信息。
📄️ 计划任务(scheduledtasks)
scheduledtasks 端点提供有关应用程序的计划任务的信息。
📄️ Sessions (sessions)
sessions 端点提供有关由 Spring Session 管理的应用程序 HTTP 会话的信息。
📄️ 关机(shutdown)
shutdown 端点用于关闭应用程序。
📄️ 应用程序启动(startup)
startup 端点提供有关应用程序启动序列的信息。
📄️ Thread Dump (threaddump)
threaddump 端点提供应用程序 JVM 的线程转储。