hjdjoo/jmx-exporter

JMX Exporter 0.20 镜像文档

镜像概述和主要用途

该镜像为JMX Exporter 0.20的基础镜像，基于最新的eclipse-temurin构建，不包含额外配置或标签。主要用于将Java应用的JMX指标转换为Prometheus可抓取的格式，适用于需要简单部署JMX Exporter的监控场景。

核心功能和特性

• 版本固定：集成JMX Exporter 0.20稳定版本，确保指标暴露功能一致性
• 基础环境可靠：基于最新eclipse-temurin（Java运行时环境），提供稳定的Java执行环境
• 轻量纯净：无多余配置文件和标签，镜像体积小，部署简单

使用场景和适用范围

适用于需要快速部署JMX Exporter以监控Java应用的场景，尤其适合对配置需求简单、追求轻量化部署的用户。典型应用场景包括：

• 监控Java应用（如Spring Boot、Tomcat、JBoss等）的JVM运行指标
• 与Prometheus、Grafana等监控工具配合，构建Java应用监控体系
• 开发环境或测试环境中快速搭建JMX指标采集能力

使用方法和配置说明

基本运行命令

由于镜像未包含默认配置文件，运行时需通过挂载方式提供JMX Exporter配置文件。基本启动命令如下：

bash
docker run -d \
  -p 9090:9090 \
  -v /本地路径/config.yml:/jmx_exporter/config.yml \
  --name jmx-exporter \
  [镜像名称] \
  java -jar /jmx_exporter/jmx_prometheus_javaagent-0.20.0.jar 9090:/jmx_exporter/config.yml

参数说明

• -p 9090:9090：将容器内JMX Exporter监听端口映射到主机9090端口（可根据需求修改主机端口）
• -v /本地路径/config.yml:/jmx_exporter/config.yml：挂载本地JMX Exporter配置文件到容器内指定路径
• [镜像名称]：替换为实际使用的Docker镜像名称
• 启动命令末尾指定JMX Exporter代理参数：9090为监听端口，/jmx_exporter/config.yml为配置文件路径

配置文件示例

JMX Exporter配置文件（config.yml）基础示例：

yaml
lowercaseOutputName: true
lowercaseOutputLabelNames: true
rules:
  # 监控JVM堆内存使用
  - pattern: 'java.lang<type=Memory><HeapMemoryUsage>(used|committed|max)'
    name: jvm_memory_heap_usage_$1_bytes
    type: GAUGE
  # 监控线程数量
  - pattern: 'java.lang<type=Threading><(daemonThreadCount|threadCount)>'
    name: jvm_threads_$1
    type: GAUGE
  # 监控GC次数
  - pattern: 'java.lang<name=([^>]+),type=GarbageCollector><CollectionCount>'
    name: jvm_gc_collection_count_total
    labels:
      gc: "$1"
    type: COUNTER

注意事项

• 确保被监控的Java应用已启用JMX远程访问（通常通过JVM参数配置：-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 -Dcom.sun.management.jmxremote.rmi.port=1099 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false）
• 根据监控需求调整配置文件中的指标规则，可参考https://github.com/prometheus/jmx_exporter%E6%89%A9%E5%B1%95%E8%A7%84%E5%88%99
• 如需修改JMX Exporter监听端口，需同时调整容器端口映射和启动命令中的端口参数