6 Zabbix agent 2 (Windows)

Overzicht

Zabbix agent 2 is een nieuwe generatie Zabbix-agent die in plaats van de Zabbix-agent kan worden gebruikt.

De parameters die worden ondersteund door het configuratiebestand van de Windows Zabbix-agent 2 (zabbix_agent2.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 vermeld wordt dat de parameter verplicht is.

Merk op dat:

• De standaardwaarden weerspiegelen de standaardwaarden van het proces, niet de waarden in de geleverde 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 itemtoets. Hiermee kan een lange en complexe itemtoets worden vervangen door een kortere en eenvoudigere toets.
Er kunnen meerdere parameters met de naam Alias aanwezig zijn. Meerdere parameters met dezelfde Alias-toets zijn niet toegestaan.
Verschillende Alias-toetsen kunnen naar dezelfde itemtoets verwijzen.
Aliassen kunnen worden gebruikt in HostMetadataItem, maar niet in de parameter HostnameItem.

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

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

Nu kan de verkorte toets 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 cpu.load[percpu,avg15] om specifieke gegevens over de CPU-belasting op te halen.

Voorbeeld 3: Het uitvoeren van meerdere ontdekkingsregels op laag niveau die dezelfde ontdekkingselementen 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], enz.

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

Het tijdsinterval in seconden dat bepaalt hoe vaak waarden van de buffer naar de Zabbix-server worden verzonden.
Let op, als de buffer vol is, worden de gegevens eerder verzonden.

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.
Deze parameter moet alleen worden gebruikt als de permanente buffer is uitgeschakeld (EnablePersistentBuffer=0).

Standaard: 100
Bereik: 2-65535

ControlSocket

Het controle-aansluitpunt, gebruikt om runtime-opdrachten te verzenden met de optie '-R'.

Standaard: \\.\pipe\agent.sock

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.

EnablePersistentBuffer

Schakel het gebruik van lokale permanente opslag in voor actieve items. Als permanente opslag is uitgeschakeld, wordt de geheugenbuffer gebruikt.

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

ForceActiveChecksOnStart

Voer onmiddellijk actieve controles uit na de herstart voor de eerste ontvangen configuratie. Ook beschikbaar als een per-plugin configuratieparameter, bijvoorbeeld: Plugins.Uptime.System.ForceActiveChecksOnStart=1

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

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. Deze optie wordt alleen gebruikt als HostInterface niet is gedefinieerd.
Het system.run[] item wordt ondersteund ongeacht de waarden van AllowKey/DenyKey.
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.

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 item definieert dat wordt gebruikt om hostmetadata op te halen. Deze optie wordt alleen gebruikt als HostMetadata niet is gedefinieerd. Gebruikersparameters 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.
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 item definieert dat wordt gebruikt om de hostnaam op te halen. Deze optie wordt alleen gebruikt als Hostname niet is gedefinieerd. Gebruikersparameters of aliassen worden niet ondersteund, maar het system.run[] item wordt ondersteund ongeacht de waarden van AllowKey/DenyKey.

Standaard: system.hostname

Include

U kunt individuele bestanden of alle bestanden in een map opnemen in het configuratiebestand. Alle opgenomen bestanden moeten de juiste syntaxis hebben, anders wordt de agent niet gestart. Het pad kan relatief zijn ten opzichte van de locatie van het zabbix_agent2.conf bestand (bijv. Include=.\zabbix_agent2.d\plugins.d\*.conf).
Om alleen relevante bestanden in de opgegeven map op te nemen, wordt het sterretje-wildcardteken ondersteund voor patroonovereenkomsten.
Zie speciale opmerkingen over beperkingen.

Voorbeeld:

Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf

ListenIP

Een lijst met door komma's gescheiden IP-adressen waar de agent naar moet luisteren. Het eerste IP-adres wordt naar de Zabbix-server gestuurd, als er verbinding mee wordt gemaakt, om de lijst met actieve checks op te halen.

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_agent2.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 van de logbestandsgrootte 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

LogType

Het type van de loguitvoer:
file - schrijf log naar het bestand dat is gespecificeerd in het parameter LogFile;
console - schrijf log naar standaarduitvoer.

Standaard: file

PersistentBufferFile

