etraveli/jmx-exporter

Prometheus JMX Exporter Docker镜像

镜像概述

本镜像提供了Prometheus JMX Exporter的容器化部署方案，基于openjdk:jre-alpine构建，用于从Java应用程序收集JMX（Java Management Extensions）指标，并通过HTTP接口暴露给Prometheus监控系统，实现Java应用性能指标的采集与监控。

核心功能与特性

• 轻量级基础：基于openjdk:jre-alpine镜像，体积小，资源占用低
• 可配置指标收集：通过挂载自定义配置文件，灵活定义需要收集的JMX指标规则
• 标准端口暴露：默认暴露9209端口，用于Prometheus抓取指标
• 容器可交互性：支持通过sh进入容器进行检查和调试（Alpine系统特性）

使用场景

• 监控Java应用程序的JVM运行状态（如内存使用、线程数、GC情况等）
• 集成到Prometheus监控体系，实现Java服务的指标可视化与告警
• 容器化环境中快速部署JMX指标收集服务，无需手动配置JVM参数

使用方法

基本部署命令

bash
docker run -v [本地配置文件路径]:/opt/jmx_export/config/jmx_exporter.yml -P etraveli/jmx_exporter

参数说明

• -v [本地配置文件路径]:/opt/jmx_export/config/jmx_exporter.yml
  挂载本地JMX Exporter配置文件到容器内固定路径，配置文件需符合JMX Exporter的YAML格式，定义指标采集规则。

• -P
  自动映射容器暴露的9209端口到主机随机端口，可通过docker ps查看映射结果。

• -p "外部端口:9209"
  手动指定端口映射，例如-p "9209:9209"将容器9209端口映射到主机9209端口，便于Prometheus固定地址抓取。

配置文件要求

需提前准备JMX Exporter配置文件（YAML格式），示例配置（监控基本JVM指标）：

yaml
rules:
  - pattern: "java.lang<type=Memory><HeapMemoryUsage>(used|committed|max)"
    name: jvm_heap_memory_usage_$1
    type: GAUGE
  - pattern: "java.lang<type=Threading><(daemonThreadCount|threadCount)>"
    name: jvm_thread_$1
    type: GAUGE

注意事项

• 配置文件必要性：必须挂载配置文件，否则JMX Exporter无法正常启动
• 网络模式：若使用--network=host网络模式，容器内的localhost指向Docker主机，需确保Java应用在主机网络中可访问
• 容器调试：可通过docker exec -it [容器ID] sh进入容器，检查配置文件挂载情况或日志输出

docker-compose示例

yaml
version: '3'
services:
  jmx-exporter:
    image: etraveli/jmx_exporter
    volumes:
      - ./jmx_exporter.yml:/opt/jmx_export/config/jmx_exporter.yml
    ports:
      - "9209:9209"
    restart: always