scalify/jolokia_exporter

scalify/jolokia_exporter 镜像说明

镜像概述

scalify/jolokia_exporter是基于Go语言和Cobra框架开发的Prometheus Exporter，用于从Jolokia端点采集Java应用的JMX数据，并转换为Prometheus可识别的监控指标，帮助用户实现Java应用的性能监控。

核心功能

1. 通过YAML配置文件定义MBean数据到Prometheus指标的映射规则
2. 支持HTTP基础认证，访问受保护的Jolokia端点
3. 允许跳过SSL证书验证（适用于HTTPS端点）
4. 可自定义Exporter的监听地址、端口及指标暴露路径
5. 提供详细日志输出模式，便于问题排查

使用场景

适用于需要监控Java应用运行状态的场景：

• 跟踪Java应用的内存使用、线程数量等核心指标
• 集成到Prometheus+Grafana体系，可视化应用性能数据
• 自动化告警配置，及时发现应用异常

配置说明

配置文件格式

通过YAML文件定义指标映射规则，示例如下：

yaml
metrics:
- source:
    mbean: java.lang:type=Memory
    attribute: HeapMemoryUsage
    path: used
  target: java_memory_heap_used
- source:
    mbean: java.lang:type=Threading
    attribute: ThreadCount
  target: java_thread_count

• source.mbean: 目标MBean名称
• source.attribute: MBean属性（可选）
• source.path: 属性内嵌套路径（可选）
• target: Prometheus指标名称

命令行参数

运行时支持的关键参数：

• --basic-auth-user: Jolokia端点认证用户名
• --basic-auth-password: Jolokia端点认证密码
• -l, --listen: 监听地址端口（默认:9422）
• -e, --endpoint: 指标暴露路径（默认/metrics）
• -i, --insecure: 跳过SSL证书验证
• -v, --verbose: 开启详细日志

部署示例

Docker Compose示例

yaml
version: "3"
services:
  jolokia_exporter:
    image: scalify/jolokia_exporter
    volumes:
      - ./metrics-config.yaml:/config.yaml
    command: [
      "export", "/config.yaml", "http://your-java-app:8080/jolokia",
      "--basic-auth-user", "admin",
      "--basic-auth-password", "your-password"
    ]
    ports:
      - "9422:9422"

Docker Run示例

bash
docker run -d \
  -p 9422:9422 \
  -v $(pwd)/metrics-config.yaml:/config.yaml \
  scalify/jolokia_exporter \
  export /config.yaml http://java-app:8080/jolokia \
  --basic-auth-user admin \
  --basic-auth-password secret

许可证

本镜像基于MIT许可证发布，详情请参考https://github.com/Scalify/jolokia_exporter%E3%80%82