Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

1 Instalación desde fuentes

Descripción general

Si se ha instalado desde fuentes, la siguiente información le ayudará a configurar el Java gateway de Zabbix.

Descripción general de los archivos

Si obtuvo Java gateway desde el código fuente, debería terminar con una colección de scripts de shell, archivos JAR y archivos de configuración bajo $PREFIX/sbin/zabbix_java. El papel de estos archivos se resume a continuación.

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

Archivo JAR de Java gateway en sí mismo.

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: Logback, SLF4J y la biblioteca 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 referenciado por los scripts de inicio y detención mencionados anteriormente.

Configuración y ejecución de Java gateway

Por defecto, 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.

El puerto 10052 no está registrado en IANA.

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

./startup.sh

Del mismo modo, cuando ya no necesite Java gateway, ejecute el script de apagado para detenerlo:

./shutdown.sh

Tenga en cuenta que, a diferencia del servidor o el proxy, Java gateway es liviano y no necesita una base de datos.

Configuración del servidor para su uso con Java gateway

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

JavaGateway=192.168.3.14
       JavaGatewayPort=10052

Por defecto, el servidor no inicia ningún proceso relacionado con la monitorización JMX. Sin embargo, si desea utilizarlo, debe especificar el número de instancias pre-forked de Java pollers. Esto se hace de la misma manera que se especifican los pollers y trappers regulares.

StartJavaPollers=5

No olvide reiniciar el servidor o el 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 el mensaje de error que vea sobre una métrica en la interfaz web no sea lo suficientemente descriptivo, puede que desee revisar el archivo de registro de Java gateway.

Por defecto, Java gateway registra sus actividades 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 del servidor Zabbix o el proxy Zabbix, no es necesario reiniciar Java gateway después de cambiar el archivo logback.xml: los cambios en logback.xml se aplicarán automáticamente. Cuando termine de depurar, puede devolver el nivel de registro a "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 más detalles.

A veces, para fines de depuración, es útil iniciar Java gateway como una aplicación de consola en lugar de como un demonio. Para ello, 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 utilice el archivo lib/logback-console.xml en su lugar, que 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 utiliza SLF4J para el registro, puede reemplazar Logback por el framework de su elección colocando el archivo JAR correspondiente en el directorio lib. Consulte el Manual de SLF4J para más detalles.

Monitorización JMX

Consulte la página Monitorización JMX para más detalles.