Configuración en Pandora   CONFIGURACIÓN El fichero de configuración del plugin para monitorización de JMX se divide en bloques: Datos de conexión ######################################################################## ## Connection data ######################################################################## ## URL endpoint of the target server ## Tomcat (example) #server_url http://localhost:8080/jolokia ## Websphere (example) #server_url http://localhost:49163/jolokia ## Weblogic (example) #server_url http://192.168.70.237:7001/jolokia ## Product; product id of an specific technology ## (tomcat, jboss, weblogic, websphere, etc). By default the plugin uses autodetection #product weblogic ## Timeout in seconds for an HTTP request (By default 180) # timeout 180 server_url Indica la dirección url donde está desplegada la aplicación Jolokia . product Se recomienda definir este campo, ya que el proceso de autodetección puede llevartiempo. Indique el producto que se va a monitorizar: tomcat, jboss, weblogic, websphere,etc. Debug ######################################################################## ## Others ######################################################################## ## Plugin log output will be fully verbose (with debug information) #debug 1 debug Establezca el valor de este campo a 1 para ver información detallada en el log de ejecución del plugin. Por defecto en /tmp/pandora_jmx_plugin.log Alcance de la monitorización ######################################################################## ## Monitoring checks ######################################################################## ## Server info checks server_info ## OS info checks os_info ## Monitor deployed web applications webapp_info ## Include also monitoring for internal applications (console, consolehelp,...) #include_internal_webapps 0 ## This list will be used later by "servlets_list_info" ## check like a white list (only the following servlets will be checked) ## Tomcat monitoring #use_only_servlets_begin #WebModule=//localhost/examples,name=HelloWorldExample #WebModule=//localhost/host-manager,name=HTMLHostManager #WebModule=//localhost/examples,name=wsSnake #use_only_servlets_end ## Websphere monitoring #use_only_servlets_begin #WebModule=DefaultCell01,name=jolokia_war #WebModule=DefaultCell01,name=Helloworld_war #use_only_servlets_end ## Weblogic monitoring #use_only_servlets_begin #WebModule=WL_PROXY,name=JspServlet #use_only_servlets_end # Servlets info # (by default all Servlets deployed in the App server; will use use_only_servlets list to restrict target Servlets checked) #servlets_list_info ## Servlet monitoring, retrieve attributes from detected servlets #servlet_attributes startTime loadTime,servletClass,requestCount,loadOnStartup Puede configurar el plugin para reportar la información que necesite: server_info Generar módulos con información del servidor JMX (1) o no (0). os_info Agregar los módulos de monitorización del sistema operativo (1) o no (0). webapp_info Monitorizar las aplicaciones desplegadas en el servidor JMX (1) o no (0). Si combina este parámetro con agent_per_instance , se crearán tantos agentes como aplicaciones tenga desplegadas. Esta funcionalidad se ha comprobado con Weblogic únicamente, su comportamiento puede no ser el esperado con otros servidores de aplicaciones. include_internal_webapps Incluir en la lista de aplicaciones web monitorizadas, las aplicaciones internas del servidor JMX (1) o no (0). servlets_list_info La monitorización basada en servlets nos permite recibir información de la disponibilidad de los mismos. Puede configurar servlets específicos a monitorizar especificando: use_only_servlets_begin Se restringirá la monitorización de servlets a los especificados línea a línea tras esta etiqueta. use_only_servlets_end Indica el final de la definición de servlets. Nota: Si utiliza servlets_list_info y no define el bloque use_only_servlets se analizarán todos los servlets disponibles. Inclusión de mbeans personalizados ######################################################################## ## Request of specifics attributes ######################################################################## # Example 1: Get an specific parameter ("used") from "HeapMemoryUsage" attribute from the MBean "java.lang:type=Memory" mbean_check_begin mbean_check_name MemoryUsed mbean_check_type generic_data mbean_check_module_group Module group mbean_check_description In Bytes mbean java.lang:type=Memory attribute HeapMemoryUsage path used mbean_check_end # Tomcat server specific checks #include jmx.tomcat.conf # Websphere server specific checks #include jmx.websphere.conf # Weblogic server specific checks #include jmx.weblogic.conf # Kafka server specific checks #include jmx.kafka.conf Puede definir sus propios chequeos para recuperar información específica de mbeans. Para ello, defina tantos bloques de chequeo como necesite: mbean_check_begin Especifica el inicio de un bloque de definición de chequeo de mbean específico. mbean_check_name Es el nombre del módulo tal y como aparecerá en Pandora FMS. mbean_check_type Indica el tipo de dato que se asignará al módulo en Pandora FMS. mbean_check_module_group Puede personalizar el grupo de módulo que se aplicará a los monitores generados por la extracción de datos del mbean. mbean_check_description Es la descripción del módulo tal y como aparecerá en Pandora FMS. mbean Configure aquí el mbean a consultar. path Indique el path donde se aloja el mbean que desea consultar. mbean_check_wmin Indica el límite inferior del umbral Warning para el módulo. mbean_check_wmax Indica el límite superior del umbral Warning para el módulo. mbean_check_wstr Indica el texto como umbral de Warning para módulos de tipo string. mbean_check_winv Invierte la dirección de los umbrales Warning del módulo. mbean_check_cmin Indica el límite inferior del umbral Critical para el módulo. mbean_check_cmax Indica el límite superior del umbral Critical para el módulo. mbean_check_cstr Indica el texto como umbral de Critical para módulos de tipo string. mbean_check_cinv Invierte la dirección de los umbrales Critical del módulo. mbean_check_end Especifica el final de un bloque de definición de chequeo de mbean específico.   Macro de detección dinámica de mbean _jokeritem_ Para poder monitorizar mbeans complejos, puede utilizar la macro _jokeritem_ de tal manera que se generen tantos módulos como datos provea el mbean: Ejemplo de configuración. mbean_check_begin mbean_check_name jms.messagescurrentcount._jokeritem_ mbean_check_module_group jvm.jms mbean_check_type generic_data mbean_check_description The current number of messages stored on this JMS server. This number does not include the pending messages. mbean com.bea:Name=_jokeritem_,ServerRuntime=_serverruntime_,Type=JMSServerRuntime attribute MessagesCurrentCount mbean_check_end Macro para la selección de server runtime Ahora es posible seleccionar el servidor de runtime objetivo dinámicamente utilizando la macro _serverruntime_ . Ejemplo de configuración: mbean com.bea:Name=ThreadPoolRuntime,ServerRuntime=_serverruntime_,Type=ThreadPoolRuntime include Puede especificar tantos archivos de configuración extra como necesite. Configuración de entrega de datos ######################################################################## ## Request of all list of JMX information ## (Warning!!! this output is very very verbose, so use this check carefully) ######################################################################## #list_all_mbeans ## Report style as_agent_plugin 0 agent_per_instance 1 ## Custom header module_header jmx_check_ ## agent configuration #agent_name custom_agent_name #agent_interval 300 #agent_group JMX ## Pandora Server configuration transfer_mode tentacle tentacle_ip your.pandora.server.ip tentacle_port 41121 tentacle_opts tentacle_client "tentacle_client" temp /tmp local_folder /var/spool/pandora/data_in Puede configurar la entrega de los datos en Pandora FMS de varias formas: list_all_mbeans Generará un módulo con una lista en texto con todos los mbeans disponibles. as_agent_plugin Si está activo (1), volcará toda la información de módulos por pantalla en formato XML para ser ejecutado desde un agente. Si no lo está (0), entregará la información transfiriendo XML completos al servidor configurado como destino. agent_per_instance Si está activo (1), enviará la información de instancias como agentes individuales a Pandora FMS. ● Si la monitorización está basada exclusivamente en mbeans, se agruparán por servlet. ● Si la monitorización se basa en aplicaciones web (webapp_info), se crearán tantos agentes como aplicaciones web tenga desplegadas. ● Siempre se creará un agente que representa el propio servidor de aplicaciones. Si está desactivado (0), se enviará toda la información de módulos en un único agente (nombre del servidor de aplicaciones o el especificado en agent_name ). module_header Especifica una cabecera personalizada para los módulos generados por el plugin. mode Modo de transferencia de ficheros XML, puede ser: ● local: copia los ficheros a local_folder ● tentacle: transfiere los ficheros a tentacle_ip por tentacle_port tentacle_ip Dirección IP o FQDN donde Pandora FMS está trabajando. tentacle_port Puerto donde el servicio Tentacle asociado a su servidor Pandora FMS está escuchando. tentacle_opts Opciones extra para el cliente Tentacle. tentacle_client Path donde encontrar el binario del cliente Tentacle. local_folder Ubicación donde mover los archivos en el modo local. temp Ubicación temporal donde almacenar los archivos antes de enviarlos.