Table of Contents
5 Zabbix agent (Windows)
Overzicht
Deze sectie vermeldt parameters die worden ondersteund in een configuratiebestand voor een Zabbix-agent (Windows) (zabbix_agentd.conf).
Merk op dat:
- De standaardwaarden weerspiegelen 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.
Parameters
| Parameter | Verplicht | Bereik | Standaard | Beschrijving |
|---|---|---|---|---|
| Alias | nee | 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. Er kunnen meerdere Alias parameters aanwezig zijn. Meerdere parameters met dezelfde Alias sleutel zijn niet toegestaan. Verschillende Alias sleutels kunnen naar dezelfde item sleutel verwijzen. Aliassen kunnen worden gebruikt in HostMetadataItem, maar niet in HostnameItem of PerfCounter parameters. Voorbeelden: 1. Ophalen van het paginabestand gebruik in procenten 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. 2. CPU-belasting verkrijgen 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 het CPU-gebruik in procenten op te halen met standaardparameters, evenals gebruik van cpu.load[percpu,avg15] om specifieke gegevens over CPU-belasting op te halen. 3. Uitvoeren van meerdere ontdekkingsregels op laag niveau die dezelfde ontdekkingsitems verwerken. Alias=vfs.fs.discovery[*]:vfs.fs.discovery Nu is het mogelijk om meerdere ontdekkingsregels in te stellen met behulp van vfs.fs.discovery met verschillende parameters voor elke regel, bijv. vfs.fs.discovery[foo], vfs.fs.discovery[bar], etc. |
||
| AllowKey | nee | Toestaan van uitvoering van die item sleutels die overeenkomen met een patroon. Sleutelpatroon is een wildcard-uitdrukking die het "*" teken ondersteunt om een willekeurig aantal willekeurige tekens te matchen. Meerdere regels voor sleutelovereenkomsten kunnen worden gedefinieerd in combinatie met DenyKey. De parameters worden één voor één verwerkt volgens de volgorde van verschijning. Deze parameter wordt ondersteund sinds Zabbix 5.0.0. Zie ook: Beperking van agent controles. |
||
| BufferSend | nee | 1-3600 | 5 | Bewaar gegevens niet langer dan N seconden in de buffer. |
| BufferSize | nee | 2-65535 | 100 | Maximaal aantal waarden in een geheugenbuffer. De agent zal alle verzamelde gegevens naar de Zabbix-server of proxy sturen als de buffer vol is. |
| DebugLevel | nee | 0-5 | 3 | Specificeert het debug niveau: 0 - basisinformatie over het starten en stoppen van Zabbix processen 1 - kritieke informatie 2 - foutinformatie 3 - waarschuwingen 4 - voor het debuggen (produceert veel informatie) 5 - uitgebreid debuggen (produceert nog meer informatie) |
| DenyKey | nee | Weiger uitvoering van die item sleutels die overeenkomen met een patroon. Sleutelpatroon is een wildcard-uitdrukking die het "*" teken ondersteunt om een willekeurig aantal willekeurige tekens te matchen. Meerdere regels voor sleutelovereenkomsten kunnen worden gedefinieerd in combinatie met AllowKey. De parameters worden één voor één verwerkt volgens de volgorde van verschijning. Deze parameter wordt ondersteund sinds Zabbix 5.0.0. Zie ook: Beperking van agent controles. |
||
| EnableRemoteCommands | nee | 0 | Of externe opdrachten van Zabbix server zijn toegestaan. Deze parameter is verouderd, gebruik AllowKey=system.run[*] of DenyKey=system.run[*] in plaats daarvan Het is een interne alias voor AllowKey/DenyKey parameters, afhankelijk van de waarde: 0 - DenyKey=system.run[*] 1 - AllowKey=system.run[*]. |
|
| HostInterface | nee | 0-255 tekens | Optionele parameter die de hostinterface definieert. Hostinterface wordt gebruikt bij het automatisch registratieproces van de host. Als de waarde de limiet van 255 tekens overschrijdt, geeft een agent een fout en start niet op. Indien niet gedefinieerd, wordt de waarde overgenomen van HostInterfaceItem. Ondersteund sinds Zabbix 4.4.0. |
|
| HostInterfaceItem | nee | Optionele parameter die een item definieert dat wordt gebruikt om de hostinterface te verkrijgen. Hostinterface wordt gebruikt bij het automatisch registratieproces van de host. Tijdens een automatisch registratieverzoek zal een 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 wanneer HostInterface niet is gedefinieerd. Ondersteund sinds Zabbix 4.4.0. |
||
| HostMetadata | nee | 0-255 tekens | Optionele parameter die host metadata definieert. Host metadata wordt alleen gebruikt bij het automatisch registratieproces van de host (actieve agent). Indien niet gedefinieerd, wordt de waarde overgenomen van HostMetadataItem. Een agent geeft een fout en start niet op als de opgegeven waarde de limiet overschrijdt of een niet-UTF-8 tekenreeks is. |
|
| HostMetadataItem | nee | Optionele parameter die een Zabbix agent item definieert dat wordt gebruikt om host metadata te verkrijgen. Deze optie wordt alleen gebruikt wanneer HostMetadata niet is gedefinieerd. Ondersteunt UserParameters, prestatietellers en aliassen. Ondersteunt system.run[] ongeacht de waarde van EnableRemoteCommands. HostMetadataItem waarde wordt opgehaald bij elke automatische registratiepoging en wordt alleen gebruikt bij het automatisch registratieproces van de host (actieve agent). Tijdens een automatisch registratieverzoek zal een agent een waarschuwingsbericht registreren als de waarde die wordt geretourneerd door het gespecificeerde item de limiet van 255 tekens overschrijdt. De waarde die door het item wordt geretourneerd, moet een UTF-8 tekenreeks zijn, anders wordt deze genegeerd. |
||
| Hostname | nee | Ingesteld door HostnameItem | Lijst van unieke hostnamen die hoofdlettergevoelig zijn en door komma's zijn gescheiden. Vereist voor actieve controles en moet overeenkomen met 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 hostnaam, 2048 tekens voor de gehele regel. |
|
| HostnameItem | nee | system.hostname | Optionele parameter die een Zabbix agent item definieert dat wordt gebruikt om de hostnaam te verkrijgen. Deze optie wordt alleen gebruikt wanneer Hostname niet is gedefinieerd. Ondersteunt geen UserParameters, prestatietellers of aliassen, maar ondersteunt system.run[] ongeacht de waarde van EnableRemoteCommands. De uitvoerlengte is beperkt tot 512 KB. Zie ook een gedetailleerdere beschrijving. |
|
| Include | nee | U 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. Bijvoorbeeld: C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf.Zie speciale opmerkingen over beperkingen. |
||
| ListenBacklog | nee | 0 - INT_MAX | SOMAXCONN | Het maximale aantal in behandeling zijnde verbindingen in de TCP-wachtrij. De standaardwaarde is een hardgecodeerde constante, afhankelijk van het systeem. De maximale ondersteunde waarde hangt af van het systeem; te hoge waarden kunnen stilzwijgend worden afgekapt tot het 'implementatiespecifieke maximum'. |
| ListenIP | nee | 0.0.0.0 | Lijst van door komma's gescheiden IP-adressen waarop de agent moet luisteren. | |
| ListenPort | nee | 1024-32767 | 10050 | De agent zal luisteren op deze poort voor verbindingen van de server. |
| LogFile | ja, als LogType is ingesteld op file, anders nee |
C:\zabbix_agentd.log | Naam van het logbestand van de agent. | |
| LogFileSize | nee | 0-1024 | 1 | Maximale grootte van het logbestand in MB. 0 - automatische logrotatie uitschakelen. Opmerking: Als de limiet voor de grootte van het logbestand is bereikt en logrotatie om welke reden dan ook mislukt, wordt het bestaande logbestand afgekapt en opnieuw gestart. |
| LogType | nee | file | Type loguitvoer: file - log schrijven naar bestand gespecificeerd door LogFile parameter, system - log schrijven naar Windows Event Log, console - log schrijven naar standaard uitvoer. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
|
| LogRemoteCommands | nee | 0 | Logging van uitgevoerde shell-opdrachten inschakelen als waarschuwingen. 0 - uitgeschakeld 1 - ingeschakeld |
|
| MaxLinesPerSecond | nee | 1-1000 | 20 | Maximaal aantal nieuwe regels dat de agent per seconde naar de Zabbix-server zal sturen voor verwerking van 'log', 'logrt' en 'eventlog' actieve controles. De opgegeven waarde wordt overschreven door de parameter 'maxlines', die wordt verstrekt in de sleutels van 'log', 'logrt' of 'eventlog' items. Opmerking: Zabbix zal 10 keer meer nieuwe regels verwerken dan ingesteld in MaxLinesPerSecond om de vereiste string te zoeken in logitems. |
| PerfCounter | nee | Definieert een nieuwe parameter <parameter_name> die een gemiddelde waarde is voor systeemprestatieteller <perf_counter_path> voor de opgegeven tijdsperiode <period> (in seconden). Syntaxis: <parameter_name>,"<perf_counter_path>",<period> Bijvoorbeeld, als je het gemiddelde aantal processoronderbrekingen per seconde van de afgelopen minuut wilt ontvangen, kun je een nieuwe parameter "interrupts" als volgt definiëren: PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 Let op de dubbele aanhalingstekens rond het prestatietellerpad. De parameter naam (interrupts) moet worden gebruikt als de item sleutel bij het maken van een item. Monsterwaarden 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 | nee | Definieert een nieuwe parameter <parameter_name> die een gemiddelde waarde is voor systeemprestatieteller <perf_counter_path> voor de opgegeven tijdsperiode <period> (in seconden). Syntaxis: <parameter_name>,"<perf_counter_path>",<period> In vergelijking met PerfCounter moeten de paden van prestatietellers in het Engels zijn. Alleen ondersteund op Windows Server 2008/Vista en hoger. Bijvoorbeeld, als je het gemiddelde aantal processoronderbrekingen per seconde van de afgelopen minuut wilt ontvangen, kun je een nieuwe parameter "interrupts" als volgt definiëren: PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60 Let op de dubbele aanhalingstekens rond het prestatietellerpad. De parameter naam (interrupts) moet worden gebruikt als de item sleutel bij het maken van een item. Monsterwaarden voor het berekenen van de gemiddelde waarde worden elke seconde genomen. Je kunt de lijst met Engelse tekenreeksen vinden door de volgende registerwaarde te bekijken: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.Deze parameter wordt ondersteund sinds Zabbix 4.0.13 en 4.2.7. |
||
| RefreshActiveChecks | nee | 60-3600 | 120 | Hoe vaak de lijst met actieve controles wordt vernieuwd, in seconden. Let op dat na een mislukte vernieuwing van actieve controles de volgende vernieuwing na 60 seconden zal worden geprobeerd. |
| Server | ja, als StartAgents niet expliciet is ingesteld op 0 | Lijst van door komma's gescheiden IP-adressen, optioneel in CIDR-notatie, of DNS-namen van Zabbix-servers. Inkomende verbindingen worden alleen 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. Merk op dat "IPv4-compatibele IPv6-adressen" (0000::/96 prefix) worden ondersteund maar verouderd zijn volgens RFC4291. Voorbeeld: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com Spaties zijn toegestaan. |
||
| ServerActive | nee | (*) | Zabbix server/proxy-adres of clustermethode om actieve controles van te verkrijgen. Server/proxy-adres is IP-adres of DNS-naam en optionele poort gescheiden door een dubbele punt. Clusterconfiguratie is één of meer serveradressen gescheiden door een puntkomma. Meerdere Zabbix-servers/clusters en Zabbix-proxies kunnen worden opgegeven, gescheiden door een komma. Vanuit elke Zabbix-server/cluster mogen meer dan één Zabbix-proxy niet worden opgegeven. Als Zabbix-proxy is opgegeven, mag de Zabbix-server/cluster voor die proxy niet worden opgegeven. Meerdere door komma's gescheiden adressen kunnen worden opgegeven om verschillende 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 er een poort voor die 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 |
|
| SourceIP | nee | Bron IP-adres voor: - uitgaande verbindingen naar Zabbix-server of Zabbix-proxy; - het maken van verbindingen tijdens het uitvoeren van sommige items (web.page.get, net.tcp.port, enz.) |
||
| StartAgents | nee | 0-63 (*) | 3 | Aantal vooraf gevorkte instanties van zabbix_agentd die passieve controles verwerken. Als ingesteld op 0, worden passieve controles uitgeschakeld en luistert de agent niet op een willekeurige TCP-poort. |
| Timeout | nee | 1-30 | 3 | Besteed niet meer dan Timeout seconden aan verwerking |
| TLSAccept | ja, als TLS-certificaat- of PSK-parameters zijn gedefinieerd (zelfs voor een ongecodeerde verbinding), anders nee | Welke inkomende verbindingen te accepteren. Gebruikt voor passieve controles. Meerdere waarden kunnen worden opgegeven, gescheiden door een 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 Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSCAFile | nee | Volledige padnaam van een bestand met de hoogste niveau CA-certificaten voor verificatie van peer-certificaat, gebruikt voor versleutelde communicatie tussen Zabbix-componenten. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSCertFile | nee | Volledige padnaam van een bestand met het agentcertificaat of certificaatketen, gebruikt voor versleutelde communicatie met Zabbix-componenten. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSConnect | ja, als TLS-certificaat- of PSK-parameters zijn gedefinieerd (zelfs voor een ongecodeerde verbinding), anders nee | Hoe de agent verbinding moet maken met Zabbix-server of -proxy. Gebruikt voor actieve controles. Slechts één waarde kan worden opgegeven: unencrypted - maak verbinding zonder versleuteling (standaard) psk - maak verbinding met TLS en een vooraf gedeelde sleutel (PSK) cert - maak verbinding met TLS en een certificaat Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSCRLFile | nee | Volledige padnaam van een bestand met ingetrokken certificaten. Deze parameter wordt gebruikt voor versleutelde communicatie met Zabbix-componenten. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSKeyFile | nee | Volledige padnaam van een bestand met de privésleutel van de agent die wordt gebruikt voor versleutelde communicatie met Zabbix-componenten. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSPSKFile | nee | Volledige padnaam van een bestand met de vooraf gedeelde sleutel van de agent die wordt gebruikt voor versleutelde communicatie met Zabbix-componenten. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSPSKIdentity | nee | Vooraf gedeelde sleutel identiteitsreeks, gebruikt voor versleutelde communicatie met Zabbix-server. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSServerCertIssuer | nee | Toegestane uitgever van server (proxy) certificaat. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSServerCertSubject | nee | Toegestaan onderwerp van server (proxy) certificaat. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| UnsafeUserParameters | nee | 0-1 | 0 | Sta toe dat alle tekens worden doorgegeven in argumenten aan door de gebruiker gedefinieerde parameters. 0 - niet toestaan 1 - toestaan De volgende tekens zijn niet toegestaan: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ Bovendien zijn newline-tekens niet toegestaan. |
| UserParameter | nee | Door de gebruiker gedefinieerde parameter om te monitoren. Er kunnen verschillende door de gebruiker gedefinieerde parameters zijn. Indeling: UserParameter=<sleutel>,<shellopdracht> Merk op dat de shellopdracht geen lege tekenreeks of alleen EOL mag retourneren. Shell-opdrachten kunnen relatieve paden hebben, als de parameter UserParameterDir is opgegeven. Voorbeelden: UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh |
||
| UserParameterDir | nee | Standaard zoekpad voor UserParameter-opdrachten. Als dit wordt gebruikt, zal de agent zijn werkmap wijzigen naar degene die hier is gespecificeerd voordat een opdracht wordt uitgevoerd. Hierdoor kunnen UserParameter-opdrachten een relatief ./ voorvoegsel hebben in plaats van een volledig pad.Slechts één invoer is toegestaan. Voorbeeld: UserParameterDir=/opt/myscripts |
(*) Het aantal actieve servers dat wordt vermeld in ServerActive, plus het aantal voorgevorkte instanties voor passieve controles dat is gespecificeerd in StartAgents, moet minder zijn dan 64.