6 Откривање JMX објеката

Преглед

Могуће је открити све JMX MBeans или MBean атрибути или да наведете образац за откривање ових објеката.

Обавезно је разумети разлику између MBean-а и MBean-а атрибути за конфигурацију правила откривања. MBean је објекат који може представљати уређај, апликацију или било који ресурс који треба да буде управљао.

На пример, постоји MBean који представља веб сервер. Његово атрибути су број конекција, број нити, временско ограничење захтева, http кеш датотека, употреба меморије, итд. Изражавање ове мисли на људском свеобухватним језиком можемо дефинисати апарат за кафу као MBean који има следеће атрибуте које треба пратити: количину воде по шољи, просечна потрошња воде за одређени временски период, број зрна кафе потребна по шољици, зрна кафе и време допуњавања воде итд.

Кључ ставке

У конфигурацији discovery rule , изаберите JMX агент у пољу Тип.

Подржана су два кључа ставке за откривање JMX објеката - jmx.discovery[] и jmx.get[]:

Коришћење jmx.discovery

Ова ставка враћа JSON објекат са макроима за откривање ниског нивоа који описују MBean објекте или атрибуте. На пример, приликом откривања MBean атрибута (реформатираних ради јасноће):

[
         {
         "{#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"
         }
       ]

У открићу MBeans објеката (реформатирано ради јасноће):

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

Подржани макрои

Следећи макрои су подржани за употребу у правилу откривања filter и прототиповима ставки, окидача и графикона:

Ограничења

Постоје нека ограничења повезана са алгоритмом креирања LLD назива макроа из назива својстава MBean-а:

• називи атрибута се мењају у велика слова
• називи атрибута се игноришу (не генеришу се LLD макрои) ако садрже неподржане знакове за називе LLD макроа. Подржани знакови могу се описати следећим регуларним изразом: A-Z0-9_\.
• ако се атрибут назива "obj" или "domain", биће игнорисани због преклапања са вредностима резервисаних Zabbix својстава {#JMXOBJ} и {#JMXDOMAIN}

Молимо вас да размотрите овај пример jmx.discovery (са режимом "beans"). MBean има следећа дефинисана својства (нека од њих ће бити игнорисана; видети доле):

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

Као резултат JMX откривања, генерисаће се следећи LLD макрои:

• {#JMXDOMAIN} - Zabbix internal, описује домен MBean-а
• {#JMXOBJ} - Zabbix internal, описује MBean објекат
• {#JMXNAME} - креирано од својства "name"

Игнорисана својства су:

• тип : његово име садржи неподржане знакове (non-ASCII)
• attributes[] : његово име садржи неподржане знакове (угласте заграде нису подржане)
• Name : већ је дефинисано (name=test)
• domAin : то је Zabbix резервисано име

Examples

Let’s review two more practical examples of a LLD rule creation with the use of MBean. To understand the difference between a LLD rule collecting MBeans and a LLD rule collecting MBean attributes better please take a look at following table:

Пример 1: Откривање MBeans-ова

Ово правило ће вратити 3 објекта: горњи ред колоне: MBean1, MBean2, MBean3.

За више информација о објектима погледајте табелу supported macros , одељак Откривање MBeans-ова.

Конфигурација правила откривања која прикупља MBeans-ове (без атрибута) изгледа овако:

Кључ који се овде користи:

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

Сви сакупљачи смећа без атрибута ће бити откривени. Пошто сакупљачи смећа имају исти скуп атрибута, можемо користити жељене атрибуте у прототиповима елемената на следећи начин:

Кључеви који се овде користе:

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

LLD правило откривања ће резултирати нечим сличним овоме (елементи су откривени за два сакупљача смећа колекционари):

Пример 2: Откривање атрибута MBean-а

Ово правило ће вратити 9 објеката са следећим пољима: MBean1Attribute1, MBean2Attribute1, MBean3Attribute1, MBean1Attribute2, MBean2Attribute2, MBean3Attribute2, MBean1Attribute3, MBean2Attribute3, MBean3Attribute3.

За више информација о објектима погледајте табелу подржани макрои , одељак Откривање атрибута MBean-а.

Конфигурација правила откривања која прикупља атрибуте MBean-а изгледа овако:

Кључ који се овде користи:

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

Сви сакупљачи смећа са једним атрибутом ставке биће откривени.

У овом конкретном случају, ставка ће бити креирана из прототипа за сваки атрибут MBean-а. Главни недостатак ове конфигурације је то што је креирање окидача из прототипова окидача немогуће јер постоји само један прототип ставке за све атрибуте. Дакле, ово подешавање се може користити за прикупљање података, али се не препоручује за аутоматско праћење.

Коришћење jmx.get

jmx.get[] је сличан ставци jmx.discovery[], али не претвара својства Јава објекта у имена макроа за откривање ниског нивоа и стога може вратити вредности без ограничења која су повезана са генерисањем имена LLD макроа, као што су цртице или не-ASCII карактери.

Када се користи jmx.get[] за откривање, макрои за откривање ниског нивоа могу се дефинисати одвојено у прилагођеној картици LLD макро у конфигурацији правила откривања, користећи JSONPath да би се указало на потребне вредности.

Откривање MBeans

Ставка открића: jmx.get[beans,"com.example:type=*,*"]

Одговор:

[
           {
               "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"
               }
           }
       ]

Откривање MBean атрибута

Ставка открића: jmx.get[attributes,"com.example:type=*,*"]

Одговор:

[
           {
               "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
               }
           }
       ]