Documentation

#4 Zabbix-agent 2 (UNIX)

Overzicht

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

De parameters die worden ondersteund door het configuratiebestand van Zabbix agent 2 (zabbix_agent2.conf) staan vermeld in deze sectie.

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

erverCertIssuer](#tlsservercertissuer) | De toegestane uitgever van het server (proxy) certificaat. | | TLSServerCertSubject | Het toegestane onderwerp van het server (proxy) certificaat. | | UnsafeUserParameters | Sta alle tekens toe om te worden doorgegeven als argumenten voor door de gebruiker gedefinieerde parameters. | | UserParameter | Een door de gebruiker gedefinieerde parameter om te controleren. | | UserParameterDir | Het standaard zoekpad voor door de gebruiker gedefinieerde parameteropdrachten. |

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

Merk op dat:

• De standaardwaarden weerspiegelen processtandaarden, 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 sleutel. Er kunnen meerdere Alias parameters aanwezig zijn. Meerdere parameters met dezelfde Alias sleutel zijn niet toegestaan. Verschillende Alias sleutels kunnen verwijzen naar dezelfde item sleutel. Aliassen kunnen worden gebruikt in HostMetadataItem, maar niet in de HostnameItem parameter.

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 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 in procenten op te halen met standaardparameters, evenals cpu.util[all, idle, avg15] te gebruiken om specifieke gegevens over CPU-gebruik op te halen.

Voorbeeld 3: Het uitvoeren van meerdere laag-niveau ontdekking regels die dezelfde ontdekkingselementen 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, 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 "*" karakter ondersteunt om een willekeurig aantal willekeurige tekens te matchen.
Meerdere regels voor het matchen van sleutels kunnen worden gedefinieerd in combinatie met DenyKey. De parameters worden één voor één verwerkt volgens hun verschijningsvolgorde. Zie ook: Beperken van agentcontroles.

BufferSend

De tijdsinterval in seconden die bepaalt hoe vaak waarden van de buffer naar de Zabbix-server worden verzonden. Houd er rekening mee dat als de buffer vol is, de gegevens eerder worden verzonden.

Standaard: 5
Bereik: 1-3600

BufferSize

Het maximale aantal waarden in de geheugenbuffer. De agent stuurt alle verzamelde gegevens naar de Zabbix-server of proxy als de buffer vol is. Deze parameter moet alleen worden gebruikt als de persistente buffer is uitgeschakeld (EnablePersistentBuffer=0).

Standaard: 100
Bereik: 2-65535

ControlSocket

De beheersocket, gebruikt om runtime-opdrachten te verzenden met de '-R' optie.

Standaard: /tmp/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 debugging (genereert veel informatie);
5 - uitgebreide debugging (genereert nog meer informatie).

Standaard: 3
Bereik: 0-5

DenyKey

Verbied de uitvoering van de item-sleutels die overeenkomen met een patroon. Het sleutelpatroon is een wildcard-uitdrukking die het "*" karakter ondersteunt om een willekeurig aantal willekeurige tekens te matchen.
Er kunnen meerdere regels voor het overeenkomen van sleutels worden gedefinieerd in combinatie met AllowKey. De parameters worden één voor één verwerkt op basis van hun verschijningsvolgorde. Zie ook: Beperken van agentcontroles.

EnablePersistentBuffer

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

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

ForceActiveChecksOnStart

Voer direct na de herstart actieve controles uit 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 heartbeat-berichten in seconden. Gebruikt om de beschikbaarheid van actieve controles te monitoren.
0 - heartbeat-berichten uitgeschakeld.

Standaard: 60
Bereik: 0-3600

HostInterface

Een optionele parameter die de hostinterface definieert. De hostinterface wordt gebruikt bij het autoregistratieproces van de host autoregistration. 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 proces van automatische hostregistratie. Indien niet gedefinieerd, wordt de waarde overgenomen van HostMetadataItem.
De agent geeft een fout uit en start niet als de opgegeven waarde de limiet van 2034 bytes overschrijdt of als het een niet-UTF-8-tekenreeks 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.

Hostnaam

Een lijst van door komma's gescheiden, unieke, hoofdlettergevoelige hostnamen. Vereist voor actieve controles en moet overeenkomen met 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 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

Inclusie

U kunt afzonderlijke bestanden of alle bestanden in een map opnemen in het configuratiebestand. Tijdens de installatie zal Zabbix de inclusiemap aanmaken in /usr/local/etc, tenzij deze is gewijzigd tijdens de compilatie. Het pad kan relatief zijn aan de locatie van het bestand zabbix_agent2.conf.
Om alleen relevante bestanden in de opgegeven map op te nemen, wordt het asterisk-wildcardteken ondersteund voor patroonherkenning.
Zie speciale opmerkingen over beperkingen.

Voorbeeld:

Include=/absoluut/pad/naar/config/bestanden/*.conf

LuisterIP

Een lijst van 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 van actieve controles op te halen.

Standaard: 0.0.0.0

LuisterPoort

De agent zal luisteren op deze poort voor verbindingen vanaf de server.

Standaard: 10050
Bereik: 1024-32767

LogBestand

De naam van het logbestand.

Standaard: /tmp/zabbix_agent2.log
Verplicht: Ja, als LogType is ingesteld op file; anders nee

LogBestandGrootte

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

Standaard: 1
Bereik: 0-1024

LogType

Het type loguitvoer:
file - schrijf log naar het bestand dat is gespecificeerd door de parameter LogBestand;
system - schrijf log naar syslog;
console - schrijf log naar standaard uitvoer

Standaard: file

PersistentBufferBestand

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

PersistentBufferPeriode

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

Standaard: 1u
Bereik: 1m-365d

PidBestand

De naam van het PID-bestand.

Standaard: /tmp/zabbix_agent2.pid

Plugins.<PluginName>.System.Capacity

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

Standaard: 1000 Bereik: 1-1000

Plugins.Log.MaxRegelsPerSeconde

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 wordt overschreven door de 'maxlines'-parameter die is opgegeven in de sleutel van het 'log' en 'logrt'-item.
Opmerking: Zabbix zal 10 keer meer nieuwe regels verwerken dan ingesteld in MaxRegelsPerSeconde om de vereiste tekenreeks in logitems te zoeken.

Standaard: 20
Bereik: 1-1000

Plugins.SystemRun.LogExternUitgevoerdeOpdrachten

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

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

PluginSocket

Het pad naar de UNIX-socket voor communicatie met laadbare plug-ins.

Standaard: /tmp/agent.plugin.sock

PluginTimeout

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

Standaard: Timeout
Bereik: 1-30

VernieuwActieveControles

Hoe vaak de lijst met actieve controles wordt vernieuwd, in seconden. Merk op dat na een mislukte poging om actieve controles te vernieuwen, 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 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

ServerActief

Het adres van de Zabbix-server/-proxy of clusterconfiguratie om actieve controles van te verkrijgen. Het adres van de server/proxy is een IP-adres of DNS-naam en optionele poort gescheiden door een dubbele punt.
De clusterconfiguratie is één of meer serveradressen gescheiden door een puntkomma. Er kunnen meerdere Zabbix-servers/clusters en Zabbix-proxies worden gespecificeerd, gescheiden door een komma. Er mag niet meer dan één Zabbix-proxy worden gespecificeerd vanuit elke 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 opgegeven, wordt de standaardpoort gebruikt.
IPv6-adressen moeten tussen vierkante haken worden geplaatst als de 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:

ServerActief=127.0.0.1:10051

Voorbeeld voor meerdere servers:

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

Voorbeeld voor hoge beschikbaarheid:

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

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

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

StatusPoort

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

Bereik: 1024-32767

Time-out

Besteed niet meer dan Timeout seconden aan verwerking.

Standaard: 3
Bereik: 1-30

TLSAccepteren

De binnenkomende verbindingen om te accepteren. 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 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 verbinding); anders nee

TLSCABestand

Het volledige pad naar het bestand met de top-level CA-certificaten voor verificatie van peer-certificaten, gebruikt voor versleutelde communicatie tussen Zabbix-componenten.

TLSCertBestand

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

TLSCipherAll

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

Example:

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

This parameter is supported since Zabbix 7.0.4.

TLSCipherAll13

The OpenSSL cipher string (TLS 1.3) for OpenSSL 1.1.1 or newer. 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.

TLSCipherCert

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

Example:

EECDH+aRSA+AES128:RSA+aRSA+AES128

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

This parameter is supported since Zabbix 7.0.4.

TLSCipherCert13

The OpenSSL cipher string (TLS 1.3) for OpenSSL 1.1.1 or newer. 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.

TLSCipherPSK

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

Example:

kECDHEPSK+AES128:kPSK+AES128

This parameter is supported since Zabbix 7.0.4.

TLSCipherPSK13

The OpenSSL cipher string (TLS 1.3) for OpenSSL 1.1.1 or newer. 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.

TLSVerbinden

Hoe de agent verbinding moet maken met de Zabbix-server of proxy. Gebruikt voor actieve controles. Slechts één waarde kan worden opgegeven:
unencrypted - maak verbinding zonder versleuteling (standaard)
psk - maak verbinding via TLS met een vooraf gedeelde sleutel (PSK)
cert - maak verbinding via TLS met een certificaat

Verplicht: ja, als TLS-certificaat- of PSK-parameters zijn gedefinieerd (zelfs voor 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