6 Zabbix aģents 2 (Windows)

Pārskats

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

Šajā sadaļā ir uzskaitīti parametri, ko atbalsta Windows Zabbix aģenta 2 konfigurācijas fails (zabbix_agent2.conf).

Parametri ir uzskaitīti bez papildu informācijas. Noklikšķiniet uz parametra, lai skatītu pilnu informāciju.

Parameter Description
Alias Iestata vienuma atslēgai aizstājvārdu.
AllowKey Atļauj izpildīt tās vienumu atslēgas, kas atbilst paraugam.
BufferSend Neglabāt datus buferī ilgāk par N sekundēm.
BufferSize Maksimālais vērtību skaits atmiņas buferī.
ControlSocket Vadības ligzda, ko izmanto izpildlaika komandu nosūtīšanai ar opciju '-R'.
DebugLevel Atkļūdošanas līmenis.
DenyKey Aizliedz izpildīt tās vienumu atslēgas, kas atbilst paraugam.
EnablePersistentBuffer Iespējo lokālās pastāvīgās krātuves izmantošanu aktīvajiem vienumiem.
ForceActiveChecksOnStart Veikt aktīvās pārbaudes uzreiz pēc restartēšanas pirmajai saņemtajai konfigurācijai.
HeartbeatFrequency Sirdspuksta ziņojumu biežums sekundēs.
HostInterface Neobligāts parametrs, kas definē hosta saskarni.
HostInterfaceItem Neobligāts parametrs, kas definē vienumu, ko izmanto hosta saskarnes iegūšanai.
HostMetadata Neobligāts parametrs, kas definē hosta metadatus.
HostMetadataItem Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto hosta metadatu iegūšanai.
Hostname Neobligāts parametrs, kas definē hosta nosaukumu.
HostnameItem Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto hosta nosaukuma iegūšanai.
Include Konfigurācijas failā var iekļaut atsevišķus failus vai visus failus direktorijā.
ListenIP Ar komatiem atdalīts IP adrešu saraksts, uz kurām aģentam jāgaida savienojumi.
ListenPort Aģents gaidīs savienojumus no servera šajā portā.
LogFile Žurnālfaila nosaukums.
LogFileSize Žurnālfaila maksimālais izmērs.
LogType Žurnāla izvades tips.
PersistentBufferFile Fails, kurā Zabbix aģentam 2 jāglabā SQLite datubāze.
PersistentBufferPeriod Laika periods, cik ilgi dati jāglabā, ja nav savienojuma ar serveri vai starpniekserveri.
Plugins.<PluginName>.System.Capacity Pārbaužu limits katram spraudnim, ko var izpildīt vienlaikus.
Plugins.Log.MaxLinesPerSecond Maksimālais jauno rindu skaits sekundē, ko aģents nosūtīs uz Zabbix serveri vai starpniekserveri, apstrādājot 'log' un 'logrt' aktīvās pārbaudes.
Plugins.SystemRun.LogRemoteCommands Iespējo izpildīto čaulas komandu reģistrēšanu kā brīdinājumus.
PluginSocket Ceļš uz UNIX ligzdu ielādējamo spraudņu saziņai.
PluginTimeout Savienojumu ar ielādējamiem spraudņiem noildze sekundēs.
PerfCounter Definē jaunu parametru <parameter_name>, kas ir sistēmas veiktspējas skaitītāja <perf_counter_path> vidējā vērtība norādītajā laika periodā <period> (sekundēs).
PerfCounterEn Definē jaunu parametru <parameter_name>, kas ir sistēmas veiktspējas skaitītāja <perf_counter_path> vidējā vērtība norādītajā laika periodā <period> (sekundēs). Salīdzinot ar PerfCounter, perfcounter ceļiem jābūt angļu valodā.
RefreshActiveChecks Cik bieži tiek atsvaidzināts aktīvo pārbaužu saraksts.
Server Ar komatiem atdalīts Zabbix serveru un Zabbix starpniekserveru IP adrešu saraksts, pēc izvēles CIDR pierakstā, vai DNS nosaukumi.
ServerActive Zabbix servera/starpniekservera adrese vai klastera konfigurācija, no kuras saņemt aktīvās pārbaudes.
SourceIP Avota IP adrese.
StatusPort Ja iestatīts, aģents gaidīs HTTP statusa pieprasījumus šajā portā (http://localhost:<port>/status).
Timeout Norāda, cik ilgi gaidīt (sekundēs), lai izveidotu savienojumu un apmainītos ar datiem ar Zabbix starpniekserveri vai serveri.
TLSAccept Kādus ienākošos savienojumus pieņemt.
TLSCAFile Pilns ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti partnera sertifikāta pārbaudei; izmanto šifrētai saziņai starp Zabbix komponentiem.
TLSCertFile Pilns ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde; izmanto šifrētai saziņai starp Zabbix komponentiem.
TLSCipherAll13 OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru komplekta atlases kritērijus sertifikātu un PSK šifrēšanai.
TLSCipherCert13 OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru komplekta atlases kritērijus uz sertifikātiem balstītai šifrēšanai.
TLSCipherPSK13 OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru komplekta atlases kritērijus uz PSK balstītai šifrēšanai.
TLSConnect Kā aģentam jāpieslēdzas Zabbix serverim vai starpniekserverim.
TLSCRLFile Pilns ceļš uz failu, kurā ir atsauktie sertifikāti. Šis parametrs tiek izmantots šifrētai saziņai starp Zabbix komponentiem.
TLSKeyFile Pilns ceļš uz failu, kurā ir aģenta privātā atslēga; izmanto šifrētai saziņai starp Zabbix komponentiem.
TLSPSKFile Pilns ceļš uz failu, kurā ir aģenta iepriekš koplietotā atslēga; izmanto šifrētai saziņai ar Zabbix serveri.
TLSPSKIdentity Iepriekš koplietotās atslēgas identitātes virkne; izmanto šifrētai saziņai ar Zabbix serveri.
TLSServerCertIssuer Atļautais servera (starpniekservera) sertifikāta izdevējs.
TLSServerCertSubject Atļautais servera (starpniekservera) sertifikāta subjekts.
UnsafeUserParameters Atļauj visām rakstzīmēm tikt nodotām lietotāja definēto parametru argumentos.
UserParameter Lietotāja definēts parametrs uzraudzībai.
UserParameterDir Noklusējuma meklēšanas ceļš UserParameter komandām.

Visi parametri ir neobligāti, ja vien nav skaidri norādīts, ka parametrs ir obligāts.

Ņemiet vērā:

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

Parametru informācija

Alias

Iestata aizstājvārdu vienuma atslēgai. 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. Vairāki parametri ar vienu un to pašu Alias atslēgu nav atļauti.
Dažādas Alias atslēgas var atsaukties uz vienu un to pašu vienuma atslēgu.
Aizstājvārdus var izmantot parametrā HostMetadataItem, bet ne parametrā HostnameItem.

  1. piemērs: Lapošanas faila izmantojuma procentos iegūšana no servera.
Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

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

  1. piemērs: CPU slodzes iegūšana ar noklusējuma un pielāgotiem parametriem.
Alias=cpu.load:system.cpu.load
Alias=cpu.load[*]:system.cpu.load[*]

Tas ļauj izmantot atslēgu cpu.load, lai iegūtu CPU slodzi ar noklusējuma parametriem, kā arī izmantot cpu.load[percpu,avg15], lai iegūtu konkrētus datus par CPU slodzi.

  1. piemērs: Vairāku zemā līmeņa atklāšanas noteikumu palaišana, kas apstrādā vienus un tos pašus atklāšanas vienumus.
Alias=vfs.fs.discovery[*]:vfs.fs.discovery

Tagad ir iespējams iestatīt vairākus atklāšanas noteikumus, izmantojot vfs.fs.discovery ar dažādiem parametriem katram noteikumam, piemēram, vfs.fs.discovery[foo], vfs.fs.discovery[bar] utt.

AllowKey

Atļaut izpildīt tos vienumu atslēgu modeļus, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta rakstzīmi "*", lai atbilstu jebkuram jebkādu rakstzīmju skaitam.
Vairākus atslēgu atbilstības noteikumus var definēt kopā ar DenyKey. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: Aģenta pārbaužu ierobežošana.

BufferSend

The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.
Note, that if the buffer is full, the data will be sent sooner.

Default: 5
Range: 1-3600

BufferSize

Maksimālais vērtību skaits 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

Vadības ligzda, ko izmanto izpildlaika komandu nosūtīšanai ar opciju '-R'.

Noklusējums: \\.\pipe\agent.sock

DebugLevel

Norādiet 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

Aizliegt to vienumu atslēgu izpildi, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta rakstzīmi "*", lai atbilstu jebkuram jebkādu rakstzīmju skaitam.
Vairākus atslēgu atbilstības noteikumus var definēt kombinācijā ar AllowKey. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: Aģenta pārbaužu ierobežošana.

EnablePersistentBuffer

Iespējo 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

Veikt aktīvās pārbaudes uzreiz pēc restartēšanas pirmajai saņemtajai konfigurācijai. 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

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

Noklusējums: 60
Diapazons: 0-3600

HostInterface

Neobligāts parametrs, kas nosaka hosta saskarni (IP adresi vai DNS nosaukumu), ko izmanto hosta automātiskās reģistrācijas procesa laikā. Šī vērtība tiks izmantota, lai aizpildītu saskarni jaunizveidotajā hostā, un ļauj skaidri 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 nestartēsies, ja vērtība pārsniegs 255 rakstzīmju ierobežojumu.

Diapazons: 0-255 rakstzīmes

HostInterfaceItem

Neobligāts parametrs, kas definē vienumu, ko izmanto, lai noteiktu hosta saskarni (IP adresi vai DNS nosaukumu) hosta automātiskās reģistrācijas procesa 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 ierobežojumu.

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

HostMetadata

Neobligāts parametrs, kas definē metadatus, ko izmanto, lai identificētu vai atšķirtu hostu hosta automātiskās reģistrācijas procesā (aktīvais aģents). HostMetadata ļauj atšķirt hostus ne tikai pēc hosta nosaukuma.

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

Aģents ziņos par kļūdu un nestartēsies, ja norādītā vērtība pārsniegs 2034 baitu ierobežojumu vai būs ne UTF-8 virkne. Ja parametrs paredz 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 apgriezta pie pirmās rindas pārtraukuma.

Diapazons: 0-2034 baiti

HostMetadataItem

Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto, lai iegūtu hosta metadatus. Šī opcija tiek izmantota tikai tad, ja HostMetadata nav definēts.

HostMetadataItem vērtība tiek iegūta katrā automātiskās reģistrācijas mēģinājumā un tiek izmantota tikai hosta automātiskās reģistrācijas procesā (aktīvais aģents). HostMetadataItem ļauj atšķirt hostus ne tikai pēc hosta nosaukuma.

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

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 65535 UTF-8 koda punktu ierobežojumu. Vienuma atgrieztajai vērtībai jābūt UTF-8 virknei, pretējā gadījumā tā tiks ignorēta. Ja parametrs paredz 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 apgriezta pie pirmās rindas pārtraukuma.

Hostname

Ar komatiem atdalītu, unikālu, reģistrjutīgu hostu nosaukumu saraksts. Nepieciešams aktīvajām pārbaudēm, un tam jāsakrīt ar hostu nosaukumiem, kā tie konfigurēti serverī. Ja vērtība nav definēta, tā tiek iegūta no HostnameItem.
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: Iestata HostnameItem

HostnameItem

Neobligāts parametrs, kas definē vienumu, ko izmanto hosta nosaukuma iegūšanai. Šī opcija tiek izmantota tikai tad, ja Hostname nav definēts. Lietotāja parametri vai aizstājvārdi netiek atbalstīti, bet vienums system.run[] tiek atbalstīts neatkarīgi no AllowKey/DenyKey vērtībām.

Noklusējums: system.hostname

Iekļaut

Konfigurācijas failā varat iekļaut atsevišķus failus vai visus failus direktorijā (pēc noklusējuma tas atrodas C:\Program Files\Zabbix Agent 2, ja Zabbix aģents ir instalēts, izmantojot Windows MSI instalētāja pakotnes; tas atrodas instalēšanas laikā norādītajā mapē, ja Zabbix aģents ir instalēts kā zip arhīvs). Visiem iekļautajiem failiem jābūt ar pareizu sintaksi, pretējā gadījumā aģents netiks palaists. Ceļš var būt relatīvs attiecībā pret zabbix_agent2.conf faila atrašanās vietu (piemēram, Include=.\zabbix_agent2.d\plugins.d\*.conf).
Lai iekļautu tikai atbilstošos failus norādītajā direktorijā, tiek atbalstīta zvaigznītes aizstājējzīme šablonu atbilstības noteikšanai.
Skatiet īpašās piezīmes par ierobežojumiem.

Piemērs:

Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf
ListenIP

Ar komatiem atdalītu IP adrešu saraksts, kurās aģents klausās. Pirmā IP adrese tiek nosūtīta Zabbix serverim, ja tiek veidots savienojums ar to, lai iegūtu aktīvo pārbaužu sarakstu.

Noklusējums: 0.0.0.0

ListenPort

Aģents klausīsies šajā portā savienojumiem no servera.

Noklusējums: 10050
Diapazons: 1024-32767

LogFile

Aģenta žurnālfaila nosaukums.

Noklusējums: c:\zabbix_agent2.log
Obligāts: Jā, ja LogType ir iestatīts uz file; pretējā gadījumā nē

LogFileSize

Maksimālais žurnālfaila izmērs MB.
0 - atspējot automātisko žurnālfaila rotāciju.
Piezīme: Ja tiek sasniegts žurnālfaila izmēra ierobežojums un faila rotācija kāda iemesla dēļ neizdodas, esošais žurnālfails tiek saīsināts un sākts no jauna.

Noklusējums: 1
Diapazons: 0-1024

LogType

Žurnāla izvades tips:
file - rakstīt žurnālu failā, kas norādīts parametrā LogFile;
console - rakstīt žurnālu standarta izvadē.

Noklusējums: file

PersistentBufferFile

Fails, kur Zabbix aģents 2 glabā SQLite datubāzi. Jānorāda pilns faila nosaukums. Šis parametrs tiek izmantots tikai tad, ja ir iespējota pastāvīgā buferēšana (EnablePersistentBuffer=1).

PersistentBufferPeriod

Laika periods, cik ilgi dati jāglabā, ja nav savienojuma ar serveri vai starpniekserveri. Vecāki dati tiks zaudēti. Žurnāla dati tiks saglabāti. Šis parametrs tiek izmantots tikai tad, ja noturīgais buferis ir iespējots (EnablePersistentBuffer=1).

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

Plugins.<PluginName>.System.Capacity

Pārbaužu limits katram <PluginName> spraudnim, ko var izpildīt vienlaikus.

Noklusējums: 1000 Diapazons: 1-1000

Plugins.Log.MaxLinesPerSecond

Maksimālais jauno rindu skaits, ko aģents nosūtīs sekundē uz Zabbix serveri vai starpniekserveri, apstrādājot aktīvās pārbaudes log, logrt un eventlog. Norādīto vērtību pārrakstīs parametrs maxlines, kas norādīts log, logrt vai eventlog vienuma atslēgā.
Piezīme: Zabbix apstrādās 10 reizes vairāk jauno rindu, nekā iestatīts MaxLinesPerSecond, lai log vienumos meklētu 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 tiks izpildītas attālināti. Žurnāla ieraksti netiks izveidoti, ja system.run[] tiks palaists lokāli ar parametriem HostMetadataItem, HostInterfaceItem vai HostnameItem.

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

PluginSocket

Ceļš uz UNIX ligzdu ielādējamo spraudņu saziņai.

Noklusējums: \\.\pipe\agent.plugin.sock

PluginTimeout

Savienojumu ar ielādējamiem spraudņiem noildze sekundēs.

Noklusējums: Timeout
Diapazons: 1-30

PerfCounter

Definē jaunu parametru <parameter_name>, kas ir sistēmas veiktspējas skaitītāja <perf_counter_path> vidējā vērtība norādītajā laika periodā <period> (sekundēs).
Sintakse: <parameter_name>,"<perf_counter_path>",<period>

Piemēram, ja vēlaties saņemt procesora pārtraukumu vidējo skaitu sekundē par pēdējo minūti, varat definēt jaunu parametru "interrupts" šādi:

PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60

Lūdzu, ņemiet vērā dubultpēdiņas ap veiktspējas skaitītāja ceļu. Parametra nosaukums (interrupts) jāizmanto kā vienuma atslēga, veidojot vienumu. Paraugi vidējās vērtības aprēķināšanai tiks ņemti katru sekundi.
Varat palaist "typeperf -qx", lai iegūtu visu Windows pieejamo veiktspējas skaitītāju sarakstu.

PerfCounterEn

Definē jaunu parametru <parameter_name>, kas ir sistēmas veiktspējas skaitītāja <perf_counter_path> vidējā vērtība norādītajā laika periodā <period> (sekundēs). Salīdzinot ar PerfCounter, perfcounter ceļiem jābūt angļu valodā. Atbalstīts tikai Windows Server 2008/Vista un jaunākās versijās.
Sintakse: <parameter_name>,"<perf_counter_path>",<period>

Piemēram, ja vēlaties saņemt procesora pārtraukumu vidējo skaitu sekundē par pēdējo minūti, varat definēt jaunu parametru "interrupts" šādi:

PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60

Lūdzu, ņemiet vērā dubultās pēdiņas ap veiktspējas skaitītāja ceļu. Parametra nosaukums (interrupts) jāizmanto kā vienuma atslēga, veidojot vienumu. Paraugi vidējās vērtības aprēķināšanai tiks ņemti katru sekundi.
Angļu virkņu sarakstu var atrast, apskatot šādu reģistra atslēgu: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.

RefreshActiveChecks

Cik bieži tiek atsvaidzināts aktīvo pārbaužu saraksts, sekundēs. Ņemiet vērā, ka pēc neveiksmīga aktīvo pārbaužu saraksta atsvaidzināšanas nākamais atsvaidzināšanas mēģinājums tiks veikts pēc 60 sekundēm.

Noklusējums: 5
Diapazons: 1-86400

Server

Ar komatiem atdalītu IP adrešu saraksts, pēc izvēles CIDR pierakstā, vai Zabbix serveru vai Zabbix starpniekserveru DNS nosaukumi. Ienākošie savienojumi tiks pieņemti tikai no šeit norādītajiem hostiem. Ja ir iespējots IPv6 atbalsts, tad '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' tiek uzskatītas par vienādām, 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īvās pārbaudes tiek atspējotas 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

Zabbix servera/starpniekservera adrese vai klastera konfigurācija, no kuras saņemt aktīvās pārbaudes. Servera/starpniekservera adrese ir IP adrese vai DNS nosaukums un neobligāts ports, kas atdalīts ar kolu.
Klastera konfigurācija ir viena vai vairākas servera vai starpniekservera grupas dalībnieku adreses, kas atdalītas 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 nevajadzētu norādīt vairāk nekā vienu Zabbix starpniekserveri. Ja ir norādīts Zabbix starpniekserveris, tad šī starpniekservera Zabbix serveri/klasteri nevajadzētu norādīt.
Lai paralēli izmantotu vairākus neatkarīgus Zabbix serverus, var norādīt vairākas ar komatiem atdalītas adreses. Atstarpes ir atļautas.
Ja ports nav norādīts, tiek izmantots noklusējuma ports.
IPv6 adresēm jābūt ietvertām kvadrātiekavās, ja šim hostam ir norādīts ports. Ja ports nav norādīts, IPv6 adrešu kvadrātiekavas 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\]

