[comment]: # ({a6d31bd3-a6d31bd3})
# 2 Pasīvās un aktīvās aģenta pārbaudes

[comment]: # ({/a6d31bd3-a6d31bd3})

[comment]: # ({1b7bc303-7bd0dd61})
#### Pārskats

Šajā sadaļā ir sniegta detalizēta informācija par pasīvajām un aktīvajām pārbaudēm, ko veic
[Zabbix aģents](/manual/concepts/agent) un [Zabbix aģents 2](/manual/concepts/agent2).

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

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

[comment]: # ({/1b7bc303-7bd0dd61})

[comment]: # ({db675be2-e6db8dd6})
#### Pasīvie 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 viena pieprasījuma atbildi, pirms tiek sākta nākamā pārbaude. DNS atrisināšana arī ir asinhrona.

Aģenta aptaujātājs mēģinās izveidot savienojumu ar visām adresēm, ko atgriež DNS uzmeklēšana. Tas nodrošina, ka, ja viena IP adrese nav sasniedzama, aptaujātājs mēģinās izmantot nākamo pieejamo adresi, palielinot veiksmīga savienojuma iespējamību. Šis uzlabojums attiecas gan uz Zabbix serveri, gan uz starpniekserveri.

Asinhrono pārbaužu maksimālais paralēlais izpildes skaits ir 1000 (definēts ar [MaxConcurrentChecksPerPoller](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)).

Asinhrono aģenta aptaujātāju skaits ir definēts ar parametru [StartAgentPollers](/manual/appendix/config/zabbix_server#startagentpollers).

**Servera pieprasījums**

Galvenes un datu garuma definīciju skatiet [protokola
detaļās](/manual/appendix/protocols/header_datalen).

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

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| request |<| _string_ | yes | `"passive checks"` |
| data |<| _array of object_ | yes | Pasīvās pārbaudes vienums. |
| | key | _string_ | yes | Vienuma atslēga ar izvērstiem makro. |
|^| timeout | _number_ | yes | Sakaru noildze. |

**Aģenta atbilde**

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

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| version |<| _string_ | yes | Aģenta versijas numurs. |
| variant |<| _number_ | yes | Aģenta variants (*1* - Zabbix aģents, *2* - Zabbix agent 2). |
| data |<| _array of object_ | yes |Satur pārbaudes rezultātu. |
| | value | _string_ | no | Vienuma vērtība, ja pārbaude bija veiksmīga. |
| | error | _string_ | no | Kļūdas ziņojums, ja pārbaude nebija veiksmīga. |

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, mūsu gadījumā - '1'
5.  TCP savienojums tiek slēgts

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, maina vienuma stāvokli uz neatbalstītu ar
    norādīto kļūdas ziņojumu
5.  TCP savienojums tiek slēgts

[comment]: # ({/db675be2-e6db8dd6})

[comment]: # ({8a5c8e4e-d33dfdd3})
##### Pārslēgšanās uz veco protokolu

Lai nodrošinātu, ka Zabbix serveris vai starpniekserveris var strādāt ar aģentiem no versijām pirms 7.0, kuri izmanto vienkāršteksta protokolu, ir ieviesta pārslēgšanās uz veco protokolu.

Pasīvās pārbaudes pēc restartēšanas vai, kad tiek mainīta interfeisa konfigurācija, 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 kešos saglabās interfeisu kā vecā protokola interfeisu un **atkārtos** pārbaudi, nosūtot tikai vienuma atslēgu.

Ņemiet vērā, ka katru stundu Zabbix serveris/starpniekserveris atkal mēģinās strādāt ar jauno protokolu ar visiem interfeisiem, vajadzības gadījumā atgriežoties pie vecā protokola.

[comment]: # ({/8a5c8e4e-d33dfdd3})

[comment]: # ({86593407-ecdd6e8e})
#### 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](/manual/config/notifications/action/operation/remote_command) neatkarīgai apstrādei.

Serveri/starpniekserveri, no kuriem iegūt aktīvās pārbaudes, ir norādīti aģenta [konfigurācijas faila](/manual/appendix/config/zabbix_agent2) 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.

[comment]: # ({/86593407-ecdd6e8e})

[comment]: # ({e520c471-4c14cd28})
::: notetip
Sākot ar Zabbix 6.4, aģents (aktīvajā režīmā) vairs nesaņem no servera/starpniekservera pilnu konfigurācijas kopiju reizi divās minūtēs (pēc noklusējuma).
Tā vietā, lai samazinātu tīkla datplūsmu un resursu izmantošanu, ik pēc 5 sekundēm (pēc noklusējuma) tiek veikta inkrementāla konfigurācijas sinhronizācija, kuras laikā serveris/starpniekserveris nodrošina pilnu konfigurācijas kopiju **tikai** tad, ja aģents to vēl nav saņēmis vai ir notikušas izmaiņas hosta konfigurācijā, globālajos makrosos vai globālajās regulārajās izteiksmēs.
:::

[comment]: # ({/e520c471-4c14cd28})

[comment]: # ({63166bda-2f80420a})
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](/manual/config/notifications/action/operation/remote_command), tiks nosūtīts arī izpildes rezultāts.
Ņemiet vērā, ka attālo komandu izpilde aktīvā aģentā tiek atbalstīta kopš Zabbix aģenta 7.0.

