sourcemation/jmx-exporter

JMX Exporter (由Sourcemation打包)

镜像概述和主要用途

此容器镜像包含Prometheus项目的JMX Exporter（Java Agent和HTTP Server），用于通过HTTP协议暴露JMX Beans，使Prometheus能够收集和监控Java应用的JMX指标。

核心功能和特性

• 提供两种运行模式：独立HTTP服务器和Java Agent
• 支持通过配置文件自定义暴露的JMX指标
• 基于sourcemation/jre-21构建，确保Java运行环境兼容性
• 可通过多阶段构建集成到Java应用镜像中

使用场景和适用范围

• 监控Java应用程序的JMX指标
• 集成到Prometheus监控体系，实现Java应用性能指标的收集和告警
• 适用于需要对Java应用进行精细化监控的场景，如微服务、企业级应用等

使用方法和配置说明

基本使用

运行临时容器查看帮助信息：

bash
docker run --rm -it sourcemation/jmx-exporter:latest --help

高级使用示例

运行独立HTTP服务器

bash
docker run -p 5556:5556 -v $(pwd)/config.yaml:/config.yaml sourcemation/jmx-exporter:latest 5556 /config.yaml

说明：

• -p 5556:5556：将容器内的5556端口映射到主机，用于HTTP访问
• -v $(pwd)/config.yaml:/config.yaml：挂载本地配置文件到容器内，用于自定义JMX指标暴露规则
• 5556 /config.yaml：指定HTTP服务器监听端口和配置文件路径

使用Java Agent

可通过多阶段构建从镜像中复制JMX Exporter的jar包：

dockerfile
COPY --from=sourcemation/jmx-exporter:latest /opt/jmx_exporter/jmx_prometheus_javaagent.jar /opt/jmx_exporter/

然后在Java应用启动命令中添加Agent参数：

bash
java -javaagent:/opt/jmx_exporter/jmx_prometheus_javaagent.jar=5556:/config.yaml -jar your-application.jar

镜像标签和版本

sourcemation/jmx-exporter镜像基于sourcemation/jre-21构建，构建过程依赖sourcemation/maven镜像。

环境变量、端口和卷

• 端口：默认使用5556端口（可通过启动参数自定义）
• 卷：建议挂载配置文件（如config.yaml）到容器内，用于自定义JMX指标暴露规则

贡献和问题反馈

欢迎贡献！你可以在Sourcemation的GitHub仓库上请求新功能、报告bug或提交PR：

• https://github.com/Sourcemation/images/issues/new/choose
• https://github.com/Sourcemation/images/compare

免责声明：sourcemation/jmx-exporter镜像与Prometheus项目无关联。提及的商标归各自公司和组织所有。sourcemation/jmx-exporter镜像是独立项目，由Sourcemation维护。

额外说明

镜像及其组件风险分析报告

镜像和组件的详细风险分析报告可在Sourcemation平台查看。

更多信息，请参考https://github.com/prometheus/jmx_exporter%E3%80%82

许可证

本解决方案的基础许可证为Apache 2.0 License。