5 Zabbix aģents (Windows)

Pārskats

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

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

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 dēmona noklusējuma iestatī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 HostnameItem vai PerfCounter parametrā.

Piemērs 1: Lapošanas 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 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] atslēgu, lai iegūtu konkrētus datus par CPU noslodzi.

Piemērs 3: Vairāku zemā līmeņa atklāšanas 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 atslēgu atbilstības noteikumus var definēt kopā ar DenyKey. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: Aģenta pārbaužu ierobežošana.

BufferSend

Neglabājiet datus buferī ilgāk par N sekundēm.

Noklusējums: 5
Diapazons: 1-3600

BufferSize

Maksimālais vērtību skaits atmiņas buferī. Ja buferis ir pilns, aģents nosūtīs visus savāktos datus uz Zabbix serveri vai starpniekserveri.

Noklusējums: 100
Diapazons: 2-65535

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

EnableRemoteCommands

Atļaut attālinātas komandas no Zabbix serveris.
Šis parametrs ir novecojis, tā vietā izmantojiet AllowKey=system.run[*] vai DenyKey=system.run[*].
Tas ir iekšējs aizstājvārds AllowKey/DenyKey parametriem atkarībā no vērtības:

• 0 - DenyKey=system.run[*]
• 1 - AllowKey=system.run[*]

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

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 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 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ārsniedz 255 rakstzīmju ierobežojumu.

Diapazons: 0-255 rakstzīmes

HostInterfaceItem

Neobligāts parametrs, kas nosaka vienumu, ko izmanto, lai hosta automātiskās reģistrācijas procesa laikā noteiktu hosta saskarni (IP adresi vai DNS nosaukumu). Šī 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 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 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ākrindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindas 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īvs aģents). HostMetadataItem ļauj atšķirt hosts ne tikai pēc hostname.

Tiek atbalstīti lietotāja parametri, veiktspējas skaitītāji un aizstājvārdi. system.run[] vienums tiek atbalstīts 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īgas UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, arī tiks noraidītas un atzīmētas kā nederīgas.

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

Hostname

Ar komatiem atdalīts, 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ī. 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

Neobligāts parametrs, kas nosaka Zabbix aģenta vienumu, ko izmanto hosta nosaukuma iegūšanai. Šī opcija tiek izmantota tikai tad, ja Hostname nav definēts. Lietotāja parametri, veiktspējas skaitītāji vai aizstājvārdi netiek atbalstīti, taču system.run[] vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey vērtībām.
Skatiet arī detalizētāku aprakstu.

Noklusējums: system.hostname

Iekļaut

Konfigurācijas failā var iekļaut atsevišķus failus vai visus failus direktorijā (pēc noklusējuma tas atrodas C:\Program Files\Zabbix Agent, ja Zabbix aģents ir instalēts, izmantojot Windows MSI instalācijas pakotnes; atrodas instalēšanas laikā norādītajā mapē, ja Zabbix aģents ir instalēts kā zip arhīvs). Visiem iekļautajiem failiem jābūt ar pareizu sintaksi, pretējā gadījumā aģents netiks palaists.
Lai norādītajā direktorijā iekļautu tikai atbilstošos failus, modeļu atbilstībai tiek atbalstīta zvaigznītes aizstājējzīme.
Skatiet īpašās piezīmes par ierobežojumiem.

Piemērs:

Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf

ListenBacklog

Maksimālais TCP rindā gaidošo savienojumu skaits.
Noklusējuma vērtība ir cieti kodēta konstante, kas ir atkarīga no sistēmas.
Arī maksimāli atbalstītā vērtība ir atkarīga no sistēmas; pārāk lielas vērtības var tikt klusi saīsinātas līdz "implementation-specified maximum".

Noklusējums: SOMAXCONN
Diapazons: 0 - INT_MAX

ListenIP

Ar komatiem atdalītu IP adrešu saraksts, uz kurām aģentam jāuzklausa.

Noklusējums: 0.0.0.0

ListenPort

aģents klausīsies šajā portā savienojumiem no serveris.

Noklusējums: 10050
Diapazons: 1024-32767

LogFile

aģenta žurnāla faila nosaukums.

Noklusējums: c:\zabbix_agentd.log
Obligāts: Jā, ja LogType ir iestatīts uz file; citos gadījumos nē

LogFileSize

Logfaila 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

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

LogType

Žurnāla izvades tips:

• file - ierakstīt žurnālu failā, kas norādīts ar LogFile parametru;
• system - ierakstīt žurnālu Windows notikumu žurnālā;
• console - ierakstīt žurnālu standarta izvades plūsmā.

Noklusējums: file

MaxLinesPerSecond

Maksimālais jauno rindu skaits, ko aģents sekundē nosūtīs uz Zabbix serveri vai starpniekserveri, 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ā norādīts MaxLinesPerSecond, lai meklētu nepieciešamo virkni log vienumos.

Noklusējums: 20
Diapazons: 1-1000

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ī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ē 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. Ņemiet vērā, ka "IPv4-compatible IPv6 addresses" (0000::/96 prefix) tiek atbalstītas, bet tās ir novecojušas saskaņā ar RFC4291. Atstarpes ir atļautas.

Piemērs:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Obligāts: jā, ja StartAgents nav nepārprotami iestatīts uz 0

ServerActive

Zabbix servera/starpniekservera adrese vai klastera konfigurācija aktīvo pārbaužu saņemšanai. Servera/starpniekservera adrese ir IP adrese vai DNS nosaukums, un 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ī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 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 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

Diapazons: (*)

SourceIP

Avota IP adrese šādiem gadījumiem:

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

StartAgents

Iepriekš atzaroto zabbix_agentd instanču skaits, kas apstrādā pasīvos pārbaudes pieprasījumus. Ja iestatīts uz 0, pasīvie pārbaudes pieprasījumi tiek atspējoti, un aģents neklausīsies nevienā TCP portā.

Noklusējums: 10
Diapazons: 0-100 (*)

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:

• gaidot atbildi no Zabbix servera;
• nosū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 vai Windows notikumu žurnāla uzraudzību;
• nosūtot sirdspukstu ziņojumus;
• maksimālais ilgums vfs.* pārbaudēm;
• ko izmanto Zabbix aģenta moduļi;
• kalpojot 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 tiem 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

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

Pilns ceļš uz failu, kurā atrodas aģenta sertifikāts vai sertifikātu ķēde, ko izmanto šifrētai saziņai ar Zabbix komponentēm.

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āti: jā, ja ir definēti TLS sertifikāta vai PSK parametri (pat unencrypted savienojumam); citādi nē

TLSCRLFile

Pilns faila ceļš uz failu, kurā ir atsauktie sertifikāti. Šis parametrs tiek izmantots šifrētai saziņai starp Zabbix komponentiem.

TLSKeyFile

Fails, kurā ir aģenta privātā atslēga, pilnais ceļš, ko izmanto šifrētai saziņai starp Zabbix komponentēm.

TLSPSKFile

Fails, kas satur aģenta iepriekš koplietotās atslēgas pilno ceļu, 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 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

UserParameter komandu noklusējuma meklēšanas ceļš. Ja 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