Augstas pieejamības piemērs:

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

Augstas pieejamības piemērs ar diviem klasteriem un vienu serveri:

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

Avota IP adrese:

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

Ja iestatīts, aģents klausīsies šajā portā HTTP statusa pieprasījumiem (http://localhost:<port>/status).

Diapazons: 1024-32767

Noildze

Norāda, cik ilgi gaidīt (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:

  • atbildes gaidīšanu no Zabbix servera;
  • pieprasījumu sūtīšanu uz Zabbix serveri, tostarp vienumu konfigurācijas pieprasījumus un vienumu datus aktīvajās pārbaudēs;
  • žurnāla datu iegūšanu, izmantojot logfile vai Windows notikumu žurnāla uzraudzību;
  • heartbeat ziņojumu sūtīšanu;
  • maksimālo ilgumu vfs.* pārbaudēm;
  • izmantošanu kā rezerves vērtību scenārijos, kad serveris vai starpniekserveris, kas ir vecāks par versiju 7.0, sūta pārbaudes bez noildzēm.

Šī noildze netiks izmantota tām aģenta pārbaudēm, kurām lietotāja saskarnē ir konfigurējami noildzes iestatījumi (globālā, starpniekservera vai katra vienuma līmenī).

Noklusējums: 3
Diapazons: 1-30

TLSAccept

Pieņemtie ienākošie savienojumi. Izmanto 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āts: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); pretējā gadījumā nē

TLSCAFile

Pilns ceļš uz failu, kas satur augstākā līmeņa CA sertifikātus(-u) partnera sertifikāta verifikācijai un tiek izmantots šifrētai saziņai starp Zabbix komponentiem.

TLSCertFile

Pilns ceļš uz failu, kas satur aģenta sertifikātu vai sertifikātu ķēdi un tiek izmantots šifrētai saziņai ar Zabbix komponentiem.

TLSCipherAll13

OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru komplektu atlases kritērijus šifrēšanai, kas balstīta uz sertifikātiem un PSK.

Piemērs:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherCert13

OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru kopas atlases kritērijus šifrēšanai, kas balstīta uz sertifikātiem.

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

TLSCipherPSK13

OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru komplekta atlases kritērijus uz PSK balstītai šifrēšanai.

Piemērs:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect

Kā aģentam jāpieslēdzas Zabbix serverim vai starpniekserverim. Izmanto aktīvajām pārbaudēm. Var norādīt tikai vienu vērtību:
unencrypted - pieslēgties bez šifrēšanas (noklusējums)
psk - pieslēgties, izmantojot TLS un iepriekš koplietotu atslēgu (PSK)
cert - pieslēgties, izmantojot TLS un sertifikātu

Obligāts: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); pretējā gadījumā nē

