3.4. MicroProfile 健康配置
3.4.1. 使用管理 CLI 检查健康状况 复制链接链接已复制到粘贴板!
您可以使用管理 CLI 检查系统健康状况。
流程
检查健康状况:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.2. 使用管理控制台检查健康状况 复制链接链接已复制到粘贴板!
您可以使用管理控制台检查系统健康状况。
检查运行时操作以布尔值的形式显示健康检查和全局结果。
流程
- 导航到 Runtime 选项卡,再选择服务器。
-
在 Monitor 列中,点 MicroProfile Health
View。
3.4.3. 使用 HTTP 端点检查健康状况 复制链接链接已复制到粘贴板!
健康检查自动部署到 JBoss EAP 上的健康上下文,因此您可以使用 HTTP 端点获取当前的健康状况。
/health
端点的默认地址(可从管理界面访问)是 http://127.0.0.1:9990/health
。
流程
要使用 HTTP 端点获取服务器当前健康状况,请使用以下 URL:
http://<host>:<port>/health
http://<host>:<port>/health
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 访问此上下文以 JSON 格式显示健康检查,指示服务器是否正常运行。
3.4.4. 为 MicroProfile 健康启用身份验证 复制链接链接已复制到粘贴板!
您可以将 健康
上下文配置为需要身份验证才能访问。
流程
在
microprofile-health-smallrye
子系统上,将security-enabled
属性设置为true
。/subsystem=microprofile-health-smallrye:write-attribute(name=security-enabled,value=true)
/subsystem=microprofile-health-smallrye:write-attribute(name=security-enabled,value=true)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 重新加载服务器,使更改生效。
reload
reload
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
任何后续尝试访问 /health
端点的尝试都会触发身份验证提示。
3.4.5. 确定服务器健康和就绪状态的就绪度探测 复制链接链接已复制到粘贴板!
JBoss EAP XP 5.0.0 支持三个就绪度探测来确定服务器健康和就绪状态。
-
当 server-state
运行时
,server-status
- 返回UP
。 -
当探测没有检测到引导错误时,
boot-errors
- 返回UP
。 -
当所有部署的状态为
- 返回OK
时,Deployment-statusUP
。
这些就绪度探测默认为启用。您可以使用 MicroProfile Config 属性 mp.health.disable-default-procedures
禁用探测。
以下示例演示了在 check
操作中使用三个探测:
3.4.6. 没有定义探测时的全局状态 复制链接链接已复制到粘贴板!
:empty-readiness-checks-status
,:empty-liveness-checks-status
, 和 :empty-startup-checks-status
管理属性在没有定义 就绪度
、存活度
或 启动探测
时指定全局状态。
这些属性允许应用程序报告 'DOWN',直到其探测验证应用是否已就绪、实时或启动。默认情况下,应用程序会报告 'UP'。
如果未定义就绪度探测,则
:empty-
属性指定readiness
-checks-status就绪度探测
的全局状态:/subsystem=microprofile-health-smallrye:read-attribute(name=empty-readiness-checks-status) { "outcome" => "success", "result" => expression "${env.MP_HEALTH_EMPTY_READINESS_CHECKS_STATUS:UP}" }
/subsystem=microprofile-health-smallrye:read-attribute(name=empty-readiness-checks-status) { "outcome" => "success", "result" => expression "${env.MP_HEALTH_EMPTY_READINESS_CHECKS_STATUS:UP}" }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果未定义存活度探测,则
:empty-
属性指定liveness
-checks-status存活度探测
的全局状态:/subsystem=microprofile-health-smallrye:read-attribute(name=empty-liveness-checks-status) { "outcome" => "success", "result" => expression "${env.MP_HEALTH_EMPTY_LIVENESS_CHECKS_STATUS:UP}" }
/subsystem=microprofile-health-smallrye:read-attribute(name=empty-liveness-checks-status) { "outcome" => "success", "result" => expression "${env.MP_HEALTH_EMPTY_LIVENESS_CHECKS_STATUS:UP}" }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果未定义启动探测,则
:empty-
属性指定startup
-checks-status启动探测
的全局状态:/subsystem=microprofile-health-smallrye:read-attribute(name=empty-startup-checks-status) { "outcome" => "success", "result" => expression "${env.MP_HEALTH_EMPTY_STARTUP_CHECKS_STATUS:UP}" }
/subsystem=microprofile-health-smallrye:read-attribute(name=empty-startup-checks-status) { "outcome" => "success", "result" => expression "${env.MP_HEALTH_EMPTY_STARTUP_CHECKS_STATUS:UP}" }
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 检查
就绪度
、存活度
和启动
探测的/health
HTTP 端点和:check
操作也会考虑这些属性。
您还可以修改这些属性,如下例所示: