Konfigurācijas parametri: Zabbix aģents 2

Pārskats

Konfigurācijas parametri ļauj pielāgot Zabbix aģents 2 darbību.

Zabbix aģents 2 ir jaunas paaudzes Zabbix aģents, un to var izmantot Zabbix aģents vietā.

Norādiet parametru vērtības konfigurācijas failā (zabbix_agent2.conf). Visi parametri ir neobligāti, ja vien nav skaidri norādīts, ka parametrs ir obligāts.

Šī lapa ir strukturēta šādi:

  • Parametru pārskats (lai skatītu pilnu parametra informāciju, noklikšķiniet uz tā nosaukuma)
  • Parametru detaļas
Parameter Description
Alias Iestata vienuma atslēgas aizstājvārdu.
AllowKey Atļauj to vienuma atslēgu izpildi, kas atbilst paraugam.
AllowKeyRegexp Atļauj to vienuma atslēgu izpildi, kas atbilst ar regulāro izteiksmi balstītam paraugam.
BufferSend Iestata vērtību nosūtīšanas biežumu no bufera uz Zabbix serveris/starpniekserveris.
BufferSize Iestata maksimālo vērtību skaitu atmiņas buferī.
ControlSocket Norāda vadības ligzdu izpildlaika komandu nosūtīšanai ar opciju '-R'.
DebugLevel Iestata atkļūdošanas līmeni.
DenyKey Aizliedz to vienuma atslēgu izpildi, kas atbilst paraugam.
DenyKeyRegexp Aizliedz to vienuma atslēgu izpildi, kas atbilst ar regulāro izteiksmi balstītam paraugam.
EnablePersistentBuffer Iespējo lokālas pastāvīgas krātuves izmantošanu aktīvajiem vienumiem.
ForceActiveChecksOnStart Veic aktīvās pārbaudes nekavējoties pēc restartēšanas pirmajai saņemtajai konfigurācijai.
HeartbeatFrequency Iestata sirdspukstu ziņojumu biežumu sekundēs.
HostInterface Norāda hosta saskarni.
HostInterfaceItem Norāda vienumu hosta saskarnes iegūšanai.
HostMetadata Norāda hosta metadatus.
HostMetadataItem Norāda Zabbix aģents vienumu hosta metadatu iegūšanai.
Hostname Norāda hosta nosaukumu.
HostnameItem Norāda Zabbix aģents vienumu hosta nosaukuma iegūšanai.
Include Norāda direktoriju vai atsevišķus failus, kas jāiekļauj konfigurācijas failā.
ListenIP Norāda aģents klausīšanās IP adresi savienojumiem no serveris/starpniekserveris.
ListenPort Norāda aģents klausīšanās portu.
LogFile Norāda aģents žurnālfailu.
LogFileSize Iestata maksimālo žurnālfaila izmēru.
LogType Norāda žurnāla izvades tipu.
PersistentBufferFile Norāda failu SQLite datubāzes glabāšanai.
PersistentBufferPeriod Iestata laika periodu datu glabāšanai, ja nav savienojuma ar Zabbix serveris vai starpniekserveris.
PidFile Norāda PID failu.
Plugins.<PluginName>.System.Capacity Iestata vienlaicīgi izpildāmo pārbaužu limitu katram spraudnim.
Plugins.Log.MaxLinesPerSecond Iestata maksimālo jauno rindu skaitu sekundē nosūtīšanai uz Zabbix serveris/starpniekserveris, apstrādājot log vai logrt aktīvās pārbaudes.
Plugins.SystemRun.LogRemoteCommands Iespējo izpildīto čaulas komandu reģistrēšanu kā brīdinājumus.
PluginSocket Norāda UNIX ligzdas ceļu ielādējamu spraudņu saziņai.
PluginTimeout Iestata savienojumu noildzi ar ielādējamiem spraudņiem.
RefreshActiveChecks Norāda aktīvo pārbaužu saraksta atsvaidzināšanas biežumu.
Server Norāda Zabbix serveris/starpniekserveris IP adreses vai DNS nosaukumus.
ServerActive Norāda Zabbix serveris/starpniekserveris adresi vai klastera konfigurāciju, no kuras saņemt aktīvās pārbaudes.
SourceIP Norāda avota IP adresi.
StatusPort Norāda portu HTTP statusa pieprasījumu uzklausīšanai (http://localhost:<port>/status).
Timeout Norāda, cik ilgi gaidīt (sekundēs) savienojuma izveidei un datu apmaiņai ar Zabbix serveris vai starpniekserveris.
TLSAccept Norāda ienākošo savienojumu prasīto šifrēšanas līmeni.
TLSCAFile Norāda pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudža sertifikāta pārbaudei, ko izmanto šifrētai saziņai starp Zabbix komponentiem.
TLSCertFile Norāda pilnu ceļu uz failu, kurā ir aģents sertifikāts vai sertifikātu ķēde, ko izmanto šifrētai saziņai starp Zabbix komponentiem.
TLSCipherAll Norāda OpenSSL šifru virkni (TLS 1.2). Pārraksta noklusējuma šifru kopas atlases kritērijus sertifikātu un PSK balstītai šifrēšanai.
TLSCipherAll13 Norāda OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārraksta noklusējuma šifru kopas atlases kritērijus sertifikātu un PSK balstītai šifrēšanai.
TLSCipherCert Norāda OpenSSL šifru virkni (TLS 1.2). Pārraksta noklusējuma šifru kopas atlases kritērijus uz sertifikātu balstītai šifrēšanai.
TLSCipherCert13 Norāda OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārraksta noklusējuma šifru kopas atlases kritērijus uz sertifikātu balstītai šifrēšanai.
TLSCipherPSK Norāda OpenSSL šifru virkni (TLS 1.2). Pārraksta noklusējuma šifru kopas atlases kritērijus uz PSK balstītai šifrēšanai.
TLSCipherPSK13 Norāda OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārraksta noklusējuma šifru kopas atlases kritērijus uz PSK balstītai šifrēšanai.
TLSConnect Norāda Zabbix serveris vai starpniekserveris savienojumiem prasīto šifrēšanas līmeni.
TLSCRLFile Norāda pilnu ceļu uz failu, kurā ir atsauktie sertifikāti. Šis parametrs tiek izmantots šifrētai saziņai starp Zabbix komponentiem.
TLSKeyFile Norāda pilnu ceļu uz failu, kurā ir aģents privātā atslēga, ko izmanto šifrētai saziņai starp Zabbix komponentiem.
TLSPSKFile Norāda pilnu ceļu uz failu, kurā ir aģents iepriekš koplietotā atslēga, ko izmanto šifrētai saziņai ar Zabbix serveris vai starpniekserveris.
TLSPSKIdentity Norāda iepriekš koplietotās atslēgas identitātes virkni, ko izmanto šifrētai saziņai ar Zabbix serveris vai starpniekserveris.
TLSServerCertIssuer Norāda atļauto serveris (starpniekserveris) sertifikāta izdevēju.
TLSServerCertSubject Norāda atļauto serveris (starpniekserveris) sertifikāta subjektu.
UnsafeUserParameters Atļauj visus simbolus nodot lietotāja definēto parametru argumentos.
UserParameter Norāda uzraugāmo lietotāja definēto parametru.
UserParameterDir Norāda noklusējuma meklēšanas ceļu UserParameter komandām.

Ņemiet vērā:

  • Noklusējuma vērtības atspoguļo procesa noklusējumus, nevis vērtības piegādātajos konfigurācijas failos.
  • Vērtības atbalsta vides mainīgos.
  • Zabbix atbalsta konfigurācijas failus tikai UTF-8 kodējumā bez BOM.
  • Komentāri, kas sākas ar #, tiek atbalstīti tikai rindas sākumā.

Parametra informācija

Alias

Iestatiet vienumam atslēgas alias. To var izmantot, lai aizstātu garu un sarežģītu vienuma atslēgu ar īsāku un vienkāršāku.
Var būt norādīti vairāki Alias parametri. Nav atļauti vairāki parametri ar vienu un to pašu Alias atslēgu.
Dažādas Alias atslēgas var atsaukties uz vienu un to pašu vienuma atslēgu.
Aliasus var izmantot HostMetadataItem, bet ne HostnameItem parametrā.

Piemērs 1: lietotāja zabbix ID iegūšana.

Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]

