1 从源代码安装

概述

如果安装java网关来自源码安装，以下信息将帮助您配置 Zabbix Java gateway。

文件概览

如果从源代码获取Java网关，您应该在$PREFIX/sbin/zabbix_java目录下得到一系列shell脚本、JAR文件和配置文件。这些文件的作用如下所述。

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网关。这通过在server configuration file中指定JavaGateway和JavaGatewayPort参数来实现。如果运行JMX应用程序的主机由Zabbix proxy监控，则应在proxy configuration file中指定连接参数。

JavaGateway=192.168.3.14
       JavaGatewayPort=10052

默认情况下，服务器不会启动任何与JMX监控相关的进程。但如果您希望使用此功能，则必须指定预分叉的Java轮询器实例数量。这与指定常规轮询器和捕获器的方式相同。

StartJavaPollers=5

配置完成后，请勿忘记重启server 或 proxy。

调试 Java 网关

若Java网关出现任何问题或前端显示的监控项错误信息描述不够详细您可能需要查看Java网关日志file

默认情况下 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进行日志记录您可以通过将适当的JAR file放入lib目录来替换Logback为您选择的框架. 详见SLF4J Manual

JMX监控

详情请参阅JMX monitoring页面

Documentation