韓誥傭痔

Table of Contents

5 Java gateway

5 Java gateway

Vis?o geral

O 韓誥傭痔 2.0 inovou com o suporte nativo ao monitoramento de aplica??es Java atrav谷s de JMX, este suporte foi adicionado atrav谷s do componente "韓誥傭痔 Java Gateway". Ele 谷 um processo de background (daemon) escrito em Java. Quando o 韓誥傭痔 Server precisa coletar um item (dado) atrav谷s de um contador JMX em um host, ele solicita ao 韓誥傭痔 Java Gateway, que utiliza a para requisitar da aplica??o o dado de interesse. A aplica??o n?o precisa de softwares adicionais, apenas necessita ter sido iniciada com a op??o -Dcom.sun.management.jmxremote no momento de sua inicializa??o (linha de comando).

O 韓誥傭痔 Java Gateway aceita conex?es oriundas do 韓誥傭痔 Server e do 韓誥傭痔 Proxy e s車 pode ser utilizado como um "proxy passivo". Ao contr芍rio do que ocorre com um 韓誥傭痔 Proxy o 韓誥傭痔 Java Gateway pode estar atr芍s de outro proxy (um 韓誥傭痔 Proxy). O acesso a cada 韓誥傭痔 Java Gateway 谷 configurado diretamente no arquivo de configura??o do 韓誥傭痔 Server ou do 韓誥傭痔 Proxy e s車 pode existir um 韓誥傭痔 Java Gateway por 韓誥傭痔 Server ou 韓誥傭痔 Proxy. Se voc那 precisar de ter mais de um 韓誥傭痔 Java Gateway em um mesmo ambiente da solu??o 韓誥傭痔 voc那 precisar芍 configurar um novo 韓誥傭痔 Proxy para cada 韓誥傭痔 Java Gateway. Se um host possuir itens do tipo JMX agent e itens de outros tipos, apenas os itens do tipo JMX agent ser?o solicitados ao 韓誥傭痔 Java Gateway.

O 韓誥傭痔 Java Gateway n?o faz cache de nenhum valor coletado.

O 韓誥傭痔 Server ou 韓誥傭痔 Proxy tem um processo espec赤fico para se conectar ao 韓誥傭痔 Java Gateway, controlado pela op??o StartJavaPollers. Internamente o 韓誥傭痔 Java Gateway inicia m迆ltiplas threads, controladas pela op??o START_POLLERS. No lado do servidor, se a conex?o demorar mais do que o limite em segundos da op??o Timeout, a requisi??o ser芍 terminada (abortada), mas o 韓誥傭痔 Java Gateway continuar芍 aguardando pela coleta do contador JMX. Para resolver isso, desde o 韓誥傭痔 2.0.15, 韓誥傭痔 2.2.10 e 韓誥傭痔 2.4.5 foi adicionada a op??o TIMEOUT no 韓誥傭痔 Java Gateway que permite definir o tempo m芍ximo para as opera??es remotas do JMX.

O 韓誥傭痔 Server ou o 韓誥傭痔 Proxy ir芍 agrupar as requisi??es em uma 迆nica requisi??o JMX, sempre que poss赤vel (谷 afetado pelos intervalos entre coletas), e enviar para o 韓誥傭痔 Java Gateway em uma 迆nica conex?o visando obter melhor performance.

? recomend芍vel configurar a op??o StartJavaPollers com valor menor ou igual 角 op??o START_POLLERS, de outra forma existir?o situa??es onde n?o existir?o trheads dispon赤veis para atender 角s requisi??es.

A sess?o abaixo descreve como obter e como executar o 韓誥傭痔 Java Gateway, como configurar o 韓誥傭痔 Server (ou 韓誥傭痔 Proxy) para usar o 韓誥傭痔 Java Gateway para monitora??o JMX, e como configurar os itens do 韓誥傭痔 em sua interface web para coletar um contador JMX espec赤fico.

When an item has to be updated over Java gateway, 韓誥傭痔 server or proxy will connect to the Java gateway and request the value, which Java gateway in turn retrieves and passes back to the server or proxy. As such, Java gateway does not cache any values.

