5 Zabbix agent (Windows)

Overzicht

De parameters die worden ondersteund door het configuratiebestand van de Windows Zabbix-agent (zabbix_agentd.conf) worden in deze sectie vermeld.

De parameters worden vermeld zonder aanvullende informatie. Klik op de parameter om de volledige details te zien.

Alle parameters zijn niet verplicht tenzij expliciet is vermeld dat de parameter verplicht is.

Merk op dat:

• De standaardwaarden reflecteren de daemon-standaarden, niet de waarden in de meegeleverde configuratiebestanden;
• Zabbix ondersteunt alleen configuratiebestanden in UTF-8 codering zonder BOM;
• Opmerkingen die beginnen met "#" worden alleen ondersteund aan het begin van de regel.

Parameter details

Alias

Stelt een alias in voor een item sleutel. Het kan worden gebruikt om een lange en complexe item sleutel te vervangen door een kortere en eenvoudigere versie.
Meerdere Alias parameters kunnen aanwezig zijn. Meerdere parameters met dezelfde Alias sleutel zijn niet toegestaan.
Verschillende Alias sleutels kunnen dezelfde item sleutel verwijzen.
Aliassen kunnen worden gebruikt in HostMetadataItem, maar niet in HostnameItem of PerfCounter parameter.

Voorbeeld 1: Het ophalen van het paginabestandsgebruik in percentage van de server.

Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

Nu kan de verkorte sleutel pg_usage worden gebruikt om gegevens op te halen.

Voorbeeld 2: Het verkrijgen van de CPU-belasting met standaard- en aangepaste parameters.

Alias=cpu.load:system.cpu.load
       Alias=cpu.load[*]:system.cpu.load[*]

Dit maakt het mogelijk om de sleutel cpu.load te gebruiken om de CPU-belasting met standaardparameters op te halen, evenals het gebruik van cpu.load[percpu,avg15] om specifieke gegevens over de CPU-belasting op te halen.

Voorbeeld 3: Het uitvoeren van meerdere ontdekkingsregels met laag niveau die dezelfde ontdekkingsitems verwerken.

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

Nu is het mogelijk om verschillende ontdekkingsregels in te stellen met behulp van vfs.fs.discovery met verschillende parameters voor elke regel, bijvoorbeeld vfs.fs.discovery[foo], vfs.fs.discovery[bar], enzovoort.

AllowKey

Sta de uitvoering toe van itemtoetsen die overeenkomen met een patroon. Het toetspatroon is een wildcard-uitdrukking die het teken "*" ondersteunt om een willekeurig aantal willekeurige tekens te matchen.
Er kunnen meerdere regels voor toetsmatching worden gedefinieerd in combinatie met DenyKey. De parameters worden één voor één verwerkt volgens hun verschijningsvolgorde. Zie ook: Beperken van agentcontroles.

BufferSend

Bewaar gegevens niet langer dan N seconden in de buffer.

Standaard: 5
Bereik: 1-3600

BufferSize

Het maximale aantal waarden in de geheugenbuffer. De agent zal alle verzamelde gegevens naar de Zabbix-server of proxy sturen als de buffer vol is.

Standaard: 100
Bereik: 2-65535

DebugLevel

Specificeer het debugniveau:
0 - basisinformatie over het starten en stoppen van Zabbix-processen
1 - kritieke informatie;
2 - foutinformatie;
3 - waarschuwingen;
4 - voor debuggen (produceert veel informatie);
5 - uitgebreid debuggen (produceert nog meer informatie).

Standaard: 3
Bereik: 0-5

DenyKey

Weiger de uitvoering van itemtoetsen die overeenkomen met een patroon. Het toetspatroon is een wildcard-uitdrukking die het teken "*" ondersteunt om een willekeurig aantal willekeurige tekens te matchen.
Er kunnen meerdere regels voor toetsmatching worden gedefinieerd in combinatie met AllowKey. De parameters worden één voor één verwerkt volgens hun verschijningsvolgorde. Zie ook: Beperken van agentcontroles.

