Table of Contents
1 Instalação a partir do código-fonte
Visão geral
Se instalado a partir do código-fonte, as informações a seguir ajudarão você a configurar o Java gateway do Zabbix.
Visão geral dos arquivos
Se você obteve o Java gateway a partir do código-fonte, deve ter terminado com uma coleção de scripts shell, arquivos JAR e arquivos de configuração em $PREFIX/sbin/zabbix_java. O papel desses arquivos é resumido abaixo.
Arquivo JAR do Java gateway propriamente dito.
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.jarDependências do Java gateway: Logback, SLF4J e biblioteca Android JSON.
Arquivos de configuração para o Logback.
Scripts de conveniência para iniciar e parar o Java gateway.
Arquivo de configuração que é incluído pelos scripts de inicialização e desligamento acima.
Configurando e executando o Java gateway
Por padrão, o Java gateway escuta na porta 10052. Se você planeja executar o Java gateway em uma porta diferente, pode especificar isso no script settings.sh. Veja a descrição do arquivo de configuração do Java gateway para saber como especificar esta e outras opções.
A porta 10052 não é registrada na IANA.
Depois de ajustar as configurações, você pode iniciar o Java gateway executando o script de inicialização:
Da mesma forma, quando não precisar mais do Java gateway, execute o script de desligamento para pará-lo:
Observe que, ao contrário do server ou proxy, o Java gateway é leve e não precisa de um banco de dados.
Configurando o server para uso com o Java gateway
Com o Java gateway em execução, você deve informar ao Zabbix server onde encontrar o Zabbix Java gateway. Isso é feito especificando os parâmetros JavaGateway e JavaGatewayPort no arquivo de configuração do server. Se o host no qual a aplicação JMX está em execução for monitorado por um Zabbix proxy, então você deve especificar os parâmetros de conexão no arquivo de configuração do proxy.
Por padrão, o server não inicia nenhum processo relacionado ao monitoramento JMX. Se você deseja usá-lo, deve especificar o número de instâncias pré-iniciadas de Java pollers. Você faz isso da mesma forma que especifica pollers e trappers regulares.
Não se esqueça de reiniciar o server ou proxy após terminar de configurá-los.
Depuração do Java gateway
Caso haja algum problema com o Java gateway ou uma mensagem de erro que você veja sobre um item no frontend não seja descritiva o suficiente, você pode querer dar uma olhada no arquivo de log do Java gateway.
Por padrão, o Java gateway registra suas atividades no arquivo /tmp/zabbix_java.log com o nível de log "info". Às vezes, essa informação não é suficiente e há necessidade de informações no nível de log "debug". Para aumentar o nível de log, modifique o arquivo lib/logback.xml e altere o atributo level da tag <root> para "debug":
Observe que, ao contrário do Zabbix server ou Zabbix proxy, não há necessidade de reiniciar o Zabbix Java gateway após alterar o arquivo logback.xml - as alterações em logback.xml serão aplicadas automaticamente. Quando terminar a depuração, você pode retornar o nível de log para "info".
Se desejar registrar em um arquivo diferente ou em um meio completamente diferente, como um banco de dados, ajuste o arquivo logback.xml conforme necessário. Veja o Manual do Logback para mais detalhes.
Às vezes, para fins de depuração, é útil iniciar o Java gateway como um aplicativo de console em vez de um daemon. Para isso, comente a variável PID_FILE em settings.sh. Se PID_FILE for omitida, o script startup.sh inicia o Java gateway como um aplicativo de console e faz com que o Logback use o arquivo lib/logback-console.xml, que não apenas registra no console, mas também tem o nível de log "debug" ativado.
Por fim, observe que, como o Java gateway usa SLF4J para registro em log, você pode substituir o Logback pelo framework de sua escolha colocando um arquivo JAR apropriado no diretório lib. Veja o Manual do SLF4J para mais detalhes.
Monitoramento JMX
Consulte a página Monitoramento JMX para mais detalhes.