Tagad saīsināto atslēgu zabbix.userid var izmantot datu iegūšanai.

Piemērs 2: CPU noslodzes iegūšana ar noklusējuma un pielāgotiem parametriem.

Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]

Tas ļauj izmantot atslēgu cpu.util, lai iegūtu CPU noslodzes procentuālo vērtību ar noklusējuma parametriem, kā arī izmantot cpu.util[all, idle, avg15], lai iegūtu konkrētus datus par CPU noslodzi.

Piemērs 3: vairāku zemlīmeņa atklāšanas noteikumu izpilde, kas apstrādā tos pašus atklāšanas vienumus.

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

Tagad ir iespējams konfigurēt vairākus atklāšanas noteikumus, izmantojot vfs.fs.discovery ar atšķirīgiem parametriem katram noteikumam, piemēram, vfs.fs.discovery[foo], vfs.fs.discovery[bar] utt.

AllowKey

Atļauj izpildīt tos vienumu atslēgu, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta * rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.
Vairākas atslēgu atbilstības kārtulas var definēt kopā ar DenyKey. Vairākas atslēgu atbilstības kārtulas var definēt kopā ar DenyKey, AllowKeyRegexp un DenyKeyRegexp. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Secība nosaka, kurai no atbilstošajām kārtulām būs prioritāte. Skatiet arī: Restricting agent checks.