EnableRemoteCommands

Of externe opdrachten van de Zabbix-server zijn toegestaan. Deze parameter is verouderd, gebruik in plaats daarvan AllowKey=system.run[*] of DenyKey=system.run[*].
Het is een interne alias voor de parameters AllowKey/DenyKey, afhankelijk van de waarde:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

Standaard: 0
Waarden: 0 - niet toegestaan, 1 - toegestaan

HeartbeatFrequency

De frequentie van hartslagberichten in seconden. Wordt gebruikt om de beschikbaarheid van actieve controles te controleren.
0 - hartslagberichten uitgeschakeld.

Standaard: 60
Bereik: 0-3600

HostInterface

Een optionele parameter die de hostinterface definieert. De hostinterface wordt gebruikt bij het automatisch registreren van hosts. Als het niet is gedefinieerd, wordt de waarde overgenomen van HostInterfaceItem.
De agent geeft een foutmelding en start niet als de waarde de limiet van 255 tekens overschrijdt.

Bereik: 0-255 tekens

HostInterfaceItem

Een optionele parameter die een item definieert dat wordt gebruikt om de hostinterface op te halen.
De hostinterface wordt gebruikt in het host autoregistratie proces.
Tijdens een autoregistratieverzoek zal de agent een waarschuwingsbericht registreren als de waarde die wordt geretourneerd door het gespecificeerde item de limiet van 255 tekens overschrijdt.
Het system.run[] item wordt ondersteund ongeacht de waarden van AllowKey/DenyKey.
Deze optie wordt alleen gebruikt als HostInterface niet is gedefinieerd.

HostMetadata

Een optionele parameter die hostmetadata definieert. Hostmetadata wordt alleen gebruikt bij het automatisch registreren van hosts (actieve agent). Als het niet is gedefinieerd, wordt de waarde overgenomen van HostMetadataItem.
De agent geeft een foutmelding en start niet als de opgegeven waarde de limiet van 2034 bytes overschrijdt of als het een niet-UTF-8-string is.

Bereik: 0-2034 bytes

HostMetadataItem

Een optionele parameter die een Zabbix-agentitem definieert dat wordt gebruikt om hostmetadata op te halen. Deze optie wordt alleen gebruikt als HostMetadata niet is gedefinieerd. Gebruikersparameters, prestatiemeters en aliassen worden ondersteund. Het system.run[] item wordt ondersteund ongeacht de waarden van AllowKey/DenyKey.
De waarde van HostMetadataItem wordt opgehaald bij elke poging tot autoregistratie en wordt alleen gebruikt tijdens het hostautoregistratieproces (actieve agent).
Tijdens een autoregistratieverzoek zal de agent een waarschuwingsbericht registreren als de waarde die wordt geretourneerd door het gespecificeerde item de limiet van 65535 UTF-8-codepunten overschrijdt. De waarde die wordt geretourneerd door het item moet een UTF-8-tekenreeks zijn, anders wordt deze genegeerd.

Hostname

Een lijst van door komma's gescheiden, unieke, hoofdlettergevoelige hostnamen. Vereist voor actieve checks en moet overeenkomen met de hostnamen zoals geconfigureerd op de server. De waarde wordt overgenomen van HostnameItem als deze niet is gedefinieerd.
Toegestane tekens: alfanumeriek, '.', ' ', '_' en '-'. Maximale lengte: 128 tekens per hostname, 2048 tekens voor de gehele regel.

Standaard: Ingesteld door HostnameItem

HostnameItem

Een optionele parameter die een Zabbix-agentitem definieert dat wordt gebruikt om de hostnaam op te halen. Deze optie wordt alleen gebruikt als Hostname niet is gedefinieerd. Gebruikersparameters, prestatiemeters of aliassen worden niet ondersteund, maar het system.run[] item wordt ondersteund ongeacht de waarden van AllowKey/DenyKey.
Zie ook een gedetailleerdere beschrijving.

Standaard: system.hostname

Include

Je kunt individuele bestanden of alle bestanden in een map opnemen in het configuratiebestand. Alle opgenomen bestanden moeten de juiste syntaxis hebben, anders zal de agent niet starten.
Om alleen relevante bestanden in de opgegeven map op te nemen, wordt het asterisk-wildcardteken ondersteund voor patroonmatching.
Zie speciale opmerkingen over beperkingen.

Voorbeeld:

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

ListenBacklog

Het maximale aantal wachtende verbindingen in de TCP-wachtrij.
De standaardwaarde is een hardgecodeerde constante die afhankelijk is van het systeem.
De maximale ondersteunde waarde is ook afhankelijk van het systeem; te hoge waarden kunnen stilzwijgend worden afgekapt tot het 'implementatiespecifieke maximum'.

Standaard: SOMAXCONN
Bereik: 0 - INT_MAX

ListenIP

Een lijst van door komma's gescheiden IP-adressen waarop de agent moet luisteren.

Standaard: 0.0.0.0

ListenPort

De agent luistert op deze poort voor verbindingen van de server.

Standaard: 10050
Bereik: 1024-32767

LogFile

De naam van het logbestand van de agent.

Standaard: C:\\zabbix_agentd.log
Verplicht: Ja, als LogType is ingesteld op file; anders nee

LogFileSize

De maximale grootte van een logbestand in MB.
0 - automatische logrotatie uitschakelen.
Opmerking: Als de limiet voor de grootte van het logbestand wordt bereikt en het draaien van het bestand mislukt om welke reden dan ook, wordt het bestaande logbestand afgekapt en opnieuw gestart.

Standaard: 1
Bereik: 0-1024

LogRemoteCommands

Schakel het loggen in van uitgevoerde shell-opdrachten als waarschuwingen. Opdrachten worden alleen gelogd als ze op afstand worden uitgevoerd. Logvermeldingen worden niet gemaakt als system.run[] lokaal wordt uitgevoerd via HostMetadataItem, HostInterfaceItem of HostnameItem parameters.

Standaard: 0
Waarden: 0 - uitgeschakeld, 1 - ingeschakeld

LogType

Het type loguitvoer:
file - schrijf log naar het bestand dat is gespecificeerd in het LogFile-parameter;
system - schrijf log naar Windows Event Log;
console - schrijf log naar standaard uitvoer.

Standaard: file

MaxLinesPerSecond

Het maximale aantal nieuwe regels dat de agent per seconde naar de Zabbix-server of proxy zal sturen bij het verwerken van 'log', 'logrt' en 'eventlog' actieve checks. De opgegeven waarde wordt overschreven door de 'maxlines'-parameter die wordt meegegeven in de 'log', 'logrt' of 'eventlog' item key.
Opmerking: Zabbix zal 10 keer meer nieuwe regels verwerken dan ingesteld in MaxLinesPerSecond om de vereiste tekenreeks in logitems te zoeken.

Standaard: 20
Bereik: 1-1000

PerfCounter

Definieert een nieuwe parameter <parameter_naam> die de gemiddelde waarde voor de systeemprestatieteller <perf_counter_path> aangeeft gedurende de opgegeven tijdsperiode <periode> (in seconden).
Syntaxis: <parameter_naam>,"<perf_counter_path>",<periode>

Bijvoorbeeld, als je het gemiddelde aantal processoronderbrekingen per seconde wilt ontvangen voor de afgelopen minuut, kun je een nieuwe parameter "interrupts" als volgt definiëren:

PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60

Let op de dubbele aanhalingstekens rond het pad naar de prestatieteller. De parameter naam (interrupts) moet worden gebruikt als item sleutel bij het maken van een item. Monsters voor het berekenen van de gemiddelde waarde worden elke seconde genomen.
Je kunt "typeperf -qx" uitvoeren om de lijst met alle beschikbare prestatietellers in Windows te krijgen.

PerfCounterEn