韓誥傭痔 server or proxy has a specific type of processes that connect to Java gateway, controlled by the option StartJavaPollers. Internally, Java gateway starts multiple threads, controlled by the START_POLLERS option. On the server side, if a connection takes more than Timeout seconds, it will be terminated, but Java gateway might still be busy retrieving value from the JMX counter. To solve this, there is the TIMEOUT option in Java gateway that allows to set timeout for JMX network operations.

韓誥傭痔 server or proxy will try to pool requests to a single JMX target together as much as possible (affected by item intervals) and send them to the Java gateway in a single connection for better performance.

It is suggested to have StartJavaPollers less than or equal to START_POLLERS, otherwise there might be situations when no threads are available in the Java gateway to service incoming requests; in such a case Java gateway uses ThreadPoolExecutor.CallerRunsPolicy, meaning that the main thread will service the incoming request and temporarily will not accept any new requests.

If you are trying to monitor Wildfly-based Java applications with 韓誥傭痔 Java gateway, please install the latest jboss-client.jar available on the .

5.1 Obtendo o 韓誥傭痔 Java Gateway

Existem duas formas de se obter o 韓誥傭痔 Java Gateway. A primeira forma 谷 adquirir o pacote do 韓誥傭痔 Java Gateway package do site da 韓誥傭痔 e a segunda 谷 compilar a partir de seu c車digo fonte.

5.1.1 Adquirir do site da 韓誥傭痔

Os pacotes do 韓誥傭痔 Java Gateway (RHEL, Debian, Ubuntu) est?o dispon赤veis para download em .

5.1.2 Compilando a partir do c車digo fonte

Para compilar o 韓誥傭痔 Java Gateway, primeiramente execute o script ./configure com o par?metro --enable-java. ? aconselh芍vel que voc那 especifique tamb谷m o par?metro --prefix para utilizar outro caminho que n?o o padr?o (/usr/local), o 韓誥傭痔 Java Gateway ir芍 criar toda a 芍rvore de diret車rios, n?o somente o execut芍vel.

$ ./configure --enable-java --prefix=$PREFIX

Para compilar e empacotar o 韓誥傭痔 Java Gateway em um arquivo JAR, execute o make. Observe que para este passo voc那 precisar芍 dos execut芍veis javac e jar em seu path.

$ make

Ap車s a execu??o do make ser芍 criado o arquivo zabbix-java-gateway-$VERSION.jar em src/zabbix_java/bin. Se voc那 preferir poder芍 ajustar o 韓誥傭痔 Java Gateway para funcionamento a partir de src/zabbix_java no diret車rio da distribu??o, para tanto, precisar芍 seguir as instru??es de configura??o e execu??o do 韓誥傭痔 Java Gateway. Caso contr芍rio, se voc那 possuir privil谷gios suficientes, execute make install.

$ make install

5.2 Vis?o geral dos arquivos na da distribui??o do 韓誥傭痔 Java Gateway

Independentemente da forma de obten??o do 韓誥傭痔 Java Gateway, neste momento voc那 possui uma colet?nia de scripts para o shell, arquivos JAR e arquivos de configura??o localizados em $PREFIX/sbin/zabbix_java. O papel deles 谷 descrito a seguir:

O 韓誥傭痔 Java Gateway em s赤.

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

Depend那ncias do 韓誥傭痔 Java Gateway: , , e library.

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

Arquivos de configura??o de log.

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

Scripts para inicializa??o e finaliza??o do 韓誥傭痔 Java Gateway.

shutdown.sh  
       startup.sh

Arquivo de configura??o dos scripts anteriores.

settings.sh

5.3 Configurando e executando o 韓誥傭痔 Java gateway

Por padr?o o 韓誥傭痔 Java Gateway escuta a porta 10052. Se voc那 planeja executa-lo em outra porta 谷 poss赤vel a configura??o usando o script settings.sh. Veja a descri??o do arquivo de configura??o do 韓誥傭痔 Java Gateway para melhor entendimento de suas op??es.

