Desenvolvimento Web com Framework Demoiselle versão 1.1

Transcrição

1 Desenvolvimento Web com Framework Demoiselle versão 1.1 Módulo 10: Monitoração de Ambientes Autor: Rodrigo Hjort SERPRO / Coordenação Estratégica de Tecnologia / Curitiba Modificado em: 09/06/2010

2 Licença Esta obra está licenciada sob uma Licença Creative Commons 2

3 Ficha Técnica Tutorial Framework Demoiselle Autor Rodrigo Hjort Serpro / Coordenação Estratégica de Tecnologia Regional Curitiba (CTCTA) Revisor Thiago de Lima Mariano Serpro / Coordenação Estratégica de Tecnologia Regional Salvador (CTSDR) 3

4 Agenda Agenda Definições iniciais Tecnologias SNMP e JMX Modalidades de monitoração Abordagem genérica SNMP Agent e Trapper Abordagem específica Zabbix Agent e Trapper Outros artefatos técnicos Checkers, Appenders e Listeners 4

5 Demoiselle Monitoring Componente Definições Fornece artefatos destinados à monitoração de aplicações em Java Modalidades: Polling e Trapping Servidores: SNMP e Zabbix 5

6 O Protocolo SNMP Comandos GET GETNEXT SET TRAP GETBULK* INFORM* Versões SNMPv1 SNMPv2c SNMPv3 6

7 SNMPv3: Segurança SNMPv3 SNMPv3 == SNMPv2 SNMPv2 ++ segurança segurança 7

8 A Tecnologia JMX JSR JMX 1.2 JMX 2.0 MBeans 8

9 Modalidades de Monitoração Polling (pull / active check) Coleta iniciada pelo servidor em intervalos regulares Configuração centralizada Trapping (push / passive check) Evento iniciado pelo host monitorado Notificações e mensagens tempestivas 9

10 Arquitetura genérica com SNMP : Suíte Especializada (ex: ZABBIX) Agente SNMP UDP :162 5 Trapper SNMP 2 MB 3 MB JMX 4 Servidor Monitorador Aplicação A MB 4 Aplicação B Servidor Java EE (JBoss) Host Monitorado Polling: - 1: Coleta de indicador de forma periódica ou sob demanda (SNMP GET) e alteração de valores de objetos (SNMP SET) através de requisição a um Agente SNMP - 2: Requisição local via JMX na mesma JVM do servidor JEE - 3: Consulta do requisito específico da aplicação através de um ManagedBean Trapping: - 4: Envio de notificação sobre comportamento ou situação anormal na aplicação ou indisponibilidade de serviços externos à um componente Trapper SNMP - 5: Envio de requisição especializada (SNMP TRAP) à um servidor SNMP externo 10

11 Árvore de Serviços (MIB Tree) PEN do SERPRO MIB (Management Information Base): banco de dados virtual organizado hierarquicamente usado para gerenciar as entidades em uma rede de comunicações Clientes / Sistemas Aplicações Requisitos de Negócio Monitoração do Ambiente 11

