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: