6 Zabbix aģents 2 (Windows)

Pārskats

Zabbix aģents 2 ir Zabbix aģenta jaunās paaudzes versija, 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 Nosaka vienumu atslēgas aizstājvārdu.
AllowKey Atļauj to vienumu atslēgu izpildi, kas atbilst paraugam.
BufferSend Nekavē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 to vienumu atslēgu izpildi, kas atbilst 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, izmantojot pirmo saņemto konfigurāciju.
HeartbeatFrequency Sirdspukstu ziņojumu biežums sekundēs.
HostInterface Neobligāts parametrs, kas nosaka hosta saskarni.
HostInterfaceItem Neobligāts parametrs, kas nosaka vienumu, ko izmanto hosta saskarnes iegūšanai.
HostMetadata Neobligāts parametrs, kas nosaka hosta metadatus.
HostMetadataItem Neobligāts parametrs, kas nosaka Zabbix aģenta vienumu, ko izmanto hosta metadatu iegūšanai.
Hostname Neobligāts parametrs, kas nosaka hosta nosaukumu.
HostnameItem Neobligāts parametrs, kas nosaka 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ītu IP adrešu saraksts, uz kurām aģentam jāuzklausa.
ListenPort Aģents uzklausīs savienojumus no serveris šajā portā.
LogFile Žurnālfaila nosaukums.
LogFileSize Maksimālais žurnālfaila lielums.
LogType Žurnāla izvades tips.
PersistentBufferFile Fails, kurā Zabbix aģents 2 glabās SQLite datubāzi.
PersistentBufferPeriod Laika periods, cik ilgi dati jāglabā, ja nav savienojuma ar serveris vai starpniekserveris.
Plugins.<PluginName>.System.Capacity Pārbaudu skaita ierobežojums uz spraudni, ko var izpildīt vienlaikus.
Plugins.Log.MaxLinesPerSecond Maksimālais jauno rindu skaits, ko aģents sekundē nosūtīs uz Zabbix serveris vai starpniekserveris, apstrādājot aktīvās pārbaudes 'log' un 'logrt'.
Plugins.SystemRun.LogRemoteCommands Iespējo izpildīto čaulas komandu reģistrēšanu kā brīdinājumus.
PluginSocket Windows nosauktās caurules ceļš ielādējamu spraudņu saziņai.
PluginTimeout Savienojumu noildze ar ielādējamiem spraudņiem, 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īdzinājumā 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ītu IP adrešu saraksts, pēc izvēles CIDR notācijā, vai Zabbix serveris un Zabbix starpniekserveris DNS nosaukumi.
ServerActive Zabbix serveris/starpniekserveris adrese vai klastera konfigurācija, no kuras iegūt aktīvās pārbaudes.
SourceIP Avota IP adrese.
StatusPort Ja iestatīts, aģents uzklausīs HTTP statusa pieprasījumus šajā portā (http://localhost:<port>/status).
Timeout Norāda, cik ilgi jāgaida (sekundēs), lai izveidotu savienojumu un apmainītos ar datiem ar Zabbix starpniekserveris vai serveris.
TLSAccept Kādus ienākošos savienojumus pieņemt.
TLSCAFile Pilns ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudžu sertifikātu verifikācijai, ko izmanto šifrētai saziņai starp Zabbix komponentēm.
TLSCertFile Pilns ceļš uz failu, kurā ir aģents sertifikāts vai sertifikātu ķēde, ko izmanto šifrētai saziņai starp Zabbix komponentēm.
TLSCipherAll13 OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru kopas atlases kritērijus sertifikātu un PSK balstītai šifrēšanai.
TLSCipherCert13 OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru kopas atlases kritērijus uz sertifikātiem balstītai šifrēšanai.
TLSCipherPSK13 OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru kopas atlases kritērijus uz PSK balstītai šifrēšanai.
TLSConnect Kā aģentam jāizveido savienojums ar Zabbix serveris vai starpniekserveris.
TLSCRLFile Pilns ceļš uz failu, kurā ir atsaukto sertifikātu saraksts. Šis parametrs tiek izmantots šifrētai saziņai starp Zabbix komponentēm.
TLSKeyFile Pilns ceļš uz failu, kurā ir aģents privātā atslēga, ko izmanto šifrētai saziņai starp Zabbix komponentēm.
TLSPSKFile Pilns ceļš uz failu, kurā ir aģents iepriekš koplietotā atslēga, ko izmanto šifrētai saziņai ar Zabbix serveris.
TLSPSKIdentity Iepriekš koplietotās atslēgas identitātes virkne, ko izmanto šifrētai saziņai ar Zabbix serveris.
TLSServerCertIssuer Atļautais serveris (starpniekserveris) sertifikāta izdevējs.
TLSServerCertSubject Atļautais serveris (starpniekserveris) sertifikāta subjekts.
UnsafeUserParameters Atļauj visus simbolus nodot argumentiem lietotāja definētiem parametriem.
UserParameter Lietotāja definēts parametrs, ko uzraudzīt.
UserParameterDir Noklusējuma meklēšanas ceļš UserParameter komandām.

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

Piezīme:

  • Noklusējuma vērtības atspoguļo procesa noklusējumus, nevis vērtības piegādātajos konfigurācijas failos;
  • 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

Iestata vienuma atslēgas aizstājvārdu. 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 parametram HostnameItem.

  1. piemērs: Lappuses faila izmantošanas procentu iegūšana no serveris.
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 low-level discovery noteikumu izpilde, apstrādājot 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 nosaukumus, 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 vienumu 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.
Šo parametru drīkst izmantot 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 simbolu skaitam.
Vairākus atslēgu atbilstības noteikumus var definēt kopā 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ē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, saņemot 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

Sirdsdarbības ziņojumu biežums sekundēs. Tiek izmantots aktīvo pārbaužu pieejamības uzraudzībai.
0 - sirdsdarbības ziņojumi ir atspējoti.

Noklusējums: 60
Diapazons: 0-3600

HostInterface

Neobligāts parametrs, kas nosaka host interfeisu (IP adresi vai DNS nosaukumu), ko izmanto host automātiskās reģistrācijas procesa laikā. Šī vērtība tiks izmantota, lai aizpildītu interfeisu jaunizveidotajā host, un ļauj skaidri konfigurēt IP vai DNS adresi. Plašāku informāciju skatiet sadaļā DNS izmantošana kā noklusējuma interfeiss.

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

aģents izsniegs kļūdu un netiks palaists, ja vērtība pārsniedz 255 rakstzīmju limitu.

Diapazons: 0-255 rakstzīmes

HostInterfaceItem

Neobligāts parametrs, kas nosaka vienumu, ko izmanto, lai noteiktu hosts saskarni (IP adresi vai DNS nosaukumu) hosts 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 limitu.

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 autoregistrācijas procesa laikā (aktīvais aģents). HostMetadata ļauj atšķirt hostus ne tikai pēc hostname.

Ja tas 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 un kā nederīgas ziņotas arī vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi.

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

Diapazons: 0-2034 baiti

HostMetadataItem

Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto host metadatu iegūšanai. Šī 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 host autoreģistrācijas procesā (aktīvais aģents). 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 ziņotas kā nederīgas.

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

Hostname

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

Noklusējums: iestatīts ar HostnameItem

HostnameItem

Neobligāts parametrs, kas nosaka 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, taču system.run[] vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey vērtībām.

Noklusējums: system.hostname

Iekļaušana

Konfigurācijas failā var 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ācijas pakotnes; tas atrodas mapē, kas norādīta instalēšanas laikā, 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 pret zabbix_agent2.conf faila atrašanās vietu (piem., Include=.\zabbix_agent2.d\plugins.d\*.conf).
Lai iekļautu tikai attiecīgos failus norādītajā direktorijā, tiek atbalstīta zvaigznītes aizstājējzīme modeļa 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ģentam jāuzklausa savienojumi. Pirmā IP adrese tiek nosūtīta Zabbix serverim, ja tiek veidots savienojums ar to, lai izgūtu aktīvo pārbaužu sarakstu.

Noklusējums: 0.0.0.0

ListenPort

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

Noklusējums: 10050
Diapazons: 1024-32767

LogFile

Aģenta žurnāla faila nosaukums.

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

LogFileSize

Log faila maksimālais lielums MB.
0 - atspējot automātisku žurnālfaila rotāciju.
Piezīme: Ja tiek sasniegts žurnālfaila lieluma ierobežojums un faila rotācija neizdodas jebkāda iemesla dēļ, esošais žurnālfails tiek saīsināts un izveidots no jauna.

Noklusējums: 1
Diapazons: 0-1024

LogType

Žurnāla izvades veids:
file - ierakstīt žurnālu failā, kas norādīts ar parametru LogFile;
console - ierakstīt žurnālu standarta izvades plūsmā.

Noklusējums: file

PersistentBufferFile

Fails, kur Zabbix aģents 2 glabā SQLite datubāzi. Tam jābūt pilnam faila nosaukumam. Šis parametrs tiek izmantots tikai tad, ja pastāvīgais buferis ir iespējots (EnablePersistentBuffer=1).

PersistentBufferPeriod

Laika periods, kurā dati jāglabā, ja nav savienojuma ar 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

Spraudņi.<PluginName>.System.Capacity

Vienlaicīgi izpildāmo pārbaudes reižu limits vienam <PluginName> spraudnim.

Noklusējums: 1000 Diapazons: 1-1000

Plugins.Log.MaxLinesPerSecond

Maksimālais jauno rindu skaits, ko aģents sekundē nosūtīs 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 meklētu nepieciešamo virkni žurnāla vienumos.

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

Ceļš uz Windows nosaukto kanālu ielādējamo spraudņu saziņai.

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

PluginTimeout

Savienojumu noildze ar ielādējamiem spraudņiem, 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 vidējo procesora pārtraukumu skaitu sekundē pēdējās minūtes laikā, 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) ir 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ītajam laika periodam <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 vidējo procesora pārtraukumu skaitu sekundē pēdējās minūtes laikā, varat definēt jaunu parametru "interrupts" šādi:

PerfCounterEn = 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) ir 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 aktīvo pārbaužu saraksts tiek atsvaidzināts, 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

Ar komatiem atdalītu IP adrešu saraksts, pēc izvēles CIDR notācijā, vai Zabbix serveru vai Zabbix starpniekserveru DNS nosaukumi. 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' ļ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ā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 iegūt aktīvās pārbaudes. Servera/starpniekservera adrese ir IP adrese vai DNS nosaukums, un pēc izvēles 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 šim starpniekserverim Zabbix serveris/klasteris nedrīkst būt norādīts.
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 adresēm jābūt ietvertām kvadrātiekavās, ja šim hostam ir norādīts ports. Ja ports nav norādīts, kvadrātiekavas IPv6 adresēm ir izvēles.
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

Avota IP adrese šā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

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

Diapazons: 1024-32767

Noildze

Norāda, 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:

  • gaidīšanu uz atbildi no Zabbix servera;
  • pieprasījumu nosūtīšanu Zabbix serverim, tostarp vienuma konfigurācijas pieprasījumus un vienuma datus aktīvajās pārbaudēs;
  • žurnālfaila datu iegūšanu, izmantojot logfile vai Windows notikumu žurnāla uzraudzību;
  • sirdspukstu ziņojumu nosūtīšanu;
  • maksimālo ilgumu vfs.* pārbaudēm;
  • izmantošanu kā rezerves variantu 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ēm, kurām lietotāja saskarnē ir konfigurējami noildzes iestatījumi (globālā līmenī, starpniekservera līmenī vai katram vienumam atsevišķi).

