跳到主要内容
版本:4.0.2

Actuator REST API

QWen Max 中英对照 Actuator 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 规定的偏移日期和时间格式进行格式化。

章节总结

📄️ 指标(metrics)

metrics 端点提供对应用程序指标的访问,用于诊断应用程序记录的指标。在生产环境中,不应“抓取”此端点或将其用作指标后端。其目的是展示当前已注册的指标,以便用户可以查看哪些指标可用、它们的当前值是多少,以及触发某些操作是否会导致某些值发生变化。如果你想通过收集的指标来诊断你的应用程序,应使用外部的指标后端。在这种情况下,metrics 端点仍然可能有用。