2 Pasīvās un aktīvās aģenta pārbaudes

Pārskats

Šajā sadaļā sniegta informācija par pasīvajām un aktīvajām pārbaudēm, ko veic Zabbix aģents un Zabbix aģents 2.

Zabbix saziņai ar aģentiem izmanto uz JSON balstītu saziņas protokolu.

Zabbix aģenta un Zabbix aģenta 2 protokoli ir apvienoti, sākot ar Zabbix 7.0. Atšķirība starp Zabbix aģenta un Zabbix aģenta 2 pieprasījumiem/atbildēm tiek izteikta ar taga "variant" vērtību.

Pasīvās pārbaudes

Pasīvā pārbaude ir vienkāršs datu pieprasījums.
Zabbix serveris vai starpniekserveris pieprasa noteiktus datus (piemēram, CPU noslodzi), un Zabbix aģents nosūta rezultātu atpakaļ serverim.

Pasīvās pārbaudes tiek izpildītas asinhroni — nav nepieciešams saņemt atbildi uz vienu pieprasījumu, pirms tiek sākta citu pārbaužu izpilde.
Arī DNS atrisināšana notiek asinhroni.

Aģentu aptaujātājs mēģinās izveidot savienojumu ar visām adresēm, kas atgrieztas DNS uzmeklēšanas rezultātā.
Tas nodrošina, ka gadījumā, ja viena IP adrese nav sasniedzama, aptaujātājs mēģinās izmantot nākamo pieejamo adresi, tādējādi palielinot veiksmīga savienojuma iespējamību.
Šis uzlabojums attiecas gan uz Zabbix serveri, gan starpniekserveri.

Asinhrono pārbaužu maksimālā vienlaicība ir 1000 (definēta ar parametru MaxConcurrentChecksPerPoller).

Asinhrono aģentu aptaujātāju skaitu nosaka parametrs StartAgentPollers.

Servera pieprasījums

Informāciju par galvenes un datu garuma definīciju skatiet sadaļā protokola informācija.

{
  "request": "passive checks",
  "data": [
    {
      "key": "agent.version",
      "timeout": 3
    }
  ]
}

Aģenta atbilde

{
  "version": "7.0.0",
  "variant": 2,
  "data": [
    {
      "value": "7.0.0"
    }
  ]
}

Piemēram, atbalstītiem vienumiem:

1. Serveris atver TCP savienojumu
2. Serveris nosūta <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}
3. Aģents nolasa pieprasījumu un atbild ar <HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"value":1}]}
4. Serveris apstrādā datus, lai iegūtu vērtību — šajā gadījumā “1”
5. TCP savienojums tiek aizvērts

Neatbalstītiem vienumiem:

1. Serveris atver TCP savienojumu
2. Serveris nosūta <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"vfs.fs.size[/nono]","timeout":3}]}
3. Aģents nolasa pieprasījumu un atbild ar <HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"error":"Unsupported item key."}]}
4. Serveris apstrādā datus un maina vienuma stāvokli uz “neatbalstīts”, izmantojot norādīto kļūdas ziņojumu
5. TCP savienojums tiek aizvērts

Atgriešanās pie vecā protokola

Lai nodrošinātu, ka Zabbix serveris vai starpniekserveris var darboties ar aģentiem no versijām, kas vecākas par 7.0 un izmanto vienkārša teksta protokolu, ir ieviesta atgriešanās pie vecā protokola.

Pasīvās pārbaudes pēc restartēšanas vai saskarnes konfigurācijas maiņas tiek veiktas, izmantojot JSON protokolu (7.0 un jaunākas versijas). Ja atbildē netiek saņemts derīgs JSON (aģents nosūtīja "ZBX_NOTSUPPORTED"), Zabbix saglabās saskarni kešatmiņā kā tādu, kas izmanto veco protokolu, un atkārtos pārbaudi, nosūtot tikai vienuma atslēgu.

Ņemiet vērā, ka katru stundu Zabbix serveris/starpniekserveris vēlreiz mēģinās izmantot jauno protokolu ar visām saskarnēm, ja nepieciešams, atgriežoties pie vecā protokola.

Aktīvās pārbaudes

Aktīvās pārbaudes prasa sarežģītāku apstrādi. Aģentam vispirms no servera/starpniekservera ir jāiegūst vienumu saraksts un/vai attālinātās komandas neatkarīgai apstrādei.

Serveri/starpniekserveri, no kuriem iegūt aktīvās pārbaudes, ir norādīti aģenta konfigurācijas faila parametrā 'ServerActive'. Šo pārbaužu pieprasīšanas biežumu nosaka tas pats konfigurācijas fails parametrs 'RefreshActiveChecks'. Tomēr, ja aktīvo pārbaužu atsvaidzināšana neizdodas, mēģinājums tiek atkārtots pēc fiksētām 60 sekundēm.

