Table of Contents
1 Zabbix agent
Overzicht
Deze controles maken gebruik van communicatie met de Zabbix-agent voor het verzamelen van gegevens.
Er zijn passieve en actieve agentcontroles. Bij het configureren van een item kun je het vereiste type selecteren:
- Zabbix-agent - voor passieve controles
- Zabbix-agent (actief) - voor actieve controles
Ondersteunde item sleutels
De tabel geeft details over de item sleutels die je kunt gebruiken met Zabbix-agent items, gegroepeerd op basis van de item familie.
Zie ook:
- Items ondersteund per platform
- Item sleutels ondersteund door Zabbix-agent 2
- Item sleutels specifiek voor de Windows agent
- Minimale toestemmingsniveaus voor Windows agent items
Verplichte en optionele parameters
Parameters zonder hoekige haken zijn verplicht. Parameters gemarkeerd met hoekige haken < > zijn optioneel.
Gebruik met command-line hulpprogramma's
Let op dat bij het testen of gebruiken van item sleutels met zabbix_agentd of zabbix_get vanaf de opdrachtregel ook de shell-syntax moet worden overwogen.
Bijvoorbeeld, als een bepaalde parameter van de sleutel moet worden ingesloten in dubbele aanhalingstekens, moet je dubbele aanhalingstekens expliciet escapen. Anders worden ze door de shell als speciale tekens afgekapt en worden ze niet doorgegeven aan het Zabbix-hulpprogramma.
Voorbeelden:
zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'
zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]Zabbix-metrieken
| Item sleutel | |||
|---|---|---|---|
| Omschrijving | Teruggegeven waarde | Parameters | Opmerkingen |
| agent.hostmetadata | |||
| Metadata van host van agent. | Tekenreeks | Geeft de waarde van de parameters HostMetadata of HostMetadataItem terug, of een lege tekenreeks als er geen zijn gedefinieerd. Ondersteund sinds Zabbix 6.0. |
|
| agent.hostname | |||
| Naam van host van agent. | Tekenreeks | Geeft terug: Als passieve controle - de naam van de eerste host vermeld in de Hostname-parameter van het configuratiebestand van de agent; Als actieve controle - de naam van de huidige hostnaam. |
|
| agent.ping | |||
| Beschikbaarheidscontrole van agent. | Niets - niet beschikbaar 1 - beschikbaar |
Gebruik de nodata() triggerfunctie om te controleren op de onbeschikbaarheid van een host. | |
| agent.variant | |||
| Variant van Zabbix-agent (Zabbix-agent of Zabbix-agent 2). | Geheel getal | Voorbeeld van teruggegeven waarde: 1 - Zabbix-agent 2 - Zabbix-agent 2 |
|
| agent.version | |||
| Versie van Zabbix-agent. | Tekenreeks | Voorbeeld van teruggegeven waarde: 6.0.3 |
|
| zabbix.stats[<ip>,<port>] | |||
| Geef een set interne metrieken van Zabbix-server of -proxy op afstand terug. | JSON-object | ip - IP/DNS/netwerkmaskerlijst van servers/proxies die op afstand moeten worden bevraagd (standaard is 127.0.0.1) port - poort van server/proxy die op afstand moet worden bevraagd (standaard is 10051) |
Merk op dat het verzoek om statistieken alleen wordt geaccepteerd vanaf de adressen die zijn vermeld in de 'StatsAllowedIP' server/proxy-parameter op de doelinstantie. Een geselecteerde set interne metrieken wordt door dit item geretourneerd. Zie voor details Extern controleren van Zabbix-statistieken. |
| zabbix.stats[<ip>,<port>,queue,<from>,<to>] | |||
| Geef het aantal bewaakte items in de wachtrij die vertraagd zijn op de Zabbix-server of -proxy op afstand terug. | JSON-object | ip - IP/DNS/netwerkmaskerlijst van servers/proxies die op afstand moeten worden bevraagd (standaard is 127.0.0.1) port - poort van server/proxy die op afstand moet worden bevraagd (standaard is 10051) queue - constante (zoals gebruikt moet worden) from - vertraagd met minstens (standaard is 6 seconden) to - vertraagd met hoogstens (standaard is oneindig) |
Merk op dat het verzoek om statistieken alleen wordt geaccepteerd vanaf de adressen die zijn vermeld in de 'StatsAllowedIP' server/proxy-parameter op de doelinstantie. |
Voetnoten
1 Een opmerking specifiek voor Linux. De Zabbix-agent moet alleen-leestoegang hebben tot het bestandssysteem /proc. Kernel-patches van www.grsecurity.org beperken de toegangsrechten van niet-geprivilegieerde gebruikers.
2 vfs.dev.read[], vfs.dev.write[]: De Zabbix-agent zal "verouderde" apparaatverbindingen beëindigen als de itemwaarden gedurende meer dan 3 uur niet worden benaderd. Dit kan gebeuren als een systeem apparaten heeft met dynamisch veranderende paden of als een apparaat handmatig wordt verwijderd. Houd er ook rekening mee dat deze items, als ze een bijwerkinterval van 3 uur of meer gebruiken, altijd '0' zullen retourneren.
3 vfs.dev.read[], vfs.dev.write[]: Als de standaardwaarde all wordt gebruikt voor de eerste parameter, zal de sleutel samenvattende statistieken retourneren, inclusief alle blokapparaten zoals sda, sdb en hun partities (sda1, sda2, sdb3...) en meerdere apparaten (MD-raid) gebaseerd op die blokapparaten/partities en logische volumes (LVM) gebaseerd op die blokapparaten/partities. In dergelijke gevallen moeten de geretourneerde waarden alleen als relatieve waarde worden beschouwd (dynamisch in de tijd), maar niet als absolute waarden.
4 SSL (HTTPS) wordt alleen ondersteund als de agent is gecompileerd met cURL-ondersteuning. Anders wordt het item niet ondersteund.
Instellingen voor codering
Om ervoor te zorgen dat de verkregen gegevens niet beschadigd raken, kunt u de juiste codering opgeven voor de verwerking van de controle (bijv. 'vfs.file.contents') in de encoding-parameter. De lijst met ondersteunde coderingen (codepagina-identificatoren) is te vinden in de documentatie voor libiconv (GNU Project) of in de documentatie van het Microsoft Windows SDK voor "Code Page Identifiers" (codepagina-identificatoren).
Als er geen codering wordt gespecificeerd in de encoding-parameter, worden de volgende oplossingsstrategieën toegepast:
- Als er geen codering is gespecificeerd (of als het een lege string is), wordt ervan uitgegaan dat het UTF-8 is en worden de gegevens "zoals ze zijn" verwerkt;
- BOM-analyse - van toepassing op items 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. Er wordt geprobeerd de juiste codering te bepalen door de byte order mark (BOM) aan het begin van het bestand te gebruiken. Als er geen BOM aanwezig is, wordt de standaardoplossing (zie hierboven) toegepast.
Problemen oplossen met agent items
- Bij gebruik met de passieve agent moet de Timeout-waarde in de serverconfiguratie mogelijk hoger zijn dan de Timeout in het configuratiebestand van de agent. Anders krijgt het item mogelijk geen waarde omdat het verzoek van de server aan de agent eerst time-out.
Kernelgegevens
| Item-sleutel | |||
|---|---|---|---|
| Omschrijving | Terugkeerwaarde | Parameters | Opmerkingen |
| kernel.maxfiles | |||
| Maximaal aantal geopende bestanden ondersteund door het besturingssysteem. | Geheel getal | ||
| kernel.maxproc | |||
| Maximaal aantal processen ondersteund door het besturingssysteem. | Geheel getal | ||
| kernel.openfiles | |||
| Geeft het aantal momenteel geopende bestandsdescriptoren terug. | Geheel getal | Deze item wordt ondersteund sinds Zabbix 6.0. | |
Loggegevens
Zie aanvullende informatie over logboekmonitoring.
| Item-sleutel | |||
|---|---|---|---|
| Omschrijving | Terugkeerwaarde | Parameters | Opmerkingen |
| log[bestand,<regexp>,<codering>,<maxlines>,<mode>,<output>,<maxdelay>,<opties>,<persistent_dir>] | |||
| Monitoring van een logboekbestand. | Log | bestand - volledig pad en naam van het logboekbestand regexp - reguliere expressie die het vereiste patroon beschrijft codering - codepagina identificatie maxlines - maximum aantal nieuwe regels per seconde dat de agent naar de Zabbix-server of -proxy zal sturen. Deze parameter overschrijft de waarde van 'MaxLinesPerSecond' in zabbix_agentd.conf mode (sinds versie 2.0) - mogelijke waarden: all (standaard), skip - overslaan van de verwerking van oudere gegevens (alleen van invloed op nieuw gemaakte items). output (sinds versie 2.2) - een optioneel uitvoerformatteringssjabloon. De \0-escape-sequentie wordt vervangen door het overeenkomende deel van de tekst (vanaf het eerste teken waar de overeenkomst begint tot het teken waar de overeenkomst eindigt), terwijl een \N-escape-sequentie (waarbij N=1...9) wordt vervangen door de Nde overeenkomende groep (of een lege tekenreeks als N groter is dan het aantal vastgelegde groepen). maxdelay (sinds versie 3.2) - maximale vertraging in seconden. Type: float. Waarden: 0 - (standaard) negeer nooit logboekregels; > 0,0 - negeer oudere regels om de meest recente regels te analyseren binnen "maxdelay" seconden. Lees de maxdelay opmerkingen voordat u deze gebruikt! opties (sinds versie 4.4.7) - aanvullende opties: mtime-noreread - niet-unieke records, alleen opnieuw lezen als de bestandsgrootte verandert (negeer wijzigingen in de modificatietijd). (Deze parameter is sinds 5.0.2 verouderd, omdat mtime nu wordt genegeerd.) persistent_dir (sinds versies 5.0.18, 5.4.9, alleen in zabbix_agentd op Unix-systemen; niet ondersteund in Agent2) - absoluut pad van het directory waar persistente bestanden moeten worden opgeslagen. Zie ook aanvullende opmerkingen over persistente bestanden. |
Het item moet worden geconfigureerd als een actieve controle. Als het bestand ontbreekt of de rechten geen toegang toestaan, wordt het item niet ondersteund. Als output leeg is gelaten - wordt de hele regel met de overeenkomende tekst geretourneerd. Let op dat alle globale reguliere expressietypen behalve 'Result is TRUE' altijd de hele overeenkomende regel retourneren en de output-parameter wordt genegeerd.Extractie van inhoud met behulp van de output-parameter vindt plaats op de agent.Voorbeelden: => log[/var/log/syslog] => log[/var/log/syslog,error] => log[/home/zabbix/logs/logfile,,,100] Gebruik van de output-parameter om een getal uit een logboekrecord te halen:=> log[/app1/app.log,"taak uitgevoerd [0-9.]+ sec, verwerkt ([0-9]+) records, [0-9]+ fouten",,,,\1] → zal een logboekrecord "2015-11-13 10:08:26 taak uitgevoerd 6,08 sec, verwerkt 6080 records, 0 fouten" matchen en alleen '6080' naar de server sturen. Omdat een numerieke waarde wordt verzonden, kan het "Type informatie" voor dit item worden ingesteld op "Numeriek (ongesigneerd)" en kan de waarde worden gebruikt in grafieken, triggers, enz. Gebruik van de output-parameter om een logboekrecord te herschrijven voordat het naar de server wordt verzonden:=> log[/app1/app.log,"([0-9 :-]+) taak uitgevoerd ([0-9.]+) sec, verwerkt ([0-9]+) records, ([0-9]+) fouten",,,,"\1 RECORDS: \3, FOUTEN: \4, DUUR: \2"] → zal een logboekrecord "2015-11-13 10:08:26 taak uitgevoerd 6,08 sec, verwerkt 6080 records, 0 fouten" matchen en een aangepast record "2015-11-13 10:08:26 RECORDS: 6080, FOUTEN: 0, DUUR: 6,08" naar de server sturen. |
| log.count[bestand,<regexp>,<codering>,<maxproclines>,<mode>,<maxdelay>,<opties>,<persistent_dir>] | |||
| Aantal overeenkomende regels in een gemonitord logboekbestand. | Geheel getal | bestand - volledig pad en naam van het logboekbestand regexp - reguliere expressie die het vereiste patroon beschrijft ** |
|
| codering** - codepagina identificatie maxproclines - maximum aantal nieuwe regels per seconde dat de agent zal analyseren (kan niet meer dan 10000 bedragen). De standaardwaarde is 10*'MaxLinesPerSecond' in zabbix_agentd.conf. mode - mogelijke waarden: all (standaard), skip - overslaan van de verwerking van oudere gegevens (alleen van invloed op nieuw gemaakte items). maxdelay - maximale vertraging in seconden. Type: float. Waarden: 0 - (standaard) negeer nooit logboekregels; > 0,0 - negeer oudere regels om de meest recente regels te analyseren binnen "maxdelay" seconden. Lees de maxdelay opmerkingen voordat u deze gebruikt! opties (sinds versie 4.4.7) - aanvullende opties: mtime-noreread - niet-unieke records, alleen opnieuw lezen als de bestandsgrootte verandert (negeer wijzigingen in de modificatietijd). (Deze parameter is sinds 5.0.2 verouderd, omdat mtime nu wordt genegeerd.) persistent_dir (sinds versies 5.0.18, 5.4.9, alleen in zabbix_agentd op Unix-systemen; niet ondersteund in Agent2) - absoluut pad van het directory waar persistente bestanden moeten worden opgeslagen. Zie ook aanvullende opmerkingen over persistente bestanden. |
Het item moet worden geconfigureerd als een actieve controle. Overeenkomende regels worden geteld in de nieuwe regels sinds de laatste logboekcontrole door de agent en zijn dus afhankelijk van het item-update-interval. Als het bestand ontbreekt of de rechten geen toegang toestaan, wordt het item niet ondersteund. Dit item wordt niet ondersteund voor het Windows Eventlog. Ondersteund sinds Zabbix 3.2.0. |
||
| logrt[bestand_regexp,<regexp>,<codering>,<maxlines>,<mode>,<output>,<maxdelay>,<opties>,<persistent_dir>] | |||
| Monitoring van een logboekbestand dat wordt geroteerd. | Log | bestand_regexp - absoluut pad naar het bestand en de bestandsnaam beschreven door een reguliere expressie. Let op dat alleen de bestandsnaam een reguliere expressie is regexp - reguliere expressie die het vereiste inhoudspatroon beschrijft codering - codepagina identificatie maxlines - maximum aantal nieuwe regels per seconde dat de agent naar de Zabbix-server of -proxy zal sturen. Deze parameter overschrijft de waarde van 'MaxLinesPerSecond' in zabbix_agentd.conf mode (sinds versie 2.0) - mogelijke waarden: all (standaard), skip - overslaan van de verwerking van oudere gegevens (alleen van invloed op nieuw gemaakte items). output (sinds versie 2.2) - een optioneel uitvoerformatteringssjabloon. De \0-escape-sequentie wordt vervangen door het overeenkomende deel van de tekst (vanaf het eerste teken waar de overeenkomst begint tot het teken waar de overeenkomst eindigt), terwijl een \N-escape-sequentie (waarbij N=1...9) wordt vervangen door de Nde overeenkomende groep (of een lege tekenreeks als N groter is dan het aantal vastgelegde groepen). maxdelay (sinds versie 3.2) - maximale vertraging in seconden. Type: float. Waarden: 0 - (standaard) negeer nooit logboekregels; > 0,0 - negeer oudere regels om de meest recente regels te analyseren binnen "maxdelay" seconden. Lees de maxdelay opmerkingen voordat u deze gebruikt! opties (sinds versie 4.0; mtime-reread, mtime-noreread opties sinds 4.4.7) - type logbestandsrotatie en andere opties. Mogelijke waarden: rotate (standaard), copytruncate - let op dat copytruncate niet samen met maxdelay kan worden gebruikt. In dit geval moet maxdelay 0 zijn of niet gespecificeerd zijn; zie copytruncate opmerkingen, mtime-reread - niet-unieke records, opnieuw lezen als de modificatietijd of grootte verandert (standaard), mtime-noreread - niet-unieke records, alleen opnieuw lezen als de grootte verandert (negeer wijzigingen in de modificatietijd). persistent_dir (sinds versies 5.0.18, 5.4.9, alleen in zabbix_agentd op Unix-systemen; niet ondersteund in Agent2) - absoluut pad van het directory waar persistente bestanden moeten worden opgeslagen. Zie ook aanvullende opmerkingen over persistente bestanden. |
Het item moet worden geconfigureerd als een actieve controle. Logbestandsrotatie is gebaseerd op de laatste modificatietijd van bestanden. Let op dat log |
| rt is ontworpen om te werken met één momenteel actief logboekbestand, met meerdere andere overeenkomende inactieve bestanden die worden geroteerd. Als een directory bijvoorbeeld veel actieve logboekbestanden heeft, moet voor elk bestand een apart logrt-item worden gemaakt. Anders kan één logrt-item te veel bestanden ophalen, wat kan leiden tot uitgeput geheugen en een crash van de monitoring. Als output leeg is gelaten - wordt de hele regel met de overeenkomende tekst geretourneerd. Let op dat alle globale reguliere expressietypen behalve 'Result is TRUE' altijd de hele overeenkomende regel retourneren en de output-parameter wordt genegeerd.Extractie van inhoud met behulp van de output-parameter vindt plaats op de agent.Voorbeelden: => logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] → zal een bestand matchen zoals "logfile1" (zal niet matchen met ".logfile1") => logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] → zal gegevens verzamelen uit bestanden zoals "logfile_abc_1" of "logfile__001". Gebruik van de output-parameter om een getal uit een logboekrecord te halen:=> logrt[/app1/^test.*log$,"taak uitgevoerd [0-9.]+ sec, verwerkt ([0-9]+) records, [0-9]+ fouten",,,,\1] → zal een logboekrecord "2015-11-13 10:08:26 taak uitgevoerd 6,08 sec, verwerkt 6080 records, 0 fouten" matchen en alleen '6080' naar de server sturen. Omdat een numerieke waarde wordt verzonden, kan het "Type informatie" voor dit item worden ingesteld op "Numeriek (ongesigneerd)" en kan de waarde worden gebruikt in grafieken, triggers, enz. Gebruik van de output-parameter om een logboekrecord te herschrijven voordat het naar de server wordt verzonden:=> logrt[/app1/^test.*log$,"([0-9 :-]+) taak uitgevoerd ([0-9.]+) sec, verwerkt ([0-9]+) records, ([0-9]+) fouten",,,,"\1 RECORDS: \3, FOUTEN: \4, DUUR: \2"] → zal een logboekrecord "2015-11-13 10:08:26 taak uitgevoerd 6,08 sec, verwerkt 6080 records, 0 fouten" matchen en een aangepast record "2015-11-13 10:08:26 RECORDS: 6080, FOUTEN: 0, DUUR: 6,08" naar de server sturen. |
|||
| logrt.count[bestand_regexp,<regexp>,<codering>,<maxproclines>,<mode>,<maxdelay>,<opties>,<persistent_dir>] | |||
| Aantal overeenkomende regels in een gemonitord logboekbestand dat wordt geroteerd. | Geheel getal | bestand_regexp - absoluut pad naar het bestand en reguliere expressie die het bestandsnaampatroon beschrijft regexp - reguliere expressie die het vereiste inhoudspatroon beschrijft codering - codepagina identificatie maxproclines - maximum aantal nieuwe regels per seconde dat de agent zal analyseren (kan niet meer dan 10000 bedragen). De standaardwaarde is 10*'MaxLinesPerSecond' in zabbix_agentd.conf. mode - mogelijke waarden: all (standaard), skip - overslaan van de verwerking van oudere gegevens (alleen van invloed op nieuw gemaakte items). maxdelay - maximale vertraging in seconden. Type: float. Waarden: 0 - (standaard) negeer nooit logboekregels; > 0,0 - negeer oudere regels om de meest recente regels te analyseren binnen "maxdelay" seconden. Lees de maxdelay opmerkingen voordat u deze gebruikt! opties (sinds versie 4.0; mtime-reread, mtime-noreread opties sinds 4.4.7) - type logbestandsrotatie en andere opties. Mogelijke waarden: rotate (standaard), copytruncate - let op dat copytruncate niet samen met maxdelay kan worden gebruikt. In dit geval moet maxdelay 0 zijn of niet gespecificeerd zijn; zie copytruncate opmerkingen, mtime-reread - niet-unieke records, opnieuw lezen als de modificatietijd of grootte verandert (standaard), |
|
Modbus-gegevens
| Item-sleutel | |||
|---|---|---|---|
| Beschrijving | Terugkeerwaarde | Parameters | Opmerkingen |
| modbus.get[eindpunt,<slave-id>,<functie>,<adres>,<aantal>,<type>,<endianness>,<offset>] | |||
| Leest Modbus-gegevens uit. | JSON-object | eindpunt - eindpunt gedefinieerd als protocol://connection_stringslave-id - slave-ID functie - Modbus-functie adres - adres van eerste register, spoel of invoer aantal - aantal te lezen records type - gegevenstype endianness - endianness-configuratie offset - aantal registers, beginnend vanaf 'adres', waarvan de resultaten worden genegeerd. Zie een gedetailleerde beschrijving van parameters. |
Ondersteund sinds Zabbix 5.2.0. |
Netwerkgegevens
| Item sleutel | |||
|---|---|---|---|
| Omschrijving | Terugkeerwaarde | Parameters | Opmerkingen |
| net.dns[<ip>,naam,<type>,<timeout>,<aantal>,<protocol>] | |||
| Controleert of DNS-service actief is. | 0 - DNS is niet actief (server reageerde niet of DNS-oplossing is mislukt) 1 - DNS is actief |
ip - IP-adres van DNS-server (leeglaten voor de standaard DNS-server, op Windows ondersteund voor Zabbix-agent 2, wordt genegeerd voor Zabbix-agent) naam - te bevragen DNS-naam type - te bevragen recordtype (standaard is SOA) timeout (genegeerd op Windows, tenzij Zabbix-agent 2 versie 6.0.1 of nieuwer wordt gebruikt) - time-out voor het verzoek in seconden (standaard is 1 seconde) aantal (genegeerd op Windows, tenzij Zabbix-agent 2 versie 6.0.1 of nieuwer wordt gebruikt) - aantal pogingen voor het verzoek (standaard is 2) protocol (sinds versie 3.0) - het protocol dat wordt gebruikt voor DNS-verzoeken: udp (standaard) of tcp |
Voorbeeld: => net.dns[8.8.8.8,example.com,MX,2,1] De mogelijke waarden voor type zijn:ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (niet ondersteund voor Zabbix-agent op Windows, Zabbix-agent 2 op alle besturingssystemen), HINFO, MINFO, TXT, AAAA, SRV Internationale domeinnamen worden niet ondersteund, gebruik in plaats daarvan IDNA-gecodeerde namen. SRV-recordtype wordt ondersteund sinds Zabbix 1.8.6 (Unix) en 2.0.0 (Windows). Voorvoegsel voor Zabbix 2.0 (nog steeds ondersteund): net.tcp.dns |
| net.dns.record[<ip>,naam,<type>,<timeout>,<aantal>,<protocol>] | |||
| Voert een DNS-query uit. | Karakterreeks met het vereiste type informatie | ip - IP-adres van DNS-server (leeglaten voor de standaard DNS-server, genegeerd op Windows, tenzij Zabbix-agent 2 versie 6.0.1 of nieuwer wordt gebruikt) naam - te bevragen DNS-naam type - te bevragen recordtype (standaard is SOA) timeout (genegeerd op Windows, tenzij Zabbix-agent 2 versie 6.0.1 of nieuwer wordt gebruikt) - time-out voor het verzoek in seconden (standaard is 1 seconde) aantal (genegeerd op Windows, tenzij Zabbix-agent 2 versie 6.0.1 of nieuwer wordt gebruikt) - aantal pogingen voor het verzoek (standaard is 2) protocol(sinds versie 3.0) - het protocol dat wordt gebruikt voor DNS-verzoeken: udp (standaard) of tcp |
Voorbeeld: => net.dns.record[8.8.8.8,example.com,MX,2,1] De mogelijke waarden voor type zijn:ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (niet ondersteund voor Zabbix-agent op Windows, Zabbix-agent 2 op alle besturingssystemen), HINFO, MINFO, TXT, AAAA, SRV Internationale domeinnamen worden niet ondersteund, gebruik in plaats daarvan IDNA-gecodeerde namen. SRV-recordtype wordt ondersteund sinds Zabbix 1.8.6 (Unix) en 2.0.0 (Windows). Voorvoegsel voor Zabbix 2.0 (nog steeds ondersteund): net.tcp.dns.query |
| net.if.collisions[if] | |||
| Aantal botsingen buiten het venster. | Geheel getal | if - naam van netwerkinterface | |
| net.if.discovery | |||
| Lijst van netwerkinterfaces. Gebruikt voor ontdekking op laag niveau. | JSON-object | Ondersteund sinds Zabbix 2.0. Ondersteund op FreeBSD, OpenBSD en NetBSD sinds Zabbix 2.2. Sommige versies van Windows (bijvoorbeeld Server 2008) vereisen mogelijk de nieuwste updates om niet-ASCII-karakters in interfacenamen te ondersteunen. |
|
| net.if.in[if,<mode>] | |||
| Statistieken voor inkomend verkeer op netwerkinterface. | Geheel getal | if - naam van netwerkinterface (Unix); volledige beschrijving van netwerkinterface of IPv4-adres; of, indien tussen haakjes, netwerkinterface GUID (Windows) mode - mogelijke waarden: bytes - aantal bytes (standaard) packets - aantal pakketten errors - aantal fouten dropped - aantal verwijderde pakketten overruns (fifo) - het aantal FIFO-bufferfouten frame - het aantal fouten in het inlijsten van pakketten compressed - het aantal gecomprimeerde pakketten ontvangen door de apparaatstuurprogramma multicast - het aantal multicast-frames ontvangen door de apparaatstuurprogramma |
Op Windows krijgt het item waarden van 64-bits tellers als deze beschikbaar zijn. 64-bits tellers voor interfacestatistieken werden geïntroduceerd in Windows Vista en Windows Server 2008. Als 64-bits tellers niet beschikbaar zijn, gebruikt de agent 32-bits tellers. Meervoudige tekens voor interfacenamen op Windows worden ondersteund sinds Zabbix 1.8.6. Voorbeelden: => net.if.in[eth0,errors] => net.if.in[eth0] U kunt netwerkinterfacebeschrijvingen opvragen op Windows met items net.if.discovery of net.if.list. U kunt deze sleutel gebruiken met de voorbewerkingsstap Verandering per seconde om statistieken in bytes per seconde te verkrijgen. |
| net.if.out[if,<mode>] | |||
| Statistieken voor uitgaand verkeer op netwerkinterface. | Geheel getal | if - naam van netwerkinterface (Unix); volledige beschrijving van netwerkinterface of IPv4-adres; of, indien tussen haakjes, netwerkinterface GUID (Windows) mode - mogelijke waarden: bytes - aantal bytes (standaard) packets - aantal pakketten errors - aantal fouten dropped - aantal verwijderde pakketten overruns (fifo) - het aantal FIFO-bufferfouten collisions (colls) - het aantal gedetecteerde botsingen op de interface carrier - het aantal verloren verbindingen gedetecteerd door het apparaatstuurprogramma compressed - het aantal gecomprimeerde pakketten verzonden door het apparaatstuurprogramma |
Op Windows krijgt het item waarden van 64-bits tellers als deze beschikbaar zijn. 64-bits tellers voor interfacestatistieken werden geïntroduceerd in Windows Vista en Windows Server 2008. Als 64-bits tellers niet beschikbaar zijn, gebruikt de agent 32-bits tellers. Meervoudige tekens voor interfacenamen op Windows worden ondersteund sinds Zabbix agent 1.8.6 versie. Voorbeelden: => net.if.out[eth0,errors] => net.if.out[eth0] U kunt netwerkinterfacebeschrijvingen opvragen op Windows met items net.if.discovery of net.if.list. U kunt deze sleutel gebruiken met de voorbewerkingsstap Verandering per seconde om statistieken in bytes per seconde te verkrijgen. |
| net.if.total[if,<mode>] | |||
| Som van inkomende en uitgaande verkeersstatistieken op netwerkinterface. | Geheel getal | if - naam van netwerkinterface (Unix); volledige beschrijving van netwerkinterface of IPv4-adres; of, indien tussen haakjes, netwerkinterface GUID (Windows) mode - mogelijke waarden: bytes - aantal bytes (standaard) packets - aantal pakketten errors - aantal fouten dropped - aantal verwijderde pakketten overruns (fifo) - het aantal FIFO-bufferfouten compressed - het aantal gecomprimeerde pakketten verzonden of ontvangen door het apparaatstuurprogramma |
Op Windows krijgt het item waarden van 64-bits tellers als deze beschikbaar zijn. 64-bits tellers voor interfacestatistieken werden geïntroduceerd in Windows Vista en Windows Server 2008. Als 64-bits tellers niet beschikbaar zijn, gebruikt de agent 32-bits tellers. Voorbeelden: => net.if.total[eth0,errors] => net.if.total[eth0] U kunt netwerkinterfacebeschrijvingen opvragen op Windows met items net.if.discovery of net.if.list. U kunt deze sleutel gebruiken met de voorbewerkingsstap Verandering per seconde om statistieken in bytes per seconde te verkrijgen. Merk op dat verwijderde pakketten alleen worden ondersteund als zowel net.if.in als net.if.out werken voor verwijderde pakketten op uw platform. |
| net.tcp.listen[port] | |||
| Controleert of deze TCP-poort in de LISTEN-toestand is. | 0 - het is niet in de LISTEN-toestand 1 - het is in de LISTEN-toestand |
port - TCP-poortnummer | Voorbeeld: => net.tcp.listen[80] Ondersteund op Linux sinds Zabbix 1.8.4 Sinds Zabbix 3.0.0, op Linux-kernels 2.6.14 en hoger, wordt informatie over luisterende TCP-sockets verkregen via de NETLINK-interface van de kernel, indien mogelijk. Anders wordt de informatie opgehaald uit de bestanden /proc/net/tcp en /proc/net/tcp6. |
| net.tcp.port[<ip>,port] | |||
| Controleert of het mogelijk is om een TCP-verbinding te maken met de opgegeven poort. | 0 - kan geen verbinding maken 1 - kan verbinding maken |
ip - IP of DNS-naam (standaard is 127.0.0.1) port - poortnummer |
Voorbeeld: => net.tcp.port[,80] → kan worden gebruikt om de beschikbaarheid te testen van een webserver die op poort 80 draait. Voor eenvoudige TCP-prestatietests gebruikt u net.tcp.service.perf[tcp,<ip>,<port>] Merk op dat deze controles kunnen resulteren in aanvullende berichten in systeemdaemon-logbestanden (meestal worden SMTP- en SSH-sessies gelogd). |
| net.tcp.service[service,<ip>,<port>] | |||
| Controleert of de service actief is en TCP-verbindingen accepteert. | 0 - service is niet actief 1 - service is actief |
service - een van: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (zie details) ip - IP of DNS-naam (standaard is 127.0.0.1) port - poortnummer (standaard wordt het standaard poortnummer van de service gebruikt) |
Voorbeeld: => net.tcp.service[ftp,,45] → kan worden gebruikt om de beschikbaarheid te testen van een FTP-server op TCP-poort 45. Merk op dat deze controles kunnen resulteren in aanvullende berichten in systeemdaemon-logbestanden (meestal worden SMTP- en SSH-sessies gelogd). Het controleren van versleutelde protocollen (zoals IMAP op poort 993 of POP op poort 995) wordt momenteel niet ondersteund. Gebruik als oplossing hiervoor net.tcp.port voor controles zoals deze. Het controleren van LDAP en HTTPS op Windows wordt alleen ondersteund door Zabbix-agent 2. Merk op dat de telnet-controle zoekt naar een aanmeldingsprompt (':' aan het einde). https en telnet services worden ondersteund sinds Zabbix 2.0. |
| net.tcp.service.perf[service,<ip>,<port>] | |||
| Controleert de prestaties van een TCP-service. | Decimaal getal 0 - service is niet actief seconden - het aantal seconden dat wordt besteed bij het verbinden met de service |
service - een van: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (zie details) ip - IP of DNS-naam (standaard is 127.0.0.1) port - poortnummer (standaard wordt het standaard poortnummer van de service gebruikt) |
Voorbeeld: => net.tcp.service.perf[ssh] → kan worden gebruikt om de snelheid van het initiële antwoord van de SSH-server te testen. Het controleren van versleutelde protocollen (zoals IMAP op poort 993 of POP op poort 995) wordt momenteel niet ondersteund. Gebruik als oplossing hiervoor net.tcp.service.perf[tcp,<ip>,<port>] voor controles zoals deze. Het controleren van LDAP en HTTPS op Windows wordt alleen ondersteund door Zabbix-agent 2. Merk op dat de telnet-controle zoekt naar een aanmeldingsprompt (':' aan het einde). https en telnet services worden ondersteund sinds Zabbix 2.0. |
| net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>] | |||
| Geeft het aantal TCP-sockets terug dat overeenkomt met de opgegeven parameters. | Geheel getal | laddr - lokaal IPv4/6-adres of CIDR-subnet lport - lokaal poortnummer of servicenaam raddr - extern IPv4/6-adres of CIDR-subnet rport - extern poortnummer of servicenaam state - verbindingsstatus (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, close_wait, last_ack, listen, closing) |
Dit item wordt alleen ondersteund op Linux, zowel op Zabbix-agent/agent 2. Op Zabbix-agent 2 wordt het ook ondersteund op 64-bit Windows. Voorbeeld: => net.tcp.socket.count[,80,,,established] → geeft het aantal verbindingen naar lokale TCP-poort 80 in de established-toestand weer Dit item wordt ondersteund sinds Zabbix 6.0. |
| net.udp.listen[port] | |||
| Controleert of deze UDP-poort in de LISTEN-toestand is. | 0 - het is niet in de LISTEN-toestand 1 - het is in de LISTEN-toestand |
port - UDP-poortnummer | Voorbeeld: => net.udp.listen[68] Ondersteund op Linux sinds Zabbix 1.8.4 |
| net.udp.service[service,<ip>,<port>] | |||
| Controleert of de service actief is en reageert op UDP-verzoeken. | 0 - service is niet actief 1 - service is actief |
service - ntp (zie details) ip - IP of DNS-naam (standaard is 127.0.0.1) port - poortnummer (standaard wordt het standaard poortnummer van de service gebruikt) |
Voorbeeld: => net.udp.service[ntp,,45] → kan worden gebruikt om de beschikbaarheid van de NTP-service op UDP-poort 45 te testen. Dit item wordt ondersteund sinds Zabbix 3.0.0, maar de ntp-service was beschikbaar voor het item net.tcp.service[] in eerdere versies. |
| net.udp.service.perf[service,<ip>,<port>] | |||
| Controleert de prestaties van een UDP-service. | Decimaal getal 0 - service is niet actief seconden - het aantal seconden dat wordt besteed tijdens het wachten op een reactie van de service |
service - ntp (zie details) ip - IP of DNS-naam (standaard is 127.0.0.1) port - poortnummer (standaard wordt het standaard poortnummer van de service gebruikt) |
Voorbeeld: => net.udp.service.perf[ntp] → kan worden gebruikt om de responstijd van de NTP-service te testen. Dit item wordt ondersteund sinds Zabbix 3.0.0, maar de ntp-service was beschikbaar voor het item net.tcp.service[] in eerdere versies. |
| net.udp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>] | |||
| Geeft het aantal UDP-sockets terug dat overeenkomt met de opgegeven parameters. | Geheel getal | laddr - lokaal IPv4/6-adres of CIDR-subnet lport - lokaal poortnummer of servicenaam raddr - extern IPv4/6-adres of CIDR-subnet rport - extern poortnummer of servicenaam state - verbindingsstatus (established, unconn) |
Dit item wordt alleen ondersteund op Linux, zowel op Zabbix-agent/agent 2. Op Zabbix-agent 2 wordt het ook ondersteund op 64-bit Windows. Voorbeeld: => net.udp.socket.count[,,,,established] → geeft het aantal UDP-sockets in de verbonden toestand weer Dit item wordt ondersteund sinds Zabbix 6.0. |
Procesgegevens
| Item sleutel | |||
|---|---|---|---|
| Omschrijving | Teruggegeven waarde | Parameters | Opmerkingen |
| proc.cpu.util[<naam>,<gebruiker>,<type>,<opdrachtregel>,<modus>,<zone>] | |||
| Percentage CPU-gebruik van het proces. | Decimaal getal | naam - procesnaam (standaard is alle processen) gebruiker - gebruikersnaam (standaard is alle gebruikers) type - CPU-gebruikstype: totaal (standaard), gebruiker, systeem opdrachtregel - filter op opdrachtregel (dit is een reguliere expressie) modus - gegevens verzamelingsmodus: avg1 (standaard), avg5, avg15 zone - doelzone: current (standaard), all. Deze parameter wordt alleen ondersteund op Solaris. |
Voorbeelden: => proc.cpu.util[,root] → CPU-gebruik van alle processen die worden uitgevoerd onder de gebruiker "root" => proc.cpu.util[zabbix_server,zabbix] → CPU-gebruik van alle zabbix_server-processen die worden uitgevoerd onder de gebruiker zabbix De geretourneerde waarde is gebaseerd op het percentage CPU-gebruik van een enkele CPU-kern. Bijvoorbeeld, het CPU-gebruik van een proces dat twee kernen volledig gebruikt, is 200%. De proces-CPU-gebruiksgegevens worden verzameld door een verzamelaar die maximaal 1024 unieke (op naam, gebruiker en opdrachtregel) vragen ondersteunt. Vragen die gedurende de laatste 24 uur niet zijn benaderd, worden uit de verzamelaar verwijderd. Let op dat wanneer de parameter zone wordt ingesteld op current (of standaard) in het geval dat de agent is gecompileerd op een Solaris zonder zone-ondersteuning, maar wordt uitgevoerd op een nieuwere Solaris waar zones worden ondersteund, zal de agent NOTSUPPORTED retourneren (de agent kan resultaten niet beperken tot alleen de huidige zone). Echter, all wordt in dit geval ondersteund.Deze sleutel wordt ondersteund sinds Zabbix 3.0.0 en is beschikbaar op verschillende platforms (zie Items supported by platform). |
| proc.mem[<naam>,<gebruiker>,<modus>,<opdrachtregel>,<geheugentype>] | |||
| Geheugen dat door het proces wordt gebruikt in bytes. | Geheel getal - met modus als max, min, sumDecimaal getal - met modus als avg |
naam - procesnaam (standaard is alle processen) gebruiker - gebruikersnaam (standaard is alle gebruikers) modus - mogelijke waarden: avg, max, min, sum (standaard) opdrachtregel - filter op opdrachtregel (dit is een reguliere expressie) geheugentype - type geheugen dat door het proces wordt gebruikt |
Voorbeelden: => proc.mem[,root] → geheugen dat door alle processen wordt gebruikt die worden uitgevoerd onder de gebruiker "root" => proc.mem[zabbix_server,zabbix] → geheugen dat wordt gebruikt door alle zabbix_server-processen die worden uitgevoerd onder de gebruiker zabbix => proc.mem[,oracle,max,oracleZABBIX] → geheugen dat wordt gebruikt door het proces met het meeste geheugengebruik dat wordt uitgevoerd onder oracle en oracleZABBIX in de opdrachtregel Opmerking: Wanneer meerdere processen gedeeld geheugen gebruiken, kan de som van het geheugengebruik door processen resulteren in grote, onrealistische waarden. Zie notities over het selecteren van processen met de parameters naam en opdrachtregel (specifiek voor Linux).Wanneer dit item vanaf de opdrachtregel wordt aangeroepen en een opdrachtregelparameter bevat (bijvoorbeeld met de testmodus van de agent: zabbix_agentd -t proc.mem[,,,apache2]), wordt één extra proces geteld, omdat de agent zichzelf telt.De parameter geheugentype wordt ondersteund op verschillende platforms sinds Zabbix 3.0.0. |
| proc.num[<naam>,<gebruiker>,<status>,<opdrachtregel>,<zone>] | |||
| Het aantal processen. | Geheel getal | naam - procesnaam (standaard is alle processen) gebruiker - gebruikersnaam (standaard is alle gebruikers) status (disk en trace opties sinds versie 3.4.0) - mogelijke waarden: all (standaard), disk - ononderbreekbare slaap, run - actief, sleep - onderbreekbare slaap, trace - gestopt, zomb - zombie opdrachtregel - filter op opdrachtregel (dit is een reguliere expressie) zone - doelzone: current (standaard), all. Deze parameter wordt alleen ondersteund op Solaris. |
Voorbeelden: => proc.num[,mysql] → aantal processen die worden uitgevoerd onder de gebruiker mysql => proc.num[apache2,www-data] → aantal apache2-processen die worden uitgevoerd onder de gebruiker www-data => proc.num[,oracle,sleep,oracleZABBIX] → aantal processen in de slaapstand die worden uitgevoerd onder oracle en oracleZABBIX in de opdrachtregel Zie notities over het selecteren van processen met de parameters naam en opdrachtregel (specifiek voor Linux).Op Windows worden alleen de parameters naam en gebruiker ondersteund.Wanneer dit item vanaf de opdrachtregel wordt aangeroepen en een opdrachtregelparameter bevat (bijvoorbeeld met de testmodus van de agent: zabbix_agentd -t proc.num[,,,apache2]), wordt één extra proces geteld, omdat de agent zichzelf telt.Let op dat wanneer de parameter zone wordt ingesteld op current (of standaard) in het geval dat de agent is gecompileerd op een Solaris zonder zone-ondersteuning, maar wordt uitgevoerd op een nieuwere Solaris waar zones worden ondersteund, zal de agent NOTSUPPORTED retourneren (de agent kan resultaten niet beperken tot alleen de huidige zone). Echter, all wordt in dit geval ondersteund. |
Sensorgegevens
| Item sleutel | |||
|---|---|---|---|
| Omschrijving | Teruggegeven waarde | Parameters | Opmerkingen |
| sensor[apparaat,sensor,<modus>] | |||
| Lezen van hardware-sensor. | Decimaal getal | apparaat - apparaatnaam; kan een reguliere expressie zijn als modus wordt weggelaten sensor - sensor-naam; kan een reguliere expressie zijn als modus wordt weggelaten modus - mogelijke waarden: avg, max, min (als deze parameter wordt weggelaten, worden apparaat en sensor letterlijk behandeld). |
Leest /proc/sys/dev/sensors op Linux 2.4. Voorbeeld: => sensor[w83781d-i2c-0-2d,temp1] Vóór Zabbix 1.8.4 werd het formaat sensor[temp1] gebruikt. |
| Leest /sys/class/hwmon op Linux 2.6+. Zie een gedetailleerdere beschrijving van het sensor item op Linux. |
|||
| Leest de hw.sensors MIB op OpenBSD. Voorbeelden: => sensor[cpu0,temp0] → temperatuur van één CPU => sensor["cpu[0-2]$",temp,avg] → gemiddelde temperatuur van de eerste drie CPU's Ondersteund op OpenBSD sinds Zabbix 1.8.4. |
|||
Is there anything else you would like to know or any other information you need assistance with?
Systeemgegevens
| Item sleutel | |||
|---|---|---|---|
| Beschrijving | Teruggegeven waarde | Parameters | Opmerkingen |
| system.boottime | |||
| Opstarttijd van het systeem. | Integer (Unix-tijdstempel) | ||
| system.cpu.discovery | |||
| Lijst van gedetecteerde CPU's/ CPU-kernen. Gebruikt voor ontdekking op laag niveau. | JSON-object | Ondersteund op alle platforms sinds 2.4.0. | |
| system.cpu.intr | |||
| Apparaatonderbrekingen. | Integer | ||
| system.cpu.load[<cpu>,<mode>] | |||
| CPU-belasting. | Float | cpu - mogelijke waarden: all (standaard), percpu (sinds versie 2.0; totale belasting gedeeld door het aantal online CPU's) mode - mogelijke waarden: avg1 (gemiddelde over één minuut, standaard), avg5, avg15 |
Voorbeeld: => system.cpu.load[,avg5]. |
| system.cpu.num[<type>] | |||
| Aantal CPU's. | Integer | type - mogelijke waarden: online (standaard), max |
Voorbeeld: => system.cpu.num |
| system.cpu.switches | |||
| Aantal contextwisselingen. | Integer | ||
| system.cpu.util[<cpu>,<type>,<mode>,<logical_or_physical>] | |||
| CPU-gebruik in procent. | Float | cpu - <CPU-nummer> of all (standaard) type - mogelijke waarden: user (standaard), idle, nice, system (standaard voor Windows), iowait, interrupt, softirq, steal, guest (op Linux-kernels 2.6.24 en hoger), guest_nice (op Linux-kernels 2.6.33 en hoger). Zie ook platformspecifieke details voor deze parameter. mode - mogelijke waarden: avg1 (gemiddelde over één minuut, standaard), avg5, avg15 logical_or_physical (sinds versie 5.0.3; alleen op AIX) - mogelijke waarden: logical (standaard), physical. Deze parameter wordt alleen ondersteund op AIX. |
Op Windows wordt de waarde verkregen met behulp van de prestatieteller Processor Time. Let op dat sinds Windows 8 de Taakbeheer van Windows CPU-gebruik weergeeft op basis van de prestatieteller Processor Utility, terwijl dit in eerdere versies de prestatieteller Processor Time was. Voorbeeld: => system.cpu.util[0,user,avg5] Oude benaming: system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX |
| system.hostname[<type>, <transform>] | |||
| Hostnaam van het systeem. | String | type (vóór versie 5.4.7 alleen ondersteund op Windows) - mogelijke waarden: netbios (standaard op Windows), host (standaard op Linux), shorthost (sinds versie 5.4.7; geeft het deel van de hostnaam vóór het eerste punt weer, een volledige tekenreeks voor namen zonder punten). transform (sinds versie 5.4.7) - mogelijke waarden: none (standaard), lower (omzetten naar kleine letters) |
De waarde wordt verkregen via de functies GetComputerName() (voor netbios) of gethostname() (voor host) op Windows en door nodename te gebruiken uit de uitvoer van de uname()-systeem-API op andere systemen.Voorbeelden van teruggegeven waarden: op Linux: => system.hostname → linux-w7x1 => system.hostname → example.com => system.hostname[shorthost] → example op Windows: => system.hostname → WIN-SERV2008-I6 => system.hostname[host] → Win-Serv2008-I6LonG => system.hostname[host,lower] → win-serv2008-i6long Zie ook een meer gedetailleerde beschrijving. |
| system.hw.chassis[<info>] | |||
| Chassis-informatie. | String | info - een van full (standaard), model, serial, type of vendor | Voorbeeld: system.hw.chassis[full] Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop] Deze sleutel is afhankelijk van de beschikbaarheid van de SMBIOS-tabel. Zal proberen de DMI-tabel uit sysfs te lezen; als toegang tot sysfs mislukt, wordt rechtstreeks uit het geheugen gelezen. Root-rechten zijn vereist omdat de waarde wordt verkregen door te lezen uit sysfs of geheugen. Ondersteund sinds Zabbix 2.0. |
| system.hw.cpu[<cpu>,<info>] | |||
| CPU-informatie. | String of integer | cpu - <CPU-nummer> of all (standaard) info - mogelijke waarden: full (standaard), curfreq, maxfreq, model of vendor |
Voorbeeld: => system.hw.cpu[0,vendor] → AuthenticAMD Verzamelt informatie uit /proc/cpuinfo en /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq. Als een CPU-nummer en curfreq of maxfreq worden opgegeven, wordt een numerieke waarde geretourneerd (Hz). Ondersteund sinds Zabbix 2.0. |
| system.hw.devices[<type>] | |||
| Lijst van PCI- of USB-apparaten. | Tekst | type (sinds versie 2.0) - pci (standaard) of usb | Voorbeeld: => system.hw.devices[pci] → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge [..] Geeft de uitvoer van het hulpprogramma lspci of lsusb weer (uitgevoerd zonder parameters). |
| system.hw.macaddr[<interface>,<format>] | |||
| Lijst van MAC-adressen. | String | interface - all (standaard) of een reguliere expressie format - full (standaard) of short |
Lijst MAC-adressen op van de interfaces waarvan de naam overeenkomt met de gegeven reguliere expressie (all voor alle interfaces). Voorbeeld: => system.hw.macaddr["eth0$",full] → [eth0] 00:11:22:33:44:55 Als format is opgegeven als short, worden interface namen en identieke MAC-adressen niet vermeld.Ondersteund sinds Zabbix 2.0. |
| system.localtime[<type>] | |||
| Systeemtijd. | Integer - met type als utcString - met type als local |
type (sinds versie 2.0) - mogelijke waarden: utc - (standaard) de tijd sinds de Epoch (00:00:00 UTC, 1 januari 1970), gemeten in seconden. local - de tijd in het formaat 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm' |
Moet alleen worden gebruikt als een passieve check. Voorbeeld: => system.localtime[local] → maak een item met deze sleutel en gebruik het vervolgens om de hosttijd weer te geven in de Clock dashboard-widget. |
| system.run[command,<mode>] | |||
| Voer opgegeven commando uit op de host. | Tekstresultaat van het commando 1 - met mode als nowait (ongeacht het resultaat van het commando) |
command - commando om uit te voeren mode - mogelijke waarden: wait - wacht tot het einde van de uitvoering (standaard), nowait - wacht niet |
Er kan maximaal 512 KB aan gegevens worden geretourneerd, inclusief overbodige witruimte die wordt afgekapt. Om correct te worden verwerkt, moet de uitvoer van het commando tekst zijn. Voorbeeld: => system.run[ls -l /] → gedetailleerde lijst van bestanden in de rootdirectory. Opmerking: system.run-items zijn standaard uitgeschakeld. Lees hoe je ze kunt inschakelen. De retourwaarde van het item is de standaard uitvoer samen met de standaardfout die door het commando wordt geproduceerd. De exitcode wordt niet gecontroleerd. Lege uitvoer is toegestaan vanaf Zabbix 2.4.0. Zie ook: Commando-uitvoering. |
| system.stat[resource,<type>] | |||
| Systeemstatistieken. | Integer of float | ent - aantal processoreenheden waarop deze partitie recht heeft (float) kthr,<type> - informatie over de status van kernelthreads: r - gemiddeld aantal actieve kernelthreads (float) b - gemiddeld aantal kernelthreads geplaatst in de wachtrij van de virtuele geheugenbeheerder (float) memory,<type> - informatie over het gebruik van virtueel en echt geheugen: avm - actieve virtuele pagina's (integer) fre - grootte van de vrije lijst (integer) page,<type> - informatie over paginatraps en paging-activiteit: fi - bestandspagina's ingelezen per seconde (float) fo - bestandspagina's uitgelezen per seconde (float) pi - pagina's die zijn ingelezen uit ruimte voor paging (float) po - pagina's die zijn uitgelezen naar ruimte voor paging (float) fr - pagina's die zijn vrijgegeven (vervanging van pagina's) (float) sr - pagina's gescand door algoritme voor vervanging van pagina's (float) faults,<type> - trap- en onderbrekingsfrequentie: in - apparaatonderbrekingen (float) sy - systeemaanroepen (float) cs - contextwissels van kernelthread (float) cpu,<type> - verdeling van het percentage gebruik van processortijd: us - gebruikerstijd (float) sy - systeemtijd (float) id - inactiviteitstijd (float) wa - inactiviteitstijd waarin het systeem in afwachting was van uitstaande schijf-/NFS-I/O-verzoeken (float) pc - aantal verbruikte fysieke processors (float) ec - het percentage van de gebruikte toegewezen capaciteit (float) lbusy - geeft het percentage van het gebruik van logische processor(s) aan dat plaatsvond tijdens de uitvoering op gebruikers- en systeemniveau (float) app - geeft de beschikbare fysieke processors aan in de gedeelde pool (float) disk,<type> - schijfstatistieken: bps - geeft de hoeveelheid data overgedragen (gelezen of geschreven) naar de schijf in bytes per seconde (integer) tps - geeft het aantal overdrachten per seconde aan dat is uitgegeven aan de fysieke schijf/tape (float) |
Dit item wordt alleen ondersteund op AIX. Houd rekening met de volgende beperkingen in deze items: => system.stat[cpu,app] - alleen ondersteund op AIX LPAR van het type "Shared" => system.stat[cpu,ec] - ondersteund op AIX LPAR van het type "Shared" en "Dedicated" ("Dedicated" retourneert altijd 100 (procent)) => system.stat[cpu,lbusy] - alleen ondersteund op AIX LPAR van het type "Shared" => system.stat[cpu,pc] - ondersteund op AIX LPAR van het type "Shared" en "Dedicated" => system.stat[ent] - ondersteund op AIX LPAR van het type "Shared" en "Dedicated" |
| system.sw.arch | |||
| Informatie over softwarearchitectuur. | String | Voorbeeld: => system.sw.arch → i686 De info wordt verkregen via de uname() functie. Ondersteund sinds Zabbix 2.0. |
|
| system.sw.os[<info>] | |||
| Informatie over besturingssysteem. | String | info - mogelijke waarden: full (standaard), short of name |
Voorbeeld: => system.sw.os[short]→ Ubuntu 2.6.35-28.50-generic 2.6.35.11 De info wordt verkregen uit (let op dat niet alle bestanden en opties aanwezig zijn in alle distributies): /proc/version (full) /proc/version_signature (short) PRETTY_NAME parameter van /etc/os-release op systemen die dit ondersteunen, of /etc/issue.net (name) Ondersteund sinds Zabbix 2.0. |
| system.sw.packages[<regexp>,<manager>,<format>] | |||
| Lijst van geïnstalleerde pakketten. | Tekst | regexp - all (standaard) of een reguliere expressie manager - all (standaard) of een pakketbeheerder format - full (standaard) of short |
Lijst (alfabetisch) geïnstalleerde pakketten waarvan de naam overeenkomt met de gegeven reguliere expressie (all geeft ze allemaal weer). Voorbeeld: => system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal Ondersteunde pakketbeheerders (uitgevoerde opdracht): dpkg (dpkg --get-selections) pkgtool (ls /var/log/packages) rpm (rpm -qa) pacman (pacman -Q) Als format is opgegeven als full, worden pakketten gegroepeerd per pakketbeheerder (elke beheerder op een aparte regel beginnend met zijn naam tussen vierkante haken).Als format is opgegeven als short, worden pakketten niet gegroepeerd en worden ze op één regel weergegeven.Ondersteund sinds Zabbix 2.0. |
| system.swap.in[<device>,<type>] | |||
| Statistieken voor inwisselen (van apparaat naar geheugen). | Integer | device - apparaat dat wordt gebruikt voor inwisselen (standaard is all) type - mogelijke waarden: count (aantal inwisselingen), sectors (sectoren ingewisseld), pages (pagina's ingewisseld). Zie ook de platformspecifieke details voor deze parameter. |
Voorbeeld: => system.swap.in[,pages] De bron van deze informatie is: /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4) /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6) |
| system.swap.out[<device>,<type>] | |||
| Statistieken voor uitwisselen (van geheugen naar apparaat). | Integer | device - apparaat dat wordt gebruikt voor uitwisselen (standaard is all) type - mogelijke waarden: count (aantal uitwisselingen), sectors (sectoren uitgewisseld), pages (pagina's uitgewisseld). Zie ook de platformspecifieke details voor deze parameter. |
Voorbeeld: => system.swap.out[,pages] De bron van deze informatie is: /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4) /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6) |
| system.swap.size[<device>,<type>] | |||
| Grootte van wisselruimte in bytes of als percentage van het totaal. | Integer - voor bytes Float - voor percentage |
device - apparaat dat wordt gebruikt voor inwisselen (standaard is all) type - mogelijke waarden: free (vrije wisselruimte, standaard), pfree (vrije wisselruimte, in percentage), pused (gebruikte wisselruimte, in percentage), total (totale wisselruimte), used (gebruikte wisselruimte) Let op dat pfree, pused niet worden ondersteund op Windows als de wisselruimte 0 is. Zie ook de platformspecifieke details voor deze parameter. |
Voorbeeld: => system.swap.size[,pfree] → percentage vrije wisselruimte Als device niet is opgegeven, houdt de Zabbix-agent alleen rekening met wisselapparaten (bestanden), het fysieke geheugen wordt genegeerd. Bijvoorbeeld, op Solaris-systemen omvat het swap -s commando een deel van het fysieke geheugen en wisselapparaten (in tegenstelling tot swap -l). Merk op dat deze sleutel mogelijk onjuiste grootte/percentage van de wisselruimte kan rapporteren op gevirtualiseerde (VMware ESXi, VirtualBox) Windows-platforms. In dat geval kunt u de sleutel perf_counter[\700(_Total)\702] gebruiken om het juiste percentage van de wisselruimte te verkrijgen. |
| system.uname | |||
| Identificatie van het systeem. | String | Voorbeeld van geretourneerde waarde (Unix): FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386 Voorbeeld van geretourneerde waarde (Windows): Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86 Op Unix wordt sinds Zabbix 2.2.0 de waarde voor dit item verkregen met de uname() |
|
Gegevens over virtueel bestandssysteem
| Item sleutel | |||
|---|---|---|---|
| Omschrijving | Terugkeerwaarde | Parameters | Opmerkingen |
| vfs.dev.discovery | |||
| Lijst van blokapparaten en hun type. Gebruikt voor ontdekking op laag niveau. | JSON-object | Deze item wordt alleen ondersteund op het Linux-platform. Ondersteund sinds Zabbix 4.4.0. |
|
| vfs.dev.read[<apparaat>,<type>,<mode>] | |||
| Statistieken voor lezen van schijven. | Integer - met type in sectors, operations, bytesFloat - met type in sps, ops, bpsOpmerking: als een update-interval van drie uur of meer wordt gebruikt2, wordt altijd '0' geretourneerd |
apparaat - schijfapparaat (standaard is all 3) type - mogelijke waarden: sectors, operations, bytes, sps, ops, bps Merk op dat de ondersteuning voor de parameter 'type' en de standaardwaarden afhankelijk zijn van het platform. Zie de platformspecifieke details. sps, ops, bps staan voor: sectoren, bewerkingen, bytes per seconde, respectievelijk. mode - mogelijke waarden: avg1 (éénminuutgemiddelde, standaard), avg5, avg15. Deze parameter wordt alleen ondersteund met type in: sps, ops, bps. |
U kunt zowel relatieve apparaatnamen (bijvoorbeeld sda) gebruiken als een optioneel voorvoegsel /dev/ (bijvoorbeeld /dev/sda).LVM-logische volumes worden ondersteund. Standaardwaarden van de parameter 'type' voor verschillende besturingssystemen: AIX - bewerkingen FreeBSD - bps Linux - sps OpenBSD - bewerkingen Solaris - bytes Voorbeeld: => vfs.dev.read[,operations] sps, ops en bps op ondersteunde platforms waren oorspronkelijk beperkt tot 8 apparaten (7 individuele en één all). Sinds Zabbix 2.0.1 is deze limiet 1024 apparaten (1023 individuele en één voor all). |
| vfs.dev.write[<apparaat>,<type>,<mode>] | |||
| Statistieken voor schrijven naar schijf. | Integer - met type in sectors, operations, bytesFloat - met type in sps, ops, bpsOpmerking: als een update-interval van drie uur of meer wordt gebruikt2, wordt altijd '0' geretourneerd |
apparaat - schijfapparaat (standaard is all 3) type - mogelijke waarden: sectors, operations, bytes, sps, ops, bps Merk op dat de ondersteuning voor de parameter 'type' en de standaardwaarden afhankelijk zijn van het platform. Zie de platformspecifieke details. sps, ops, bps staan voor: sectoren, bewerkingen, bytes per seconde, respectievelijk. mode - mogelijke waarden: avg1 (éénminuutgemiddelde, standaard), avg5, avg15. Deze parameter wordt alleen ondersteund met type in: sps, ops, bps. |
U kunt zowel relatieve apparaatnamen (bijvoorbeeld sda) gebruiken als een optioneel voorvoegsel /dev/ (bijvoorbeeld /dev/sda).LVM-logische volumes worden ondersteund. Standaardwaarden van de parameter 'type' voor verschillende besturingssystemen: AIX - bewerkingen FreeBSD - bps Linux - sps OpenBSD - bewerkingen Solaris - bytes Voorbeeld: => vfs.dev.write[,operations] sps, ops en bps op ondersteunde platforms waren oorspronkelijk beperkt tot 8 apparaten (7 individuele en één all). Sinds Zabbix 2.0.1 is deze limiet 1024 apparaten (1023 individuele en één voor all). |
| vfs.dir.count[dir,<regex_incl>,<regex_excl>,<types_incl>,<types_excl>,<max_depth>,<min_size>,<max_size>,<min_age>,<max_age>,<regex_excl_dir>] | |||
| Maptellingstelling. | Integer | dir - absoluut pad naar de map regex_incl - reguliere expressie die het naampatroon van het onderdeel (bestand, map, symbolische link) beschrijft dat moet worden opgenomen; alles opnemen als leeg (standaardwaarde) regex_excl - reguliere expressie die het naampatroon van het onderdeel (bestand, map, symbolische link) beschrijft dat moet worden uitgesloten; geen enkel uitsluiten als leeg (standaardwaarde) types_incl - te tellen mappen, mogelijke waarden: file - gewoon bestand, dir - submap, sym - symbolische link, sock - socket, bdev - blokapparaat, cdev - karakterapparaat, fifo - FIFO, dev - synoniem voor "bdev,cdev", all - alle typen (standaard), dat wil zeggen "file,dir,sym,sock,bdev,cdev,fifo". Meerdere typen moeten worden gescheiden met een komma en tussen aanhalingstekens worden geplaatst. types_excl - typen mappen (zie <types_incl>) die NIET moeten worden geteld. Als een typenamen zich zowel in <types_incl> als in <types_excl> bevindt, worden mappen van dit type NIET geteld. max_depth - maximale diepte van submappen om doorheen te gaan. -1 (standaard) - onbeperkt, 0 - niet afdalen in submappen. min_size - minimale grootte (in bytes) voor een bestand dat moet worden geteld. Kleinere bestanden worden niet geteld. Geheugenachtervoegsels kunnen worden gebruikt. max_size - maximale grootte (in bytes) voor een bestand dat moet worden geteld. Grotere bestanden worden niet geteld. Geheugenachtervoegsels kunnen worden gebruikt. min_age - minimale leeftijd (in seconden) van een mapvermelding die moet worden geteld. Recente vermeldingen worden niet geteld. Tijdachtervoegsels kunnen worden gebruikt. max_age - maximale leeftijd (in seconden) van een mapvermelding die moet worden geteld. Vermeldingen die zo oud of ouder zijn, worden niet geteld (wijzigingstijd). Tijdachtervoegsels kunnen worden gebruikt. regex_excl_dir - reguliere expressie die het naampatroon van de map beschrijft die moet worden uitgesloten. Alle inhoud van de map wordt uitgesloten (in tegenstelling tot regex_excl) |
Omgevingsvariabelen, zoals %APP_HOME%, $HOME en %TEMP%, worden niet ondersteund.Pseudomappen "." en ".." worden nooit geteld. Symbolische koppelingen worden nooit gevolgd voor mapdoorloop. Op Windows worden symbolische mappen overgeslagen. Zowel regex_incl als regex_excl worden toegepast op bestanden en mappen bij het berekenen van het aantal vermeldingen, maar worden genegeerd bij het kiezen van submappen om doorheen te gaan (als regex_incl "^(?i)^.+\.zip$" is en max_depth niet is ingesteld, dan worden alle submappen doorlopen, maar worden alleen bestanden van het type zip geteld).De uitvoeringstijd wordt beperkt door de time-outwaarde in de agent configuratie. Omdat het doorzoeken van grote mappen langer kan duren dan dat, worden er geen gegevens geretourneerd en wordt het item niet ondersteund. Er wordt geen gedeeltelijke telling geretourneerd. Bij filteren op grootte hebben alleen gewone bestanden betekenisvolle groottes. Onder Linux en BSD hebben mappen ook niet-nul groottes (meestal een paar Kb). Apparaten hebben nul groottes, bijvoorbeeld de grootte van /dev/sda1 weerspiegelt niet de grootte van de respectievelijke partitie. Daarom is het bij gebruik van <min_size> en <max_size> raadzaam om <types_incl> in te stellen op "file", om verrassingen te voorkomen.Voorbeelden: ⇒ vfs.dir.count[/dev] - bewaakt het aantal apparaten in /dev (Linux) ⇒ vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] - bewaakt het aantal bestanden in de tijdelijke map (Windows) Ondersteund sinds Zabbix 4.0.0. |
| vfs.dir.get[dir,<regex_incl>,<regex_excl>,<types_incl>,<types_excl>,<max_depth>,<min_size>,<max_size>,<min_age>,<max_age>,<regex_excl_dir>] | |||
| Lijst van mapelementen. | JSON | dir - absoluut pad naar de map regex_incl - reguliere expressie die het naampatroon van het onderdeel (bestand, map, symbolische link) beschrijft dat moet worden opgenomen; alles opnemen als leeg (standaardwaarde) regex_excl - reguliere expressie die het naampatroon van het onderdeel (bestand, map, symbolische link) beschrijft dat moet worden uitgesloten; geen enkel uitsluiten als leeg (standaardwaarde) types_incl - te vermelden mappen, mogelijke waarden: file - gewoon bestand, dir - submap, sym - symbolische link, sock - socket, bdev - blokapparaat, cdev - karakterapparaat, fifo - FIFO, dev - synoniem voor "bdev,cdev", all - alle typen (standaard), dat wil zeggen "file,dir,sym,sock,bdev,cdev,fifo". Meerdere typen moeten worden gescheiden met een komma en tussen aanhalingstekens worden geplaatst. types_excl - typen mappen (zie <types_incl>) die NIET moeten worden vermeld. Als een typenamen zich zowel in <types_incl> als in <types_excl> bevindt, worden mappen van dit type NIET vermeld. max_depth - maximale diepte van submappen om doorheen te gaan. -1 (standaard) - onbeperkt, 0 - niet afdalen in submappen. min_size - minimale grootte (in bytes) voor een bestand dat moet worden vermeld. Kleinere bestanden worden niet vermeld. Geheugenachtervoegsels kunnen worden gebruikt. max_size - maximale grootte (in bytes) voor een bestand dat moet worden vermeld. Grotere bestanden worden niet vermeld. Geheugenachtervoegsels kunnen worden gebruikt. min_age - minimale leeftijd (in seconden) van een mapvermelding die moet worden vermeld. Recente vermeldingen worden niet vermeld. Tijdachtervoegsels kunnen worden gebruikt. max_age - maximale leeftijd (in seconden) van een mapvermelding die moet worden vermeld. Vermeldingen die zo oud of ouder zijn, worden niet vermeld (wijzigingstijd). Tijdachtervoegsels kunnen worden gebruikt. regex_excl_dir - reguliere expressie die het naampatroon van de map beschrijft die moet worden uitgesloten. Alle inhoud van de map wordt uitgesloten (in tegenstelling tot regex_excl) |
Omgevingsvariabelen, zoals %APP_HOME%, $HOME en %TEMP%, worden niet ondersteund.Pseudomappen "." en ".." worden nooit vermeld. Symbolische koppelingen worden nooit gevolgd voor mapdoorloop. Op Windows worden symbolische mappen overgeslagen. Zowel regex_incl als regex_excl worden toegepast op bestanden en mappen bij het genereren van de vermeldingslijst, maar worden genegeerd bij het kiezen van submappen om doorheen te gaan (als regex_incl "^(?i)^.+\.zip$" is en max_depth niet is ingesteld, dan worden alle submappen doorlopen, maar worden alleen bestanden van het type zip vermeld).De uitvoeringstijd wordt beperkt door de time-outwaarde in de agent configuratie. Omdat het doorzoeken van grote mappen langer kan duren dan dat, worden er geen gegevens geretourneerd en wordt het item niet ondersteund. Er wordt geen gedeeltelijke lijst geretourneerd. Bij filteren op grootte hebben alleen gewone bestanden betekenisvolle groottes. Onder Linux en BSD hebben mappen ook niet-nul groottes (meestal een paar Kb). Apparaten hebben nul groottes, bijvoorbeeld de grootte van /dev/sda1 weerspiegelt niet de grootte van de respectievelijke partitie. Daarom is het bij gebruik van <min_size> en <max_size> raadzaam om <types_incl> in te stellen op "file", om verrassingen te voorkomen.Voorbeelden: ⇒ vfs.dir.get[/dev] - haalt een lijst met apparaten op in /dev (Linux) ⇒ vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] - haalt een lijst met bestanden op in de tijdelijke map (Windows) Ondersteund sinds Zabbix 6.0.0. |
| vfs.dir.size[dir,<regex_incl>,<regex_excl>,<mode>,<max_depth>,<regex_excl_dir>] | |||
| Mapgrootte (in bytes). | Integer | dir - absoluut pad naar de map regex_incl - reguliere expressie die het naampatroon van het onderdeel (bestand, map, symbolische link) beschrijft dat moet worden opgenomen; alles opnemen als leeg (standaardwaarde) regex_excl - reguliere expressie die het naampatroon van het onderdeel (bestand, map, symbolische link) beschrijft dat moet worden uitgesloten; geen enkel uitsluiten als leeg (standaardwaarde) mode - mogelijke waarden: apparent (standaard) - geeft schijnbare bestandsgroottes weer in plaats van schijfgebruik (gedraagt zich als du -sb dir), disk - geeft schijfgebruik weer (gedraagt zich als du -s -B1 dir). In tegenstelling tot het du-commando houdt het item vfs.dir.size rekening met verborgen bestanden bij het berekenen van de mapgrootte (gedraagt zich als du -sb .[^.]* * binnen dir).max_depth - maximale diepte van submappen om doorheen te gaan. -1 (standaard) - onbeperkt, 0 - niet afdalen in submappen. regex_excl_dir - reguliere expressie die het naampatroon van de map beschrijft die moet worden uitgesloten. Alle inhoud van de map wordt uitgesloten (in tegenstelling tot regex_excl) |
Alleen mappen met ten minste leesmachtigingen voor de zabbix-gebruiker worden berekend. Op Windows wordt elke symbolische koppeling overgeslagen en harde koppelingen worden slechts één keer in aanmerking genomen. Bij grote mappen of trage schijven kan dit item time-out veroorzaken vanwege de time-outinstelling in de configuratiebestanden van agent en server/proxy. Verhoog indien nodig de time-outwaarden. Voorbeelden: ⇒ vfs.dir.size[/tmp,log] - berekent de grootte van alle bestanden in /tmp die 'log' bevatten ⇒ vfs.dir.size[/tmp,log,^.+\.old$] - berekent de grootte van alle bestanden in /tmp die 'log' in hun namen bevatten, waarbij bestanden met namen die eindigen op '.old' worden uitgesloten De bestandsgroottelimiet hangt af van ondersteuning voor grote bestanden. Ondersteund sinds Zabbix 3.4.0. |
| vfs.file.cksum[file,<mode>] | |||
| Bestandschecksum, berekend met het UNIX cksum-algoritme. | Integer - met mode als crc32String - met mode als md5, sha256 |
file - volledig pad naar het bestand mode - crc32 (standaard), md5, sha256 |
Voorbeeld: => vfs.file.cksum[/etc/passwd] Voorbeeld van geretourneerde waarden (respectievelijk crc32/md5/sha256): 675436101 9845acf68b73991eb7fd7ee0ded23c44 ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc De bestandsgroottelimiet hangt af van ondersteuning voor grote bestanden. De parameter mode wordt ondersteund sinds Zabbix 6.0. |
| vfs.file.contents[file,<encoding>] | |||
| Inhoud van een bestand ophalen. | Tekst | file - volledig pad naar het bestand encoding - codepagina identificator |
Geeft een lege tekenreeks terug als het bestand leeg is of alleen LF/CR-karakters bevat. De bytevolgorde-markering (BOM) wordt uit de uitvoer uitgesloten. Voorbeeld: => vfs.file.contents[/etc/passwd] Dit item is beperkt tot bestanden die niet groter zijn dan 64 Kbytes. Ondersteund sinds Zabbix 2.0. |
| vfs.file.exists[bestand,<types_incl>,<types_excl>] | |||
| Controleert of het bestand bestaat. | 0 - niet gevonden 1 - bestand van het gespecificeerde type bestaat |
bestand - volledig pad naar bestand types_incl - lijst van bestandstypen om op te nemen, mogelijke waarden: bestand (regulier bestand, standaard (indien types_excl niet is ingesteld)), dir (map), sym (symbolische koppeling), sock (socket), bdev (blokapparaat), cdev (karakterapparaat), fifo (FIFO), dev (synoniem voor "bdev,cdev"), all (alle genoemde typen, standaard als types_excl is ingesteld). types_excl - lijst van bestandstypen om uit te sluiten, zie types_incl voor mogelijke waarden (standaard worden geen typen uitgesloten) |
Meerdere typen moeten worden gescheiden door een komma en de hele set moet tussen aanhalingstekens "" staan. Op Windows moeten de dubbele aanhalingstekens worden ontsnapt met een schuine streep '\' en het hele item moet tussen dubbele aanhalingstekens worden geplaatst bij gebruik van het commandoregelhulpprogramma voor het aanroepen van zabbix_get.exe of agent2. Als hetzelfde type zowel in <types_incl> als in <types_excl> staat, worden bestanden van dit type uitgesloten. Voorbeelden: => vfs.file.exists[/tmp/application.pid] => vfs.file.exists[/tmp/application.pid,"bestand,map,sym"] => vfs.file.exists[/tmp/application_dir,map] De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. Houd er rekening mee dat het item niet wordt ondersteund op Windows als er binnenin een niet-bestaande map wordt gezocht, bijvoorbeeld vfs.file.exists[C:\no\dir,map] (waar 'no' niet bestaat). |
| vfs.file.get[bestand] | |||
| Geeft informatie over een bestand. | JSON-object | bestand - volledig pad naar bestand | Ondersteunde bestandstypen op UNIX-achtige systemen: regulier bestand, map, symbolische koppeling, socket, blokapparaat, karakterapparaat, FIFO Ondersteunde bestandstypen op Windows: regulier bestand, map, symbolische koppeling Voorbeeld: => vfs.file.get[/etc/passwd] → geeft een JSON met informatie over het bestand /etc/passwd (type, gebruiker, machtigingen, SID, uid, enz.) De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. Ondersteund sinds Zabbix 6.0. |
| vfs.file.md5sum[bestand] | |||
| MD5-checksum van het bestand. | Karakterreeks (MD5-hash van het bestand) | bestand - volledig pad naar bestand | Voorbeeld: => vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf] Voorbeeld van geretourneerde waarde: b5052decb577e0fffd622d6ddc017e82 De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. |
| vfs.file.owner[bestand,<eigendomstype>,<resultaattype>] | |||
| Haal de eigenaar van een bestand op. | Karakterreeks | bestand - volledig pad naar bestand eigendomstype - gebruiker (standaard) of groep (alleen Unix) resultaattype - naam (standaard) of id; voor id - retourneert uid/gid op Unix, SID op Windows |
Voorbeeld: => vfs.file.owner[/tmp/zabbix_server.log] → retourneert bestandeigenaar van /tmp/zabbix_server.log => vfs.file.owner[/tmp/zabbix_server.log,,id] → retourneert bestandeigenaar-ID van /tmp/zabbix_server.log De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. Ondersteund sinds Zabbix 6.0. |
| vfs.file.permissions[bestand] | |||
| Retourneert een 4-cijferige tekenreeks met het octale nummer van Unix-machtigingen. | Tekenreeks | bestand - volledig pad naar bestand | Niet ondersteund op Windows. Voorbeeld: => vfs.file.permissions[/etc/passwd] → retourneert machtigingen van /etc/passwd, bijvoorbeeld '0644' De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. Ondersteund sinds Zabbix 6.0. |
| vfs.file.regexp[bestand,regexp,<codering>,<startregel>,<eindregel>,<uitvoer>] | |||
| Zoek een tekenreeks in een bestand. | De regel met de overeenkomende tekenreeks, of zoals gespecificeerd door de optionele parameter uitvoer |
bestand - volledig pad naar bestand regexp - reguliere expressie die het vereiste patroon beschrijft codering - codepagina identificatie startregel - het nummer van de eerste regel om te doorzoeken (eerste regel van bestand standaard). eindregel - het nummer van de laatste regel om te doorzoeken (laatste regel van bestand standaard). uitvoer - een optioneel uitvoerformatteringssjabloon. De \0-escape-sequentie wordt vervangen door het overeenkomende deel van de tekst (vanaf het eerste teken waar de overeenkomst begint tot het teken waar de overeenkomst eindigt), terwijl een \N (waar N=1...9) escape-sequentie wordt vervangen door de N-de overeenkomende groep (of een lege tekenreeks als N groter is dan het aantal vastgelegde groepen). |
Alleen de eerste overeenkomende regel wordt geretourneerd. Een lege tekenreeks wordt geretourneerd als geen enkele regel aan de expressie voldeed. Byte Order Mark (BOM) wordt uitgesloten van de uitvoer. De inhoudsextractie met behulp van de uitvoer-parameter vindt plaats op de agent.De parameters startregel, eindregel en uitvoer worden ondersteund vanaf versie 2.2.Voorbeelden: => vfs.file.regexp[/etc/passwd,zabbix] => vfs.file.regexp[/pad/naar/enig/bestand,"([0-9]+)$",,3,5,\1] => vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] → verkrijgen van het ID van gebruiker zabbix De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. |
| vfs.file.regmatch[bestand,regexp,<codering>,<startregel>,<eindregel>] | |||
| Zoek een tekenreeks in een bestand. | 0 - geen overeenkomst gevonden 1 - overeenkomst gevonden |
bestand - volledig pad naar bestand regexp - reguliere expressie die het vereiste patroon beschrijft codering - codepagina identificatie startregel - het nummer van de eerste regel om te doorzoeken (eerste regel van bestand standaard). eindregel - het nummer van de laatste regel om te doorzoeken (laatste regel van bestand standaard). |
Byte Order Mark (BOM) wordt genegeerd. De parameters startregel en eindregel worden ondersteund vanaf versie 2.2.Voorbeeld: => vfs.file.regmatch[/var/log/app.log,error] De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. |
| vfs.file.size[bestand,<modus>] | |||
| Bestandsgrootte (in bytes). | Geheel getal | bestand - volledig pad naar bestand modus - mogelijke waarden: bytes (standaard) of regels (lege regels worden ook geteld) |
Het bestand moet leesrechten hebben voor gebruiker zabbix. Voorbeeld: => vfs.file.size[/var/log/syslog] De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. De parameter modus wordt ondersteund sinds Zabbix 6.0. |
| vfs.file.time[bestand,<modus>] | |||
| Informatie over bestandstijden. | Geheel getal (Unix-tijdstempel) | bestand - volledig pad naar bestand modus - mogelijke waarden: modify (standaard) - laatste tijd van wijzigen van bestandsinhoud, access - laatste tijd van lezen van bestand, change - laatste tijd van wijzigen van bestandseigenschappen |
Voorbeeld: => vfs.file.time[/etc/passwd,modify] De bestandsgroottebeperking is afhankelijk van ondersteuning voor grote bestanden. |
| vfs.fs.discovery | |||
| Lijst van aangekoppelde bestandssystemen en hun typen. Gebruikt voor ontdekking op laag niveau. | JSON-object | Ondersteund sinds Zabbix 2.0. De {#FSDRIVETYPE}-macro wordt ondersteund op Windows sinds Zabbix 3.0. De {#FSLABEL}-macro wordt ondersteund op Windows sinds Zabbix 6.0. |
|
| vfs.fs.get | |||
| Lijst van aangekoppelde bestandssystemen, hun typen, schijfruimte en inode-statistieken. Kan worden gebruikt voor ontdekking op laag niveau. | JSON-object | De {#FSLABEL}-macro wordt ondersteund op Windows sinds Zabbix 6.0. Sinds Zabbix 6.0.11 kan dit item bestandssystemen rapporteren waarbij het inode-aantal gelijk is aan nul, wat het geval kan zijn bij bestandssystemen met dynamische inodes (bijv. btrfs). |
|
| vfs.fs.inode[fs,<modus>] | |||
| Aantal of percentage inodes. | Geheel getal - voor aantal Drijvend getal - voor percentage |
fs - bestandssysteem modus - mogelijke waarden: total (standaard), free, used, pfree (vrij, percentage), pused (gebruikt, percentage) |
Sinds Zabbix 6.0.11 wordt dit item niet onbruikbaar in de pfree/pused-modi als het inode-aantal gelijk is aan nul, wat het geval kan zijn bij bestandssystemen met dynamische inodes (bijv. btrfs). In plaats daarvan worden de pfree/pused-waarden voor dergelijke bestandssystemen respectievelijk gerapporteerd als "100" en "0". Voorbeeld: => vfs.fs.inode[/,pfree] |
| vfs.fs.size[fs,<modus>] | |||
| Schijfruimte in bytes of als percentage van totaal. | Geheel getal - voor bytes Drijvend getal - voor percentage |
fs - bestandssysteem modus - mogelijke waarden: total (standaard), free, used, pfree (vrij, percentage), pused (gebruikt, percentage) |
Als het bestandssysteem niet is aangekoppeld, wordt de grootte geretourneerd van een lokaal bestandssysteem waar het aankoppelpunt zich bevindt. Voorbeeld: => vfs.fs.size[/tmp,free] Gereserveerde ruimte van een bestandssysteem wordt in aanmerking genomen en niet meegeteld bij gebruik van de free-modus. |
Gegevens over virtueel geheugen
| Item sleutel | |||
|---|---|---|---|
| Omschrijving | Teruggegeven waarde | Parameters | Opmerkingen |
| vm.memory.size[<modus>] | |||
| Geheugengrootte in bytes of als percentage van het totaal. | Geheel getal - voor bytes Decimaal getal - voor percentage |
modus - mogelijke waarden: total (standaard), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (gebruikt, percentage), available, pavailable (beschikbaar, percentage) Zie ook platformspecifieke ondersteuning en aanvullende details voor deze parameter. |
Dit item accepteert drie categorieën parameters: 1) total - totale hoeveelheid geheugen; 2) platformspecifieke geheugentypes: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired; 3) schattingen op gebruikersniveau van hoeveel geheugen wordt gebruikt en beschikbaar is: used, pused, available, pavailable. |
Gegevens over webmonitoring
| Item sleutel | |||
|---|---|---|---|
| Omschrijving | Teruggegeven waarde | Parameters | Opmerkingen |
| web.page.get[host,<path>,<port>] | |||
| Inhoud van een webpagina ophalen. | Broncode van de webpagina als tekst (inclusief headers) | host - hostnaam of URL (in de vorm van scheme://host:port/path, waarbij alleen host verplicht is).Toegestane URL-schema's: http, https4. Als het schema ontbreekt, wordt het behandeld als http. Als een URL wordt opgegeven, moeten path en port leeg zijn. Het opgeven van gebruikersnaam/wachtwoord bij verbinding met servers die verificatie vereisen, bijvoorbeeld: http://user:[email protected], is alleen mogelijk met cURL-ondersteuning 4.Punycode wordt ondersteund in hostnamen. path - pad naar HTML-document (standaard is /) port - poortnummer (standaard is 80 voor HTTP) |
Dit item wordt niet ondersteund als de bron die is opgegeven in host niet bestaat of niet beschikbaar is.host kan een hostnaam, domeinnaam, IPv4- of IPv6-adres zijn. Maar voor een IPv6-adres moet de Zabbix-agent gecompileerd zijn met ingeschakelde IPv6-ondersteuning.Voorbeeld: => web.page.get[www.example.com,index.php,80] => web.page.get[https://www.example.com] => web.page.get[https://blog.example.com/?s=zabbix] => web.page.get[localhost:80] => web.page.get["[::1]/server-status"] |
| web.page.perf[host,<path>,<port>] | |||
| Laadtijd van volledige webpagina (in seconden). | Decimaal getal | host - hostnaam of URL (in de vorm van scheme://host:port/path, waarbij alleen host verplicht is).Toegestane URL-schema's: http, https4. Als het schema ontbreekt, wordt het behandeld als http. Als een URL wordt opgegeven, moeten path en port leeg zijn. Het opgeven van gebruikersnaam/wachtwoord bij verbinding met servers die verificatie vereisen, bijvoorbeeld: http://user:[email protected], is alleen mogelijk met cURL-ondersteuning 4.Punycode wordt ondersteund in hostnamen. path - pad naar HTML-document (standaard is /) port - poortnummer (standaard is 80 voor HTTP) |
Dit item wordt niet ondersteund als de bron die is opgegeven in host niet bestaat of niet beschikbaar is.host kan een hostnaam, domeinnaam, IPv4- of IPv6-adres zijn. Maar voor een IPv6-adres moet de Zabbix-agent gecompileerd zijn met ingeschakelde IPv6-ondersteuning.Voorbeeld: => web.page.perf[www.example.com,index.php,80] => web.page.perf[https://www.example.com] |
| web.page.regexp[host,<path>,<port>,regexp,<length>,<output>] | |||
| Een tekenreeks op een webpagina vinden. | De overeenkomende tekenreeks, of zoals gespecificeerd door de optionele parameter output |
host - hostnaam of URL (in de vorm van scheme://host:port/path, waarbij alleen host verplicht is).Toegestane URL-schema's: http, https4. Als het schema ontbreekt, wordt het behandeld als http. Als een URL wordt opgegeven, moeten path en port leeg zijn. Het opgeven van gebruikersnaam/wachtwoord bij verbinding met servers die verificatie vereisen, bijvoorbeeld: http://user:[email protected], is alleen mogelijk met cURL-ondersteuning 4.Punycode wordt ondersteund in hostnamen. path - pad naar HTML-document (standaard is /) port - poortnummer (standaard is 80 voor HTTP) regexp - reguliere expressie die het vereiste patroon beschrijft length - maximaal aantal tekens om terug te geven output - een optionele output-opmaaksjabloon. De \0 escape-sequentie wordt vervangen door het overeenkomende deel van de tekst (vanaf het eerste teken waar de overeenkomst begint tot het teken waar de overeenkomst eindigt), terwijl een \N (waar N=1...9) escape-sequentie wordt vervangen door de N-de overeenkomende groep (of een lege tekenreeks als N groter is dan het aantal vastgelegde groepen). |
Dit item wordt niet ondersteund als de bron die is opgegeven in host niet bestaat of niet beschikbaar is.host kan een hostnaam, domeinnaam, IPv4- of IPv6-adres zijn. Maar voor een IPv6-adres moet de Zabbix-agent gecompileerd zijn met ingeschakelde IPv6-ondersteuning.Inhoudsextractie met behulp van de output-parameter vindt plaats op de agent.De output-parameter wordt ondersteund vanaf versie 2.2.Voorbeeld: => web.page.regexp[www.example.com,index.php,80,OK,2] => web.page.regexp[https://www.example.com,,,OK,2] |