Konfigurācijas parametri: Zabbix aģents 2
Pārskats
Konfigurācijas parametri ļauj pielāgot Zabbix aģenta 2 darbību.
Zabbix aģents 2 ir jaunas paaudzes Zabbix aģents, un to var izmantot Zabbix aģenta vietā.
Norādiet parametru vērtības Zabbix aģenta 2 konfigurācijas failā (zabbix_agent2.conf). Visi parametri ir neobligāti, ja vien nav skaidri norādīts, ka parametrs ir obligāts.
Šī lapa ir strukturēta šādi:
- Parametru pārskats (lai skatītu pilnu parametra informāciju, noklikšķiniet uz tā nosaukuma)
- Parametru informācija
| Parametrs | Apraksts |
|---|---|
| Alias | Iestatīt vienuma atslēgas aizstājvārdu. |
| AllowKey | Atļaut to vienumu atslēgu izpildi, kas atbilst paraugam. |
| AllowKeyRegexp | Atļaut to vienumu atslēgu izpildi, kas atbilst uz regulāro izteiksmju balstītam paraugam. |
| BufferSend | Iestatīt vērtību nosūtīšanas biežumu no bufera uz Zabbix serveri/starpniekserveri. |
| BufferSize | Iestatīt maksimālo vērtību skaitu atmiņas buferī. |
| ControlSocket | Norādīt vadības ligzdu izpildlaika komandu nosūtīšanai ar opciju '-R'. |
| DebugLevel | Iestatīt atkļūdošanas līmeni. |
| DenyKey | Aizliegt to vienumu atslēgu izpildi, kas atbilst paraugam. |
| DenyKeyRegexp | Aizliegt to vienumu atslēgu izpildi, kas atbilst uz regulāro izteiksmju balstītam paraugam. |
| EnablePersistentBuffer | Iespējot lokālās pastāvīgās krātuves izmantošanu aktīvajiem vienumiem. |
| ForceActiveChecksOnStart | Veikt aktīvās pārbaudes tūlīt pēc restartēšanas, saņemot pirmo konfigurāciju. |
| HeartbeatFrequency | Iestatīt sirdspukstu ziņojumu biežumu sekundēs. |
| HostInterface | Norādīt hosts saskarni. |
| HostInterfaceItem | Norādīt vienumu hosts saskarnes iegūšanai. |
| HostMetadata | Norādīt hosts metadatus. |
| HostMetadataItem | Norādīt Zabbix aģenta vienumu hosts metadatu iegūšanai. |
| Hostname | Norādīt hosts nosaukumu. |
| HostnameItem | Norādīt Zabbix aģenta vienumu hosts nosaukuma iegūšanai. |
| Include | Norādīt direktoriju vai atsevišķus failus, kas jāiekļauj konfigurācijas failā. |
| ListenIP | Norādīt aģenta IP adresi, kurā klausīties savienojumus no servera/starpniekservera. |
| ListenPort | Norādīt aģenta klausīšanās portu. |
| LogFile | Norādīt aģenta žurnālfailu. |
| LogFileSize | Iestatīt maksimālo žurnālfaila lielumu. |
| LogType | Norādīt žurnāla izvades tipu. |
| PersistentBufferFile | Norādīt failu SQLite datubāzes glabāšanai. |
| PersistentBufferPeriod | Iestatīt datu glabāšanas periodu, kad nav savienojuma ar Zabbix serveri vai starpniekserveri. |
| PidFile | Norādīt PID failu. |
| Plugins.<PluginName>.System.Capacity | Iestatīt vienlaikus izpildāmo pārbaužu ierobežojumu katram spraudnim. |
| Plugins.Log.MaxLinesPerSecond | Iestatīt maksimālo jauno rindu skaitu sekundē, kas tiek nosūtīts Zabbix serverim/starpniekserverim, apstrādājot log vai logrt aktīvās pārbaudes. |
| Plugins.SystemRun.LogRemoteCommands | Iespējot izpildīto čaulas komandu reģistrēšanu kā brīdinājumus. |
| PluginSocket | Norādīt ceļu uz UNIX ligzdu ielādējamo spraudņu saziņai. |
| PluginTimeout | Iestatīt savienojumu taimautu ar ielādējamiem spraudņiem. |
| RefreshActiveChecks | Norādīt aktīvo pārbaužu saraksta atsvaidzināšanas biežumu. |
| Server | Norādīt Zabbix serveru/starpniekserveru IP adreses vai DNS nosaukumus. |
| ServerActive | Norādīt Zabbix servera/starpniekservera adresi vai klastera konfigurāciju, no kuras iegūt aktīvās pārbaudes. |
| SourceIP | Norādīt avota IP adresi. |
| StatusPort | Norādīt portu HTTP statusa pieprasījumu klausīšanai (http://localhost:<port>/status). |
| Timeout | Norādīt, cik ilgi (sekundēs) gaidīt savienojuma izveidi un datu apmaiņu ar Zabbix serveri vai starpniekserveri. |
| TLSAccept | Norādīt ienākošajiem savienojumiem nepieciešamo šifrēšanas līmeni. |
| TLSCAFile | Norādīt pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāti partnera sertifikāta pārbaudei; to izmanto šifrētai saziņai starp Zabbix komponentēm. |
| TLSCertFile | Norādīt pilnu ceļu uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde; to izmanto šifrētai saziņai starp Zabbix komponentēm. |
| TLSCipherAll | Norādīt OpenSSL šifru virkni (TLS 1.2). Ignorēt noklusējuma šifru komplekta atlases kritērijus uz sertifikātiem un PSK balstītai šifrēšanai. |
| TLSCipherAll13 | Norādīt OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Ignorēt noklusējuma šifru komplekta atlases kritērijus uz sertifikātiem un PSK balstītai šifrēšanai. |
| TLSCipherCert | Norādīt OpenSSL šifru virkni (TLS 1.2). Ignorēt noklusējuma šifru komplekta atlases kritērijus uz sertifikātiem balstītai šifrēšanai. |
| TLSCipherCert13 | Norādīt OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Ignorēt noklusējuma šifru komplekta atlases kritērijus uz sertifikātiem balstītai šifrēšanai. |
| TLSCipherPSK | Norādīt OpenSSL šifru virkni (TLS 1.2). Ignorēt noklusējuma šifru komplekta atlases kritērijus uz PSK balstītai šifrēšanai. |
| TLSCipherPSK13 | Norādīt OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Ignorēt noklusējuma šifru komplekta atlases kritērijus uz PSK balstītai šifrēšanai. |
| TLSConnect | Norādīt savienojumiem ar Zabbix serveri vai starpniekserveri nepieciešamo šifrēšanas līmeni. |
| TLSCRLFile | Norādīt pilnu ceļu uz failu, kurā ir atsaukto sertifikātu saraksts. Šo parametru izmanto šifrētai saziņai starp Zabbix komponentēm. |
| TLSKeyFile | Norādīt pilnu ceļu uz failu, kurā ir aģenta privātā atslēga; to izmanto šifrētai saziņai starp Zabbix komponentēm. |
| TLSPSKFile | Norādīt pilnu ceļu uz failu, kurā ir aģenta iepriekš koplietotā atslēga; to izmanto šifrētai saziņai ar Zabbix serveri vai starpniekserveri. |
| TLSPSKIdentity | Norādīt iepriekš koplietotās atslēgas identitātes virkni; to izmanto šifrētai saziņai ar Zabbix serveri vai starpniekserveri. |
| TLSServerCertIssuer | Norādīt atļauto servera (starpniekservera) sertifikāta izdevēju. |
| TLSServerCertSubject | Norādīt atļauto servera (starpniekservera) sertifikāta subjektu. |
| UnsafeUserParameters | Atļaut visus simbolus nodot lietotāja definētu parametru argumentos. |
| UserParameter | Norādīt uzraugāmu lietotāja definētu parametru. |
| UserParameterDir | Norādīt noklusējuma meklēšanas ceļu UserParameter komandām. |
Ņ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 UTF-8 kodējumā esošus konfigurācijas failus bez BOM.
- Komentāri, kas sākas ar
#, tiek atbalstīti tikai rindas sākumā.
Parametra informācija
Alias
Iestatiet vienumam atslēgas alias.
To var izmantot, lai aizstātu garu un sarežģītu vienuma atslēgu ar īsāku un vienkāršāku.
Var būt norādīti vairāki Alias parametri.
Nav atļauti vairāki parametri ar vienu un to pašu Alias atslēgu.
Dažādas Alias atslēgas var atsaukties uz vienu un to pašu vienuma atslēgu.
Aliasus var izmantot HostMetadataItem, bet ne HostnameItem parametrā.
Piemērs 1: lietotāja zabbix ID iegūšana.
Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]
Tagad saīsināto atslēgu zabbix.userid var izmantot datu iegūšanai.
Piemērs 2: CPU noslodzes iegūšana ar noklusējuma un pielāgotiem parametriem.
Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]
Tas ļauj izmantot atslēgu cpu.util, lai iegūtu CPU noslodzes procentuālo vērtību ar noklusējuma parametriem, kā arī izmantot cpu.util[all, idle, avg15], lai iegūtu konkrētus datus par CPU noslodzi.
Piemērs 3: vairāku zemlīmeņa atklāšanas noteikumu izpilde, kas apstrādā tos pašus atklāšanas vienumus.
Alias=vfs.fs.discovery[*]:vfs.fs.discovery
Tagad ir iespējams konfigurēt vairākus atklāšanas noteikumus, izmantojot vfs.fs.discovery ar atšķirīgiem parametriem katram noteikumam, piemēram, vfs.fs.discovery[foo], vfs.fs.discovery[bar] utt.
AllowKey
Atļauj izpildīt tos vienumu atslēgu, kas atbilst paraugam.
Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta * rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.
Vairākas atslēgu atbilstības kārtulas var definēt kopā ar DenyKey.
Vairākas atslēgu atbilstības kārtulas var definēt kopā ar DenyKey, AllowKeyRegexp un DenyKeyRegexp.
Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai.
Secība nosaka, kurai no atbilstošajām kārtulām būs prioritāte.
Skatiet arī: Restricting agent checks.
AllowKeyRegexp
Atļauj izpildīt tos vienumu atslēgu nosaukumus, kas atbilst paraugam.
Atslēgas paraugs ir regulārā izteiksme.
Var definēt vairākus atslēgu atbilstības noteikumus kopā ar DenyKeyRegexp, AllowKey un DenyKey.
Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai.
Secība nosaka, kuram atbilstošajam noteikumam būs prioritāte.
Skatiet arī: Aģenta pārbaužu ierobežošana.
BufferSend
Iestatiet vērtību nosūtīšanas biežumu no bufera uz Zabbix serveri/starpniekserveri (sekundēs).
Ņemiet vērā, ka, ja buferis ir pilns, dati tiks nosūtīti ātrāk.
Noklusējums: 5
Diapazons: 1-3600
BufferSize
Iestata maksimālo vērtību skaitu atmiņas buferī.
Aģents nosūtīs visus savāktos datus uz Zabbix serveri vai starpniekserveri, ja buferis būs pilns.
Šis parametrs jāizmanto tikai tad, ja pastāvīgais buferis ir atspējots (EnablePersistentBuffer=0).
Noklusējums: 1000
Diapazons: 2-65535
ControlSocket
Norādiet vadības socket, lai ar -R opciju sūtītu izpildlaika komandas.
Noklusējums: /tmp/agent.sock
DebugLevel
Iestatiet atkļūdošanas līmeni:
- 0 - pamatinformācija par Zabbix procesu palaišanu un apturēšanu;
- 1 - kritiska informācija;
- 2 - kļūdu informācija;
- 3 - brīdinājumi;
- 4 - atkļūdošanai (rada daudz informācijas);
- 5 - paplašināta atkļūdošana (rada vēl vairāk informācijas).
Noklusējums: 3
Diapazons: 0-5
DenyKey
Noraidīt to vienumu atslēgu izpildi, kas atbilst paraugam.
Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta * rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.
Var definēt vairākus atslēgu atbilstības noteikumus kopā ar AllowKey.
Var definēt vairākus atslēgu atbilstības noteikumus kopā ar AllowKey, AllowKeyRegexp un DenyKeyRegexp.
Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai.
Secība nosaka, kuram atbilstības noteikumam būs prioritāte.
Skatiet arī: Restricting agent checks.
DenyKeyRegexp
Aizliedz to vienumu atslēgu izpildi, kas atbilst paraugam.
Atslēgas paraugs ir regulārā izteiksme.
Vairākas atslēgu atbilstības kārtulas var definēt kopā ar AllowKeyRegexp, AllowKey un DenyKey.
Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai.
Secība nosaka, kurai atbilstošajai kārtulai būs prioritāte.
Skatiet arī: Aģenta pārbaužu ierobežošana.
EnablePersistentBuffer
Iespējot lokālās pastāvīgās krātuves izmantošanu aktīvajiem vienumiem.
Ja pastāvīgā krātuve ir atspējota, tiks izmantots atmiņas buferis.
Noklusējums: 0
Vērtības: 0 - atspējots, 1 - iespējots
ForceActiveChecksOnStart
Veic aktīvās pārbaudes nekavējoties pēc restartēšanas, lai saņemtu pirmo konfigurāciju.
Pieejams arī kā katra spraudņa konfigurācijas parametrs, piemēram: Plugins.Uptime.System.ForceActiveChecksOnStart=1
Noklusējums: 0
Vērtības: 0 - atspējots, 1 - iespējots
HeartbeatFrequency
Iestata heartbeat ziņojumu biežumu sekundēs.
Izmanto aktīvo pārbaužu pieejamības uzraudzībai.
0 - heartbeat ziņojumi ir atspējoti.
Noklusējums: 60
Diapazons: 0-3600
HostInterface
Norādiet hosta saskarni (IP adresi vai DNS nosaukumu), kas tiek izmantota hosta autoregistrācijas laikā.
Šī vērtība tiks izmantota, lai aizpildītu saskarni jaunizveidotajā hostā, un ļauj nepārprotami konfigurēt vai nu IP, vai DNS adresi.
Plašāku informāciju skatiet sadaļā DNS izmantošana kā noklusējuma saskarne.
Ja nav definēts, vērtība tiks iegūta no HostInterfaceItem.
Aģents izdos kļūdu un netiks palaists, ja vērtība pārsniegs 255 rakstzīmju limitu.
Diapazons: 0-255 rakstzīmes
HostInterfaceItem
Norādiet vienumu, lai noteiktu hosta saskarni (IP adresi vai DNS nosaukumu) hosta automātiskās reģistrācijas laikā.
Šī vērtība tiek izmantota tikai tad, ja HostInterface nav definēts.
Plašāku informāciju skatiet sadaļā DNS izmantošana kā noklusējuma saskarne.
Automātiskās reģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 255 rakstzīmju limitu.
system.run[] vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey iestatījumiem.
HostMetadata
Norādiet metadatus, kas tiek izmantoti, lai identificētu vai atšķirtu hostu hosta autoregistrācijas laikā.
HostMetadata ļauj atšķirt hostus ne tikai pēc hostname.
Ja nav definēts, vērtība tiks iegūta no HostMetadataItem.
aģents izsniegs kļūdu un netiks palaists, ja norādītā vērtība pārsniedz 2034 baitu limitu vai ir ne-UTF-8 virkne. Ja parametrs sagaida IP adresi vai DNS nosaukumu, tiks noraidītas arī vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, un tās tiks ziņotas kā nederīgas.
Vairāku rindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindas pārtraukuma.
Diapazons: 0-2034 baiti
HostMetadataItem
Norādiet vienumu, lai iegūtu host metadatus.
Šī opcija tiek izmantota tikai tad, ja HostMetadata nav definēts.
HostMetadataItem vērtība tiek izgūta katrā autoregistrācijas mēģinājumā un tiek izmantota tikai hosta autoreģistrācijas procesā.
HostMetadataItem ļauj atšķirt hostus ne tikai pēc hostname.
Tiek atbalstīti lietotāja parametri un aizstājvārdi.
system.run[] vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey iestatījumiem.
Autoregistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 65535 UTF-8 koda punktu limitu. Vienuma atgrieztajai vērtībai jābūt UTF-8 virknei, pretējā gadījumā tā tiks ignorēta. Ja parametrs sagaida IP adresi vai DNS nosaukumu, vērtības, kas ir derīgas UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, arī tiks noraidītas un atzīmētas kā nederīgas.
Vairākrindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindiņas pārtraukuma.
Hostname
Norādiet unikālus, reģistrjutīgus hostu nosaukumus. Ar komatiem atdalīts saraksts.
Nepieciešams aktīvajām pārbaudēm, un tam jāsakrīt ar hostu nosaukumiem, kā tie ir konfigurēti serverī.
Vērtība tiek iegūta no HostnameItem, ja tā nav definēta.
Atļautās rakstzīmes: burtciparu rakstzīmes, '.', ' ', '_' un '-'.
Maksimālais garums: 128 rakstzīmes katram hosta nosaukumam, 2048 rakstzīmes visai rindai.
Noklusējums: iestatīts ar HostnameItem
HostnameItem
Norādiet vienumu, lai iegūtu hosta nosaukumu.
Šī opcija tiek izmantota tikai tad, ja Hostname nav definēts.
Lietotāja parametri vai aizstājvārdi netiek atbalstīti, taču system.run[] vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey vērtībām.
Noklusējums: system.hostname
Iekļaut
Norādiet direktoriju vai atsevišķus failus, kas jāiekļauj konfigurācijas failā.
Zabbix instalēšanas laikā šis parametrs tiek iestatīts uz /usr/local/etc, ja vien to nemaināt kompilēšanas laikā.
Vispārīgie noteikumi parametram Include:
- Ceļš var būt relatīvs attiecībā pret
zabbix_agent2.conffaila atrašanās vietu. - Vienā konfigurācijas failā var norādīt vairākus
Includeparametrus. - Zabbix apstrādā
Includeparametru uzreiz pēc tā nolasīšanas, tāpēc ieteicams to ievietot konfigurācijas faila beigās.
Iekļauto failu noteikumi:
- Katram failam jābūt lasāmam.
- Katram failam jābūt ar pareizu sintaksi. Pretējā gadījumā komponents netiks palaists.
Direktoriju vai failu modeļu iekļaušanas noteikumi:
- Nepieņemiet, ka iekļaušanas secība ir noteikta (piemēram, faili netiek iekļauti alfabētiskā secībā).
- Nedefinējiet vienu un to pašu parametru vairāk nekā vienā iekļautajā failā (piemēram, lai pārrakstītu vispārīgu iestatījumu ar specifisku), jo nevar paredzēt, kura vērtība tiks izmantota.
- Ņemiet vērā rezerves kopijas, ko daži teksta redaktori izveido automātiski (piemēram, rediģējot
include/my_specific.conf, var tikt izveidotsinclude/my_specific.conf.BAK), jo abi faili tiks iekļauti.
Lai no direktorija iekļautu tikai atbilstošos failus, izmantojiet aizstājējzīmi (*) modeļa atbilstībai.
Piemērs:
Include=/absolute/path/to/config/files/*.conf
ListenIP
Norādiet aģenta klausīšanās IP adresi savienojumiem no servera/starpniekservera. Komatu atdalīts saraksts.
Pirmā IP adrese tiek nosūtīta Zabbix serverim, ja savienojums tiek izveidots ar to, lai izgūtu aktīvo pārbaužu sarakstu.
Noklusējums: 0.0.0.0
ListenPort
Norādiet aģenta klausīšanās portu savienojumiem no servera/starpniekservera.
Noklusējums: 10050
Diapazons: 1024-32767
LogFile
Norādiet aģenta žurnāla failu.
Noklusējums: /tmp/zabbix_agent2.log
Obligāts: Jā, ja LogType ir iestatīts uz file; citādi nē
LogFileSize
Iestatiet maksimālo žurnāla faila izmēru (MB).
0 - atspējot automātisku žurnāla rotāciju.
Piezīme: Ja tiek sasniegts žurnāla faila izmēra ierobežojums un faila rotācija neizdodas jebkāda iemesla dēļ, esošais žurnāla fails tiek saīsināts un izveidots no jauna.
Noklusējums: 1
Diapazons: 0-1024
LogType
Norādiet žurnāla izvades tipu:
- file - rakstīt žurnālu failā, kas norādīts ar
LogFileparametru; - system - rakstīt žurnālu syslog;
- console - rakstīt žurnālu standarta izvadei.
Noklusējums: file
PersistentBufferFile
Norādiet failu SQLite datubāzes glabāšanai. Jānorāda pilns faila nosaukums.
Šis parametrs tiek izmantots tikai tad, ja pastāvīgais buferis ir iespējots (EnablePersistentBuffer=1).
Pastāvīgā bufera periods
Iestatiet laika periodu datu glabāšanai, ja nav savienojuma ar Zabbix serveri vai starpniekserveri.
Vecākie dati tiks zaudēti.
Žurnāla dati tiks saglabāti.
Šis parametrs tiek izmantots tikai tad, ja pastāvīgais buferis ir iespējots (EnablePersistentBuffer=1).
Noklusējums: 1h
Diapazons: 1m-365d
PidFile
Norādiet PID failu.
Noklusējums: /tmp/zabbix_agent2.pid
Spraudņi.<PluginName>.System.Capacity
Iestatiet vienlaicīgi izpildāmo pārbaužu limitu katram <PluginName> spraudnim.
Noklusējums: 1000
Diapazons: 1-1000
Plugins.Log.MaxLinesPerSecond
Iestata maksimālo jauno rindu skaitu sekundē, ko nosūtīt uz Zabbix serveri/starpniekserveri, apstrādājot log vai logrt aktīvās pārbaudes.
Norādītā vērtība tiks pārrakstīta ar maxlines parametru, kas norādīts log un logrt vienuma atslēgā.
Piezīme: Zabbix apstrādās 10 reizes vairāk jauno rindu nekā iestatīts MaxLinesPerSecond, lai loga vienumos atrastu nepieciešamo virkni.
Noklusējums: 20
Diapazons: 1-1000
Plugins.SystemRun.LogRemoteCommands
Iespējot izpildīto čaulas komandu reģistrēšanu kā brīdinājumus.
Komandas tiks reģistrētas tikai tad, ja tās tiek izpildītas attālināti.
Žurnāla ieraksti netiks izveidoti, ja system.run[] tiek palaists lokāli, izmantojot HostMetadataItem, HostInterfaceItem vai HostnameItem parametrus.
Noklusējums: 0
Vērtības: 0 - atspējots, 1 - iespējots
PluginSocket
Norādiet UNIX ligzdas ceļu ielādējamo spraudņu saziņai.
Noklusējums: /tmp/agent.plugin.sock
PluginTimeout
Norādiet savienojumu noildzi ar ielādējamiem spraudņiem sekundēs.
Noklusējums: Timeout
Diapazons: 1-30
RefreshActiveChecks
Norādiet aktīvo pārbaužu saraksta atsvaidzināšanas biežumu sekundēs.
Ņemiet vērā, ka pēc aktīvo pārbaužu atsvaidzināšanas neveiksmes nākamais atsvaidzināšanas mēģinājums tiks veikts pēc 60 sekundēm.
Noklusējums: 5
Diapazons: 1-86400
Serveris
Norādiet Zabbix serveru/starpniekserveru IP adreses, pēc izvēles CIDR notācijā, vai DNS nosaukumus. Ar komatiem atdalīts saraksts.
Ienākošie savienojumi tiks pieņemti tikai no šeit norādītajiem hosts.
Ja ir iespējota IPv6 atbalsts, tad 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 tiek uzskatīti par ekvivalentiem, un ::/0 atļaus jebkuru IPv4 vai IPv6 adresi.
0.0.0.0/0 var izmantot, lai atļautu jebkuru IPv4 adresi.
Atstarpes ir atļautas.
Ja šis parametrs nav norādīts, pasīvie pārbaužu veidi tiek atspējoti, un aģents neklausīsies nevienā TCP portā.
Piemērs:
Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
ServerActive
Norādiet Zabbix servera/starpniekservera adresi vai klastera konfigurāciju, no kuras saņemt aktīvās pārbaudes.
Servera/starpniekservera adrese ir IP adrese vai DNS nosaukums, kā arī izvēles ports, kas atdalīts ar kolu.
Klastera konfigurācija ir viena vai vairāku servera vai starpniekservera grupas dalībnieku adrešu kopa, kas atdalīta ar semikolu.
Var norādīt vairākus Zabbix serverus/klasterus un Zabbix starpniekserverus, atdalot tos ar komatu.
Ja netiek izmantotas starpniekserveru grupas, no katra Zabbix servera/klastera nedrīkst norādīt vairāk nekā vienu Zabbix starpniekserveri.
Ja ir norādīts Zabbix starpniekserveris, tad šim starpniekserverim atbilstošo Zabbix serveri/klasteri norādīt nedrīkst.
Var norādīt vairākas ar komatiem atdalītas adreses, lai paralēli izmantotu vairākus neatkarīgus Zabbix serverus.
Atstarpes ir atļautas.
Ja ports nav norādīts, tiek izmantots noklusējuma ports.
IPv6 adreses jāiekļauj kvadrātiekavās, ja šim hostam ir norādīts ports.
Ja ports nav norādīts, kvadrātiekavas IPv6 adresēm nav obligātas.
Ja šis parametrs nav norādīts, aktīvās pārbaudes ir atspējotas.
Piemērs Zabbix starpniekserverim:
ServerActive=127.0.0.1:10051
Piemērs Zabbix starpniekserveru grupai:
ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com
Piemērs vairākiem serveriem:
ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]
Piemērs augstai pieejamībai:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3
Piemērs augstai pieejamībai ar diviem klasteriem un vienu serveri:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
SourceIP
Norādiet avota IP adresi šādiem gadījumiem:
- izejošajiem savienojumiem ar Zabbix serveri vai Zabbix starpniekserveri.
- savienojumu izveidei, izpildot dažus vienumus (
web.page.get,net.tcp.portu.c.).
StatusPort
Norādiet portu HTTP statusa pieprasījumu uzklausīšanai (http://localhost:<port>/status).
Diapazons: 1024-32767
Noildze
Norādiet, cik ilgi jāgaida (sekundēs), lai izveidotu savienojumu un apmainītos ar datiem ar Zabbix starpniekserveri vai serveri.
Šis parametrs nosaka dažādu saziņas darbību ilgumu, tostarp:
- gaidot atbildi no Zabbix servera;
- sūtot pieprasījumus Zabbix serverim, tostarp vienuma konfigurācijas pieprasījumus un vienuma datus aktīvajās pārbaudēs;
- izgūstot žurnāla datus, izmantojot logfile;
- sūtot sirdspukstu ziņojumus;
- maksimālais ilgums
vfs.*pārbaudēm; - kalpojot kā rezerves variants situācijās, kad serveris vai starpniekserveris, kas ir vecāks par 7.0 versiju, sūta pārbaudes bez noildzēm.
Šī noildze netiks izmantota tiem aģenta pārbaudījumiem, kuriem lietotāja saskarnē ir konfigurējami noildzes iestatījumi (globālā, starpniekservera vai atsevišķa vienuma līmenī).
Noklusējums: 3
Diapazons: 1-30
TLSAccept
Norādiet ienākošajiem savienojumiem nepieciešamo šifrēšanas līmeni.
Tiek izmantots pasīvajām pārbaudēm.
Var norādīt vairākas vērtības, atdalot tās ar komatu:
- unencrypted - pieņemt savienojumus bez šifrēšanas (noklusējums);
- psk - pieņemt savienojumus ar TLS un iepriekš koplietotu atslēgu (PSK);
- cert - pieņemt savienojumus ar TLS un sertifikātu.
Obligāti: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); citādi nē
TLSCAFile
Norādiet pilnu ceļu uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudžu sertifikātu verifikācijai, kas tiek izmantota šifrētai saziņai starp Zabbix komponentiem.
TLSCertFile
Norādiet pilnu faila ceļu uz failu, kurā atrodas aģenta sertifikāts vai sertifikātu ķēde, kas tiek izmantota šifrētai saziņai ar Zabbix komponentēm.
TLSCipherAll
Norādiet OpenSSL šifru virkni (TLS 1.2). Pārrakstiet noklusējuma šifru kopas atlases kritērijus sertifikātu un PSK balstītai šifrēšanai.
Piemērs:
EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
TLSCipherAll13
Norādiet OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārrakstiet noklusējuma šifru komplektu atlases kritērijus sertifikātu un PSK balstītai šifrēšanai.
Piemērs:
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherCert
Norādiet OpenSSL šifru virkni (TLS 1.2). Pārrakstiet noklusējuma šifru kopas atlases kritērijus sertifikātu balstītai šifrēšanai.
Piemērs:
EECDH+aRSA+AES128:RSA+aRSA+AES128
Ņemiet vērā, ka šo parametru nevar izmantot kopā ar TLSAccept=cert,psk; sertifikāta savienojumam (TLSConnect=cert) izmantojiet TLSCipherAll vietā.
TLSCipherCert13
Norādiet OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārrakstiet noklusējuma šifru kopas atlases kritērijus sertifikātu balstītai šifrēšanai.
Ņemiet vērā, ka šo parametru nevar izmantot kopā ar TLSAccept=cert,psk; sertifikāta savienojumam (TLSConnect=cert) izmantojiet TLSCipherAll13 vietā.
TLSCipherPSK
Norādiet OpenSSL šifru virkni (TLS 1.2). Pārrakstiet noklusējuma šifru kopas atlases kritērijus PSK balstītai šifrēšanai.
Piemērs:
kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13
Norādiet OpenSSL šifru virkni (TLS 1.3) OpenSSL 1.1.1 vai jaunākai versijai. Pārrakstiet noklusējuma šifru kopas atlases kritērijus PSK balstītai šifrēšanai.
Piemērs:
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
Norādiet šifrēšanas līmeni, kas nepieciešams aģenta savienojumiem ar Zabbix serveri vai starpniekserveri.
Tiek izmantots aktīvajām pārbaudēm.
Var norādīt tikai vienu vērtību:
- unencrypted - savienoties bez šifrēšanas (noklusējums);
- psk - savienoties, izmantojot TLS un iepriekš koplietotu atslēgu (PSK);
- cert - savienoties, izmantojot TLS un sertifikātu.
Obligāti: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); citādi nē
TLSCRLFile
Norādiet pilnu ceļu uz failu, kurā ir atsauktie sertifikāti. Šis parametrs tiek izmantots šifrētai saziņai starp Zabbix komponentiem.
TLSKeyFile
Norādiet pilnu ceļu uz failu, kurā atrodas aģenta privātā atslēga, kas tiek izmantota šifrētai saziņai starp Zabbix komponentēm.
TLSPSKFile
Norādiet pilnu faila ceļu uz failu, kurā ir aģenta iepriekš koplietotā atslēga, kas tiek izmantota šifrētai saziņai ar Zabbix serveri vai starpniekserveri.
TLSPSKIdentity
Norādiet iepriekš koplietotās atslēgas identitātes virkni, ko izmanto šifrētai saziņai ar Zabbix serveri vai starpniekserveri.
TLSServerCertIssuer
Norādiet atļauto servera (starpniekservera) sertifikāta izdevēju.
TLSServerCertSubject
Norādiet atļauto servera (starpniekservera) sertifikāta subjektu.
UnsafeUserParameters
Atļaut visus simbolus nodot argumentiem lietotāja definētajos parametros.
Šādi simboli nav atļauti: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ %
Turklāt rindiņas pārtraukuma simboli nav atļauti.
Noklusējums: 0
Vērtības: 0 - neatļaut, 1 - atļaut
UserParameter
Norādiet lietotāja definētu parametru, ko uzraudzīt.
Var būt vairāki lietotāja definēti parametri.
Formāts: UserParameter=<key>,<shell command>
Ņemiet vērā, ka shell komandai nedrīkst atgriezt tukšu virkni vai tikai EOL.
Shell komandām var būt relatīvi ceļi, ja ir norādīts parametrs UserParameterDir.
Piemērs:
UserParameter=system.test,who|wc -l
UserParameter=check_cpu,./custom_script.sh
UserParameterDir
Norādiet noklusējuma meklēšanas ceļu UserParameter komandām.
Ja šis iestatījums tiek izmantots, aģents pirms komandas izpildes mainīs savu darba direktoriju uz šeit norādīto.
Tādējādi UserParameter komandām var izmantot relatīvu ./ prefiksu pilna ceļa vietā.
Atļauts tikai viens ieraksts.
Piemērs:
UserParameterDir=/opt/myscripts