TLSCRLFile

Pilns ceļš uz failu, kas satur atsauktos sertifikātus. Šis parametrs tiek izmantots šifrētai saziņai starp Zabbix komponentiem.

TLSKeyFile

Pilns ceļš uz failu, kas satur aģents privāto atslēgu un tiek izmantots šifrētai saziņai starp Zabbix komponentiem.

TLSPSKFile

Pilns ceļš uz failu, kas satur aģenta iepriekš koplietoto atslēgu un tiek izmantots šifrētai saziņai ar Zabbix serveri.

TLSPSKIdentity

Iepriekš koplietotās atslēgas identitātes virkne, ko izmanto šifrētai saziņai ar Zabbix serveri.

TLSServerCertIssuer

Atļautā servera (starpniekservera) sertifikāta izdevējs.

TLSServerCertSubject

Atļautā servera (starpniekservera) sertifikāta subjekts.

UnsafeUserParameters

Atļaut visas rakstzīmes nodot argumentos lietotāja definētiem parametriem. Šādas rakstzīmes nav atļautas: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @ %
Papildus tam nav atļautas arī jaunās rindas rakstzīmes.

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

UserParameter

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

Piemērs:

UserParameter=system.test,dir /b | find /c /v ""
UserParameter=check_cpu,.\custom\_script.bat
UserParameterDir

Noklusējuma meklēšanas ceļš UserParameter komandām. Ja tiek izmantots, aģents pirms komandas izpildes nomainīs savu darba direktoriju uz šeit norādīto. Tādējādi UserParameter komandām pilna ceļa vietā var izmantot relatīvo prefiksu .\.
Ir atļauts tikai viens ieraksts.

Piemērs:

UserParameterDir=C:\opt\myscripts