::: notetip
Ja aģents atrodas aiz ugunsmūra, varat apsvērt
izmantot tikai aktīvās pārbaudes, jo šajā gadījumā nebūs nepieciešams
mainīt ugunsmūra iestatījumus, lai atļautu sākotnējos ienākošos savienojumus.
:::

[comment]: # ({/63166bda-2f80420a})

[comment]: # ({fa025abc-d898e135})
##### 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](/manual/appendix/config/zabbix_agent2) intervāliem.

```json
{
  "request": "active checks",
  "host": "Zabbix serveris",
  "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"
}
```

| Field | Type | Mandatory | Value |
|-|-|-|--------|
| request | _string_ | yes | `active checks` |
| host | _string_ | yes | Host name. |
| host_metadata | _string_ | no | The configuration parameter HostMetadata or HostMetadataItem metric value. |
| interface | _string_ | no | The configuration parameter HostInterface or HostInterfaceItem metric value. |
| ip | _string_ | no | The configuration parameter ListenIP first IP if set. |
| port | _number_ | no | The configuration parameter ListenPort value if set and not default agent listening port. |
| version | _string_ | yes | The agent version number. |
| variant | _number_ | yes | The agent variant (*1* - Zabbix agent, *2* - Zabbix agent 2). |
| config_revision | _number_ | no | Configuration identifier for [incremental configuration sync](#active-checks). |
| session | _string_ | no | Session identifier for [incremental configuration sync](#active-checks). |
  
**Servera atbilde**

Aktīvo pārbaužu atbilde tiek nosūtīta no servera atpakaļ aģentam pēc aktīvo pārbaužu pieprasījuma apstrādes.
  
```json
{
  "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
    }
  ]
}

```

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| response |<| _string_ | yes | `success` \| `failed` |
| info |<| _string_ | no | Error information in case of failure. |
| data |<| _array of objects_ | no | Active check items. Omitted if host configuration is unchanged. |
| | key | _string_ | no | Item key with expanded macros. |
|^| itemid | _number_ | no | Item identifier. |
|^| delay | _string_ | no | Item update interval.<br>Flexible/scheduling intervals are supported by both Zabbix agent and Zabbix agent 2 since Zabbix 7.0. |
|^| lastlogsize | _number_ | no | Item lastlogsize. |
|^| mtime | _number_ | no | Item mtime. |
|^| timeout | _string_ | no | Item timeout. |
| refresh_unsupported |<| _number_ | no | Unsupported item refresh interval. |
| regexp |<| _array of objects_ | no | Global regular expressions. |
| | name | _string_ | no | Global regular expression name. |
|^| expression | _string_ | no | Global regular expression. |
|^| expression_type | _number_ | no | Global regular expression type. |
|^| exp_delimiter | _string_ | no | Global regular expression delimiter. |
|^| case_sensitive | _number_ | no | Global regular expression case sensitivity setting. |
| commands |<| _array of objects_ | no | Remote commands to execute. Included if remote command execution has been triggered by an action [operation](/manual/config/notifications/action/operation#operations) or manual [script](/manual/web_interface/frontend_sections/alerts/scripts) execution. Note that remote command execution on an active agent is supported since Zabbix agent 7.0. Older active agents will ignore any remote commands included in the active checks server response. |
| | command | _string_ | no | Remote command. |
|^| id | _number_ | no | Remote command identifier. |
|^| wait | _number_ | no | Remote command mode of execution ("0" (nowait) for commands from action [operations](/manual/config/notifications/action/operation#operations); "1" (wait) for commands from manual [script](/manual/web_interface/frontend_sections/alerts/scripts) execution). |
|^| timeout | _number_ | no | Remote command execution timeout in [server](/manual/appendix/config/zabbix_server#timeout)/[proxy](/manual/appendix/config/zabbix_proxy#timeout) configuration. |
| config_revision | < | _number_ | no | Configuration identifier for [incremental configuration sync](#active-checks). Omitted if host configuration is unchanged. Incremented if host configuration is changed. |
  
Serverim jāatbild ar success.

Piemēram:

1. Aģents atver TCP savienojumu
2. Aģents pieprasa pārbaužu sarakstu
3. Serveris atbild ar vienumu un izpildāmo attālo komandu sarakstu
4. Aģents parsē atbildi
5. TCP savienojums tiek aizvērts
6. Aģents sāk periodisku datu vākšanu un izpilda attālās komandas (atbalstīts kopš Zabbix agent 7.0)

::: noteimportant
Ņemiet vērā, ka, izmantojot aktīvo pārbaudi, (sensitīvi) konfigurācijas dati var kļūt pieejami pusēm, kurām ir piekļuve Zabbix servera trapper porta. Tas ir iespējams, jo ikviens var izlikties par aktīvu aģentu un pieprasīt vienuma konfigurācijas datus; autentifikācija nenotiek, ja vien netiek izmantotas [šifrēšanas](/manual/encryption) opcijas.
:::

[comment]: # ({/fa025abc-d898e135})

[comment]: # ({1e8860e1-8c5ecfe1})
##### Nosūtīšana ar savāktajiem datiem

**Aģents nosūta**

Aģenta datu pieprasījums satur savāktās vienumu vērtības un izpildīto attālināto komandu vērtības (ja tādas ir).
  
```json
{
  "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
}
```

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| request |<| _string_ | yes | `agent data` |
| data |<| _array of objects_ | yes | Vienumu vērtības. |
| | id | _number_ | yes | Vērtības identifikators (inkrementāls skaitītājs, ko izmanto, lai pārbaudītu dublētas vērtības tīkla problēmu gadījumā). |
|^| itemid | _number_ | yes | Vienuma identifikators. |
|^| value | _string_ | no | Vienuma vērtība. |
|^| lastlogsize | _number_ | no | Vienuma lastlogsize. |
|^| mtime | _number_ | no | Vienuma mtime. |
|^| state | _number_ | no | Vienuma state. |
|^| source | _string_ | no | Vērtības notikumu žurnāla avots. |
|^| eventid | _number_ | no | Vērtības notikumu žurnāla eventid. |
|^| severity | _number_ | no | Vērtības notikumu žurnāla severity. |
|^| timestamp | _number_ | no | Vērtības notikumu žurnāla timestamp. |
|^| clock | _number_ | yes | Vērtības laikspiedols (sekundes kopš Epoch). |
|^| ns | _number_ | yes | Vērtības laikspiedola nanosekundes. |
| commands |<| _array of objects_ | no | Attālināto komandu izpildes rezultāts. Ņemiet vērā, ka attālināto komandu izpilde aktīvajā aģentā tiek atbalstīta kopš Zabbix aģents 7.0. Vecāki aktīvie aģenti ignorēs jebkuras attālinātās komandas, kas iekļautas aktīvo pārbaužu servera atbildē. |
| | id | _number_ | no | Attālinātās komandas identifikators. |
|^| value | _string_ | no | Attālinātās komandas izpildes rezultāts, ja izpilde bija veiksmīga. |
|^| error | _string_ | no | Attālinātās komandas izpildes kļūdas ziņojums, ja izpilde neizdevās. |
| session |<| _string_ | yes | Unikāls sesijas identifikators, kas tiek ģenerēts katru reizi, kad tiek palaists aģents. |
| host |<| _string_ | yes | Hosts nosaukums. |
| version |<| _string_ | yes | Aģenta versijas numurs. |
| variant |<| _number_ | yes | Aģenta variants (*1* - Zabbix aģents, *2* - Zabbix aģents 2). |

Katram vērtības ierakstam 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 (identificēts ar sesijas
tokenu). Šis ID tiek izmantots, lai atmestu dublētas vērtības, kas var tikt nosūtītas
sliktas savienojamības vidēs.

**Servera atbilde**

Aģenta datu atbildi serveris nosūta atpakaļ aģentam pēc aģenta datu pieprasījuma apstrādes.
  
```json
{
  "response": "success",
  "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
}
```

| Field | Type | Mandatory | Value |
|-|-|-|--------|
| response | _string_ | yes | `success` \| `failed` |
| info | _string_ | yes | Vienumu apstrādes rezultāti. |
  
::: noteimportant
Ja dažu vērtību nosūtīšana serverī neizdodas (piemēram, tāpēc, ka hosts vai vienums ir atspējots vai dzēsts), aģents nemēģinās šīs vērtības nosūtīt atkārtoti.
:::

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

::: noteimportant
Kļūdas ziņojums servera pusē tiks saīsināts līdz 2048 simboliem.
:::

[comment]: # ({/1e8860e1-8c5ecfe1})

[comment]: # ({12ecaf8c-ee2b7a2a})
##### Sirdspējas ziņojums

**Aģents nosūta**

Sirdspējas ziņojumu aktīvs aģents nosūta Zabbix serverim/starpniekserverim
ik pēc HeartbeatFrequency sekundēm (konfigurēts [Zabbix agent](/manual/appendix/config/zabbix_agentd)/
[agent 2](/manual/appendix/config/zabbix_agent2) konfigurācijas failā).

To izmanto, lai uzraudzītu aktīvo pārbaužu pieejamību.

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

| Field | Type | Mandatory | Value |
|-|-|-|-|
| request | _string_ | yes | `active check heartbeat` |
| host | _string_ | yes | Saimniekdatora nosaukums. |
| heartbeat_freq | _number_ | yes | Aģenta sirdspējas biežums (HeartbeatFrequency konfigurācijas parametrs). |
| version | _string_ | yes | Aģenta versijas numurs. |
| variant | _number_ | yes | Aģenta variants (*1* - Zabbix agent, *2* - Zabbix agent 2). |

**Pāradresācijas atbilde**

Ja hosts ir pārdalīts, serveris var norādīt aģentam pāradresēt tā sirdspēju (un turpmākās aktīvās pārbaudes) uz citu starpniekservera vai servera instanci.

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

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| response |<| _string_ | yes | `success` \| `failed` |
| redirect |<| _object_ | yes | Pāradresācijas norādījumi. |
| | revision | _number_ | yes | Konfigurācijas revīzijas identifikators. |
|^| address | _string_ | yes | Mērķa servera/starpniekservera adrese. |

[comment]: # ({/12ecaf8c-ee2b7a2a})

[comment]: # ({e66043c4-e66043c4})
#### Vecāks XML protokols

::: noteclassic
Zabbix pieņems līdz 16 MB XML Base64 kodētu datu, taču
viena atkodēta vērtība nedrīkst būt lielāka par 64 KB, pretējā gadījumā tā
atkodēšanas laikā tiks saīsināta līdz 64 KB.
:::

[comment]: # ({/e66043c4-e66043c4})