A porta 10052 n?o 谷 .

Uma vez que as configura??es estejam conforme sua necessidade, voc那 poder芍 inicia-lo atrav谷s do script de inicializa??o:

$ ./startup.sh

Por outro lado, se voc那 necessita de parar o servi?o, execute o script de finaliza??o:

$ ./shutdown.sh

Diferentemente do 韓誥傭痔 Server e do 韓誥傭痔 Proxy o 韓誥傭痔 Java Gateway 谷 leve e n?o necessita de um banco de dados.

5.4 Configurando o 韓誥傭痔 Server para uso em conjunto com o 韓誥傭痔 Jav Gateway Java gateway

Neste momento o 韓誥傭痔 Java Gateway est芍 apto para execu??o e voc那 pode configurar o 韓誥傭痔 Server para que ele saiba localiza-lo. Esta tarefa pode ser conclu赤da especificando os par?metros JavaGateway e JavaGatewayPort no arquivo de configura??o do 韓誥傭痔 Server. Se o host com a aplica??o JMX em execu??o for monitorado atrav谷s de um 韓誥傭痔 Porxy, voc那 dever芍 definir tais par?metros no arquivo de configura??o do proxy.

JavaGateway=192.168.3.14
       JavaGatewayPort=10052

Por padr?o o 韓誥傭痔 Server n?o inicia nenhum processo relacionado 角 monitora??o JMX. Se voc那 necessita deste tipo de monitora??o dever芍 especificar uma quantidade de processos de pooler Java a serem pr谷-alocados. Esta configura??o 谷 feita no mesmo arquivo atrav谷s do par?metro a seguir:

StartJavaPollers=5

N?o se esque?a de reiniciar o 韓誥傭痔 Server ou 韓誥傭痔 Proxy ap車s alterar suas configura??es.

5.5 Debugando o 韓誥傭痔 Java Gateway

Caso ocorram problemas com o 韓誥傭痔 Java Gateway ou caso a mensagem de erro apresentada na interface web do 韓誥傭痔 n?o seja clara o suficiente, voc那 poder芍 necessitar analisar o arquivo de log do 韓誥傭痔 Java Gateway.

Por padr?o, as atividades do 韓誥傭痔 Java Gateway s?o registradas no arquivo /tmp/zabbix_java.log com o n赤vel de log: "info". Algumas vezes o n赤vel de detalhe da informa??o l芍 constante pode n?o ser suficiente, sendo necess芍rio o incremento da quantidade de informa??es registradas. Este incremento de n赤vel de log pode ser feito ao modificar o arquivo lib/logback.xml modificando o par?metro "level" da tag <root> para "debug":

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

Observe que, diferentemente do 韓誥傭痔 Server ou 韓誥傭痔 Proxy, n?o 谷 necess芍rio o reinicio do 韓誥傭痔 Java Gateway quando o arquivo logback.xml 谷 modificado. Quando voc那 concluir o debug, poder芍 retornar o n赤vel para "info".

Se voc那 necessitar de registrar o log de outras formas, poder芍 ajustar o logback.xml conforme suas necessidades. Observe o para mais detalhes.

Algumas vezes para as a??es de debug 谷迆til iniciar o 韓誥傭痔 Java Gateway 谷迆til inicia-lo como uma aplica??o de console (shell) ao inv谷s do modo de background (daemon). Para fazer isso comente a vari芍vel PID_FILE em settings.sh. Se a vari芍vel PID_FILE estiver ausente, o script startup.sh iniciar芍 o 韓誥傭痔 Java Gateway como uma aplica??o de console e configurar芍 o Logback para o arquivo lib/logback-console.xml, tal configura??o n?o apenas demonstrar芍 as mensagens na console, tamb谷m ir芍 habilitar o modo de log para "debug".

Finalmente, observe que o 韓誥傭痔 Java Gateway usa o SLF4J para as atividades de log, voc那 pode substituir o Logback pelo framework de sua escolha ao colocar o arquivo JAR apropriado dentro do diret車rio lib. Para mais detalhes consulte o .