Noklusējums: 3
Diapazons: 1-30

TLSAccept

Ienākošie savienojumi, ko pieņemt. 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āts: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); citādi nē

TLSCAFile

Pilns ceļa nosaukums failam, kurā ir augstākā līmeņa CA sertifikāti vienaudžu sertifikātu verifikācijai, ko izmanto šifrētai saziņai starp Zabbix komponentiem.

TLSCertFile

Pilns faila ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde, kas tiek izmantota šifrētai saziņai ar Zabbix komponentiem.

TLSCipherAll13

OpenSSL šifru virknes iestatījums (TLS 1.3). Pārraksta 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

Šis parametrs tiek atbalstīts kopš Zabbix 7.0.4.

TLSCipherCert13

OpenSSL šifru virknes (TLS 1.3). Pārraksta noklusējuma šifru komplekta 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.

Šis parametrs tiek atbalstīts kopš Zabbix 7.0.4.

TLSCipherPSK13

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

Piemērs:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

Šis parametrs tiek atbalstīts kopš Zabbix 7.0.4.

TLSConnect

Kā aģentam jāizveido savienojums ar Zabbix serveri vai starpniekserveri. Tiek izmantots aktīvajām pārbaudēm. Var norādīt tikai vienu vērtību:
unencrypted - izveidot savienojumu bez šifrēšanas (noklusējums)
psk - izveidot savienojumu, izmantojot TLS un iepriekš koplietotu atslēgu (PSK)
cert - izveidot savienojumu, izmantojot TLS un sertifikātu

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

TLSCRLFile

Fails, kurā ir atsaukto sertifikātu pilnais ceļš. Šis parametrs tiek izmantots šifrētai saziņai starp Zabbix komponentēm.

TLSKeyFile

Fails, kas satur aģenta privāto atslēgu, pilnais ceļš, ko izmanto šifrētai saziņai starp Zabbix komponentiem.

TLSPSKFile

Fails, kurā ir aģenta iepriekš koplietotā atslēga, pilnais ceļš, ko izmanto š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ļautais servera (starpniekservera) sertifikāta izdevējs.

TLSServerCertSubject

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

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

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 komandai 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

UserParameter komandu noklusējuma meklēšanas ceļš. Ja tas tiek izmantots, aģents pirms komandas izpildes mainīs savu darba direktoriju uz šeit norādīto. Tādējādi UserParameter komandas var izmantot relatīvu .\ prefiksu pilna ceļa vietā.
Atļauts tikai viens ieraksts.

Piemērs:

UserParameterDir=C:\opt\myscripts