3 Zabbix agent (UNIX)

Overzicht

De parameters die worden ondersteund door het configuratiebestand van de Zabbix-agent (zabbix_agentd.conf) worden in dit gedeelte 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 weerspiegelen standaard daemon-instellingen, 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.
Er kunnen meerdere Alias parameters 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 de parameter HostnameItem.

Voorbeeld 1: Het ophalen van het ID van de gebruiker 'zabbix'.

Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]

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

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

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

Dit maakt het mogelijk om de sleutel cpu.util te gebruiken om het CPU-gebruik als percentage te verkrijgen met standaardparameters, evenals cpu.util[all, idle, avg15] te gebruiken om specifieke gegevens over CPU-gebruik te verkrijgen.

Voorbeeld 3: Het uitvoeren van meerdere laag-niveau ontdekking regels 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], enz.

AllowKey

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

AllowRoot

Sta toe dat de agent wordt uitgevoerd als 'root'. Indien uitgeschakeld en de agent wordt gestart door 'root', zal de agent proberen over te schakelen naar gebruiker 'zabbix'. Heeft geen effect als het wordt gestart onder een reguliere gebruiker.

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

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 voor het ophalen van hostmetadata. 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 (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 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. 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=/absoluut/pad/naar/configuratie/bestanden/*.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

LoadModule

De module die wordt geladen bij het starten van de agent. Modules worden gebruikt om de functionaliteit van de agent uit te breiden. De module moet zich bevinden in de map die is gespecificeerd door LoadModulePath of het pad moet voorafgaan aan de modulenaam. Als het voorafgaande pad absoluut is (begint met '/'), wordt LoadModulePath genegeerd.
Indelingen:
LoadModule=<module.so>
LoadModule=<pad/module.so>
LoadModule=</abs_path/module.so>
Het is toegestaan om meerdere LoadModule parameters op te nemen.

LoadModulePath

Het volledige pad naar de locatie van agent-modules. De standaardwaarde is afhankelijk van de compilatieopties.

LogFile

De naam van het logbestand.

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

LogRemoteCommands

Schakel logging in van de 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 de LogFile parameter;
system - schrijf log naar syslog;
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' en 'logrt' actieve controles. De opgegeven waarde zal worden overschreven door de 'maxlines' parameter, opgegeven in de 'log' of 'logrt' item sleutel.
Let op: Zabbix zal 10 keer meer nieuwe regels verwerken dan ingesteld in MaxLinesPerSecond om de vereiste string in log-items te zoeken.

Standaard: 20
Bereik: 1-1000

PidFile

De naam van het PID-bestand.

Standaard: /tmp/zabbix_agentd.pid

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 door komma's gescheiden IP-adressen, optioneel in CIDR-notatie, of DNS-namen van Zabbix-servers en 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' staat elk IPv4- of IPv6-adres toe. '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. 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 ontvangen. Het server/proxy adres is een IP-adres of DNS-naam en optionele poort gescheiden door een dubbele punt.
Clusterconfiguratie is één of meerdere serveradressen gescheiden door een puntkomma. Er kunnen meerdere Zabbix servers/clusters en Zabbix proxies worden gespecificeerd, gescheiden door een komma. Er moet niet meer dan één Zabbix proxy worden gespecificeerd vanuit elk Zabbix server/cluster. Als een Zabbix proxy is gespecificeerd, mag de Zabbix server/cluster voor die proxy niet worden gespecificeerd.
Er kunnen meerdere door komma's gescheiden adressen worden opgegeven om meerdere onafhankelijke Zabbix servers parallel te gebruiken. Spaties zijn toegestaan.
Als de poort niet is gespecificeerd, wordt de standaardpoort gebruikt.
IPv6-adressen moeten worden ingesloten in vierkante haken als de poort voor die host is gespecificeerd. Als de poort niet is gespecificeerd, zijn vierkante haken voor IPv6-adressen optioneel.
Als deze parameter niet is gespecificeerd, 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

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

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

Standaard: 3
Bereik: 0-100

Timeout

Besteed niet meer dan Timeout seconden aan verwerking.

Standaard: 3
Bereik: 1-30

TLSAccept

Welke inkomende verbindingen moeten worden geaccepteerd. Gebruikt voor passieve controles. Er kunnen meerdere waarden worden opgegeven, gescheiden door een komma:
unencrypted - accepteer verbindingen zonder versleuteling (standaard)
psk - accepteer verbindingen met TLS en een pre-shared key (PSK)
cert - accepteer verbindingen met TLS en een certificaat

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

TLSCAFile

Het volledige pad naar het bestand dat de CA-certificaten van het hoogste niveau bevat voor verificatie van peer-certificaten, gebruikt voor versleutelde communicatie tussen Zabbix-componenten.

TLSCertFile

Het volledige pad naar het bestand dat het agentcertificaat of de certificaatketen bevat, gebruikt voor versleutelde communicatie met Zabbix-componenten.

TLSCipherAll

De GnuTLS-prioriteitsreeks of OpenSSL (TLS 1.2) cipher-string. Overschrijft de standaard selectiecriteria voor ciphersuites voor certificaat- en PSK-gebaseerde versleuteling.

Voorbeeld:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSCipherAll13

De ciphersuite-string voor OpenSSL 1.1.1 of nieuwer in TLS 1.3. Overschrijft de standaard selectiecriteria voor ciphersuites voor certificaat- en PSK-gebaseerde versleuteling.

Voorbeeld voor GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509

Voorbeeld voor OpenSSL:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128

TLSCipherCert

De GnuTLS-prioriteitsreeks of OpenSSL (TLS 1.2) cipher-string. Overschrijft de standaard selectiecriteria voor ciphersuites voor certificaatgebaseerde versleuteling.

Voorbeeld voor GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509

Voorbeeld voor OpenSSL:

EECDH+aRSA+AES128:RSA+aRSA+AES128

TLSCipherCert13

De ciphersuite-string voor OpenSSL 1.1.1 of nieuwer in TLS 1.3. Overschrijft de standaard selectiecriteria voor ciphersuites voor certificaatgebaseerde versleuteling.

TLSCipherPSK

De GnuTLS-prioriteitsreeks of OpenSSL (TLS 1.2) cipher-string. Overschrijft de standaard selectiecriteria voor ciphersuites voor PSK-gebaseerde versleuteling.

Voorbeeld voor GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL

Voorbeeld voor OpenSSL:

kECDHEPSK+AES128:kPSK+AES128

TLSCipherPSK13

De ciphersuite-string voor OpenSSL 1.1.1 of nieuwer in TLS 1.3. Overschrijft de standaard selectiecriteria voor ciphersuites voor PSK-gebaseerde versleuteling.

Voorbeeld:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

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

User

Verlaag de privileges naar een specifieke, bestaande gebruiker op het systeem.
Heeft alleen effect als het wordt uitgevoerd als 'root' en AllowRoot is uitgeschakeld.

Standaard: zabbix

UserParameter

Een door de gebruiker gedefinieerde parameter om te monitoren. Er kunnen verschillende door de gebruiker gedefinieerde parameters zijn.
Indeling: 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