1 使用源码安装

概述

如果你是使用源码安装，那么下列信息会帮助你配置Zabbix Java网关。

文件概述

如果你从源码中获得Java网关，那么您最终会得到 $PREFIX/sbin/zabbix_java 下的Shell脚本、JAR和配置文件的集合。这些文件的作用总结如下。

bin/zabbix-java-gateway-$VERSION.jar

Java 网关自身JAR 文件。

lib/logback-core-0.9.27.jar
       lib/logback-classic-0.9.27.jar
       lib/slf4j-api-1.6.1.jar
       lib/android-json-4.3_r3.1.jar

Java 网关依赖于: Logback, SLF4J, 和Android JSON 库。

lib/logback.xml  
       lib/logback-console.xml

Logback的配置文件。

shutdown.sh  
       startup.sh

用于启动和停止Java网关的便捷脚本。

settings.sh

用于控制上述启动和停止脚本的配置文件。

配置和运行Java网关

Java网关默认监听10052端口。如果你想运行Java网关在其他端口，你可以在settings.sh的脚本中指定其他端口号。详情可见Java网关配置文件中描述的如何更改端口等其他信息。

10052端口不是由 IANA 注册的.

当配置好，你可以使用启动脚本来运行Java网关:

$ ./startup.sh

同样，如果你不再使用Java网关了，可以运行关闭脚本将其停止:

$ ./shutdown.sh

请注意，Java网关是轻量应用，不需要数据库，这一点与Server和Proxy不同。

配置Zabbix Server 关联Java网关

当Java网关启动并运行后，你需要告诉Zabbix server去哪里找Zabbix Java网关。通过在server 配置文件中指定JavaGateway和JavaGatewayPort来完成这个操作。如果运行JMX应用程序的主机是由Zabbix代理监控的，则可以在proxy 配置文件中指定连接参数。

JavaGateway=192.168.3.14
       JavaGatewayPort=10052

默认情况下，server不会启动任何与JMX监控相关的进程。如果你希望用到它，则必须指定Java pollers的数量。此操作与配置常规 pollers 和 trappers数量一样。

StartJavaPollers=5

配置完server或proxy后，一定不要忘记重启server或proxy。

调试Java网关

为了防止在 Java gateway 出现任何问题或在 Zabbix 前端看不到详细的报错信息的情况下，你可以通过 Java gateway 日志文件来查看。

默认情况下，Java gateway 将其活动日志记录到日志级别为 "info" 的 /tmp/zabbix_java.log 文件中。有时候，该日志信息可能不够详细，需要在日志级别为 "debug" 中获取。为了提升日志级别，需要修改 lib/logback.xml 文件，并将 <root> 标记的日志等级属性更改为 "debug"：

<root level="debug">
         <appender-ref ref="FILE" />
       </root>

值得注意的是，与 Zabbix server 或 Zabbix proxy 不同，更改 logback.xml 文件并不需要重启 Zabbix Java gateway，它会自动提交。当完成调试后，可以将日志级别还原成“info”。

如果希望将日志记录到其他文件或完全不同的介质，如数据库，那么只需要调整 logback.xml 文件。详见Logback 手册获取更多信息。

有时为了调试，将 Java 网关用作控制台应用比以守护进程来启动更方便。因此可以在 settings.sh 中注释掉 PID_FILE 变量，这时运行startup.sh 脚本启动 Java gateway 就会作为控制台应用来启动，并将 Logback 使用 lib/logback-console.xml 文件，这不仅会记录到控制台，还会启用日志级别 “debug”。

最后，请注意，由于 Java gateway 使用 SLF4J 来记录，您可以通过在 lib 目录放置合适的 JAR 文件来将 Logback 替换为您选中的框架。详见 SLF4J 手册以获取更多信息。

JMX 监控

详见 JMX 监控页面以获取更多信息。

Documentation