Table of Contents
3 Zabbix agent (UNIX)
Overzicht
In deze sectie worden parameters vermeld die worden ondersteund in een Zabbix-agent configuratie bestand (zabbix_agentd.conf). Let daar op:
- De standaardwaarden weerspiegelen de standaardinstellingen van de daemon, niet de waarden in de verzonden configuratiebestanden;
- Zabbix ondersteunt configuratiebestanden alleen in UTF-8-codering zonder BOM;
- Opmerkingen die beginnen met "#" worden alleen ondersteund aan het begin van de lijn.
Parameters
| Parameter | Verplicht | Bereik | Standaard | Omschrijving |
|---|---|---|---|---|
| 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 kleinere en eenvoudigere sleutel. 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 parameters. Voorbeelden: 1. Het ophalen van het ID van 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. 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-gebruikpercentage te verkrijgen met standaard parameters, evenals het gebruik van cpu.util[all, idle, avg15] om specifieke gegevens over CPU-gebruik te verkrijgen. 3. Uitvoeren van meerdere low-level discovery regels die dezelfde ontdekkingsitems verwerken. Alias=vfs.fs.discovery[*]:vfs.fs.discovery Het is nu mogelijk om meerdere 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 | nee | Toestaan uitvoering van die item sleutels die overeenkomen met een patroon. Sleutelpatroon is een wildcard expressie die het "*" teken ondersteunt om overeen te komen met een willekeurig aantal tekens. Meerdere regels voor sleutelovereenkomst kunnen worden gedefinieerd in combinatie met DenyKey. De parameters worden één voor één verwerkt volgens hun verschijningsvolgorde. Deze parameter wordt ondersteund sinds Zabbix 5.0.0. Zie ook: Beperken van agent checks. |
||
| AllowRoot | nee | 0 | Laat de agent draaien als 'root'. Als dit is uitgeschakeld en de agent wordt gestart door 'root', zal de agent proberen over te schakelen naar de gebruiker 'zabbix'. Heeft geen effect als het wordt gestart onder een reguliere gebruiker. 0 - niet toestaan 1 - toestaan |
|
| BufferSend | nee | 1-3600 | 5 | Houd gegevens niet langer in de buffer dan N seconden. |
| 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 debugniveau: 0 - basisinformatie over het starten en stoppen van Zabbix-processen 1 - kritieke informatie 2 - foutinformatie 3 - waarschuwingen 4 - voor debuggen (genereert veel informatie) 5 - uitgebreid debuggen (genereert nog meer informatie) |
| DenyKey | nee | Weiger de uitvoering van die item sleutels die overeenkomen met een patroon. Sleutelpatroon is een wildcard expressie die het "*" teken ondersteunt om overeen te komen met een willekeurig aantal tekens. Meerdere regels voor sleutelovereenkomst kunnen worden gedefinieerd in combinatie met AllowKey. De parameters worden één voor één verwerkt volgens hun verschijningsvolgorde. Deze parameter wordt ondersteund sinds Zabbix 5.0.0. Zie ook: Beperken van agent checks. |
||
| EnableRemoteCommands | nee | 0 | Of externe commando's 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 hostinterface definieert. Hostinterface wordt gebruikt bij het autoregistratie proces van de host. De agent geeft een foutmelding en start niet als de waarde de limiet van 255 tekens overschrijdt. Indien niet gedefinieerd, wordt de waarde verkregen van HostInterfaceItem. Ondersteund sinds Zabbix 4.4.0. |
|
| HostInterfaceItem | nee | Optionele parameter die een item definieert dat wordt gebruikt om de hostinterface op te halen. Hostinterface wordt gebruikt bij het autoregistratie proces van de host. Tijdens een autoregistratieverzoek zal een agent een waarschuwingsbericht registreren als de waarde die wordt teruggegeven door het gespecificeerde item de limiet van 255 tekens overschrijdt. Het systeem.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 hostmetadata definieert. Hostmetadata wordt alleen gebruikt bij het autoregistratieproces van de host (actieve agent). Indien niet gedefinieerd, wordt de waarde verkregen van HostMetadataItem. Een agent geeft een foutmelding en start niet als de gespecificeerde 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 hostmetadata op te halen. Deze optie wordt alleen gebruikt wanneer HostMetadata niet is gedefinieerd. Ondersteunt UserParameters en aliassen. Ondersteunt system.run[] ongeacht de waarden van AllowKey/DenyKey. HostMetadataItem-waarde wordt opgehaald bij elke poging tot autoregistratie en wordt alleen gebruikt bij het autoregistratieproces van de host (actieve agent). Tijdens een autoregistratieverzoek zal een agent een waarschuwingsbericht registreren als de waarde die wordt teruggegeven 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, hoofdlettergevoelige hostnamen, gescheiden door komma's. Vereist voor actieve controles en moet overeenkomen met de hostnamen zoals geconfigureerd op de server. De waarde wordt overgenomen van HostnameItem indien niet gedefinieerd. Toegestane tekens: alfanumeriek, '.', ' ', '_' en '-'. Maximale lengte: 128 tekens per hostnaam, 2048 tekens voor de hele regel. |
|
| HostnameItem | nee | system.hostname | Optionele parameter die een Zabbix agent item definieert dat wordt gebruikt om de hostnaam op te halen. Deze optie wordt alleen gebruikt wanneer Hostname niet is gedefinieerd. Ondersteunt geen UserParameters of aliassen, maar ondersteunt wel system.run[] ongeacht de waarden van AllowKey/DenyKey. De uitvoerlengte is beperkt tot 512 KB. |
|
| Include | nee | U kunt individuele bestanden of alle bestanden in een directory opnemen in het configuratiebestand. Om alleen relevante bestanden in de opgegeven directory op te nemen, wordt het asterisk-wildcardteken ondersteund voor patroonherkenning. Bijvoorbeeld: /absolute/path/to/config/files/*.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 die afhankelijk is 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. Meerdere IP-adressen worden ondersteund in versie 1.8.3 en hoger. |
|
| ListenPort | nee | 1024-32767 | 10050 | De agent zal op deze poort luisteren voor verbindingen van de server. |
| LoadModule | nee | Module om te laden bij het opstarten van de agent. Modules worden gebruikt om de functionaliteit van de agent uit te breiden. Formaten: LoadModule=<module.so> LoadModule=<path/module.so> LoadModule=</abs_path/module.so> De module moet zich bevinden in de directory die is gespecificeerd door LoadModulePath, of het pad moet voorafgaan aan de modulenaam. Als het voorafgaande pad absoluut is (begint met '/'), wordt LoadModulePath genegeerd. Het is toegestaan om meerdere LoadModule parameters op te nemen. |
||
| LoadModulePath | nee | Volledig pad naar de locatie van agentmodules. De standaardwaarde hangt af van de compilatieopties. |
||
| LogFile | ja, indien LogType is ingesteld op file, anders nee |
Naam van het logbestand. | ||
| 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 wordt bereikt en het draaien van het bestand mislukt om welke reden dan ook, wordt het bestaande logbestand ingekort en opnieuw gestart. |
| LogType | nee | file | Type loguitvoer: file - log schrijven naar bestand gespecificeerd door de parameter LogFile, system - log schrijven naar syslog, console - log schrijven naar standaard uitvoer. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
|
| LogRemoteCommands | nee | 0 | Logboekregistratie van uitgevoerde shell-opdrachten inschakelen als waarschuwingen. 0 - uitgeschakeld 1 - ingeschakeld Opdrachten worden alleen gelogd als ze op afstand worden uitgevoerd. Logvermeldingen worden niet gemaakt als system.run[] lokaal wordt gestart door HostMetadataItem, HostInterfaceItem of HostnameItem parameters. |
|
| MaxLinesPerSecond | nee | 1-1000 | 20 | Maximaal aantal nieuwe regels dat de agent per seconde naar Zabbix-server of -proxy zal sturen bij het verwerken van 'log' en 'eventlog' actieve controles. De opgegeven waarde wordt overschreven door de parameter 'maxlines', verstrekt in 'log' of 'eventlog' item sleutel. Opmerking: Zabbix zal 10 keer meer nieuwe regels verwerken dan ingesteld in MaxLinesPerSecond om de vereiste tekenreeks in logitems te zoeken. |
| PidFile | nee | /tmp/zabbix_agentd.pid | Naam van het PID-bestand. | |
| RefreshActiveChecks | nee | 60-3600 | 120 | Hoe vaak de lijst met actieve controles wordt vernieuwd, in seconden. Let op: na het niet kunnen vernieuwen van actieve controles wordt de volgende vernieuwing geprobeerd na 60 seconden. |
| Server | ja, indien StartAgents niet expliciet is ingesteld op 0 | Lijst van IP-adressen, optioneel in CIDR-notatie, of DNS-namen van Zabbix-servers en Zabbix-proxies, gescheiden door komma's. 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 afgeraden door 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 clusterconfiguratie om actieve controles van te krijgen. Server/proxy-adres is een IP-adres of DNS-naam en optionele poort gescheiden door een dubbele punt. Clusterconfiguratie is een of meer serveradressen gescheiden door een puntkomma. Meerdere Zabbix-servers/clusters en Zabbix-proxies kunnen worden gespecificeerd, gescheiden door een komma. Vanuit elke Zabbix-server/cluster mag niet meer dan één Zabbix-proxy worden gespecificeerd. 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 gespecificeerd, wordt de standaardpoort gebruikt. IPv6-adressen moeten tussen vierkante haken worden geplaatst als de poort voor dat host is gespecificeerd. Als de poort niet is gespecificeerd, zijn vierkante haken voor IPv6-adressen optioneel. Als deze parameter niet is gespecificeerd, worden 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 bepaalde items (web.page.get, net.tcp.port, etc.) |
||
| StartAgents | nee | 0-100 | 3 | Aantal voorgevorkte instanties van zabbix_agentd die passieve controles verwerken. Als ingesteld op 0, worden passieve controles uitgeschakeld en luistert de agent niet op een TCP-poort. |
| Timeout | nee | 1-30 | 3 | Besteed niet meer dan Timeout seconden aan verwerking. |
| TLSAccept | ja, indien TLS-certificaat of PSK-parameters zijn gedefinieerd (zelfs voor ongecodeerde verbinding), anders nee | Welke inkomende verbindingen te accepteren. Gebruikt voor passieve controles. Meerdere waarden kunnen worden gespecificeerd, 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 Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSCAFile | nee | Volledig pad naar een bestand met de top-level CA-certificaten voor verificatie van peer-certificaten, gebruikt voor versleutelde communicatie tussen Zabbix-componenten. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSCertFile | nee | Volledig pad naar een bestand met het agentcertificaat of certificaatketen, gebruikt voor versleutelde communicatie met Zabbix-componenten. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSCipherAll | nee | GnuTLS-prioriteitstekenreeks of OpenSSL (TLS 1.2) cijfertekenreeks. Overschrijft de standaard selectiecriteria voor cijfers voor certificaat- en PSK-gebaseerde versleuteling. Voorbeeld: TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 Deze parameter wordt ondersteund sinds Zabbix 4.4.7. |
||
| TLSCipherAll13 | nee | Cijfertekenreeks voor OpenSSL 1.1.1 of nieuwer in TLS 1.3. Overschrijft de standaard selectiecriteria voor cijfers 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 Deze parameter wordt ondersteund sinds Zabbix 4.4.7. |
||
| TLSCipherCert | nee | GnuTLS-prioriteitstekenreeks of OpenSSL (TLS 1.2) cijfertekenreeks. Overschrijft de standaard selectiecriteria voor cijfers 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 Deze parameter wordt ondersteund sinds Zabbix 4.4.7. |
||
| TLSCipherCert13 | nee | Cijfertekenreeks voor OpenSSL 1.1.1 of nieuwer in TLS 1.3. Overschrijft de standaard selectiecriteria voor cijfers voor certificaatgebaseerde versleuteling. Deze parameter wordt ondersteund sinds Zabbix 4.4.7. |
||
| TLSCipherPSK | nee | GnuTLS-prioriteitstekenreeks of OpenSSL (TLS 1.2) cijfertekenreeks. Overschrijft de standaard selectiecriteria voor cijfers 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 Deze parameter wordt ondersteund sinds Zabbix 4.4.7. |
||
| TLSCipherPSK13 | nee | Cijfertekenreeks voor OpenSSL 1.1.1 of nieuwer in TLS 1.3. Overschrijft de standaard selectiecriteria voor cijfers voor PSK-gebaseerde versleuteling. Voorbeeld: TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 Deze parameter wordt ondersteund sinds Zabbix 4.4.7. |
||
| TLSConnect | ja, als TLS-certificaat- of PSK-parameters zijn gedefinieerd (zelfs voor niet-versleutelde verbinding), anders nee | Hoe de agent verbinding moet maken met Zabbix-server of -proxy. Gebruikt voor actieve checks. Slechts één waarde kan worden opgegeven: unencrypted - verbinden zonder versleuteling (standaard) psk - verbinden via TLS en een pre-shared key (PSK) cert - verbinden via TLS en een certificaat Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSCRLFile | nee | Volledig pad naar 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 | Volledig pad naar 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 | Volledig pad naar een bestand met de pre-shared key van de agent die wordt gebruikt voor versleutelde communicatie met Zabbix-componenten. Deze parameter wordt ondersteund sinds Zabbix 3.0.0. |
||
| TLSPSKIdentity | nee | Identiteitsreeks voor pre-shared key, 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 voor door gebruiker gedefinieerde parameters. 0 - niet toestaan 1 - toestaan De volgende tekens zijn niet toegestaan: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ Bovendien zijn nieuwe regeltekens niet toegestaan. |
| User | nee | zabbix | Verminder de rechten tot een specifieke, bestaande gebruiker op het systeem. Heeft alleen effect als het wordt uitgevoerd als 'root' en AllowRoot is uitgeschakeld. |
|
| UserParameter | nee | Door de gebruiker gedefinieerde parameter om te controleren. Er kunnen verschillende door de gebruiker gedefinieerde parameters zijn. Formaat: 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. 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 de hier gespecificeerde map voordat hij een opdracht uitvoert. Hierdoor kunnen UserParameter-opdrachten een relatief ./-voorvoegsel hebben in plaats van een volledig pad.Er is slechts één invoer toegestaan. Voorbeeld: UserParameterDir=/opt/myscripts |