Konfigurācijas parametri: Zabbix aģents 2 (Windows)
Pārskats
Konfigurācijas parametri ļauj pielāgot Zabbix aģents 2 darbību operētājsistēmā Windows.
Norādiet parametru vērtības konfigurācijas failā (zabbix_agent2.win.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 detalizēta informācija
| Parameter | Description |
|---|---|
| Alias | Iestata vienums atslēgas aizstājvārdu. |
| AllowKey | Atļauj to vienums atslēgu izpildi, kas atbilst paraugam. |
| BufferSend | Iestata vērtību nosūtīšanas biežumu no bufera uz Zabbix serveris. |
| BufferSize | Iestata maksimālo vērtību skaitu atmiņas buferī. |
| ControlSocket | Norāda vadības ligzdu, ko izmanto izpildlaika komandu nosūtīšanai ar opciju '-R'. |
| DebugLevel | Iestata atkļūdošanas līmeni. |
| DenyKey | Aizliedz to vienums atslēgu izpildi, kas atbilst paraugam. |
| EnablePersistentBuffer | Iespējo lokālas pastāvīgas krātuves izmantošanu aktīvajiem vienums. |
| ForceActiveChecksOnStart | Veic aktīvās pārbaudes nekavējoties pēc restartēšanas, lai saņemtu pirmo konfigurāciju. |
| HeartbeatFrequency | Iestata sirdspukstu ziņojumu biežumu sekundēs. |
| HostInterface | Norāda hosts saskarni. |
| HostInterfaceItem | Norāda vienums hosts saskarnes iegūšanai. |
| HostMetadata | Norāda hosts metadatus. |
| HostMetadataItem | Norāda Zabbix aģents vienums, ko izmanto hosts metadatu iegūšanai. |
| Hostname | Norāda hosts nosaukumu. |
| HostnameItem | Norāda Zabbix aģents vienums hosts 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. |
| PerfCounter | Norāda 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 | Norāda 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ā. |
| PersistentBufferFile | Norāda failu, kurā Zabbix aģents 2 jāglabā SQLite datubāze. |
| PersistentBufferPeriod | Iestata datu glabāšanas ilgumu, ja nav savienojuma ar serveris vai starpniekserveris. |
| Plugins.<PluginName>.System.Capacity | Iestata ierobežojumu pārbaudēm uz spraudni, kuras var tikt izpildītas vienlaikus. |
| Plugins.Log.MaxLinesPerSecond | Iestata maksimālo jauno rindu skaitu, ko aģents nosūtīs sekundē uz Zabbix serveris vai starpniekserveris, apstrādājot log, logrt un eventlog aktīvās pārbaudes. |
| Plugins.SystemRun.LogRemoteCommands | Iespējo izpildīto čaulas komandu reģistrēšanu kā brīdinājumus. |
| PluginSocket | Norāda Windows nosauktās caurules ceļu ielādējamu spraudņu saziņai. |
| PluginTimeout | Iestata savienojumu noildzi ar ielādējamiem spraudņiem sekundēs. |
| 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 iegūt aktīvās pārbaudes. |
| SourceIP | Norāda avota IP adresi. |
| StatusPort | Iestata portu, uz kura aģents klausās HTTP statusa pieprasījumus (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žu sertifikātu pārbaudei, ko izmanto šifrētai saziņai starp Zabbix komponentēm. |
| 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 komponentēm. |
| TLSCipherAll13 | Norāda OpenSSL šifru virkni (TLS 1.3). Pārraksta noklusējuma šifru kopas atlases kritērijus sertifikātu un PSK balstītai šifrēšanai. |
| TLSCipherCert13 | Norāda OpenSSL šifru virkni (TLS 1.3). Pārraksta noklusējuma šifru kopas atlases kritērijus sertifikātu balstītai šifrēšanai. |
| TLSCipherPSK13 | Norāda OpenSSL šifru virkni (TLS 1.3). Pārraksta noklusējuma šifru kopas atlases kritērijus 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 komponentēm. |
| TLSKeyFile | Norāda pilnu ceļu uz failu, kurā ir aģents privātā atslēga, ko izmanto šifrētai saziņai starp Zabbix komponentēm. |
| 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. |
| TLSPSKIdentity | Norāda iepriekš koplietotās atslēgas identitātes virkni, ko izmanto šifrētai saziņai ar Zabbix serveris. |
| 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 rakstzīmes nodot argumentos lietotāja definētiem parametriem. |
| UserParameter | Norāda monitorējamu lietotāja definētu 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 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.
Vairāki parametri ar vienu un to pašu Alias atslēgu nav atļauti.
Dažādas Alias atslēgas var atsaukties uz to pašu vienuma atslēgu.
Aliasus var izmantot HostMetadataItem, bet ne parametru HostnameItem.
- piemērs: Lappuses faila lietojuma procentos izgūšana no servera.
Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]
Tagad saīsināto atslēgu pg_usage var izmantot datu izgūšanai.
- piemērs: 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, lai iegūtu CPU noslodzi ar noklusējuma parametriem, kā arī izmantot cpu.load[percpu,avg15], lai iegūtu konkrētus datus par CPU noslodzi.
- piemērs: Vairāku zemā lī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 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
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
Iestatiet 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
Norādiet vadības ligzdu, ko izmanto izpildlaika komandu nosūtīšanai ar opciju '-R'.
Noklusējums: \\.\pipe\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
Liegt to vienumu atslēgu izpildi, kas atbilst paraugam.
Atslēgas paraugs ir aizstā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 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, 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
Iestatiet sirdspukstu ziņojumu biežumu sekundēs.
Tiek izmantots aktīvo pārbaužu pieejamības uzraudzībai.
0 - sirdspukstu 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 automātiskās reģistrācijas 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 izsniegs kļūdu un netiks palaists, ja vērtība pārsniegs 255 rakstzīmju ierobežojumu.
Diapazons: 0-255 rakstzīmes
HostInterfaceItem
Norādiet vienumu, lai noteiktu host interfeisu (IP adresi vai DNS nosaukumu) host 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 interfeiss.
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.
Hosts metadati
Norādiet metadatus, kas tiek izmantoti, lai identificētu vai atšķirtu hostu hosta autoregistrācijas laikā (aktīvais aģents). 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, 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āku rindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindiņas pārtraukuma.
Diapazons: 0-2034 baiti
HostMetadataItem
Norādiet Zabbix aģenta vienumu, lai iegūtu host metadata. Šī 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. Tiek atbalstīts system.run[] vienums 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īgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, arī tiks noraidītas un ziņotas kā nederīgas.
Vairākrindu metadata netiek atbalstīta — 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.
Obligāts aktīvajām pārbaudēm, un tam jāsakrīt ar serverī konfigurētajiem hostu nosaukumiem.
Ja vērtība nav definēta, tā tiek iegūta no HostnameItem.
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
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ā (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 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., 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 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
Norādiet aģenta klausīšanās IP adresi savienojumiem no servera/starpniekservera. Komatatdalīts saraksts.
Pirmais IP adreses ieraksts tiek nosūtīts Zabbix serverim, ja tiek veidots savienojums 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: c:\zabbix_agent2.log
Obligāts: Jā, ja LogType ir iestatīts uz file; citādi nē
LogFileSize
Iestatiet maksimālo žurnāla faila lielumu (MB).
0 - atspējot automātisku žurnāla rotāciju.
Piezīme: Ja tiek sasniegts žurnāla faila lieluma 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 - ierakstīt žurnālu failā, kas norādīts ar parametru LogFile;
console - ierakstīt žurnālu standarta izvades plūsmā.
Noklusējums: file
PerfCounter
Definējiet 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).
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ējiet 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īdzinājumā 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, skatot šādu reģistra atslēgu: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.
PersistentBufferFile
Norādiet failu, kurā Zabbix aģents 2 glabās SQLite datubāzi. Tam jābūt pilnam faila nosaukumam. Šis parametrs tiek izmantots tikai tad, ja ir iespējots pastāvīgais buferis (EnablePersistentBuffer=1).
PersistentBufferPeriod
Iestata datu glabāšanas ilgumu, 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
Iestatiet vienlaicīgi izpildāmo pārbažu limitu katram <PluginName> spraudnim.
Noklusējums: 1000
Diapazons: 1-1000
Plugins.Log.MaxLinesPerSecond
Iestata maksimālo jauno rindu skaitu, ko aģents sekundē nosūtīs uz Zabbix serveris vai starpniekserveris, apstrādājot log, logrt un eventlog aktīvās pārbaudes.
Norādīto vērtību pārrakstīs parametrs 'maxlines', kas norādīts log, logrt vai eventlog vienums atslēgā.
Piezīme: Zabbix apstrādās 10 reizes vairāk jaunu 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
Norādiet Windows nosauktās caurules ceļu ielādējamo spraudņu saziņai.
Noklusējums: \\.\pipe\agent.plugin.sock
PluginTimeout
Iestatiet 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ējots 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ā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
Norādiet Zabbix servera/starpniekservera adresi vai klastera konfigurāciju, no kuras iegūt 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 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 adreses jāiekļauj kvadrātiekavās, ja šim hostam ir norādīts ports.
Ja ports nav norādīts, IPv6 adrešu kvadrātiekavas ir izvēles.
Ja šis parametrs nav norādīts, aktīvās pārbaudes ir atspējotas.
Zabbix starpniekservera piemērs:
ServerActive=127.0.0.1:10051
Zabbix starpniekservera grupas piemērs:
ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com
Vairāku serveru piemērs:
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
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
Iestatiet portu, kurā aģents klausās HTTP statusa pieprasījumus (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;
- pieprasījumu nosūtīšanu Zabbix serverim, tostarp vienuma konfigurācijas pieprasījumus un vienuma datus aktīvajās pārbaudēs;
- žurnāla datu izgūšanu, izmantojot logfile vai Windows notikumu žurnāla uzraudzību;
- sirdspukstu ziņojumu nosūtīšanu;
- maksimālo ilgumu
vfs.*pārbaudēm; - kalpošanu 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 tām aģenta pārbaudēm, kurām 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 šifrēšanas līmeni, kas nepieciešams ienākošajiem savienojumiem.
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); citos gadījumos nē
TLSCAFile
Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāti, kas tiek izmantoti vienaudžu sertifikātu verifikācijai un šifrētai saziņai starp Zabbix komponentiem.
TLSCertFile
Norādiet pilnu ceļu uz failu, kurā atrodas aģenta sertifikāts vai sertifikātu ķēde, kas tiek izmantota šifrētai saziņai ar Zabbix komponentiem.
TLSCipherAll13
Norādiet OpenSSL šifru virkni (TLS 1.3). 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
TLSCipherCert13
Norādiet OpenSSL šifru virkni (TLS 1.3). 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) tā vietā izmantojiet TLSCipherAll13.
TLSCipherPSK13
Norādiet OpenSSL šifra virkni (TLS 1.3). 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 komponentiem.
TLSPSKFile
Norādiet pilnu faila ceļu uz failu, kurā atrodas aģenta iepriekš koplietotā atslēga, kas tiek izmantota šifrētai saziņai ar Zabbix serveri.
TLSPSKIdentity
Norādiet iepriekš koplietotās atslēgas identitātes virkni, ko izmanto šifrētai saziņai ar Zabbix serveri.
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 rindu 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 komandas var izmantot relatīvus ceļus, ja ir norādīts parametrs UserParameterDir.
Piemērs:
UserParameter=system.test,dir /b | find /c /v ""
UserParameter=check_cpu,.\custom\_script.bat
UserParameterDir
Norādiet UserParameter komandu noklusējuma meklēšanas ceļu.
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