如何使用Ansible读取JMX MBean属性以实现JVM应用健康检查？

下面是几种可行的实现方案：

方案1：使用jmxterm工具直接查询 #

jmxterm是一款轻量级的JMX命令行工具，可以直接连接JVM的远程JMX端口并查询MBean属性。

1. 先通过Ansible在目标主机部署jmxterm（可从官方仓库下载jar包）：

   - name: 部署jmxterm工具
     get_url:
       url: "https://github.com/jiaqi/jmxterm/releases/download/v1.0.4/jmxterm-1.0.4-uber.jar"
       dest: /opt/jmxterm.jar
       mode: '0755'
   

2. 编写健康检查任务，循环查询直到MBean属性符合健康状态：

   - name: 检查JVM应用健康状态（通过MBean）
     shell: >
       java -jar /opt/jmxterm.jar -n -l service:jmx:rmi:///jndi/rmi://localhost:{{ jmx_port }}/jmxrmi
       -e "get -b com.your.app:name=HealthIndicator status"
     register: jmx_check_result
     until: jmx_check_result.stdout.find('status = HEALTHY') != -1
     retries: 12
     delay: 5
   

   说明：retries和delay可根据应用启动时长调整，com.your.app:name=HealthIndicator和status替换为实际的MBean路径与属性名。

方案2：通过Jolokia代理间接查询 #

如果允许在目标主机部署代理，Jolokia可以将JMX接口转换为HTTP接口，让Ansible用uri模块轻松访问：

1. 将Jolokia代理jar包加入应用启动类路径，或单独启动代理进程，确保其监听HTTP端口。
2. 编写Ansible健康检查任务：

   - name: 通过Jolokia查询MBean健康属性
     uri:
       url: "http://localhost:{{ jolokia_port }}/jolokia/read/com.your.app:name=HealthIndicator/status"
       return_content: yes
     register: jolokia_result
     until: jolokia_result.json.value == "HEALTHY"
     retries: 12
     delay: 5
   

方案3：自定义Java脚本查询 #

编写简单的Java程序，通过JMX API连接并查询目标属性，输出标准化结果供Ansible判断：

1. 编写并编译自定义JMX检查程序，打包成jar包上传至目标主机。
2. 执行健康检查任务：

   - name: 运行自定义JMX健康检查脚本
     shell: java -cp /opt/jmx-health-check.jar com.your.app.JmxHealthChecker {{ jmx_port }}
     register: custom_jmx_result
     until: custom_jmx_result.stdout == "HEALTHY"
     retries: 12
     delay: 5
   

关键注意事项 #

• 确保目标JVM已开启远程JMX连接，启动参数需包含：

  -Dcom.sun.management.jmxremote
  -Dcom.sun.management.jmxremote.port=9999
  -Dcom.sun.management.jmxremote.authenticate=false
  -Dcom.sun.management.jmxremote.ssl=false
  

  生产环境建议开启认证与SSL加密，避免安全风险。
• 确认目标主机防火墙放行JMX端口（或Jolokia的HTTP端口），保证Ansible能正常访问。

内容的提问来源于stack exchange，提问作者Valery Ryaboshapko