AllowKeyRegexp

Atļauj izpildīt tos vienumu atslēgu nosaukumus, kas atbilst paraugam. Atslēgas paraugs ir regulārā izteiksme.
Vairākas atslēgu atbilstības kārtulas var definēt kopā ar DenyKeyRegexp, AllowKey un DenyKey. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Secība nosaka, kurai atbilstošajai kārtulai būs prioritāte. Skatiet arī: Aģenta pārbaužu ierobežošana.

BufferSend

Iestatiet vērtību nosūtīšanas biežumu no bufera uz Zabbix serveri/starpniekserveri (sekundēs).
Ņemiet vērā, ka, ja buferis ir pilns, dati tiks nosūtīti ātrāk.

Noklusējums: 5
Diapazons: 1-3600

BufferSize

Iestata maksimālo vērtību skaitu atmiņas buferī.
Aģents nosūtīs visus savāktos datus uz Zabbix serveri vai starpniekserveri, ja buferis būs pilns. Šis parametrs jāizmanto tikai tad, ja pastāvīgais buferis ir atspējots (EnablePersistentBuffer=0).

Noklusējums: 1000
Diapazons: 2-65535

ControlSocket

Norādiet vadības socket, lai ar -R opciju sūtītu izpildlaika komandas.

Noklusējums: /tmp/agent.sock

DebugLevel

Iestatiet atkļūdošanas līmeni:

  • 0 - pamatinformācija par Zabbix procesu palaišanu un apturēšanu;
  • 1 - kritiska informācija;
  • 2 - kļūdu informācija;
  • 3 - brīdinājumi;
  • 4 - atkļūdošanai (rada daudz informācijas);
  • 5 - paplašināta atkļūdošana (rada vēl vairāk informācijas).

Noklusējums: 3
Diapazons: 0-5

DenyKey

Noraidīt to vienumu atslēgu izpildi, kas atbilst paraugam.
Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta * rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.
Var definēt vairākus atslēgu atbilstības noteikumus kopā ar AllowKey. Var definēt vairākus atslēgu atbilstības noteikumus kopā ar AllowKey, AllowKeyRegexp un DenyKeyRegexp. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Secība nosaka, kuram atbilstības noteikumam būs prioritāte. Skatiet arī: Restricting agent checks.