Definieert een nieuwe parameter <parameter_naam> die de gemiddelde waarde voor systeemprestatieteller <perf_counter_path> aangeeft gedurende de opgegeven tijdsperiode <periode> (in seconden). In vergelijking met PerfCounter moeten de perfcount-pad in het Engels zijn. Ondersteund alleen op Windows Server 2008/Vista en later.
Syntaxis: <parameter_naam>,"<perf_counter_path>",<periode>

Bijvoorbeeld, als je het gemiddelde aantal processoronderbrekingen per seconde wilt ontvangen voor de afgelopen minuut, kun je een nieuwe parameter "interrupts" als volgt definiëren:

PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60

Let op de dubbele aanhalingstekens rond het pad naar de prestatieteller. De parameter naam (interrupts) moet worden gebruikt als item sleutel bij het maken van een item. Monsters voor het berekenen van de gemiddelde waarde worden elke seconde genomen.
Je kunt de lijst met Engelse strings vinden door de volgende registersleutel te bekijken: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.

RefreshActiveChecks

Hoe vaak de lijst met actieve controles wordt vernieuwd, in seconden. Houd er rekening mee dat na het niet kunnen vernieuwen van actieve controles, de volgende vernieuwing zal worden geprobeerd na 60 seconden.

Standaard: 5
Bereik: 1-86400

Server

Een lijst van door komma's gescheiden IP-adressen, optioneel in CIDR-notatie, of DNS-namen van Zabbix-servers of Zabbix-proxies. Inkomende verbindingen zullen alleen worden geaccepteerd vanaf de hier vermelde hosts. Als IPv6-ondersteuning is ingeschakeld, worden '127.0.0.1', '::127.0.0.1' en '::ffff:127.0.0.1' gelijk behandeld en '::/0' zal elk IPv4- of IPv6-adres toestaan. '0.0.0.0/0' kan worden gebruikt om elk IPv4-adres toe te staan. Let op dat "IPv4-compatibele IPv6-adressen" (0000::/96 prefix) worden ondersteund maar afgeraden volgens RFC4291. Spaties zijn toegestaan.

Voorbeeld:

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

Verplicht: ja, als StartAgents niet expliciet is ingesteld op 0

ServerActive

Het Zabbix server/proxy-adres of clusterconfiguratie om actieve controles van te verkrijgen. Het server/proxy-adres is een IP-adres of DNS-naam en een optionele poort, gescheiden door een dubbele punt.
De clusterconfiguratie is een of meer serveradressen, gescheiden door een puntkomma. Meerdere Zabbix-servers/clusters en Zabbix-proxies kunnen worden gespecificeerd, gescheiden door een komma. Er moet niet meer dan één Zabbix-proxy worden gespecificeerd vanaf elke Zabbix-server/cluster. Als een Zabbix-proxy is gespecificeerd, mag de Zabbix-server/cluster voor die proxy niet worden gespecificeerd.
Meerdere door komma's gescheiden adressen kunnen worden opgegeven om meerdere onafhankelijke Zabbix-servers parallel te gebruiken. Spaties zijn toegestaan.
Als de poort niet is opgegeven, wordt de standaardpoort gebruikt.
IPv6-adressen moeten worden ingesloten in vierkante haken als de poort voor dat host is opgegeven. Als de poort niet is opgegeven, zijn vierkante haken voor IPv6-adressen optioneel.
Als deze parameter niet is opgegeven, zijn actieve controles uitgeschakeld.

Voorbeeld voor Zabbix-proxy:

ServerActive=127.0.0.1:10051

Voorbeeld voor meerdere servers:

ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

Voorbeeld voor hoge beschikbaarheid:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

Voorbeeld voor hoge beschikbaarheid met twee clusters en één server:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain

Bereik: (*)

Bron-IP

Het bron-IP-adres voor:
- uitgaande verbindingen naar Zabbix-server of Zabbix-proxy;
- verbindingen maken tijdens het uitvoeren van bepaalde items (web.page.get, net.tcp.port, enz.).

StartAgents

Het aantal vooraf geforkte instanties van zabbix_agentd die passieve controles verwerken. Als ingesteld op 0, zijn passieve controles uitgeschakeld en luistert de agent niet op een willekeurige TCP-poort.

