banzaicloud/jmx-javaagent

JMX Exporter镜像

镜像概述

本镜像提供JMX到Prometheus的导出器工具，用于采集Java应用的JMX指标并转换为Prometheus可识别的格式。该工具推荐以Java Agent方式运行，直接嵌入目标JVM，暴露HTTP端点供Prometheus刮取指标；也可作为独立HTTP服务器采集远程JMX目标，但前者能获得更全面的进程指标（如内存、CPU使用）。

核心功能

• 本地JVM指标采集：作为Java Agent运行时，直接收集当前JVM的mBeans指标（包括进程内存、CPU、线程等）。
• 远程JMX目标支持：可配置连接远程JMX服务，采集第三方Java应用的指标。
• 灵活配置规则：通过YAML配置自定义指标采集逻辑，包括白名单/黑名单mBeans、指标名称转换、标签设置等。
• HTTP指标端点：暴露/metrics端点，支持Prometheus标准刮取。

使用场景

• Java应用监控：监控Spring Boot、Tomcat等Java应用的JVM运行状态。
• 自定义指标采集：收集Java应用中自定义的mBeans业务指标。
• Prometheus集成：将Java应用指标纳入Prometheus监控体系，结合Grafana实现可视化分析。

配置说明

配置文件采用YAML格式，关键参数及示例如下：

关键参数

配置示例

yaml
---
startDelaySeconds: 0
lowercaseOutputName: false
whitelistObjectNames: ["com.example.app:type=Performance,*"]
rules:
  - pattern: 'com.example.app<type=Performance, name=(\w+)><>Value: (\d+)'
    name: app_performance_$1
    value: $2
    help: "应用性能指标：$1"
    type: GAUGE

Docker部署示例

Dockerfile集成

在Java应用的Dockerfile中添加JMX Exporter作为Java Agent：

dockerfile
FROM openjdk:11-jre-slim
COPY --from=banzaicloud/jmx-javaagent:latest /jmx_prometheus_javaagent.jar /app/
COPY your-app.jar /app/
COPY jmx-config.yaml /app/
CMD ["java", "-javaagent:/app/jmx_prometheus_javaagent.jar=8080:/app/jmx-config.yaml", "-jar", "/app/your-app.jar"]

运行容器

bash
docker run -d \
  -p 8080:8080 \
  -v /host/path/to/jmx-config.yaml:/app/jmx-config.yaml \
  your-app-image

指标可通过http://localhost:8080/metrics访问。