Instalación desde fuentes

Resumen

Si se instala desde el código fuente, la siguiente información le ayudará a configurar el Java gateway de Zabbix.

Descripción general de los archivos

Si obtuvo Java gateway a partir de las fuentes, debería haber terminado con una colección de scripts de shell, archivos JAR y archivos de configuración en $PREFIX/sbin/zabbix_java. La función de estos archivos se resume a continuación.

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

El propio archivo JAR de Java gateway.

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

Dependencias de Java gateway: biblioteca Logback, SLF4J y Android JSON.

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

Archivos de configuración para Logback.

shutdown.sh  
startup.sh

Scripts de conveniencia para iniciar y detener Java gateway.

settings.sh

Archivo de configuración que es cargado por los scripts startup y shutdown anteriores.

Configuración y ejecución de Java gateway

De forma predeterminada, Java gateway escucha en el puerto 10052. Si planea ejecutar Java gateway en un puerto diferente, puede especificarlo en el script settings.sh. Consulte la descripción del archivo de configuración de Java gateway para saber cómo especificar esta y otras opciones.

Una vez que esté conforme con la configuración, puede iniciar Java gateway ejecutando el script startup.sh:

./startup.sh

Del mismo modo, cuando ya no necesite Java gateway, ejecute el script shutdown.sh para detenerlo:

./shutdown.sh

Tenga en cuenta que, a diferencia de server o proxy, Java gateway es ligero y no necesita una base de datos.

Configuración de server para su uso con Java gateway

Con Java gateway en funcionamiento, debe indicar a Zabbix server dónde encontrar Zabbix Java gateway. Esto se hace especificando los parámetros JavaGateway y JavaGatewayPort en el archivo de configuración de server. Si el host en el que se ejecuta la aplicación JMX es supervisado por Zabbix proxy, entonces debe especificar los parámetros de conexión en el archivo de configuración de proxy en su lugar.

JavaGateway=192.168.3.14
JavaGatewayPort=10052

De forma predeterminada, server no inicia ningún proceso relacionado con la supervisión JMX. Sin embargo, si desea usarla, debe especificar el número de instancias pre-fork de Java pollers. Esto se hace del mismo modo que se especifica el número de pollers y trappers normales.

StartJavaPollers=5

No olvide reiniciar server o proxy una vez que haya terminado de configurarlos.

Depuración de Java gateway

En caso de que haya algún problema con Java gateway o de que el mensaje de error que vea sobre un item en el frontend no sea lo suficientemente descriptivo, quizá le convenga revisar el archivo de registro de Java gateway.

De forma predeterminada, Java gateway registra sus गतिविधades en el archivo /tmp/zabbix_java.log con el nivel de registro "info". A veces esa información no es suficiente y se necesita información con el nivel de registro "debug". Para aumentar el nivel de registro, modifique el archivo lib/logback.xml y cambie el atributo level de la etiqueta <root> a debug:

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

Tenga en cuenta que, a diferencia de Zabbix server o Zabbix proxy, no es necesario reiniciar Zabbix Java gateway después de cambiar el archivo logback.xml; los cambios en logback.xml se aplicarán automáticamente. Cuando termine con la depuración, puede volver a establecer el nivel de registro en "info".

Si desea registrar en un archivo diferente o en un medio completamente distinto, como una base de datos, ajuste el archivo logback.xml según sus necesidades. Consulte el Manual de Logback para obtener más detalles.

A veces, con fines de depuración, resulta útil iniciar Java gateway como una aplicación de consola en lugar de un daemon. Para hacerlo, comente la variable PID_FILE en settings.sh. Si se omite PID_FILE, el script startup.sh inicia Java gateway como una aplicación de consola y hace que Logback use el archivo lib/logback-console.xml en su lugar, el cual no solo registra en la consola, sino que también tiene habilitado el nivel de registro "debug".

Por último, tenga en cuenta que, dado que Java gateway usa SLF4J para el registro, puede reemplazar Logback por el framework de su elección colocando el archivo JAR adecuado en el directorio lib. Consulte el Manual de SLF4J para obtener más detalles.

Monitoreo JMX

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