DenyKeyRegexp

Liegt to vienumu atslēgu izpildi, kas atbilst noteiktam paraugam. Atslēgas paraugs ir regulārā izteiksme.
Vairākus atslēgu atbilstības noteikumus var definēt kopā ar AllowKeyRegexp, AllowKey un DenyKey. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Secība nosaka, kuram atbilstošajam noteikumam būs prioritāte. Skatiet arī: Aģenta pārbaužu ierobežošana.

EnablePersistentBuffer

Iespējot lokālās pastāvīgās krātuves izmantošanu aktīvajiem vienumiem.
Ja pastāvīgā krātuve ir atspējota, tiks izmantots atmiņas buferis.

Noklusējums: 0
Vērtības: 0 - atspējots, 1 - iespējots

ForceActiveChecksOnStart

Veic aktīvās pārbaudes nekavējoties pēc restartēšanas, lai saņemtu pirmo konfigurāciju.
Pieejams arī kā katra spraudņa konfigurācijas parametrs, piemēram: Plugins.Uptime.System.ForceActiveChecksOnStart=1

Noklusējums: 0
Vērtības: 0 - atspējots, 1 - iespējots

HeartbeatFrequency

Iestata heartbeat ziņojumu biežumu sekundēs.
Izmanto aktīvo pārbaužu pieejamības uzraudzībai.
0 - heartbeat ziņojumi ir atspējoti.

Noklusējums: 60
Diapazons: 0-3600

HostInterface

Norādiet hosta saskarni (IP adresi vai DNS nosaukumu), kas tiek izmantota hosta autoregistrācijas laikā.
Šī vērtība tiks izmantota, lai aizpildītu saskarni jaunizveidotajā hostā, un ļauj nepārprotami konfigurēt vai nu IP, vai DNS adresi.
Plašāku informāciju skatiet sadaļā DNS izmantošana kā noklusējuma saskarne.

Ja nav definēts, vērtība tiks iegūta no HostInterfaceItem.

Aģents izdos kļūdu un netiks palaists, ja vērtība pārsniegs 255 rakstzīmju limitu.

Diapazons: 0-255 rakstzīmes

HostInterfaceItem

Norādiet vienumu, lai noteiktu hosta saskarni (IP adresi vai DNS nosaukumu) hosta automātiskās reģistrācijas laikā.
Šī vērtība tiek izmantota tikai tad, ja HostInterface nav definēts.
Plašāku informāciju skatiet sadaļā DNS izmantošana kā noklusējuma saskarne.

Automātiskās reģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 255 rakstzīmju limitu.

system.run[] vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey iestatījumiem.

HostMetadata

Norādiet metadatus, kas tiek izmantoti, lai identificētu vai atšķirtu hostu hosta autoregistrācijas laikā.
HostMetadata ļauj atšķirt hostus ne tikai pēc hostname.

Ja nav definēts, vērtība tiks iegūta no HostMetadataItem.

aģents izsniegs kļūdu un netiks palaists, ja norādītā vērtība pārsniedz 2034 baitu limitu vai ir ne-UTF-8 virkne. Ja parametrs sagaida IP adresi vai DNS nosaukumu, tiks noraidītas arī vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, un tās tiks ziņotas kā nederīgas.

Vairāku rindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindas pārtraukuma.

Diapazons: 0-2034 baiti

HostMetadataItem

Norādiet vienumu, lai iegūtu host metadatus.
Šī opcija tiek izmantota tikai tad, ja HostMetadata nav definēts.

HostMetadataItem vērtība tiek izgūta katrā autoregistrācijas mēģinājumā un tiek izmantota tikai hosta autoreģistrācijas procesā. HostMetadataItem ļauj atšķirt hostus ne tikai pēc hostname.

Tiek atbalstīti lietotāja parametri un aizstājvārdi. system.run[] vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey iestatījumiem.

Autoregistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 65535 UTF-8 koda punktu limitu. Vienuma atgrieztajai vērtībai jābūt UTF-8 virknei, pretējā gadījumā tā tiks ignorēta. Ja parametrs sagaida IP adresi vai DNS nosaukumu, vērtības, kas ir derīgas UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, arī tiks noraidītas un atzīmētas kā nederīgas.

Vairākrindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindiņas pārtraukuma.

Hostname

Norādiet unikālus, reģistrjutīgus hostu nosaukumus. Ar komatiem atdalīts saraksts.
Nepieciešams aktīvajām pārbaudēm, un tam jāsakrīt ar hostu nosaukumiem, kā tie ir konfigurēti serverī.
Vērtība tiek iegūta no HostnameItem, ja tā nav definēta.
Atļautās rakstzīmes: burtciparu rakstzīmes, '.', ' ', '_' un '-'. Maksimālais garums: 128 rakstzīmes katram hosta nosaukumam, 2048 rakstzīmes visai rindai.

Noklusējums: iestatīts ar HostnameItem

HostnameItem

Norādiet vienumu, lai iegūtu hosta nosaukumu.
Šī opcija tiek izmantota tikai tad, ja Hostname nav definēts.
Lietotāja parametri vai aizstājvārdi netiek atbalstīti, taču system.run[] vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey vērtībām.

Noklusējums: system.hostname

Iekļaut

Norādiet direktoriju vai atsevišķus failus, kas jāiekļauj konfigurācijas failā.
Instalēšanas laikā Zabbix izveidos iekļaušanas direktoriju /usr/local/etc, ja vien tas netiks mainīts kompilēšanas laikā. Ceļš var būt relatīvs attiecībā pret zabbix_agent2.conf faila atrašanās vietu.
Lai norādītajā direktorijā iekļautu tikai atbilstošos failus, modeļu atbilstībai tiek atbalstīta zvaigznītes aizstājējzīme.
Skatiet īpašās piezīmes par ierobežojumiem.

Piemērs:

Include=/absolute/path/to/config/files/*.conf
ListenIP

Norādiet aģenta klausīšanās IP adresi savienojumiem no servera/starpniekservera. Komatu atdalīts saraksts.
Pirmā IP adrese tiek nosūtīta Zabbix serverim, ja savienojums tiek izveidots ar to, lai izgūtu aktīvo pārbaužu sarakstu.

Noklusējums: 0.0.0.0

ListenPort

Norādiet aģenta klausīšanās portu savienojumiem no servera/starpniekservera.

Noklusējums: 10050
Diapazons: 1024-32767

LogFile

Norādiet aģenta žurnāla failu.

Noklusējums: /tmp/zabbix_agent2.log
Obligāts: Jā, ja LogType ir iestatīts uz file; citādi nē

LogFileSize

Iestatiet maksimālo žurnāla faila izmēru (MB).
0 - atspējot automātisku žurnāla rotāciju.
Piezīme: Ja tiek sasniegts žurnāla faila izmēra ierobežojums un faila rotācija neizdodas jebkāda iemesla dēļ, esošais žurnāla fails tiek saīsināts un izveidots no jauna.

Noklusējums: 1
Diapazons: 0-1024

LogType

Norādiet žurnāla izvades tipu:

  • file - rakstīt žurnālu failā, kas norādīts ar LogFile parametru;
  • system - rakstīt žurnālu syslog;
  • console - rakstīt žurnālu standarta izvadei.

Noklusējums: file

PersistentBufferFile

Norādiet failu SQLite datubāzes glabāšanai. Jānorāda pilns faila nosaukums.
Šis parametrs tiek izmantots tikai tad, ja pastāvīgais buferis ir iespējots (EnablePersistentBuffer=1).

Pastāvīgā bufera periods

Iestatiet laika periodu datu glabāšanai, ja nav savienojuma ar Zabbix serveri vai starpniekserveri. Vecākie dati tiks zaudēti.
Žurnāla dati tiks saglabāti. Šis parametrs tiek izmantots tikai tad, ja pastāvīgais buferis ir iespējots (EnablePersistentBuffer=1).

Noklusējums: 1h
Diapazons: 1m-365d

PidFile

Norādiet PID failu.

Noklusējums: /tmp/zabbix_agent2.pid

Spraudņi.<PluginName>.System.Capacity

Iestatiet vienlaicīgi izpildāmo pārbaužu limitu katram <PluginName> spraudnim.

Noklusējums: 1000 Diapazons: 1-1000

Plugins.Log.MaxLinesPerSecond

Iestata maksimālo jauno rindu skaitu sekundē, ko nosūtīt uz Zabbix serveri/starpniekserveri, apstrādājot log vai logrt aktīvās pārbaudes.
Norādītā vērtība tiks pārrakstīta ar maxlines parametru, kas norādīts log un logrt vienuma atslēgā.
Piezīme: Zabbix apstrādās 10 reizes vairāk jauno rindu nekā iestatīts MaxLinesPerSecond, lai loga vienumos atrastu nepieciešamo virkni.

Noklusējums: 20
Diapazons: 1-1000

Plugins.SystemRun.LogRemoteCommands

Iespējot izpildīto čaulas komandu reģistrēšanu kā brīdinājumus.
Komandas tiks reģistrētas tikai tad, ja tās tiek izpildītas attālināti.
Žurnāla ieraksti netiks izveidoti, ja system.run[] tiek palaists lokāli, izmantojot HostMetadataItem, HostInterfaceItem vai HostnameItem parametrus.

Noklusējums: 0
Vērtības: 0 - atspējots, 1 - iespējots

PluginSocket

Norādiet UNIX ligzdas ceļu ielādējamo spraudņu saziņai.

Noklusējums: /tmp/agent.plugin.sock

PluginTimeout

Norādiet savienojumu noildzi ar ielādējamiem spraudņiem sekundēs.

Noklusējums: Timeout
Diapazons: 1-30

RefreshActiveChecks

Norādiet aktīvo pārbaužu saraksta atsvaidzināšanas biežumu sekundēs.
Ņemiet vērā, ka pēc aktīvo pārbaužu atsvaidzināšanas neveiksmes nākamais atsvaidzināšanas mēģinājums tiks veikts pēc 60 sekundēm.

Noklusējums: 5
Diapazons: 1-86400

Serveris

Norādiet Zabbix serveru/starpniekserveru IP adreses, pēc izvēles CIDR notācijā, vai DNS nosaukumus. Ar komatiem atdalīts saraksts.
Ienākošie savienojumi tiks pieņemti tikai no šeit norādītajiem hosts. Ja ir iespējota IPv6 atbalsts, tad 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 tiek uzskatīti par ekvivalentiem, un ::/0 atļaus jebkuru IPv4 vai IPv6 adresi. 0.0.0.0/0 var izmantot, lai atļautu jebkuru IPv4 adresi. Atstarpes ir atļautas. Ja šis parametrs nav norādīts, pasīvie pārbaužu veidi tiek atspējoti, un aģents neklausīsies nevienā TCP portā.

Piemērs:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
ServerActive

Norādiet Zabbix servera/starpniekservera adresi vai klastera konfigurāciju, no kuras saņemt aktīvās pārbaudes.
Servera/starpniekservera adrese ir IP adrese vai DNS nosaukums, kā arī izvēles ports, kas atdalīts ar kolu.
Klastera konfigurācija ir viena vai vairāku servera vai starpniekservera grupas dalībnieku adrešu kopa, kas atdalīta ar semikolu. Var norādīt vairākus Zabbix serverus/klasterus un Zabbix starpniekserverus, atdalot tos ar komatu. Ja netiek izmantotas starpniekserveru grupas, no katra Zabbix servera/klastera nedrīkst norādīt vairāk nekā vienu Zabbix starpniekserveri. Ja ir norādīts Zabbix starpniekserveris, tad šim starpniekserverim atbilstošo Zabbix serveri/klasteri norādīt nedrīkst.
Var norādīt vairākas ar komatiem atdalītas adreses, lai paralēli izmantotu vairākus neatkarīgus Zabbix serverus. Atstarpes ir atļautas.
Ja ports nav norādīts, tiek izmantots noklusējuma ports.
IPv6 adreses jāiekļauj kvadrātiekavās, ja šim hostam ir norādīts ports. Ja ports nav norādīts, kvadrātiekavas IPv6 adresēm nav obligātas.
Ja šis parametrs nav norādīts, aktīvās pārbaudes ir atspējotas.

Piemērs Zabbix starpniekserverim:

ServerActive=127.0.0.1:10051

Piemērs Zabbix starpniekserveru grupai:

ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com

Piemērs vairākiem serveriem:

ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

Piemērs augstai pieejamībai:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

Piemērs augstai pieejamībai ar diviem klasteriem un vienu serveri:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
SourceIP

Norādiet avota IP adresi šādiem gadījumiem:

  • izejošajiem savienojumiem ar Zabbix serveri vai Zabbix starpniekserveri.
  • savienojumu izveidei, izpildot dažus vienumus (web.page.get, net.tcp.port u.c.).
StatusPort

Norādiet portu HTTP statusa pieprasījumu uzklausīšanai (http://localhost:<port>/status).

Diapazons: 1024-32767

Noildze

Norādiet, cik ilgi jāgaida (sekundēs), lai izveidotu savienojumu un apmainītos ar datiem ar Zabbix starpniekserveri vai serveri.

Šis parametrs nosaka dažādu saziņas darbību ilgumu, tostarp:

  • gaidot atbildi no Zabbix servera;
  • sūtot pieprasījumus Zabbix serverim, tostarp vienuma konfigurācijas pieprasījumus un vienuma datu pieprasījumus aktīvajās pārbaudēs;
  • izgūstot žurnāla datus, izmantojot logfile;
  • sūtot sirdspukstu ziņojumus;
  • maksimālais ilgums vfs.* pārbaudēm;
  • kalpojot kā rezerves variants situācijās, kad serveris vai starpniekserveris, kas ir vecāks par 7.0 versiju, nosūta pārbaudes bez noildzēm.

Šī noildze netiks izmantota tiem aģenta pārbaudījumiem, kuriem lietotāja saskarnē ir konfigurējami noildzes iestatījumi (globālā, starpniekservera vai atsevišķa vienuma līmenī).

Noklusējums: 3
Diapazons: 1-30

TLSAccept

Norādiet ienākošajiem savienojumiem nepieciešamo šifrēšanas līmeni.
Tiek izmantots pasīvajām pārbaudēm.
Var norādīt vairākas vērtības, atdalot tās ar komatu:

  • unencrypted - pieņemt savienojumus bez šifrēšanas (noklusējums);
  • psk - pieņemt savienojumus ar TLS un iepriekš koplietotu atslēgu (PSK);
  • cert - pieņemt savienojumus ar TLS un sertifikātu.

Obligāti: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); citādi nē

TLSCAFile

Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudžu sertifikātu verifikācijai, kas tiek izmantota šifrētai saziņai starp Zabbix komponentiem.

TLSCertFile

Norādiet pilnu faila ceļu uz failu, kurā atrodas aģenta sertifikāts vai sertifikātu ķēde, kas tiek izmantota šifrētai saziņai ar Zabbix komponentēm.

TLSCipherAll

Norādiet OpenSSL šifru virkni (TLS 1.2). Pārrakstiet noklusējuma šifru kopas atlases kritērijus sertifikātu un PSK balstītai šifrēšanai.

Piemērs:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
TLSCipherAll13

Norādiet OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārrakstiet noklusējuma šifru komplektu atlases kritērijus sertifikātu un PSK balstītai šifrēšanai.

Piemērs:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherCert

Norādiet OpenSSL šifru virkni (TLS 1.2). Pārrakstiet noklusējuma šifru kopas atlases kritērijus sertifikātu balstītai šifrēšanai.

Piemērs:

EECDH+aRSA+AES128:RSA+aRSA+AES128

Ņemiet vērā, ka šo parametru nevar izmantot kopā ar TLSAccept=cert,psk; sertifikāta savienojumam (TLSConnect=cert) izmantojiet TLSCipherAll vietā.

TLSCipherCert13

Norādiet OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārrakstiet noklusējuma šifru kopas atlases kritērijus sertifikātu balstītai šifrēšanai.

Ņemiet vērā, ka šo parametru nevar izmantot kopā ar TLSAccept=cert,psk; sertifikāta savienojumam (TLSConnect=cert) izmantojiet TLSCipherAll13 vietā.

TLSCipherPSK

Norādiet OpenSSL šifru virkni (TLS 1.2). Pārrakstiet noklusējuma šifru kopas atlases kritērijus PSK balstītai šifrēšanai.

Piemērs:

kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13

Norādiet OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārrakstiet noklusējuma šifru kopas atlases kritērijus PSK balstītai šifrēšanai.

Piemērs:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect

Norādiet šifrēšanas līmeni, kas nepieciešams aģenta savienojumiem ar Zabbix serveri vai starpniekserveri.
Tiek izmantots aktīvajām pārbaudēm.
Var norādīt tikai vienu vērtību:

  • unencrypted - savienoties bez šifrēšanas (noklusējums);
  • psk - savienoties, izmantojot TLS un iepriekš koplietotu atslēgu (PSK);
  • cert - savienoties, izmantojot TLS un sertifikātu.

Obligāti: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); citādi nē

TLSCRLFile

Norādiet pilnu ceļu uz failu, kurā ir atsauktie sertifikāti. Šis parametrs tiek izmantots šifrētai saziņai starp Zabbix komponentiem.

TLSKeyFile

Norādiet pilnu ceļu uz failu, kurā atrodas aģenta privātā atslēga, kas tiek izmantota šifrētai saziņai starp Zabbix komponentēm.

TLSPSKFile

Norādiet pilnu faila ceļu uz failu, kurā ir aģenta iepriekš koplietotā atslēga, kas tiek izmantota šifrētai saziņai ar Zabbix serveri vai starpniekserveri.

TLSPSKIdentity

Norādiet iepriekš koplietotās atslēgas identitātes virkni, ko izmanto šifrētai saziņai ar Zabbix serveri vai starpniekserveri.

TLSServerCertIssuer

Norādiet atļauto servera (starpniekservera) sertifikāta izdevēju.

TLSServerCertSubject

Norādiet atļauto servera (starpniekservera) sertifikāta subjektu.

UnsafeUserParameters

Atļauj visus simbolus nodot argumentiem lietotāja definētajos parametros. Šādi simboli nav atļauti: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @ %
Turklāt rindiņas pārtraukuma simboli nav atļauti.

Noklusējums: 0
Vērtības: 0 - neatļaut, 1 - atļaut

UserParameter

Norādiet lietotāja definētu parametru, ko uzraudzīt. Var būt vairāki lietotāja definēti parametri.
Formāts: UserParameter=<key>,<shell command>
Ņemiet vērā, ka shell komandai nedrīkst atgriezt tukšu virkni vai tikai EOL. Shell komandām var būt relatīvi ceļi, ja ir norādīts parametrs UserParameterDir.

Piemērs:

UserParameter=system.test,who|wc -l
UserParameter=check_cpu,./custom_script.sh
UserParameterDir

Norādiet noklusējuma meklēšanas ceļu UserParameter komandām. Ja šis iestatījums tiek izmantots, aģents pirms komandas izpildes mainīs savu darba direktoriju uz šeit norādīto. Tādējādi UserParameter komandām var izmantot relatīvu ./ prefiksu pilna ceļa vietā.
Atļauts tikai viens ieraksts.

Piemērs:

UserParameterDir=/opt/myscripts