aristanetworks/jmx-exporter

Prometheus JMX Exporter 独立HTTP服务器镜像

镜像概述

本镜像提供Prometheus JMX Exporter的独立HTTP服务器实现，用于将JVM应用程序的JMX指标转换为Prometheus兼容格式，并通过HTTP接口暴露，便于Prometheus进行指标抓取和监控。

核心功能和特性

• 独立运行模式：无需嵌入到目标JVM应用，作为独立服务运行
• JMX指标收集：支持通过JMX协议连接远程JVM应用，采集运行时指标
• Prometheus兼容：输出Prometheus标准格式的指标数据
• 可配置化：支持自定义指标过滤、重命名和类型映射
• 轻量级部署：基于精简基础镜像，资源占用低

使用场景和适用范围

• 监控各类JVM应用程序（如Java应用、Spring Boot服务、Tomcat、Kafka、Elasticsearch等）
• 目标应用无法或不适合嵌入JMX Exporter代理的场景
• 需要集中采集多个JVM应用指标的监控架构
• 容器化环境中JVM应用的监控部署

使用方法和配置说明

基本运行命令

bash
docker run -d -p 9090:9090 \
  -e JMX_HOST=target-jvm-host \
  -e JMX_PORT=1099 \
  prom/prometheus-jmx-exporter

环境变量配置

自定义指标配置

如需自定义指标采集规则，可通过挂载配置文件实现：

bash
docker run -d -p 9090:9090 \
  -e JMX_HOST=target-jvm-host \
  -e JMX_PORT=1099 \
  -e CONFIG_FILE=/etc/jmx-exporter/config.yml \
  -v /local/path/to/config.yml:/etc/jmx-exporter/config.yml \
  prom/prometheus-jmx-exporter

配置文件示例 (config.yml):

yaml
lowercaseOutputName: true
rules:
  - pattern: "java.lang<type=Memory>(HeapMemoryUsage|NonHeapMemoryUsage): (used|committed|max)"
    name: jvm_memory_usage_$1_$2
    type: GAUGE
  - pattern: "java.lang<type=Threading>(TotalStartedThreadCount|ThreadCount|DaemonThreadCount)"
    name: jvm_threads_$1
    type: GAUGE

Docker Compose部署示例

yaml
version: '3.8'
services:
  jmx-exporter:
    image: prom/prometheus-jmx-exporter
    container_name: jmx-exporter
    restart: always
    ports:
      - "9090:9090"
    environment:
      - JMX_HOST=kafka-broker
      - JMX_PORT=9999
      - HTTP_PORT=9090
    volumes:
      - ./jmx-config.yml:/etc/jmx-exporter/config.yml
    networks:
      - monitoring-network

networks:
  monitoring-network:
    driver: bridge

验证指标

启动后可通过以下URL访问指标：

http://localhost:9090/metrics