Pēc tam aģents periodiski nosūta jaunās vērtības serverim(-iem). Ja aģents ir saņēmis izpildei kādas attālās komandas, tiks nosūtīts arī izpildes rezultāts. Ņemiet vērā, ka attālo komandu izpilde aktīvā aģentā tiek atbalstīta, sākot ar Zabbix aģentu 7.0.

Vienumu saraksta iegūšana

Aģenta pieprasījums

Aktīvo pārbaužu pieprasījums tiek izmantots, lai iegūtu aktīvās pārbaudes, kuras jāapstrādā aģentam. Šo pieprasījumu aģents nosūta startēšanas laikā un pēc tam ar RefreshActiveChecks intervālu.

{
  "request": "active checks",
  "host": "Zabbix server",
  "host_metadata": "mysql,nginx",
  "interface": "zabbix.server.lan",
  "ip": "159.168.1.1",
  "port": 12050,
  "version": "7.0.0",
  "variant": 2,
  "config_revision": 1,
  "session": "e3dcbd9ace2c9694e1d7bbd030eeef6e"
}

Servera atbilde

Aktīvo pārbaužu atbildi serveris nosūta aģentam pēc aktīvo pārbaužu pieprasījuma apstrādes.

{
  "response": "success",
  "config_revision": 2,
  "data": [
    {
      "key": "system.uptime",
      "itemid": 1234,
      "delay": "10s",
      "lastlogsize": 0,
      "mtime": 0
    },
    {
      "key": "agent.version",
      "itemid": 5678,
      "delay": "10m",
      "lastlogsize": 0,
      "mtime": 0,
      "timeout": "30s"
    }
  ],
  "commands": [
    {
      "command": "df -h --output=source,size / | awk 'NR>1 {print $2}'",
      "id": 1324,
      "wait": 1
    }
  ]
}

Serverim jāatbild ar veiksmīgu rezultātu.

Piemēram:

1. Aģents atver TCP savienojumu
2. Aģents pieprasa pārbaužu sarakstu
3. Serveris atbild ar vienumu sarakstu un izpildāmajām attālajām komandām
4. Aģents parsē atbildi
5. TCP savienojums tiek aizvērts
6. Aģents sāk periodisku datu apkopošanu un izpilda attālās komandas (tiek atbalstīts, sākot ar Zabbix aģentu 7.0)

Apkopoto datu nosūtīšana

Aģents nosūta

Aģenta datu pieprasījumā ir ietvertas apkopotās vienumu vērtības un izpildīto attālo komandu vērtības (ja tādas ir).

{
  "request": "agent data",
  "data": [
    {
      "id": 1,
      "itemid": 5678,
      "value": "7.0.0",
      "clock": 1712830783,
      "ns": 76808644
    },
    {
      "id": 2,
      "itemid": 1234,
      "value": "69672",
      "clock": 1712830783,
      "ns": 77053975
    }
  ],
  "commands": [
    {
      "id": 1324,
      "value": "16G"
    }
  ],
  "session": "8495cd52070e6ca52b371f29c8574165",
  "host": "Zabbix server",
  "version": "7.0.0",
  "variant": 2
}

Katrai vērtībai tiek piešķirts virtuāls ID. Vērtības ID ir vienkāršs augošs skaitītājs, kas ir unikāls vienas datu sesijas ietvaros (to identificē sesijas tokens). Šis ID tiek izmantots, lai atmestu dublētās vērtības, kas var tikt nosūtītas sliktas savienojamības apstākļos.

Servera atbilde

Serveris nosūta aģenta datu atbildi atpakaļ aģentam pēc aģenta datu pieprasījuma apstrādes.

{
  "response": "success",
  "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
}

Piemēram:

1. Aģents atver TCP savienojumu
2. Aģents nosūta vērtību sarakstu
3. Serveris apstrādā datus un nosūta statusu atpakaļ
4. TCP savienojums tiek aizvērts

Sirdspuksta ziņojums

Aģents nosūta

Sirdspuksta ziņojumu aktīvais aģents nosūta Zabbix serverim/starpniekserverim ik pēc HeartbeatFrequency sekundēm (konfigurēts Zabbix aģenta/aģenta 2 konfigurācijas failā).

To izmanto aktīvo pārbaužu pieejamības uzraudzībai.

{
  "request": "active check heartbeat",
  "host": "Zabbix server",
  "heartbeat_freq": 60,
  "version": "7.0.0",
  "variant": 2
}

Novirzīšanas atbilde

Kad hosts ir piešķirts citam objektam, serveris var norādīt aģentam novirzīt sirdspuksta ziņojumus (un turpmākās aktīvās pārbaudes) uz citu starpniekserveri vai servera instanci.

  {
    "response": "failed",
    "redirect": {
      "revision": 2,
      "address": "192.0.2.1:10055"
    }
  }

Vecāks XML protokols