[comment]: # ({1c2455b7-1c2455b7})
# 2 Aktīvā aģenta automātiskā reģistrācija

[comment]: # ({/1c2455b7-1c2455b7})

[comment]: # ({53523aad-81edbbe2})
#### Pārskats

Ir iespējams atļaut aktīvo Zabbix aģentu automātisko reģistrāciju, pēc kuras serveris var sākt to uzraudzību.
Šādā veidā jaunus hostus var pievienot uzraudzībai, nekonfigurējot tos manuāli serverī.

Automātiskā reģistrācija var notikt, kad iepriekš nezināms aktīvs aģents pieprasa pārbaudes.

Šī iespēja var būt ļoti noderīga jaunu Cloud mezglu automātiskai uzraudzībai.
Tiklīdz Cloud vidē parādās jauns mezgls, Zabbix automātiski sāks hosta veiktspējas un pieejamības datu vākšanu.

Aktīvo aģentu automātiskā reģistrācija atbalsta arī pievienoto hostu uzraudzību ar pasīvajām pārbaudēm.
Kad aktīvais aģents pieprasa pārbaudes, ja tā konfigurācijas failā ir definēti [`ListenIP`](/manual/appendix/config/zabbix_agentd?hl=ListenIP#listenip) vai [`ListenPort`](/manual/appendix/config/zabbix_agentd?hl=ListenIP#listenport) konfigurācijas parametri, tie tiek nosūtīti arī serverim.
Ja ir norādītas vairākas IP adreses, serverim tiek nosūtīta pirmā no tām.

Serveris, pievienojot jauno automātiski reģistrēto hostu, izmanto saņemto IP adresi un portu, lai konfigurētu aģentu.
Ja netiek saņemta IP adreses vērtība, tiek izmantota tā, kas izmantota ienākošajam savienojumam.
Ja netiek saņemta porta vērtība, tiek izmantots 10050.

Ir iespējams norādīt, ka hosts jāreģistrē automātiski ar [DNS nosaukumu](#using-dns-as-default-interface) kā noklusējuma aģenta saskarni.

Automātiskā reģistrācija tiek izpildīta atkārtoti:

-   ja mainās hosta [metadatu](#using-host-metadata) informācija:
    -   jo ir mainīts HostMetadata un aģents ir restartēts
    -   jo ir mainījusies HostMetadataItem atgrieztā vērtība
-   manuāli izveidotiem hostiem, kuriem trūkst metadatu
-   ja hosts tiek manuāli mainīts tā, lai to uzraudzītu cits Zabbix starpniekserveris
-   ja automātiskā reģistrācija tam pašam hostam nāk no jauna Zabbix starpniekservera

Aktīvā aģenta automātiskās reģistrācijas sirdspukstu intervāls Zabbix serverim un Zabbix starpniekserverim ir 120 sekundes.
Tāpēc, ja atklātais hosts tiek dzēsts, automātiskā reģistrācija tiks izpildīta atkārtoti pēc 120 sekundēm.

[comment]: # ({/53523aad-81edbbe2})

[comment]: # ({5d32b87c-5d32b87c})
#### Konfigurācija

[comment]: # ({/5d32b87c-5d32b87c})

[comment]: # ({9340f4a0-bf3762f0})
##### Norādiet serveri

Pārliecinieties, ka Zabbix serveris ir norādīts aģenta [konfigurācijas failā](/manual/appendix/config/zabbix_agentd) - `zabbix_agentd.conf`:

```ini
ServerActive=10.0.0.1
```

Ja vien jūs īpaši nenorādāt *Hostname* `zabbix_agentd.conf`, serveris izmantos aģenta atrašanās vietas sistēmas resursdatora nosaukumu, lai piešķirtu nosaukumu hostam.
Sistēmas resursdatora nosaukumu Linux vidē var iegūt, izpildot komandu `hostname`.

Ja *Hostname* Zabbix aģenta konfigurācijā ir definēts kā ar komatiem atdalīts hostu saraksts, tiks izveidoti hosti visiem uzskaitītajiem resursdatoru nosaukumiem.

Pēc jebkādu izmaiņu veikšanas konfigurācijas failā restartējiet aģentu.

[comment]: # ({/9340f4a0-bf3762f0})

[comment]: # ({04e44cd6-7b103292})
##### Darbība aktīvā aģenta automātiskai reģistrācijai

Kad serveris saņem automātiskās reģistrācijas pieprasījumu no aģenta, tas izsauc [darbību](/manual/config/notifications/action).
Aģenta automātiskajai reģistrācijai ir jākonfigurē darbība ar notikuma avotu "Autoregistration".

::: noteclassic
Lai aktīvie aģenti varētu automātiski reģistrēties, nav nepieciešams iestatīt [tīkla atklāšanu](network_discovery).
:::

Zabbix lietotāja saskarnē dodieties uz *Alerts → Actions*, atlasiet *Autoregistration actions* un noklikšķiniet uz *Create action*:

-   Cilnē Action piešķiriet savai darbībai nosaukumu
-   Pēc izvēles norādiet [nosacījumus](/manual/config/notifications/action/conditions#autoregistration-actions).
Nosacījumos host nosaukumam/host metadatiem varat izmantot apakšvirknes atbilstību vai regulārās izteiksmes atbilstību.
Ja plānojat izmantot nosacījumu "Host metadata", skatiet nākamo sadaļu.
-   Cilnē Operations pievienojiet atbilstošas darbības, piemēram, 'Add host', 'Add to host group' (piemēram, *Discovered hosts*), 'Link templates' utt.

::: notetip
Ja hosts, kas tiks automātiski reģistrēti, visticamāk, būs atbalstīti tikai aktīvai uzraudzībai (piemēram, hosts, kas no jūsu Zabbix serveris ir aiz ugunsmūra), iespējams, vēlēsities izveidot konkrētu veidni, piemēram, *Template\_Linux-active*, ko piesaistīt.
:::

Izveidotie hosts tiek pievienoti grupai *Discovered hosts* (pēc noklusējuma; to var konfigurēt sadaļā *Administration* > *General* > *[Other](/manual/web_interface/frontend_sections/administration/general#other-parameters)*).
Ja vēlaties, lai hosts tiktu pievienoti citai grupai, pievienojiet darbību *Remove from host group* (norādot "Discovered hosts") un arī darbību *Add to host group* (norādot citu host grupu), jo hostam ir jāpieder host grupai.

[comment]: # ({/04e44cd6-7b103292})

[comment]: # ({96641bd1-66cac4ef})
#### Droša automātiskā reģistrācija

Drošs automātiskās reģistrācijas veids ir iespējams, konfigurējot uz PSK balstītu autentifikāciju ar šifrētiem savienojumiem.

Šifrēšanas līmenis tiek konfigurēts globāli sadaļā *Administrēšana* >
*Vispārīgi* > *[Automātiskā reģistrācija](/manual/web_interface/frontend_sections/administration/general#autoregistration)*.
Ir iespējams izvēlēties neizmantot šifrēšanu, TLS šifrēšanu ar PSK autentifikāciju vai abus variantus (lai daži hosti varētu reģistrēties bez šifrēšanas, bet citi — ar šifrēšanu).

Autentifikāciju ar PSK Zabbix serveris pārbauda pirms hosta pievienošanas.
Ja pārbaude ir veiksmīga, hosts tiek pievienots un *[Savienojumi no/uz hostu](/manual/config/hosts/host#encryption)* tiek iestatīti tikai uz 'PSK', izmantojot identitāti/koplietoto atslēgu, kas ir tāda pati kā globālajā automātiskās reģistrācijas iestatījumā.

::: noteimportant
Lai nodrošinātu automātiskās reģistrācijas drošību instalācijās, kurās tiek izmantoti starpniekserveri, ir jāiespējo šifrēšana starp Zabbix serveri un starpniekserveri.
:::

[comment]: # ({/96641bd1-66cac4ef})

[comment]: # ({6f85d554-9c275675})
#### DNS izmantošana kā noklusējuma saskarne

HostInterface un HostInterfaceItem [konfigurācijas parametri](/manual/appendix/config/zabbix_agentd) ļauj norādīt pielāgotu vērtību hosts saskarnei automātiskās reģistrācijas laikā.

Precīzāk, tie ir noderīgi, ja hosts jāreģistrē automātiski ar DNS nosaukumu kā noklusējuma aģenta saskarni, nevis tā IP adresi.
Šādā gadījumā DNS nosaukums jānorāda vai jāatgriež kā HostInterface vai HostInterfaceItem parametru vērtība.
Ja kāda no šiem parametriem vērtība mainās — piemēram, no IP adreses uz DNS nosaukumu vai otrādi — automātiski reģistrētā hosta noklusējuma saskarne tiks attiecīgi atjaunināta.
Šis atjauninājums tiek piemērots esošajam hostam, nevis izveidots jauns.
Lai nosūtītu jauno vērtību, aģents ir jārestartē, lai tas atkārtoti uzsāktu automātiskās reģistrācijas procesu.

::: noteclassic
Ja HostInterface vai HostInterfaceItem parametri nav konfigurēti, tiek izmantots listen\_dns parametrs.
Šī vērtība tiek noteikta, veicot aģenta IP adreses reverso DNS uzmeklēšanu.
Ja reversais DNS nav pareizi konfigurēts vai atgriež nederīgu nosaukumu, tas var izraisīt nepareizu vai neveiksmīgu automātisko reģistrāciju nederīgas saskarnes vērtības dēļ.
:::

[comment]: # ({/6f85d554-9c275675})

[comment]: # ({32a8b833-af247ed6})
#### Host metadata izmantošana

Kad aģents sūta automātiskās reģistrācijas pieprasījumu serverim, tas nosūta savu resursdatora nosaukumu.
Dažos gadījumos, piemēram, Amazon mākoņa mezgliem, resursdatora nosaukums nav pietiekams, lai Zabbix serveris varētu atšķirt atklātos hosts.
Host metadata var izmantot pēc izvēles, lai no aģenta uz serveri nosūtītu citu informāciju.

Host metadata tiek konfigurēti aģenta [konfigurācijas failā](/manual/appendix/config/zabbix_agentd) - `zabbix_agentd.conf`.
Konfigurācijas failā ir 2 veidi, kā norādīt host metadata:

```ini
HostMetadata
HostMetadataItem
```

Skatiet opciju aprakstu iepriekš norādītajā saitē.

Parametrs HostMetadataItem var atgriezt līdz 65535 UTF-8 koda punktiem.
Garāka vērtība tiks saīsināta.

Ņemiet vērā, ka MySQL gadījumā faktiskais maksimālais rakstzīmju garums būs mazāks, ja atgrieztajā vērtībā ir vairāku baitu rakstzīmes.
Piemēram, vērtība, kas satur tikai 3 baitu rakstzīmes, kopā būs ierobežota līdz 21844 rakstzīmēm, savukārt vērtība, kas satur tikai 4 baitu rakstzīmes, būs ierobežota līdz 16383 simboliem.

::: noteimportant
Automātiskās reģistrācijas mēģinājums notiek katru reizi, kad aktīvs aģents nosūta serverim pieprasījumu atjaunot aktīvās pārbaudes.
Aizkave starp pieprasījumiem ir norādīta aģenta parametrā [RefreshActiveChecks](/manual/appendix/config/zabbix_agentd).
Pirmais pieprasījums tiek nosūtīts nekavējoties pēc aģenta restartēšanas.
:::

[comment]: # ({/32a8b833-af247ed6})

[comment]: # ({4c860844-e2de662b})
#### Piemēri

[comment]: # ({/4c860844-e2de662b})

[comment]: # ({30b1e8da-070aaeb4})
##### Autoreģistrācija pēc OS, izmantojot HostMetadata

Pieņemsim, ka vēlaties, lai hosti tiktu automātiski reģistrēti Zabbix serverī.
Jūsu tīklā darbojas aktīvi Zabbix aģenti (skatiet iepriekš esošo sadaļu "Configuration").
Jūsu tīklā ir Windows hosti un Linux hosti, un Zabbix lietotāja saskarnē jums ir pieejamas veidnes "Linux by Zabbix agent" un "Windows by Zabbix agent".
Tāpēc hosta reģistrācijas laikā vēlaties, lai reģistrējamajam hostam tiktu piemērota atbilstošā Linux/Windows veidne.
Pēc noklusējuma automātiskās reģistrācijas laikā uz serveri tiek nosūtīts tikai hosta nosaukums, un ar to var nepietikt.
Lai nodrošinātu, ka hostam tiek piemērota pareizā veidne, jums jāizmanto hosta metadati.

[comment]: # ({/30b1e8da-070aaeb4})

[comment]: # ({e73b011d-9543f562})
**Lietotāja saskarnes konfigurācija**

Pirmā lieta, kas jādara, ir konfigurēt lietotāja saskarni.
Izveidojiet 2 darbības.
Pirmā darbība:

-   Nosaukums: Linux hosta automātiskā reģistrācija
-   Nosacījumi: Hosta metadati satur *Linux*
-   Darbības: Saistīt veidnes: Linux by Zabbix aģents

::: noteclassic
Šajā gadījumā varat izlaist darbību "Pievienot hostu".
Lai saistītu veidni ar hostu, vispirms ir jāpievieno hosts, tāpēc serveris to izdarīs automātiski.
:::

Otrā darbība:

-   Nosaukums: Windows hosta automātiskā reģistrācija
-   Nosacījumi: Hosta metadati satur *Windows*
-   Darbības: Saistīt veidnes: Windows by Zabbix aģents

[comment]: # ({/e73b011d-9543f562})

[comment]: # ({5c00417a-110dbc2b})
**Aģenta konfigurācija**

Tagad jums jākonfigurē aģenti.
Pievienojiet nākamo rindu aģenta konfigurācijas failiem:

```ini
HostMetadataItem=system.uname
```

Tādējādi jūs nodrošināsiet, ka hosta metadati saturēs "Linux" vai "Windows" atkarībā no hosta, uz kura darbojas aģents.
Hosta metadatu piemērs šajā gadījumā:

```default
Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux
Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32
```

Neaizmirstiet restartēt aģentu pēc jebkādu izmaiņu veikšanas konfigurācijas failā.

[comment]: # ({/5c00417a-110dbc2b})

[comment]: # ({4906ecf5-85f695d6})
##### HostMetadata izmantošana, lai kontrolētu automātisko reģistrāciju un veidnes

[comment]: # ({/4906ecf5-85f695d6})

[comment]: # ({ccdb1681-c5ffa817})
***1. solis — Aizsargājiet reģistrāciju ar HostMetadata***

Izmantojot hosta metadatus, var nodrošināt pamata aizsardzību pret nevēlamu hostu reģistrēšanos.

[comment]: # ({/ccdb1681-c5ffa817})

[comment]: # ({7cbf997b-c9e24581})
**Lietotāja saskarnes konfigurācija**

Izveidojiet darbību lietotāja saskarnē, izmantojot grūti uzminamu slepeno kodu, lai liegtu nevēlamiem hostiem reģistrēties:

-   Nosaukums: Linux automātiskās reģistrācijas darbība
-   Nosacījumi:
    - Aprēķina veids: AND
    - Nosacījums (A): Hosta metadati satur //Linux//
    - Nosacījums (B): Hosta metadati satur //21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae//
-   Darbības: 
    - Sūtīt ziņojumu lietotājiem: Admin, izmantojot visus datu nesējus
    - Pievienot hostu grupām: Linux serveri
    - Piesaistīt veidnes: Linux by Zabbix aģents

Lūdzu, ņemiet vērā, ka šī metode viena pati nenodrošina spēcīgu aizsardzību, jo dati tiek pārraidīti atklātā tekstā.
Lai izmaiņas stātos spēkā nekavējoties, ir nepieciešama konfigurācijas kešatmiņas pārlāde.

[comment]: # ({/7cbf997b-c9e24581})

[comment]: # ({498ec3de-9fca761d})
**Aģenta konfigurācija**

Pievienojiet aģenta konfigurācijas failam šādu rindu:

```ini
HostMetadata=Linux    21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae
```

kur "Linux" ir platforma, bet pārējā virknes daļa ir grūti uzminams slepenais teksts.

Neaizmirstiet restartēt aģentu pēc jebkādu izmaiņu veikšanas konfigurācijas failā.

[comment]: # ({/498ec3de-9fca761d})

[comment]: # ({60f2763f-c93c8a99})
***2. solis — pievienojiet veidni reģistrētajam hostam***

Jau reģistrētam hostam ir iespējams pievienot papildu veidnes.
Šajā gadījumā veidne MySQL by Zabbix agent tiks piesaistīta tikai tiem hostiem, kuru HostMetadata satur marķieri `MySQL`.

[comment]: # ({/60f2763f-c93c8a99})

[comment]: # ({f0fc5068-6eb51339})
**Lietotāja saskarnes konfigurācija**

Atjauniniet darbību lietotāja saskarnē:

-   Nosaukums: Linux autoreģistrācijas darbība
-   Nosacījumi:
    - Aprēķina veids: AND
    - Nosacījums (A): Hosta metadati satur Linux
    - Nosacījums (B): Hosta metadati satur 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae
    - Nosacījums (C): Hosta metadati satur MySQL
-   Operācijas:
    - Sūtīt ziņojumu lietotājiem: Admin, izmantojot visus datu nesējus
    - Pievienot hostu grupām: Linux serveri
    - Piesaistīt veidnes: Linux by Zabbix aģents
    - Piesaistīt veidnes: MySQL by Zabbix Agent

[comment]: # ({/f0fc5068-6eb51339})

[comment]: # ({c0627a72-15c86816})
**Aģenta konfigurācija**

Atjauniniet nākamo rindu aģenta konfigurācijas failā:

```ini
HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae
```

Neaizmirstiet restartēt aģentu pēc jebkādu izmaiņu veikšanas konfigurācijas failā.

[comment]: # ({/c0627a72-15c86816})