Het bestand waarin Zabbix agent 2 de SQLite-database moet bewaren. Moet een volledige bestandsnaam zijn. Deze parameter wordt alleen gebruikt als de persistente buffer is ingeschakeld (EnablePersistentBuffer=1).

PersistentBufferPeriod

De tijdsperiode waarvoor gegevens moeten worden opgeslagen wanneer er geen verbinding is met de server of proxy. Oudere gegevens gaan verloren. Loggegevens worden behouden. Deze parameter wordt alleen gebruikt als de persistente buffer is ingeschakeld (EnablePersistentBuffer=1).

Standaard: 1u (1 uur)
Bereik: 1m (1 minuut) - 365d (365 dagen)

Plugins.<PluginName>.System.Capacity

De limiet van controles per <PluginName> plugin die tegelijkertijd kan worden uitgevoerd.

Standaard: 1000 Bereik: 1-1000

Plugins.Log.MaxLinesPerSecond

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

Standaard: 20
Bereik: 1-1000

Plugins.SystemRun.LogRemoteCommands

Schakel het loggen in van uitgevoerde shell-opdrachten als waarschuwingen. De opdrachten worden alleen gelogd als ze op afstand worden uitgevoerd. Er worden geen logboekvermeldingen gemaakt als system.run[] lokaal wordt gestart door de parameters HostMetadataItem, HostInterfaceItem of HostnameItem.

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

PluginSocket

Het pad naar het UNIX-socket voor communicatie met laadbare plugins.

Standaard: \\.\pipe\agent.plugin.sock

PluginTimeout

De time-out voor verbindingen met laadbare plugins, in seconden.

Standaard: Timeout
Bereik: 1-30

RefreshActiveChecks

Hoe vaak de lijst met actieve checks wordt vernieuwd, in seconden. Houd er rekening mee dat na een mislukte poging om actieve checks te vernieuwen, de volgende vernieuwing over 60 seconden zal worden geprobeerd.

Standaard: 5
Bereik: 1-86400

Server

Een lijst van komma-gescheiden IP-adressen, optioneel in CIDR-notatie, of DNS-namen van Zabbix-servers of Zabbix-proxies. 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. Spaties zijn toegestaan.

Voorbeeld:

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

Verplicht: ja

ServerActive

Het IP-adres of de DNS-naam van de Zabbix-server/proxy of de configuratie van een cluster om actieve checks van te ontvangen. Het adres van de server/proxy is een IP-adres of een DNS-naam en een optionele poort, gescheiden door een dubbele punt.
De 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 mag niet meer dan één Zabbix-proxy worden opgegeven. Als een Zabbix-proxy wordt opgegeven, mag de Zabbix-server/cluster voor die proxy niet worden opgegeven.
Meerdere komma-gescheiden adressen kunnen worden opgegeven om meerdere onafhankelijke Zabbix-servers parallel te gebruiken. Spaties zijn toegestaan.
Als de poort niet wordt opgegeven, wordt de standaard poort gebruikt.
IPv6-adressen moeten worden ingesloten in vierkante haken als er een poort voor dat host is opgegeven. Als de poort niet wordt opgegeven, zijn vierkante haken voor IPv6-adressen optioneel.
Als deze parameter niet wordt opgegeven, zijn actieve checks 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

Bron-IP

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

StatusPort

Indien ingesteld, luistert de agent op deze poort voor HTTP-statusverzoeken (http://localhost:<poort>/status).

Bereik: 1024-32767

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

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

TLSCAFile

Het volledige pad naar het bestand met de top-level CA(s) 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.

TLSCipherAll13

The OpenSSL cipher string (TLS 1.3). Override the default ciphersuite selection criteria for certificate- and PSK-based encryption.

Example:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

This parameter is supported since Zabbix 7.0.4.

TLSCipherCert13

The OpenSSL cipher string (TLS 1.3). Override the default ciphersuite selection criteria for certificate-based encryption.

Note that this parameter cannot be used together with TLSAccept=cert,psk; for certificate connection (TLSConnect=cert) use TLSCipherAll13 instead.

This parameter is supported since Zabbix 7.0.4.

TLSCipherPSK13

The OpenSSL cipher string (TLS 1.3). Override the default ciphersuite selection criteria for PSK-based encryption.

Example:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

This parameter is supported since Zabbix 7.0.4.

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