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 Windows Zabbix aģenta 2 konfigurācijas failā (zabbix_agent2.conf) atbalstītie parametri.
Parametri ir uzskaitīti bez papildu informācijas. Noklikšķiniet uz parametra, lai skatītu pilnu informāciju.
| Parameter | Description |
|---|---|
| Alias | Nosaka vienuma atslēgas aizstājvārdu. |
| AllowKey | Atļauj to vienuma atslēgu izpildi, kas atbilst paraugam. |
| BufferSend | Neglabā 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 -R opciju. |
| DebugLevel | Atkļūdošanas līmenis. |
| DenyKey | Aizliedz to vienuma atslēgu izpildi, kas atbilst paraugam. |
| EnablePersistentBuffer | Iespējo lokālās pastāvīgās 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 | Žurnālfaila maksimālais izmērs. |
| 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ārbažu limits vienam spraudnim, ko var izpildīt vienlaikus. |
| Plugins.Log.MaxLinesPerSecond | Maksimālais jauno rindu skaits, ko aģents sekundē nosūtīs 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ļš saziņai ar ielādējamiem spraudņiem. |
| 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 saņemt 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 | Šifrēšanas līmenis, kas nepieciešams ienākošajiem savienojumiem. |
| TLSCAFile | Pilns ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudžu sertifikātu pārbaudei, ko izmanto šifrētai saziņai starp Zabbix komponentiem. |
| TLSCertFile | Pilns ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde, ko izmanto šifrētai saziņai starp Zabbix komponentiem. |
| 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 sertifikātu balstītai šifrēšanai. |
| TLSCipherPSK13 | OpenSSL šifru virkne (TLS 1.3). Pārraksta noklusējuma šifru kopas atlases kritērijus PSK balstītai šifrēšanai. |
| TLSConnect | Šifrēšanas līmenis, kas nepieciešams aģenta savienojumiem ar Zabbix serveris vai starpniekserveris. |
| 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, ko izmanto šifrētai saziņai starp Zabbix komponentiem. |
| TLSPSKFile | Pilns ceļš uz failu, kurā ir aģenta 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 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 nav obligā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ē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ā.
Parametru informācija
Alias
Nosaka 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 HostnameItem parametrā.
Piemērs 1: Lapošanas 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.
Piemērs 2: CPU noslodzes iegūšana ar noklusējuma un pielāgotiem parametriem.
Alias=cpu.load:system.cpu.load
Alias=cpu.load[*]:system.cpu.load[*]
Tas ļauj izmantot cpu.load atslēgu CPU noslodzes iegūšanai ar noklusējuma parametriem, kā arī cpu.load[percpu,avg15], lai iegūtu konkrētus datus par CPU noslodzi.
Piemērs 3: Vairāku low-level discovery 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 nosaukumus, kas atbilst paraugam.
Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta * rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.
Vairāki atslēgu atbilstības noteikumi var tikt definēti 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
Iestata maksimālo vērtību skaitu atmiņas buferī.
Ja buferis ir pilns, aģents nosūtīs visus savāktos datus uz Zabbix serveri vai starpniekserveri.
Š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 -R opciju.
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āki atslēgu atbilstības noteikumi var tikt definēti 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ē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 procesā. Šī vērtība tiks izmantota, lai aizpildītu saskarni jaunizveidotajā hostā, un ļauj skaidri konfigurēt IP vai DNS adresi. Papildinformāciju skatiet sadaļā DNS izmantošana kā noklusējuma saskarne.
Ja nav definēts, vērtība tiks iegūta no HostInterfaceItem.
aģents ziņos par 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 nosaka 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.
Papildinformā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 automātiskās reģistrā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 par nederīgām 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 hosts metadatu iegūšanai.
Šī opcija tiek izmantota tikai tad, ja HostMetadata nav definēts.
HostMetadataItem vērtība tiek izgūta katrā autoreģistrācijas mēģinājumā un tiek izmantota tikai hosts autoreģistrācijas procesā (aktīvais aģents).
HostMetadataItem ļauj atšķirt hosts ne tikai pēc hostname.
Tiek atbalstīti lietotāja parametri un aizstājvārdi.
Tiek atbalstīts system.run[] vienums neatkarīgi no AllowKey/DenyKey iestatījumiem.
Autoreģ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 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īgs 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ī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, taču system.run[] vienums 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ācijas pakotnes; 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
pareizai sintaksei, 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ā, modeļu atbilstībai tiek atbalstīts zvaigznītes aizstājējzīmes simbols.
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āla faila nosaukums.
Noklusējums: c:\zabbix_agent2.log
Obligāts: Jā, ja LogType ir iestatīts uz file; citos gadījumos 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 veids:
- file - ierakstīt žurnālu failā, kas norādīts ar
LogFileparametru; - console - ierakstīt žurnālu standarta izvades plūsmā.
Noklusējums: file
Pastāvīgā bufera fails
Fails, kurā Zabbix aģentam 2 jāglabā SQLite datubāze.
Tam jābūt pilnam faila nosaukumam.
Šis parametrs tiek izmantots tikai tad, ja pastāvīgais buferis ir iespējots (EnablePersistentBuffer=1).
Pastāvīgā bufera periods
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
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
Iestata maksimālo jauno rindu skaitu, ko aģents nosūtīs uz Zabbix serveri vai starpniekserveri sekundē, apstrādājot log, logrt un eventlog aktīvās pārbaudes.
Norādīto vērtību pārrakstīs maxlines parametrs, 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 tiks izpildītas attālināti.
Žurnāla ieraksti netiks izveidoti, ja system.run[] tiek palaists lokāli, izmantojot parametrus HostMetadataItem, HostInterfaceItem vai HostnameItem.
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 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 pēdējās minūtes vidējo procesora pārtraukumu skaitu sekundē, 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ī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
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ējots 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 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 šādiem gadījumiem:
- izejošajiem savienojumiem ar Zabbix serveri vai Zabbix starpniekserveri;
- savienojumu izveidei, izpildot dažus vienumus (
web.page.get,net.tcp.portu.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
Ienākošajiem savienojumiem nepieciešamais šifrēšanas līmenis. 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ļš 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 virknes (TLS 1.3). Pārraksta noklusējuma šifru komplektu atlases kritērijus uz 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ā.
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
Šifrēšanas līmenis, 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āts: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); citādi 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ļ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
Noklusējuma meklēšanas ceļš UserParameter komandām.
Ja 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 būt relatīvs prefikss .\ pilna ceļa vietā.
Atļauts tikai viens ieraksts.
Piemērs:
UserParameterDir=C:\opt\myscripts