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 180server_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 1debug
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,loadOnStartupPuede 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.confPuede 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_endMacro 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=ThreadPoolRuntimeinclude
Puede especificar tantos archivos de configuración extra como necesite.
Configuración de entrega de datos