epicmorg/zabbix-java-gateway

Zabbix Java Gateway Docker镜像文档!logo## 镜像概述和主要用途Zabbix是企业级开源分布式监控解决方案，可监控网络参数、服务器健康状态和完整性，并提供灵活的通知机制和数据可视化功能。Zabbix Java Gateway是Zabbix的组件，用于原生支持JMX应用监控，作为"被动代理"接受来自Zabbix服务器或代理的连接请求。

核心功能和特性- 原生支持JMX应用监控，无需额外插件

• 作为被动代理工作，仅响应Zabbix服务器或代理的连接请求
• 基于Alpine Linux、Ubuntu 18.04和CentOS 7构建，提供多种基础镜像选择
• 可通过环境变量灵活配置轮询器数量、超时时间和日志级别
• 支持挂载卷添加额外JAR文件，扩展协议支持

使用场景和适用范围适用于需要监控Java应用服务器（如Tomcat、JBoss等）JMX指标的环境，是Zabbix监控架构中针对Java应用监控的关键组件，特别适合企业级Java应用的性能和健康状态监控。

使用方法和配置说明### 启动Zabbix Java Gateway容器使用以下命令启动Zabbix Java Gateway容器：```console

docker run --name some-zabbix-java-gateway -d zabbix/zabbix-java-gateway:tag ```其中：- some-zabbix-java-gateway 是容器名称

• tag 是指定版本的标签（如alpine-5.0-latest、ubuntu-latest等），完整标签列表见https://hub.docker.com/r/zabbix/zabbix-java-gateway/tags/

链接到Zabbix服务器或代理将Zabbix Java Gateway容器链接到Zabbix服务器或代理：```console

docker run --name some-zabbix-java-gateway --link some-zabbix-server:zabbix-server -d zabbix/zabbix-java-gateway:tag

### 容器shell访问和日志查看#### 进入容器shell```console
docker exec -ti some-zabbix-java-gateway /bin/bash
```#### 查看日志```console
docker logs some-zabbix-java-gateway

环境变量配置启动容器时可通过环境变量调整配置：#### ZBX_START_POLLERS- 描述：指定轮询器数量

• 默认值：5
• 示例：-e ZBX_START_POLLERS=10

ZBX_TIMEOUT- 描述：指定出站连接超时时间（秒）

• 默认值：3
• 示例：-e ZBX_TIMEOUT=5

ZBX_DEBUGLEVEL- 描述：指定日志级别

• 默认值：info
• 允许值：trace、debug、info、want、error、all、off
• 示例：-e ZBX_DEBUGLEVEL=debug

卷挂载#### /usr/sbin/zabbix_java/ext_lib- 用途：添加额外JAR文件以扩展Zabbix Java Gateway支持的协议

• 使用方法：-v /host/path/to/ext_lib:/usr/sbin/zabbix_java/ext_lib

镜像变体### zabbix-java-gateway:ubuntu-<version>- 基于Ubuntu 18.04 (bionic)构建

• 包含较多系统工具，适合需要完整系统环境的场景
• 推荐作为默认选择，兼容性较好

zabbix-java-gateway:alpine-<version>- 基于Alpine Linux v3.11构建

• 镜像体积小（约5MB基础镜像），适合对镜像大小有严格要求的场景
• 使用musl libc替代glibc，部分依赖glibc的软件可能存在兼容性问题

支持的Docker版本- 官方支持Docker 1.12.0及以上版本

• 1.6及以上版本提供尽力支持
• 升级Docker请参考Docker安装文档

用户反馈### 文档- 镜像文档存储在https://github.com/zabbix/zabbix-docker/%E7%9A%84%60java-gateway/%60%E7%9B%AE%E5%BD%95%E4%B8%8B

• 提交PR前请先阅读仓库的https://github.com/zabbix/zabbix-docker/blob/master/README.md

问题反馈如遇问题或有疑问，请通过https://github.com/zabbix/zabbix-docker/issues%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC

贡献欢迎贡献新功能、修复或更新，建议先通过https://github.com/zabbix/zabbix-docker/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%EF%BC%8C%E5%86%8D%E6%8F%90%E4%BA%A4PR