Prometheus 提供一套管理 API,以促进自动化和集成。
GET /-/healthy HEAD /-/healthy
该端点总是返回 200,应用于检查 Prometheus 的健康状况。如下图:
GET /-/ready HEAD /-/ready
当 Prometheus 准备好提供流量服务(即响应查询)时,该端点会返回 200。如下图:
PUT /-/reload POST /-/reload
该端点会触发 Prometheus 配置和规则文件的重新加载。默认情况下已禁用,可通过 --web.enable-lifecycle 标志启用。
另外,也可以通过向 Prometheus 进程发送 SIGHUP 来触发配置重载。
示例:
(1)使用 --web.enable-lifecycle 选项启动 Prometheus,如下:
D:\prometheus-2.45.4.windows-amd64> prometheus.exe --web.enable-lifecycle
(2)访问接口,如下图:
a、没有使用 --web.enable-lifecycle 选项开启功能,调用如下图:
b、使用了 --web.enable-lifecycle 选项,调用如下图:
PUT /-/quit POST /-/quit
该端点会触发 Prometheus 的优雅关机。默认情况下已禁用,可通过 --web.enable-lifecycle 标志启用。
另外,也可以通过向 Prometheus 进程发送 SIGTERM 来触发优雅关机。
示例:
(1)使用 --web.enable-lifecycle 选项启动 Prometheus,如下:
D:\prometheus-2.45.4.windows-amd64> prometheus.exe --web.enable-lifecycle
(2)访问接口,发送关闭 Prometheus 服务的命令,如下图: