Table of Contents
1 Setup a partir de fontes
Visão Geral
Se instalado installed a partir de fontes, as seguintes informações irão ajudá-lo a configurar o Zabbix Java gateway.
Visão Geral dos Arquivos
Se você obteve o Java gateway a partir das fontes, você deve ter acabado com uma coleção de scripts shell, JAR e arquivos de configuração em $PREFIX/sbin/zabbix_java. O papel desses arquivos é resumido abaixo.
O próprio arquivo JAR do Java gateway. lib/logback-core-0.9.27.jar lib/logback-classic-0.9.27.jar lib/slf4j-api-1.6.1.jar lib/android-json-4.3_r3.1.jar
Dependências do Java gateway: Bibliotecas Logback, SLF4J, e Android JSON.
Arquivos de configuração para Logback.
Scripts de conveniência para iniciar e parar Java gateway.
Arquivo de configuração que é fonte para os 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, você pode especificar isso no script settings.sh. Consulte a descrição do arquivo de configuração do Java gateway Java gateway configuration file para especificar esta e outras opções.
A porta Port 10052 não está registrada IANA registered.
Uma vez que você esteja confortável com as configurações, pode iniciar o Java gateway executando o script de inicialização:
Da mesma forma, uma vez que você não precise mais do Java gateway, execute o script de desligamento para pará-lo:
Observe que, ao contrário do servidor ou do proxy, o Java gateway é leve e não precisa de um banco de dados.
Configurando os servidor para usar o Java gateway
Com o Java gateway funcionando, você precisa informar ao servidor Zabbix onde encontrar o Java gateway do Zabbix. Isso é feito especificando os parâmetros JavaGateway e JavaGatewayPort no arquivo de configuração do servidor server configuration file. Se o host no qual a aplicação JMX está sendo executada estiver sendo monitorado por um proxy Zabbix, então você especifica os parâmetros de conexão no arquivo de configuração do proxy proxy configuration file.
Por padrão, o servidor não inicia nenhum processo relacionado ao monitoramento JMX. Se você deseja usá-lo, no entanto, você precisa especificar o número de instâncias predefinidas dos pollers Java. Você faz isso da mesma forma que especifica os pollers e trappers regulares.
Não se esqueça de reiniciar o servidor ou o proxy assim que terminar de configurá-los.
Debugando Java gateway
Caso haja algum problema com o Java gateway ou uma mensagem de erro que você vê sobre um item no frontend não seja descritiva o suficiente, você pode 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 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 registro, modifique o arquivo lib/logback.xml e altere o atributo de nível da tag <root> para "debug":
Observe que, ao contrário do servidor ou do proxy Zabbix, não é necessário reiniciar o Java gateway do Zabbix após alterar o arquivo logback.xml - as alterações no logback.xml serão automaticamente reconhecidas. Quando terminar a debugging, 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 para atender às suas necessidades. Para mais detalhes, consulte o manual Logback Manual.
Às vezes, para fins de debugging, é útil iniciar o Java gateway como um aplicativo de console em vez de um daemon. Para fazer isso, comente a variável PID_FILE em settings.sh. Se o PID_FILE for omitido, 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.
Finalmente, observe que, como o Java gateway usa o SLF4J para registro, você pode substituir o Logback pelo framework de sua escolha colocando um arquivo JAR apropriado no diretório lib. Para mais detalhes, consulte o manual SLF4J Manual.
Monitoramento JMX
Para mais detalhes, consulte a página JMX monitoring.