Estes dias eu postei nas redes sociais que havia terminado de implementar um monitoramento bem específico.

Se tratava de ter implementado o monitoramento de um JBOSS utilizando o Zabbix e a ferramenta Zapcat.

Então um colega, o André Deo, me perguntou quando eu escreveria sobre isso, a propósito esta é uma deficiência grave que tenho quando faço as coisas, não gostar de documentar, então eu disse a ele que faria um txt e enviaria pra ele, mas nem isso eu fiz .

Então eu resolvi hoje, nessa bela sexta-feira, fazer o tal documento e ensinar a você como se monitora o seu JBOSS com o Zabbix usando o Zapcat, mas não vou utilizar prints de tela, vou só ensinar mesmo como você deve proceder ok!? Fechado! Bora lá então…

Contando que você já tenha seu Zabbix instalado e configurado, bem como seu servidor Linux com JBOSS instalado e configurado, e pode até estar monitorando o servidor Linux onde está o JBOSS com o Zabbix, os passos a seguir já podem ser seguidos, mas antes vamos aos detalhes.

O Zapcat

O que é o Zapcat? O zapcat nada mais é que uma pacote java que é “deployado” no seu servidor JBOSS e que, além de uma interface Web onde você pode visualizar os Itens suportados para o monitoramento, lhe dará um agente Zabbix completinho funcionando dentro do seu JBOSS.

Este agente funciona em uma porta diferente do agente padrão  do Zabbix, funciona na porta 10052 ao invés da porta usual do agente zabbix que é a 10050.

Outro aspecto interessante é que os itens que você pode criar não não tem nada de diferente de um item padrão utilizando o agente Zabbix, exceto as chaves que serão utilizadas no item.

Mas além disso, o Zapcat, para adiantar sua vida difícil de Sysadmin, te da um template Java prontinho pra você usar com Itens, Triggers e Gráficos.

Então vamos a prática.

Baixe o Zapcat daqui http://sourceforge.net/projects/zapcat/, descompacte e localize o arquivo “zapcat-1.2.war” dentro da pasta descompactada.

Localize também a pasta template, e dentro dela localize o arquivo Template_Java.xml.

Pronto, meio caminho andado…Porra, mas ai você vai me falar, como assim meio caminho andado?  Pois é, é muito simples e já está quase tudo pronto.

Com os devidos arquivos localizados, vamos a implementação do monitoramento.

Primeiramente seu servidor Zabbix deverá ter acesso a porta 10052 do servidor que você quer monitorar.

Segundo, faça um backup do template java que já vem por padrão no Zabbix, modificando seu nome para qualquer coisa que você queira. Feito isso você vai importar o Template_Java.xml que falamos logo acima para o Zabbix, que por sua vez já criará para você um template para monitorar os Servidores JBOSS já com alguns Itens, Triggers e Gráficos.

Feito isso o próximo passo é fazer o deploy do arquivo “zapcat-1.2.war” no seu AS. Para isso você terá que simplesmente copiar o arquivo “.war” acima para dentro da diretório “${JBOSS_HOME}/server/default/deploy”. Não precisa nem reiniciar o JBOSS. Neste momento o Zapcat já estará instalado e o Zabbix configurado para monitorar o seu JBOSS AS.

Bom, agora você terá que adicionar o Servidor ao Zabbix.

Putz, ai você vai me falar: Carinha, eu já tenho este servidor cadastrado no Zabbix!!

E eu vou lhe dizer: Adiciona novamente mas mudando o nome do host, tipo adicionando a palavra “zapcat” na frente dele, e ao invés de usar a porta padrão pré configurada na adição do host, tu muda para a porta do zapcat, que é a 10052.

Beleza, já no ato da adição tu pode associar seu novo “host-zapcat” ao Template_Java que criamos agora a pouco.

Pronto, zapcat instalado e monitorando o JBOSS.

Para você ver os itens disponíveis para monitoramento você pode acessar a seguinte url:

http://ip.do.servidor.jboss:8080/zapcat-1.2/ <- interfacezinha web falando do zapcat.

http://ip.do.servidor.jboss:8080/zapcat-1.2/mbean.jsp <- Lista de intens e parametros que você pode monitorar no seu JBOSS AS. Ou simplesmente clique em “mbeam list” na interfacezinha que eu mostrei acima.

Obviamente teremos agora as restrições . Vamo então as observações sobre o Zapcat:

- Se o monitoramento não funcionar de cara você terá que acessar primeiro o jmx-console do AS para o Zapcat passar a funcionar. Eu não sei por que cargas d’agua isso acontece, mas se tu não acessar http://ip.do.seu.jboss:8080/jmx-console antes de começar a monitorar em alguns casos. Se não fizer isso o maldito zapcat não funciona. Tipo que não precisa fazer nada na jmx-console, é só acessar que o zapcat passa a funcionar.

- O template do zapcat não funciona com Zabbix Server 1.8.3, sei que a partir do 1.8.4 funciona bem e com o Zabbix Server 1.6 também funciona.

- O zapcat-1.2.war não funciona no JBOSS AS 4.0.2, a partir do 4.2 já pode usar sem medo de ser feliz.

Déo, tá ai, acho que melhor que o txt que eu prometi

Abraços