3 Passieve en Actieve agent controles

Overview

Deze sectie bevat details over passieve en actieve controles uitgevoerd door Zabbix agent.

Zabbix gebruikt een op JSON gebaseerd communicatie protocol om te communiceren met de Zabbix agent.

Passieve controles

Een passieve controle is een eenvoudig gegevensverzoek. Zabbix-server of proxy vraagt voor sommige gegevens (bijvoorbeeld CPU-belasting) en Zabbix-agent stuurt de resultaat naar de server.

Serververzoek

Voor definitie van koptekst en gegevenslengte verwijzen wij u naar protocol details.

<itemtoets>

Reactie agent

<GEGEVENS>[\0<FOUT>]

Hierboven is het gedeelte tussen vierkante haken optioneel en wordt alleen verzonden voor niet ondersteunde artikelen.

Voor ondersteunde items bijvoorbeeld:

1. Server opent een TCP-verbinding
2. Server verzendt <HEADER><DATALEN>agent.ping
3. Agent leest het verzoek en reageert met: <HEADER><DATALEN>1
4. Server verwerkt gegevens om de waarde '1' in ons geval te krijgen
5. TCP-verbinding is gesloten

Voor niet-ondersteunde items:

1. Server opent een TCP-verbinding
2. Server verzendt <HEADER><DATALEN>vfs.fs.size[/nono]
3. Agent leest het verzoek en reageert met: <HEADER><DATALEN>ZBX_NOTSUPPORTED\0Kan niet verkrijgen bestandssysteeminformatie: [2] Geen dergelijk bestand of map
4. Server verwerkt gegevens, wijzigt itemstatus in niet ondersteund met de gespecificeerde foutmelding
5. TCP-verbinding is gesloten

Actieve controles

Actieve controles vereisen een complexere verwerking. De agent moet eerst van de server(s) een lijst met items ophalen voor onafhankelijke verwerking.

De servers waar de actieve controles vandaan komen, staan vermeld in de 'ServerActive' parameter van de agent configuratie bestand. De frequentie van vragen voor deze controles wordt ingesteld door de parameter 'RefreshActiveChecks' in de hetzelfde configuratiebestand. Als het vernieuwen van actieve controles echter niet lukt, wordt na 60 seconden hardcoded opnieuw geprobeerd.

De agent stuurt vervolgens periodiek de nieuwe waarden naar de server(s).

De lijst van items ophalen

Verzoek van de agent

Het actieve controleverzoek wordt gebruikt om de actieve controles op te halen die door de agent moeten worden verwerkt. Dit verzoek wordt door de agent verzonden bij het opstarten en vervolgens met intervallen voor het vernieuwen van actieve controles.

{
         "request": "active checks",
         "host": "Zabbix-server",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050
       }

Reactie van de server

De reactie van de actieve controles wordt door de server teruggestuurd naar de agent na verwerking van het verzoek voor actieve controles.

{
         "response": "success",
         "data": [
           {
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "itemid": 1234,
             "delay": "30s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "key_orig": "agent.version",
             "itemid": 5678,
             "delay": "10m",
             "lastlogsize": 0,
             "mtime": 0
           }
         ]
       }

De server moet reageren met succes.

Bijvoorbeeld:

1. Agent opent een TCP-verbinding
2. Agent vraagt om de lijst van controles
3. Server reageert met een lijst van items (item sleutel, interval)
4. Agent analyseert het antwoord
5. TCP-verbinding wordt gesloten
6. Agent begint met periodieke gegevensverzameling

Verzamelde gegevens insturen

Agent stuurt

{
           "request":"agentgegevens",
           "sessie": "12345678901234567890123456789012",
           "gegevens":[
               {
                   "host":"<hostnaam>",
                   "key":"agent.version",
                   "waarde":"2.4.0",
                   "id": 1,
                   "klok":1400675595,
                   "ns":76808644
               },
               {
                   "host":"<hostnaam>",
                   "key":"log[/home/zabbix/logs/zabbix_agentd.log]",
                   "lastloggrootte":112,
                   "value":" 19845:20140621:141708.521 Zabbix Agent starten [<hostnaam>]. Zabbix 2.4.0 (revisie 50000)",
                   "id": 2,
                   "klok":1400675595,
                   "ns":77053975
               },
               {
                   "host":"<hostnaam>",
                   "key":"vfs.fs.size[/nono]",
                   "staat":1,
                   "value":"Kan geen bestandssysteeminformatie verkrijgen: [2] Geen dergelijk bestand of map",
                   "id": 3,
                   "klok":1400675595,
                   "ns":78154128
               }
           ],
           "klok": 1400675595,
           "ns": 78211329
       }

Aan elke waarde wordt een virtuele ID toegewezen. Waarde-ID is eenvoudig oplopend teller, uniek binnen één datasessie (geïdentificeerd door de sessie teken). Deze ID wordt gebruikt om dubbele waarden te verwijderen die mogelijk worden verzonden in omgevingen met slechte connectiviteit.

Serverreactie

{
           "response":"succes",
           "info":"verwerkt: 3; mislukt: 0; totaal: 3; bestede seconden: 0,003534"
       }

Bijvoorbeeld:

1. Agent opent een TCP-verbinding
2. Agent stuurt een lijst met waarden
3. Server verwerkt de gegevens en stuurt de status terug
4. TCP-verbinding is gesloten

Merk op hoe in het bovenstaande voorbeeld de niet-ondersteunde status voor vfs.fs.size[/nono] wordt aangegeven door de "state" waarde van 1 en de foutmelding in de eigenschap "waarde".

Ouder XML-protocol