Jolokia Exporter 镜像文档

镜像概述

本镜像是基于 scalify/jolokia_exporter 构建的JMX指标导出工具，专注于将JVM应用暴露的JMX（Java Management Extensions）指标转换为Prometheus监控系统可直接抓取的格式。通过对接Jolokia代理（JMX over HTTP），实现JVM应用指标的标准化采集，适用于各类Java应用的监控场景。

核心功能与特性

• JMX指标转换：支持将JVM应用的JMX指标（如内存使用、线程状态、GC情况等）转换为Prometheus兼容的时序数据格式。
• Prometheus集成：原生支持Prometheus抓取协议，可直接配置为Prometheus的target。
• 灵活配置：支持通过环境变量或配置文件自定义Jolokia代理地址、监听端口、指标路径等核心参数。
• 轻量级设计：基于Alpine基础镜像构建，镜像体积小，资源占用低，适合容器化部署。
• 兼容性广：兼容主流JVM应用（如Spring Boot、Tomcat、Jetty、Kafka等）及Jolokia代理版本。

使用场景

• Java应用监控：监控运行中的JVM应用（如微服务、中间件）的实时状态，包括内存、CPU、线程、GC等关键指标。
• Prometheus+Grafana体系：作为Prometheus的数据源组件，配合Grafana实现JVM指标的可视化展示与告警。
• 容器化环境集成：在Kubernetes、Docker Compose等容器编排平台中，与Java应用容器联动部署，实现监控闭环。

使用方法

基础使用（Docker Run）

通过docker run命令快速启动导出器，需指定Jolokia代理地址（目标JVM应用的Jolokia端点）：

docker run -d \
  --name jolokia-exporter \
  -p 9234:9234 \
  -e JOLOKIA_URL=[***] \
  your-image-name:latest

参数说明：

• -p 9234:9234：映射容器内监听端口（默认9234）到主机，供Prometheus抓取。
• JOLOKIA_URL：必填，目标JVM应用的Jolokia代理地址（需提前在目标应用中部署Jolokia代理，如通过jolokia-agent.jar启动）。

自定义配置

环境变量配置

支持通过以下环境变量调整导出器行为：

示例（自定义端口与超时时间）：

docker run -d \
  --name jolokia-exporter \
  -p 9090:9090 \
  -e LISTEN_PORT=9090 \
  -e JOLOKIA_URL=[***] \
  -e JOLOKIA_TIMEOUT=15 \
  your-image-name:latest

配置文件挂载（高级）

如需更复杂的指标过滤或转换规则，可通过挂载配置文件实现（配置文件格式参考scalify/jolokia_exporter官方规范）：

docker run -d \
  --name jolokia-exporter \
  -p 9234:9234 \
  -v /host/path/to/config.yml:/etc/jolokia-exporter/config.yml \
  -e CONFIG_FILE=/etc/jolokia-exporter/config.yml \
  your-image-name:latest

Docker Compose 部署示例

在多容器应用中，可通过docker-compose.yml与Java应用联动部署：

version: '3'
services:
  target-app:
    image: your-java-app:latest
    ports:
      - "8080:8080"
    # 目标应用需启动Jolokia代理（示例：通过JVM参数指定）
    environment:
      - JAVA_OPTS=-javaagent:/jolokia-agent.jar=port=8778,host=0.0.0.0
    volumes:
      - ./jolokia-agent.jar:/jolokia-agent.jar

  jolokia-exporter:
    image: your-image-name:latest
    ports:
      - "9234:9234"
    environment:
      - JOLOKIA_URL=[***]
      - LOG_LEVEL=info
    depends_on:
      - target-app

指标抓取验证

启动后，可通过访问 http://localhost:9234/metrics 验证指标是否正常暴露，返回内容应包含Prometheus格式的指标数据（如jolokia_jvm_memory_used_bytes、jolokia_threads_active_count等）。

注意事项

• 目标JVM应用需提前部署Jolokia代理（如通过jolokia-agent.jar作为Javaagent启动），并确保导出器可访问Jolokia端点（网络连通性）。
• 生产环境建议通过配置文件自定义指标过滤规则，减少无效指标传输，提升性能。
• 监控高并发应用时，可适当调整JOLOKIA_TIMEOUT参数，避免因网络延迟导致指标抓取失败。