1 从源代码安装

概述

如果安装java网关 from sources，以下信息将帮助您进行设置 Zabbix Java gateway。

文件概览

如果您从源代码获取了 Java 网关，则最终应该得到一组 shell 脚本、JAR 文件和配置文件，位于 $PREFIX/sbin/zabbix_java 目录下。这些文件的作用如下所示。

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

Java 网关的 JAR file 文件本身。

lib/logback-core-1.5.16.jar
       lib/logback-classic-1.5.16.jar
       lib/slf4j-api-2.0.16.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

由上述启动和关闭脚本调用的配置 file 文件。

配置并运行Java网关

默认情况下，Java网关监听10052端口。若需在不同端口运行Java网关，可在settings.sh脚本中指定。关于如何配置此端口及其他选项，请参阅Java gateway configuration file的说明。

10052端口未被IANA registered。

确认配置无误后，可通过运行启动脚本启动Java网关：

./startup.sh

同理，当不再需要Java网关时，执行run关闭脚本停止服务：

./shutdown.sh

需注意，与server 或 proxy不同，Java网关属于轻量级服务且无需数据库支持。

配置服务器以与 Java 网关配合使用

Java网关启动并运行后，你必须告诉Zabbix server在哪里要找到 Zabbix Java 网关。这是通过指定 JavaGateway 和 JavaGatewayPort 参数在 server configuration file 中。如果主机上启用了 JMX 应用程序是否在运行由Zabbix proxy监控，然后你进行指定请改用 proxy configuration file 中的连接参数。

Java网关=192.168.3.14
       JavaGatewayPort=10052

默认情况下，服务器不会启动与 JMX 相关的任何进程。监控。但是，如果您希望使用它，则必须指定 Java轮询器预派生实例的数量。您在此处进行相同设置您指定常规轮询器和陷阱接收器的方式。

StartJavaPollers=5

不要忘get重启server 或 proxy，一旦你完成了配置它们。

调试 Java 网关

如果 Java 网关出现任何问题，或者在前端看到的有关监控项的错误信息不够详细，你可能需要查看 Java 网关的日志文件。

默认情况下，Java 网关会将其活动记录到 /tmp/zabbix_java.log file 中，日志级别为 "info"。有时这些信息可能不够，需要日志级别为 "debug" 的信息。为了提高日志记录级别，请修改 file lib/logback.xml 文件，并将 <root> 标签的 level 属性更改为 "debug"：

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

请注意，与 Zabbix server 或 Zabbix proxy 不同，更改 logback.xml file 后不需要重启 Zabbix Java 网关 - logback.xml 中的更改会自动生效。调试完成后，可以将日志记录级别恢复为 "info"。

如果你希望记录到不同的 file 或完全不同的介质（如数据库），请根据需要调整 logback.xml file。更多详细信息请参见 Logback Manual。

有时为了调试目的，将 Java 网关作为控制台应用程序而非守护进程启动会很有用。为此，请注释掉 settings.sh 中的 PID_FILE 变量。如果省略 PID_FILE，startup.sh 脚本会将 Java 网关作为控制台应用程序启动，并使 Logback 使用 lib/logback-console.xml file，这不仅会记录到控制台，还会启用日志级别 "debug"。

最后请注意，由于 Java 网关使用 SLF4J 进行日志记录，你可以通过在 lib 目录中放置适当的 JAR file 文件，将 Logback 替换为你选择的框架。更多详细信息请参见 SLF4J Manual。

JMX监控

请参阅 JMX monitoring 页面以获取更多详细信息。

Documentation