1 Configuración desde fuentes

Descripción general

Si está instalado desde las fuentes, la siguiente información le ayudará a configurar la puerta de enlace de Java de Zabbix.

Resumen de archivos

Si obtuvo la puerta de enlace Java de las fuentes, debería haber terminado con una colección de scripts de shell, JAR y archivos de configuración bajo $PREFIJO/sbin/zabbix_java. La función de estos archivos se resume a continuación.

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

El archivo JAR de puerta de enlace de Java en sí mismo.

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

Dependencias de la puerta de enlace Java: bibliotecas Logback, SLF4J y Android JSON.

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

Archivos de configuración para Logback.

startup.sh
       shutdown.sh

Scripts de conveniencia para iniciar y detener la puerta de enlace de Java.

settings.sh

Archivo de configuración que es integrado en los scripts de inicio y apagado mostrados más arriba.

Configuración y ejecución de la puerta de enlace Java

De forma predeterminada, la puerta de enlace de Java escucha en el puerto 10052. Si planea ejecutar la puerta de enlace Java en un puerto diferente, puede especificarlo en el script settings.sh Consulte la descripción de [Archivo de configuración de puerta de enlace Java] (/manual/appendix/config/zabbix_java) para saber cómo especificar esto y otras opciones.

El puerto 10052 no está registrado en [IANA] (http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt).

Una vez que se sienta cómodo con la configuración, puede iniciar la puerta de enlace de Java ejecutando el script de inicio:

$ ./startup.sh

Del mismo modo, una vez que ya no necesite la puerta de enlace de Java, ejecute el script de apagado para detenerlo:

$ ./shutdown.sh

Tenga en cuenta que, a diferencia del servidor o el proxy, la puerta de enlace de Java es liviana y no necesita una base de datos.

Configuración del servidor para su uso con Java gateway

Con Java gateway en funcionamiento, debe decirle al servidor Zabbix dónde encontrar el Java gateway de Zabbix. Esto se hace especificando los parámetro JavaGateway y JavaGatewayPort en el [archivo de configuración del servidor] (/manual/appendix/config/zabbix_server). Si el host en el que la aplicación JMX se está ejecutando es monitoreada por el proxy Zabbix, luego especifica los parámetros de conexión en el [archivo configuración del proxy /manual/appendix/config/zabbix_proxy) en su lugar.

JavaGateway=192.168.3.14
       JavaGatewayPort=10052

De forma predeterminada, el servidor no inicia ningún proceso relacionado con monitoreo JMX. Sin embargo, si desea utilizarlo, debe especificar el número de instancias previamente bifurcadas de sondas de Java. Haces esto de la misma forma en que especifica sondas y tramperos regulares.

StartJavaPollers=5

No olvide reiniciar el servidor o proxy, una vez que haya terminado con la configuración.

Depurando puerta de enlace Java

En caso de que haya algún problema con la puerta de enlace de Java o un mensaje de error que ve sobre un elemento en la interfaz no es lo suficientemente descriptivo, es posible que desee echar un vistazo al archivo de registro de la puerta de enlace de Java.

De forma predeterminada, la puerta de enlace de Java registra sus actividades en el archivo /tmp/zabbix_java.log con nivel de registro "info". A veces esa información no es suficiente y hay una necesidad de información a nivel de registro "depuración". Con el fin de aumente el nivel de registro, modifique el archivo lib/logback.xml y cambie el nivel atributo de la etiqueta <root> para "depurar":

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

Tenga en cuenta que, a diferencia del servidor Zabbix o el proxy Zabbix, no es necesario reinicie la puerta de enlace Zabbix Java después de cambiar el archivo logback.xml - los cambios en logback.xml se recogerá automáticamente. cuando termines con la depuración, puede devolver el nivel de registro a "info".

Si desea iniciar sesión en un archivo diferente o en un medio completamente diferente como base de datos, ajuste el archivo logback.xml para satisfacer sus necesidades. Ver Iniciar sesión Manual para obtener más detalles.

A veces, para fines de depuración, es útil iniciar la puerta de enlace de Java como un aplicación de consola en lugar de un demonio. Para ello comenta variable PID_FILE en settings.sh. Si se omite PID_FILE, startup.sh El script inicia Java Gateway como una aplicación de consola y hace que Logback use el archivo lib/logback-console.xml en su lugar, que no solo registra en consola, pero también tiene habilitado el nivel de registro "depuración".

Finalmente, tenga en cuenta que dado que la puerta de enlace Java usa SLF4J para iniciar sesión, puede reemplace Logback con el marco de su elección colocando un archivo JAR apropiado en el directorio lib. Ver SLF4J Manual para obtener más detalles.

Monitoreo de la JMX

Consulte la página Monitoreo de la JMX para más detalles.