Standaard: 3
Bereik: 0-63 (*)

Timeout

Besteed niet meer dan Timeout seconden aan verwerking.

Standaard: 3
Bereik: 1-30

TLSAccept

De inkomende verbindingen om te accepteren. Gebruikt voor passieve checks. Meerdere waarden kunnen worden opgegeven, gescheiden door komma:
unencrypted - accepteer verbindingen zonder versleuteling (standaard)
psk - accepteer verbindingen met TLS en een vooraf gedeelde sleutel (PSK)
cert - accepteer verbindingen met TLS en een certificaat

Verplicht: ja, als TLS-certificaat- of PSK-parameters zijn gedefinieerd (zelfs voor unencrypted verbindingen); anders nee

TLSCAFile

De volledige bestandsnaam van het bestand met de hoogste niveau CA-certificaten voor verificatie van peer-certificaten, gebruikt voor versleutelde communicatie tussen Zabbix-componenten.

TLSCertFile

Het volledige pad naar het bestand met het certificaat van de agent of de certificaatketen, gebruikt voor versleutelde communicatie met Zabbix-componenten.

TLSConnect

Hoe de agent moet verbinden met de Zabbix-server of -proxy. Gebruikt voor actieve controles. Er kan slechts één waarde worden opgegeven:
unencrypted - verbind zonder versleuteling (standaard)
psk - verbind met TLS en een vooraf gedeelde sleutel (PSK)
cert - verbind met TLS en een certificaat

Verplicht: ja, als TLS-certificaat of PSK-parameters zijn gedefinieerd (zelfs voor een unencrypted verbinding); anders nee

TLSCRLFile

Het volledige pad naar het bestand dat ingetrokken certificaten bevat. Deze parameter wordt gebruikt voor versleutelde communicatie tussen Zabbix-componenten.

TLSKeyFile

Het volledige pad naar het bestand dat de privésleutel van de agent bevat, gebruikt voor versleutelde communicatie tussen Zabbix-componenten.

TLSPSKFile

Het volledige pad naar het bestand dat de pre-shared key (PSK) van de agent bevat, gebruikt voor versleutelde communicatie met Zabbix-server.

TLSPSKIdentity

De pre-shared key identity string, gebruikt voor versleutelde communicatie met de Zabbix-server.

TLSServerCertIssuer

De toegestane uitgever (issuer) van het server (proxy) certificaat.

TLSServerCertSubject

Het toegestane onderwerp (subject) van het server (proxy) certificaat.

UnsafeUserParameters

Sta toe dat alle tekens worden doorgegeven als argumenten aan door de gebruiker gedefinieerde parameters. De volgende tekens zijn niet toegestaan:  ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
Bovendien zijn newline-tekens niet toegestaan.

Standaard: 0
Waarden: 0 - niet toestaan, 1 - toestaan

UserParameter

Een door de gebruiker gedefinieerde parameter om te bewaken. Er kunnen meerdere door de gebruiker gedefinieerde parameters zijn.
Opmaak: UserParameter=<sleutel>,<shell-opdracht>
Merk op dat de shell-opdracht geen lege tekenreeks of alleen EOL mag retourneren. Shell-opdrachten kunnen relatieve paden hebben als de parameter UserParameterDir is gespecificeerd.

Voorbeeld:

UserParameter=system.test,who|wc -l
       UserParameter=check_cpu,./custom_script.sh

UserParameterDir

Het standaard zoekpad voor UserParameter-opdrachten. Als dit wordt gebruikt, zal de agent zijn werkmap wijzigen naar de hier gespecificeerde map voordat een opdracht wordt uitgevoerd. Hierdoor kunnen UserParameter-opdrachten een relatief ./ voorvoegsel hebben in plaats van een volledig pad. Er is slechts één invoer toegestaan.

Voorbeeld:

UserParameterDir=/opt/myscripts

Zie ook

1. Verschillen in de Zabbix-agentconfiguratie voor actieve en passieve controles vanaf versie 2.0.0.