12 Implementação de Polling = = " ") public class EscolaMonitoring implements EscolaMonitoringMBean = ".1", type = Gauge32.class) public long getqtdalunosmatriculados() = ".2", type = Counter32.class) public int getqtdturmasincluidas() = ".4", access = AccessMode.READ_WRITE, type = OctetString.class) public String getversaoaplicacao() {... 12

13 Configuração do Agente SNMP # enable a SNMP agent that provides a given MIB tree monitoring.snmp.agent.enabled = true # the network protocol to be used (udp or tcp) monitoring.snmp.agent.protocol = udp snmp.properties # the port that the agent listens on (default 1161) monitoring.snmp.agent.port = 1161 # the address to listen on, or '*' to listen on any available address monitoring.snmp.agent.address = * # the MIB root to be considered monitoring.snmp.agent.mib.root = # MBeans to be exported as MIB trees monitoring.snmp.agent.mibs = br.gov.component.demoiselle.monitoring.mbean.demoisellemonitoring, br.gov.sample.demoiselle.escola.monitoring.mbean.escolamonitoring, br.gov.component.demoiselle.monitoring.mbean.jvmmonitoring # security settings (particularly for SNMPv3) monitoring.snmp.agent.security = snmp-security.xml 13

14 Coleta de Valores nas MIBs SNMP snmp*: walk, get, getnext, set 14

15 Definição de Segurança (SNMPv3) <?xml version="1.0" encoding="utf-8"?> <snmp-security> <security> <user name="escola"> <auth protocol="sha" pass="senha123" /> <priv protocol="aes" pass="senha456" /> </user> <user name="zabbix"> <auth protocol="md5" pass="senha321" /> <priv protocol="des" pass="senha654" /> </user> </security> <access-control> <views> <view name="escolareadview"> <include subtree=" " /> </view> <view name="escolawriteview"> <include subtree=" " /> </view> <view name="escolanotifyview"> <include subtree=" " /> </view> </views> <groups> <group name="v3escola"> <security name="escola" model="usm" /> <security name="zabbix" model="usm" /> <access model="usm" auth="true" priv="true" exact="true"> <read view="escolareadview" /> <write view="escolawriteview" /> <notify view="escolanotifyview" /> </access> </group> </groups> </access-control> </snmp-security> Usuários (USM) Visões (VACM) Grupos e Controle de Acesso snmp-security.xml 15

16 Implementação de Trapping = " ") public class EscolaSNMPTrapper extends SNMPTrapper implements IEscolaTrapper = TrapType.ENTERPRISE_SPECIFIC, specifictype = 12345, variablebindings = = ".1", type = = ".2", type = = ".3", type = Counter32.class)) public void sendmessage(string message, int level, int value) = 15, variablebindings = = ".1", type = = ".2", type = Gauge32.class)) public void senddatabaseinfo(string datasource, int connections) = 5, variablebindings = ".1", type = OctetString.class)) public void sendfailure(string message) { 16

17 Configuração do Trapper SNMP # enable a SNMP trapper that sends data to the server monitoring.snmp.trapper.enabled = true snmp.properties # the network protocol to be used (udp or tcp) monitoring.snmp.trapper.protocol = udp # name or IP address of the machine that SNMP server runs on monitoring.snmp.trapper.server = # the port of SNMP on its server (default 162) monitoring.snmp.trapper.port = 162 # name of the community to be considered monitoring.snmp.trapper.community = public # SNMP version (v1, v2c or v3) monitoring.snmp.trapper.version = v1 # enterprise OID for sending traps monitoring.snmp.trapper.enterprise_oid = # default generic trap type monitoring.snmp.trapper.generic_type = 6 # default specific trap type monitoring.snmp.trapper.specific_type = 1 # default application trap OID for sending traps monitoring.snmp.trapper.application_trap_oid =

18 Envio e Recebimento de Traps public class CustomTrappersUsage { public void dosomethinggood() { IEscolaTrapper trapper = EscolaSNMPTrapper.getInstance(); trapper.sendheapmemoryused(); trapper.senddatabaseinfo("db1", 500); public void dosomethingbad() { try { throw new Exception("An error occurred intentionally"); catch (Exception e) { EscolaSNMPTrapper.getInstance(). sendfailure(e.getmessage()); 18

19 Arquitetura específica com Zabbix : Suíte Especializada (ex: ZABBIX) TCP : MB Agente Zabbix 2 3 JMX Trapper Zabbix Servidor Monitorador MB MB 4 4 Aplicação A Aplicação B Servidor Java EE (JBoss) Host Monitorado Polling: - 1: Coleta de indicador de forma periódica ou sob demanda (polling) usando o protocolo v1.4 do Zabbix através de requisição a um Agente Zabbix - 2: Requisição local via JMX na mesma JVM do servidor JEE - 3: Consulta do requisito específico da aplicação através de um MBean Trapping: - 4: Envio de notificação sobre comportamento ou situação anormal na aplicação ou indisponibilidade de serviços externos a um componente Trapper Zabbix - 5: Envio de requisição especializada (trapping) a um servidor Zabbix 19

20 Implementação de Polling = "br.gov.demoiselle:name=escola") public class EscolaMonitoring implements EscolaMonitoringMBean { public long getqtdalunosmatriculados() {... public int getqtdturmasincluidas() {... public String getultimousuariologado() {... public String getversaoaplicacao() {... Again! 20

21 Configuração do Agente Zabbix # enable a Zabbix agent that handles JMX queries monitoring.zabbix.agent.enabled = true # the port that the agent listens on (default 10052) monitoring.zabbix.agent.port = # the address to listen on, or '*' to listen on any available address monitoring.zabbix.agent.address = * # protocol version to use (default 1.4) monitoring.zabbix.agent.protocol = 1.4 zabbix.properties 21

22 Implementação de Trapping public class EscolaZabbixTrapper extends ZabbixTrapper implements IEscolaTrapper = "escola.message") public void sendfailure(string message) = "escola.database[*]") public void senddatabaseinfo( String datasource, int connections) { Chave (Key) do Zabbix parametrizada com = "escola.versao", mbeanname = "br.gov.demoiselle:name=escola", mbeanattribute = "VersaoAplicacao") public void sendversaoaplicacao() = "escola.memory[used]", mbeanname = "java.lang:type=memory", mbeanattribute = "HeapMemoryUsage.used") public void sendheapmemoryused() { Invocação de MBeans da JVM ou customizados 22

23 Configuração do Trapper Zabbix # enable a Zabbix trapper that sends data to the server monitoring.zabbix.trapper.enabled = true # name or IP address of the machine that Zabbix runs on monitoring.zabbix.trapper.server = # the port of Zabbix on its server (default 10051) monitoring.zabbix.trapper.port = # name of the host as defined in the hosts section in Zabbix monitoring.zabbix.trapper.host = Armenia Zabbix # schedule automatic trapping of active checks monitoring.zabbix.trapper.active_checks = false zabbix.properties 23

24 Envio de Traps ao Zabbix public class CustomTrappersUsage { public void dosomethinggood() { IEscolaTrapper trapper = EscolaZabbixTrapper.getInstance(); trapper.sendheapmemoryused(); trapper.senddatabaseinfo("db1", 500); ZabbixTrapper.getInstance(). send("escola.message", "Hello Zabbix"); public void dosomethingbad() { try { throw new Exception("An error occurred intentionally"); catch (Exception e) { EscolaZabbixTrapper.getInstance(). sendfailure(e.getmessage()); 24

25 Checkers (Verificadores) public class EscolaChecker extends GenericChecker private EscolaSNMPTrapper private EscolaZabbixTrapper = 30, unit = TimeUnit.SECONDS) public void checkdatabases() { snmptrapper.senddatabaseinfo("db1", conn1); snmptrapper.senddatabaseinfo("db3", = 1, unit = TimeUnit.MINUTES) public void checkusedmemory() { snmptrapper.sendheapmemoryused(); zabbixtrapper.sendheapmemoryused(); 25

26 Log4j Trapping Appenders public class LogAppendersUsage { private static final Logger log = Logger.getLogger(LogAppendersUsage.class); public static void main(string[] args) { log.debug("debug Message"); log.info("info Message"); log.warn("warning Message"); log.error("error Message"); # Zabbix Log4j Appender log4j.appender.zabbix=br.gov.component.demoiselle.monitoring.logger.zabbix.zabbixappender log4j.appender.zabbix.layout=org.apache.log4j.patternlayout log4j.appender.zabbix.layout.conversionpattern=[%d{mmm dd HH:mm:ss] %-5p (%F:%L) - %m%n log4j.appender.zabbix.threshold=error log4j.appender.zabbix.key=escola[logger] # SNMP Log4j Appender log4j.appender.snmp=br.gov.component.demoiselle.monitoring.logger.snmp.snmpappender log4j.appender.snmp.layout=org.apache.log4j.patternlayout log4j.appender.snmp.layout.conversionpattern=[%d{mmm dd HH:mm:ss] %-5p (%F:%L) - %m%n log4j.appender.snmp.threshold=error log4j.appender.snmp.enterpriseoid= log4j.appender.snmp.generictraptype=6 log4j.appender.snmp.specifictraptype=15 log4j.appender.snmp.applicationtrapoid=

27 Servlet Context Listeners (Web) <?xml version="1.0" encoding="utf-8"?> <web-app... version="2.5">... <!-- Demoiselle Monitoring Configuration --> <!-- SNMP --> <listener> <listener-class> br.gov.component.demoiselle.monitoring.web.snmp.snmplistener </listener-class> </listener> <!-- Zabbix --> <listener> <listener-class> br.gov.component.demoiselle.monitoring.web.zabbix.zabbixlistener </listener-class> </listener>... </web-app> WEB-INF/web.xml 27

28 Configurações Gerais MBeans # JMX MBeans to be loaded on application startup component.demoiselle.monitoring.jmx.mbeans = br.gov.sample.demoiselle.escola.monitoring.mbean.escolamonitoring, br.gov.component.demoiselle.monitoring.mbean.demoisellemonitoring, br.gov.component.demoiselle.monitoring.mbean.jvmmonitoring # Custom trapper classes to be loaded on application startup Trappers component.demoiselle.monitoring.trappers = br.gov.sample.demoiselle.escola.monitoring.snmp.escolasnmptrapper, br.gov.sample.demoiselle.escola.monitoring.zabbix.escolazabbixtrapper Checkers # Custom checker classes to be loaded on application startup component.demoiselle.monitoring.checkers = br.gov.sample.demoiselle.escola.monitoring.checker.escolachecker demoiselle.properties 28

29 Pontos de = = ".1.5.2") public class JVMMonitoring implements JVMMonitoringMBean = ".1", access = AccessMode.READ_ONLY, type = Gauge32.class) public int getloadedclasscount() { Integer value = (Integer) MBeanHelper.query( "java.lang:type=classloading", "LoadedClassCount"); return = ".2", access = AccessMode.READ_ONLY, type = Gauge32.class) public long getheapmemoryused() { Long value = (Long) MBeanHelper.query( "java.lang:type=memory", "HeapMemoryUsage.used"); return value; MBeans pré-definidas 29

30 Laboratório Laboratório 10 Exercício 10 Objetivos Implementar polling e trapping SNMP Implementar polling e trapping Zabbix Implementar checkers Utilizar trapping padrão e appenders Log4j 30

31 Contato Tutorial Framework Demoiselle Comunidade Demoiselle Colaborações Lista 31