6 Descubrimiento de objetos JMX

Descripción general

Es posible descubrir todos los MBeans de JMX o los atributos de MBean, o especificar un patrón para la descubrimiento de estos objetos.

Es obligatorio comprender la diferencia entre un MBean y los atributos de MBean para la configuración de la regla de descubrimiento. Un MBean es un objeto que puede representar un dispositivo, una aplicación o cualquier recurso que necesite ser gestionado.

Por ejemplo, existe un MBean que representa un servidor web. Sus atributos son el número de conexiones, el número de hilos, el tiempo de espera de la solicitud, la caché de archivos http, el uso de memoria, etc. Expresando este pensamiento en un lenguaje comprensible para los humanos, podemos definir una máquina de café como un MBean que tiene los siguientes atributos a monitorizar: cantidad de agua por taza, consumo medio de agua durante un determinado período de tiempo, número de granos de café necesarios por taza, tiempo de recarga de granos de café y agua, etc.

Clave de item

En la configuración de la regla de descubrimiento, seleccione JMX agent en el campo Tipo.

Se admiten dos claves de item para el descubrimiento de objetos JMX: jmx.discovery[] y jmx.get[]:

Uso de jmx.discovery

Esta métrica devuelve un objeto JSON con macros de bajo nivel que describen objetos o atributos MBean. Por ejemplo, en el descubrimiento de atributos MBean (reformateado para mayor claridad):

[
    {
        "{#JMXVALUE}":"0",
        "{#JMXTYPE}":"java.lang.Long",
        "{#JMXOBJ}":"java.lang:type=GarbageCollector,name=PS Scavenge",
        "{#JMXDESC}":"java.lang:type=GarbageCollector,name=PS Scavenge,CollectionCount",
        "{#JMXATTR}":"CollectionCount"
    },
    {
        "{#JMXVALUE}":"0",
        "{#JMXTYPE}":"java.lang.Long",
        "{#JMXOBJ}":"java.lang:type=GarbageCollector,name=PS Scavenge",
        "{#JMXDESC}":"java.lang:type=GarbageCollector,name=PS Scavenge,CollectionTime",
        "{#JMXATTR}":"CollectionTime"
    },
    {
        "{#JMXVALUE}":"true",
        "{#JMXTYPE}":"java.lang.Boolean",
        "{#JMXOBJ}":"java.lang:type=GarbageCollector,name=PS Scavenge",
        "{#JMXDESC}":"java.lang:type=GarbageCollector,name=PS Scavenge,Valid",
        "{#JMXATTR}":"Valid"
    },
    {
        "{#JMXVALUE}":"PS Scavenge",
        "{#JMXTYPE}":"java.lang.String",
        "{#JMXOBJ}":"java.lang:type=GarbageCollector,name=PS Scavenge",
        "{#JMXDESC}":"java.lang:type=GarbageCollector,name=PS Scavenge,Name",
        "{#JMXATTR}":"Name"
    },
    {
        "{#JMXVALUE}":"java.lang:type=GarbageCollector,name=PS Scavenge",
        "{#JMXTYPE}":"javax.management.ObjectName",
        "{#JMXOBJ}":"java.lang:type=GarbageCollector,name=PS Scavenge",
        "{#JMXDESC}":"java.lang:type=GarbageCollector,name=PS Scavenge,ObjectName",
        "{#JMXATTR}":"ObjectName"
    }
]

En el descubrimiento de MBeans (reformateado para mayor claridad):

[
    {
        "{#JMXDOMAIN}":"java.lang",
        "{#JMXTYPE}":"GarbageCollector",
        "{#JMXOBJ}":"java.lang:type=GarbageCollector,name=PS Scavenge",
        "{#JMXNAME}":"PS Scavenge"
    }
]

Macros compatibles

Las siguientes macros son compatibles para su uso en el filtro de la regla de descubrimiento y en los prototipos de items, triggers y gráficos:

Limitaciones

Existen algunas limitaciones asociadas al algoritmo de creación de nombres de macros LLD a partir de nombres de propiedades MBean:

• los nombres de los atributos se convierten a mayúsculas
• los nombres de los atributos se ignoran (no se generan macros LLD) si consisten en caracteres no soportados para nombres de macros LLD. Los caracteres soportados pueden describirse mediante la siguiente expresión regular: A-Z0-9_\.
• si un atributo se llama "obj" o "domain" serán ignorados debido a la superposición con los valores de las propiedades reservadas de Zabbix {#JMXOBJ} y {#JMXDOMAIN}

Considere este ejemplo de jmx.discovery (con modo "beans"). El MBean tiene las siguientes propiedades definidas (algunas de las cuales serán ignoradas; ver más abajo):

name=test
тип=Type
attributes []=1,2,3
Name=NameOfTheTest
domAin=some

Como resultado del descubrimiento JMX, se generarán las siguientes macros LLD:

• {#JMXDOMAIN} - Interna de Zabbix, describe el dominio del MBean
• {#JMXOBJ} - Interna de Zabbix, describe el objeto MBean
• {#JMXNAME} - creada a partir de la propiedad "name"

Las propiedades ignoradas son:

• тип : su nombre contiene caracteres no soportados (no-ASCII)
• attributes[] : su nombre contiene caracteres no soportados (los corchetes no están soportados)
• Name : ya está definida (name=test)
• domAin : es un nombre reservado de Zabbix

Ejemplos

Revisemos dos ejemplos más prácticos de creación de una regla LLD con el uso de MBean. Para comprender mejor la diferencia entre una regla LLD que recopila MBeans y una regla LLD que recopila atributos de MBean, por favor observe la siguiente tabla:

Ejemplo 1: Descubrimiento de MBeans

Esta regla devolverá 3 objetos: la fila superior de la columna: MBean1, MBean2, MBean3.

Para obtener más información sobre los objetos, consulte la tabla de macros soportadas, sección Descubrimiento de MBeans.

La configuración de la regla de descubrimiento para recopilar MBeans (sin los atributos) tiene el siguiente aspecto:

La clave utilizada aquí:

jmx.discovery[beans,"*:type=GarbageCollector,name=*"]

Se descubrirán todos los recolectores de basura sin atributos. Como los recolectores de basura tienen el mismo conjunto de atributos, podemos usar los atributos deseados en los prototipos de item de la siguiente manera:

Las claves utilizadas aquí:

jmx[{#JMXOBJ},CollectionCount] 
jmx[{#JMXOBJ},CollectionTime] 
jmx[{#JMXOBJ},Valid] 

La regla de descubrimiento LLD dará como resultado algo similar a esto (se descubren items para dos recolectores de basura):

Ejemplo 2: Descubrimiento de atributos MBean

Esta regla devolverá 9 objetos con los siguientes campos: MBean1Attribute1, MBean2Attribute1, MBean3Attribute1,MBean1Attribute2,MBean2Attribute2, MBean3Attribute2, MBean1Attribute3, MBean2Attribute3, MBean3Attribute3.

Para obtener más información sobre los objetos, consulte la tabla de macros soportadas, sección Descubrimiento de atributos MBean.

La configuración de la regla de descubrimiento que recopila atributos MBean es la siguiente:

La clave utilizada aquí:

jmx.discovery[attributes,"*:type=GarbageCollector,name=*"]

Se descubrirán todos los recolectores de basura con un único atributo de item.

En este caso concreto, se creará un item a partir del prototipo para cada atributo MBean. La principal desventaja de esta configuración es que la creación de triggers a partir de prototipos de trigger es imposible, ya que solo hay un prototipo de item para todos los atributos. Por lo tanto, esta configuración puede utilizarse para la recopilación de datos, pero no se recomienda para la monitorización automática.

Uso de jmx.get

jmx.get[] es similar al item jmx.discovery[], pero no convierte las propiedades de los objetos Java en nombres de macros de descubrimiento de bajo nivel y, por lo tanto, puede devolver valores sin las limitaciones asociadas con la generación de nombres de macros LLD, como guiones o caracteres no ASCII.

Al usar jmx.get[] para el descubrimiento, las macros de descubrimiento de bajo nivel pueden definirse por separado en la pestaña personalizada de macro LLD de la configuración de la regla de descubrimiento, utilizando JSONPath para señalar los valores requeridos.

Descubriendo MBeans

Métrica de descubrimiento: jmx.get[beans,"com.example:type=*,*"]

Respuesta:

[
    {
        "object": "com.example:type=Hello,data-src=data-base,ключ=значение",
        "domain": "com.example",
        "properties": {
            "data-src": "data-base",
            "ключ": "значение",
            "type": "Hello"
        }
    },
    {
        "object": "com.example:type=Atomic",
        "domain": "com.example",
        "properties": {
            "type": "Atomic"
        }
    }
]

Descubriendo atributos de MBean

Métrica de descubrimiento: jmx.get[attributes,"com.example:type=*,*"]

Respuesta:

[
    {
        "object": "com.example:type=*",
        "domain": "com.example",
        "properties": {
            "type": "Simple"
        }
    },
    {
        "object": "com.zabbix:type=yes,domain=zabbix.com,data-source=/dev/rand,ключ=значение,obj=true",
        "domain": "com.zabbix",
        "properties": {
            "type": "Hello",
            "domain": "com.example",
            "data-source": "/dev/rand",
            "ключ": "значение",
            "obj": true
        }
    }
]