1 Zabbix Agent

Übersicht

Dieser Abschnitt enthält Details zu den Datenpunktschlüsseln, die die Kommunikation mit dem Zabbix Agent zur Datenerfassung verwenden.

Es gibt passive und aktive Agent-Prüfungen. Bei der Konfiguration eines Datenpunkts können Sie den erforderlichen Typ auswählen:

• Zabbix Agent - für passive Prüfungen
• Zabbix Agent (active) - für aktive Prüfungen

Beachten Sie, dass alle vom Zabbix Agent unterstützten Datenpunktschlüssel auch vom Zabbix Agent 2 der neuen Generation unterstützt werden. Siehe die zusätzlichen Datenpunktschlüssel, die Sie nur mit Agent 2 verwenden können.

Unterstützte item keys

Die item keys, die Sie mit dem Zabbix Agent verwenden können, sind unten aufgeführt.

Die item keys sind ohne Parameter und zusätzliche Informationen aufgeführt. Klicken Sie auf den item key, um die vollständigen Details anzuzeigen.

Unterstützte Plattformen

Sofern in den Details des Datenpunkts nicht anders angegeben, werden die Agent-Datenpunkte (und alle Parameter) unterstützt auf:

• Linux
• FreeBSD
• Solaris
• HP-UX
• AIX
• MacOS X
• OpenBSD
• NetBSD

Viele Agent-Datenpunkte werden auch unter Windows unterstützt. Siehe die Seite Windows-Agent-Datenpunkt für Details.

Details zum Datenpunktschlüssel

Parameter ohne spitze Klammern sind obligatorisch. Parameter, die mit spitzen Klammern < > gekennzeichnet sind, sind optional.

kernel.maxfiles

Die maximale Anzahl geöffneter Dateien, die vom Betriebssystem unterstützt wird.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.

kernel.maxproc

Die maximale Anzahl von Prozessen, die vom Betriebssystem unterstützt wird.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux 2.6 und höher, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

kernel.openfiles

Die Anzahl der derzeit offenen Dateideskriptoren.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux (der Datenpunkt kann auch auf anderen UNIX-ähnlichen Plattformen funktionieren).

log[file,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]

Die Überwachung einer Protokolldatei.
Rückgabewert: Log.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad und Name einer Protokolldatei;
  
• regexp - ein regulärer Ausdruck, der das erforderliche Muster beschreibt;
  
• encoding - die Kennung der Codepage;
  
• maxlines - die maximale Anzahl neuer Zeilen pro Sekunde, die der Agent an den Zabbix Server oder Proxy sendet. Dieser Parameter überschreibt den Wert von 'MaxLinesPerSecond' in zabbix_agentd.conf;
  
• mode - mögliche Werte: all (Standard) oder skip - Verarbeitung älterer Daten überspringen (betrifft nur neu erstellte Datenpunkte);
  
• output - eine optionale Vorlage für die Ausgabeformatierung. Die Escape-Sequenz \0 wird durch den übereinstimmenden Teil des Textes ersetzt (vom ersten Zeichen, an dem die Übereinstimmung beginnt, bis zu dem Zeichen, an dem sie endet), während eine Escape-Sequenz \N (wobei N=1...9) durch die N-te übereinstimmende Gruppe ersetzt wird (oder durch eine leere Zeichenfolge, wenn N die Anzahl der erfassten Gruppen überschreitet);
  
• maxdelay - die maximale Verzögerung in Sekunden. Typ: float. Werte: 0 - (Standard) Zeilen der Protokolldatei niemals ignorieren; > 0.0 - ältere Zeilen ignorieren, um die neuesten Zeilen innerhalb von "maxdelay" Sekunden analysieren zu können. Lesen Sie vor der Verwendung die Hinweise zu maxdelay!
  
• options - zusätzliche Optionen:
  mtime-noreread - nicht eindeutige Datensätze, nur erneut lesen, wenn sich die Dateigröße ändert (Änderungen der Änderungszeit ignorieren). (Dieser Parameter ist seit 5.0.2 veraltet, da mtime jetzt ignoriert wird.)
  
• persistent dir (nur in zabbix_agentd auf Unix-Systemen; in Zabbix agent 2 nicht unterstützt) - der absolute Verzeichnispfad, in dem persistente Dateien gespeichert werden. Siehe auch zusätzliche Hinweise zu persistenten Dateien.

Kommentare:

• Der Datenpunkt muss als aktive Prüfung konfiguriert sein.
• Wenn die Datei fehlt oder Berechtigungen den Zugriff nicht erlauben, wird der Datenpunkt nicht unterstützt.
• Wenn output leer bleibt, wird die gesamte Zeile zurückgegeben, die den übereinstimmenden Text enthält. Beachten Sie, dass alle globalen Typen regulärer Ausdrücke außer 'Result is TRUE' immer die gesamte übereinstimmende Zeile zurückgeben und der Parameter output ignoriert wird.
• Die Inhaltsextraktion mit dem Parameter output erfolgt auf dem Agent.

Beispiele:

log[/var/log/syslog]
log[/var/log/syslog,error]
log[/home/zabbix/logs/logfile,,,100]

Beispiel für die Verwendung des Parameters output, um eine Zahl aus einem Protokolldatensatz zu extrahieren:

log[/app1/app.log,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.

Beispiel für die Verwendung des Parameters output, um einen Protokolldatensatz vor dem Senden an den Server umzuschreiben:

log[/app1/app.log,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to the server.

log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]

Die Anzahl der übereinstimmenden Zeilen in einer überwachten Protokolldatei.
Rückgabewert: Integer.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad und Name der Protokolldatei;
  
• regexp - ein regulärer Ausdruck, der das erforderliche Muster beschreibt;
  
• encoding - die Kennung der Codepage;
  
• maxproclines - die maximale Anzahl neuer Zeilen pro Sekunde, die der Agent analysiert (darf 10000 nicht überschreiten). Der Standardwert ist 10*'MaxLinesPerSecond' in zabbix_agentd.conf.
  
• mode - mögliche Werte: all (Standard) oder skip - Verarbeitung älterer Daten überspringen (betrifft nur neu erstellte Datenpunkte).
  
• maxdelay - die maximale Verzögerung in Sekunden. Typ: float. Werte: 0 - (Standard) Zeilen der Protokolldatei niemals ignorieren; > 0.0 - ältere Zeilen ignorieren, damit die neuesten Zeilen innerhalb von "maxdelay" Sekunden analysiert werden. Lesen Sie vor der Verwendung die Hinweise zu maxdelay!
  
• options - zusätzliche Optionen:
  mtime-noreread - nicht eindeutige Datensätze, nur erneut lesen, wenn sich die Dateigröße ändert (Änderungen der Änderungszeit ignorieren). (Dieser Parameter ist seit 5.0.2 veraltet, da mtime jetzt ignoriert wird.)
  
• persistent dir (nur in zabbix_agentd auf Unix-Systemen; in Zabbix Agent 2 nicht unterstützt) - der absolute Pfadname des Verzeichnisses, in dem persistente Dateien gespeichert werden. Siehe auch zusätzliche Hinweise zu persistenten Dateien.

Kommentare:

• Der Datenpunkt muss als aktive Prüfung konfiguriert sein.
• Übereinstimmende Zeilen werden in den neuen Zeilen seit der letzten Protokolldateiprüfung durch den Agent gezählt und hängen daher vom Aktualisierungsintervall des Datenpunkts ab.
• Wenn die Datei fehlt oder die Berechtigungen keinen Zugriff erlauben, wird der Datenpunkt nicht unterstützt.

logrt[file regexp,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]

Die Überwachung einer rotierten Protokolldatei.
Rückgabewert: Log.
Siehe unterstützte Plattformen.

Parameter:

• file regexp - der absolute Pfad zur Datei, wobei der Dateiname mithilfe eines regulären Ausdrucks angegeben wird. Beachten Sie, dass der reguläre Ausdruck nur auf den Dateinamen angewendet wird und nicht mit dem gesamten Namen übereinstimmen muss (z. B. stimmt /path/to/agent mit zabbix_agentd.log überein).
  
• regexp - ein regulärer Ausdruck, der das erforderliche Inhaltsmuster beschreibt.
  
• encoding - der Codepage-Bezeichner.
  
• maxlines - die maximale Anzahl neuer Zeilen pro Sekunde, die der Agent an den Zabbix Server oder Proxy sendet. Dieser Parameter überschreibt den Wert von 'MaxLinesPerSecond' in zabbix_agentd.conf.
  
• mode - mögliche Werte: all (Standard) oder skip - Verarbeitung älterer Daten überspringen (wirkt sich nur auf neu erstellte Datenpunkte aus).
  
• output - eine optionale Vorlage für die Ausgabeformatierung. Die Escape-Sequenz \0 wird durch den übereinstimmenden Teil des Textes ersetzt (vom ersten Zeichen, an dem die Übereinstimmung beginnt, bis zu dem Zeichen, an dem die Übereinstimmung endet), während eine Escape-Sequenz \N (wobei N=1...9) durch die N-te übereinstimmende Gruppe ersetzt wird (oder durch eine leere Zeichenfolge, wenn N größer als die Anzahl der erfassten Gruppen ist).
  
• maxdelay - die maximale Verzögerung in Sekunden. Typ: float. Werte: 0 - (Standard) Protokolldateizeilen niemals ignorieren; > 0.0 - ältere Zeilen ignorieren, um die neuesten Zeilen zu erhalten, die innerhalb von "maxdelay" Sekunden analysiert werden. Lesen Sie vor der Verwendung die Hinweise zu maxdelay!
  
• options - der Typ der Protokolldateirotation und weitere Optionen. Mögliche Werte:
  rotate (Standard),
  copytruncate - beachten Sie, dass copytruncate nicht zusammen mit maxdelay verwendet werden kann. In diesem Fall muss maxdelay 0 sein oder darf nicht angegeben werden; siehe Hinweise zu copytruncate,
  mtime-reread - nicht eindeutige Datensätze, erneut lesen, wenn sich Änderungszeit oder Größe ändern (wird standardmäßig verwendet, wenn keine mtime-*-Option explizit gesetzt ist),
  mtime-noreread - nicht eindeutige Datensätze, nur erneut lesen, wenn sich die Größe ändert (Änderung der Änderungszeit ignorieren).
  
• persistent dir (nur in zabbix_agentd auf Unix-Systemen; in Zabbix Agent 2 nicht unterstützt) - der absolute Pfad des Verzeichnisses, in dem persistente Dateien gespeichert werden. Siehe auch zusätzliche Hinweise zu persistenten Dateien.

Kommentare:

• Der Datenpunkt muss als aktiver Check konfiguriert sein.
• Die Protokolldateirotation basiert auf der letzten Änderungszeit der Dateien.
• Beachten Sie, dass logrt dafür ausgelegt ist, mit einer aktuell aktiven Protokolldatei zu arbeiten, während mehrere andere passende inaktive Dateien rotiert werden. Wenn ein Verzeichnis beispielsweise viele aktive Protokolldateien enthält, sollte für jede einzelne ein separater logrt-Datenpunkt erstellt werden. Andernfalls kann es, wenn ein logrt-Datenpunkt zu viele Dateien erfasst, zu erschöpftem Speicher und einem Absturz der Überwachung kommen.
• Wenn output leer gelassen wird, wird die gesamte Zeile zurückgegeben, die den übereinstimmenden Text enthält. Beachten Sie, dass alle globalen regulären Ausdruckstypen außer 'Result is TRUE' immer die gesamte übereinstimmende Zeile zurückgeben und der Parameter output ignoriert wird.
• Die Extraktion von Inhalten mithilfe des Parameters output erfolgt auf dem Agent.
• Im Parameter file regexp müssen der Pfad des Protokollverzeichnisses und der reguläre Ausdruck der Protokolldatei durch das korrekte Verzeichnistrennzeichen getrennt werden:
  • unter Windows muss das Trennzeichen ein Backslash (\) sein; Schrägstriche können an anderen Stellen toleriert werden, außer an der Stelle, die den Pfad des Protokollverzeichnisses und den regulären Ausdruck der Protokolldatei trennt (siehe Beispiele unten).
  • auf anderen Systemen muss es ein Schrägstrich (/) sein.

Beispiele für Windows:

logrt["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #this item will collect data from log files in "c:/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log".
logrt["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #this item will collect data from log files in the network share "//example.com/share/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log".

Beispiele für andere Systeme:

logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #this item will match a file like "logfile1" (will not match ".logfile1").
logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #this item will collect data from files such as "logfile_abc_1" or "logfile__001".

Beispiel für die Verwendung des Parameters output zum Extrahieren einer Zahl aus einem Protokolleintrag:

logrt[/app1/^test.*log$,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.

Beispiel für die Verwendung des Parameters output zum Umschreiben eines Protokolleintrags vor dem Senden an den Server:

logrt[/app1/^test.*log$,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server.

logrt.count[file regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]

Die Anzahl der übereinstimmenden Zeilen in einer überwachten rotierenden Protokolldatei.
Rückgabewert: Integer.
Siehe unterstützte Plattformen.

Parameter:

• file regexp - der absolute Pfad zur Datei, wobei der Dateiname mithilfe eines regulären Ausdrucks angegeben wird. Beachten Sie, dass der reguläre Ausdruck nur auf den Dateinamen angewendet wird und nicht mit dem gesamten Namen übereinstimmen muss (z. B. /path/to/agent stimmt mit zabbix_agentd.log überein).
  
• regexp - ein regulärer Ausdruck, der das erforderliche Muster beschreibt.
  
• encoding - der Codepage-Bezeichner.
  
• maxproclines - die maximale Anzahl neuer Zeilen pro Sekunde, die der Agent analysiert (darf 10000 nicht überschreiten). Der Standardwert ist 10*'MaxLinesPerSecond' in zabbix_agentd.conf.
  
• mode - mögliche Werte: all (Standard) oder skip - die Verarbeitung älterer Daten überspringen (wirkt sich nur auf neu erstellte Datenpunkte aus).
  
• maxdelay - die maximale Verzögerung in Sekunden. Typ: float. Werte: 0 - (Standard) Protokolldateizeilen niemals ignorieren; > 0.0 - ältere Zeilen ignorieren, um die neuesten Zeilen innerhalb von "maxdelay" Sekunden analysieren zu lassen. Lesen Sie vor der Verwendung die Hinweise zu maxdelay!
  
• options - der Typ der Protokolldateirotation und weitere Optionen. Mögliche Werte:
  rotate (Standard),
  copytruncate - beachten Sie, dass copytruncate nicht zusammen mit maxdelay verwendet werden kann. In diesem Fall muss maxdelay 0 sein oder darf nicht angegeben werden; siehe Hinweise zu copytruncate,
  mtime-reread - nicht eindeutige Datensätze, erneut lesen, wenn sich Änderungszeit oder Größe ändert (Standard),
  mtime-noreread - nicht eindeutige Datensätze, erneut lesen nur, wenn sich die Größe ändert (Änderung der Änderungszeit ignorieren).
  
• persistent dir (nur in zabbix_agentd auf Unix-Systemen; nicht unterstützt in Zabbix agent 2) - der absolute Pfad des Verzeichnisses, in dem persistente Dateien gespeichert werden. Siehe auch zusätzliche Hinweise zu persistenten Dateien.

Kommentare:

• Der Datenpunkt muss als aktiver Check konfiguriert sein.
• Übereinstimmende Zeilen werden in den neuen Zeilen seit der letzten Protokollprüfung durch den Agent gezählt und hängen daher vom Aktualisierungsintervall des Datenpunkts ab.
• Die Protokolldateirotation basiert auf der letzten Änderungszeit der Dateien.
• Im Parameter file regexp müssen der Protokollverzeichnispfad und der reguläre Ausdruck für die Protokolldatei durch das korrekte Verzeichnistrennzeichen getrennt sein:
  • unter Windows muss das Trennzeichen ein Backslash (\) sein; Schrägstriche können an anderen Stellen toleriert werden, außer an der Stelle, die den Protokollverzeichnispfad und den regulären Ausdruck für die Protokolldatei trennt (siehe Beispiele unten).
  • auf anderen Systemen muss es ein Schrägstrich (/) sein.

Beispiele für Windows:

logrt.count["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #dieser Datenpunkt zählt die Anzahl der Übereinstimmungen für das Muster "pattern_to_match" in Protokolldateien im Verzeichnis "c:/dir1/dir2/dir3".
logrt.count["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #dieser Datenpunkt zählt die Anzahl der Übereinstimmungen für das Muster "pattern_to_match" in Protokolldateien auf der Netzwerkfreigabe "//example.com/share/dir1/dir2/dir3".

Beispiele für andere Systeme:

logrt.count["/home/zabbix/logs/.*","^logfile[0-9]{1,3}$",,100] #dieser Datenpunkt zählt die Anzahl der Übereinstimmungen für das Muster "^logfile[0-9]{1,3}$" in Protokolldateien im Verzeichnis "/home/zabbix/logs".
logrt.count["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #dieser Datenpunkt zählt die Anzahl der Vorkommen des Musters "pattern_to_match" in Protokolldateien im Verzeichnis "/home/user".

modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>]

Liest Modbus-Daten.
Rückgabewert: JSON-String.
Unterstützte Plattformen: Linux, Windows.

Parameter:

• endpoint - der als protocol://connection_string definierte Endpunkt;
  
• slave id - die Slave-ID;
  
• function - die Modbus-Funktion;
  
• address - die Adresse des ersten Registers, der ersten Coil oder des ersten Eingangs;
  
• count - die Anzahl der zu lesenden Datensätze;
  
• type - der Datentyp;
  
• endianness - die Endianness-Konfiguration;
  
• offset - die Anzahl der Register, beginnend bei „address“, deren Ergebnisse verworfen werden.

Unter Windows folgt dieser Datenpunkt UNC-Pfaden im Parameter endpoint, was ein Sicherheitsrisiko darstellen kann.

Siehe eine detaillierte Beschreibung der Parameter.

net.dns[<ip>,name,<type>,<timeout>,<count>,<protocol>]

Prüft den Status eines DNS-Dienstes.
Rückgabewerte: 0 - DNS-Auflösung fehlgeschlagen (DNS-Server hat nicht geantwortet oder einen Fehler zurückgegeben); 1 - DNS-Auflösung erfolgreich.
Siehe unterstützte Plattformen.

Parameter:

• ip (unter Windows ignoriert, außer bei Verwendung von Zabbix Agent 2) - die IP-Adresse des DNS-Servers (leer lassen für den Standard-DNS-Server);
• name - der abzufragende DNS-Name;
• type - der abzufragende Record-Typ (Standard ist SOA);
• timeout (unter Windows ignoriert, außer bei Verwendung von Zabbix Agent 2) - das Timeout für die Anfrage in Sekunden (Standard ist 1 Sekunde);
• count (unter Windows ignoriert, außer bei Verwendung von Zabbix Agent 2) - die Anzahl der Versuche für die Anfrage (Standard ist 2);
• protocol - das für DNS-Abfragen verwendete Protokoll: udp (Standard) oder tcp.

Kommentare:

• Die möglichen Werte für type sind: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (nicht unterstützt für Zabbix Agent unter Windows, Zabbix Agent 2 auf allen Betriebssystemen), HINFO, MINFO, TXT, SRV.
• Für Reverse-DNS-Abfragen (wenn type auf PTR gesetzt ist) können Sie den DNS-Namen sowohl im umgekehrten als auch im nicht umgekehrten Format angeben (siehe Beispiele unten). Beachten Sie, dass bei Anforderung eines PTR-Records der DNS-Name tatsächlich eine IP-Adresse ist.
• Internationalisierte Domainnamen werden nicht unterstützt; verwenden Sie stattdessen bitte IDNA-kodierte Namen.

Beispiele:

net.dns[198.51.100.1,example.com,MX,2,1]

net.dns[,198.51.100.1,PTR]
net.dns[,1.100.51.198.in-addr.arpa,PTR]

net.dns[,2a00:1450:400f:800::200e,PTR]
net.dns[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]

net.dns.perf[<ip>,name,<type>,<timeout>,<count>,<protocol>]

Prüft die Performance eines DNS-Dienstes.
Rückgabewert: Float (0 - Dienst ist nicht verfügbar; Sekunden - die Anzahl der Sekunden, die auf eine Antwort des Dienstes gewartet wurde).
Siehe unterstützte Plattformen.

Parameter:

• ip (unter Windows ignoriert, sofern nicht Zabbix Agent 2 verwendet wird) - die IP-Adresse des DNS-Servers (leer lassen für den Standard-DNS-Server);
• name - der abzufragende DNS-Name;
• type - der abzufragende Record-Typ (Standard ist SOA);
• timeout (unter Windows ignoriert, sofern nicht Zabbix Agent 2 verwendet wird) - das Timeout für die Anfrage in Sekunden (Standard ist 1 Sekunde);
• count (unter Windows ignoriert, sofern nicht Zabbix Agent 2 verwendet wird) - die Anzahl der Versuche für die Anfrage (Standard ist 2);
• protocol - das für DNS-Abfragen verwendete Protokoll: udp (Standard) oder tcp.

Kommentare:

• Die möglichen Werte für type sind:
  ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (nicht unterstützt für Zabbix Agent unter Windows, Zabbix Agent 2 auf allen Betriebssystemen), HINFO, MINFO, TXT, SRV.
• Für Reverse-DNS-Abfragen (wenn type auf PTR gesetzt ist) können Sie den DNS-Namen sowohl im umgekehrten als auch im nicht umgekehrten Format angeben (siehe Beispiele unten). Beachten Sie, dass beim Anfordern eines PTR-Records der DNS-Name tatsächlich eine IP-Adresse ist.
• Internationalisierte Domainnamen werden nicht unterstützt; verwenden Sie stattdessen bitte IDNA-kodierte Namen.
• Der Datenpunkt gibt eine Antwortzeit anstelle von 0 zurück, wenn der DNS-Server mit einem Fehlercode antwortet (zum Beispiel NXDOMAIN oder SERVFAIL).

Beispiele:

net.dns.perf[198.51.100.1,example.com,MX,2,1]

net.dns.perf[,198.51.100.1,PTR]
net.dns.perf[,1.100.51.198.in-addr.arpa,PTR]

net.dns.perf[,2a00:1450:400f:800::200e,PTR]
net.dns.perf[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]

net.dns.record[<ip>,name,<type>,<timeout>,<count>,<protocol>]

Führt eine DNS-Abfrage aus.

Zabbix Agent 2 bietet außerdem net.dns.get, das zusätzliche Funktionen wie weitere Record-Typen und eine bessere Steuerung der DNS-Überwachung bietet. Rückgabewert: eine Zeichenkette mit dem erforderlichen Informationstyp.
Siehe unterstützte Plattformen.

Parameter:

• ip (unter Windows ignoriert, sofern nicht Zabbix Agent 2 verwendet wird) – die IP-Adresse des DNS-Servers (leer lassen für den Standard-DNS-Server);
• name – der abzufragende DNS-Name;
• type – der abzufragende Record-Typ (Standard ist SOA);
• timeout (unter Windows ignoriert, sofern nicht Zabbix Agent 2 verwendet wird) – das Timeout für die Anfrage in Sekunden (Standard ist 1 Sekunde);
• count (unter Windows ignoriert, sofern nicht Zabbix Agent 2 verwendet wird) – die Anzahl der Versuche für die Anfrage (Standard ist 2);
• protocol – das für DNS-Abfragen verwendete Protokoll: udp (Standard) oder tcp.

Kommentare:

• Die möglichen Werte für type sind:
  ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (nicht unterstützt für Zabbix Agent unter Windows, Zabbix Agent 2 auf allen Betriebssystemen), HINFO, MINFO, TXT, SRV.
• Für Reverse-DNS-Abfragen (wenn type auf PTR gesetzt ist) können Sie den DNS-Namen im umgekehrten oder nicht umgekehrten Format angeben (siehe Beispiele unten). Beachten Sie, dass beim Anfordern eines PTR-Records der DNS-Name tatsächlich eine IP-Adresse ist.
• Internationalisierte Domainnamen werden nicht unterstützt; verwenden Sie stattdessen IDNA-kodierte Namen.

Beispiele:

net.dns.record[198.51.100.1,example.com,MX,2,1]

net.dns.record[,198.51.100.1,PTR]
net.dns.record[,1.100.51.198.in-addr.arpa,PTR]

net.dns.record[,2a00:1450:400f:800::200e,PTR]
net.dns.record[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]

net.if.collisions[if]

Die Anzahl der Kollisionen außerhalb des Fensters.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Auf NetBSD sind Root-Rechte erforderlich.

Parameter:

• if - Name der Netzwerkschnittstelle

net.if.discovery

Die Liste der Netzwerkschnittstellen. Wird für Low-Level-Discovery verwendet.
Rückgabewert: JSON-String.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD, Windows.

net.if.in[if,<mode>]

Die Statistik des eingehenden Datenverkehrs auf einer Netzwerkschnittstelle.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. Auf NetBSD sind Root-Rechte erforderlich.

Parameter:

• if - Name der Netzwerkschnittstelle (Unix); vollständige Beschreibung der Netzwerkschnittstelle oder IPv4-Adresse; oder, in geschweiften Klammern, die GUID der Netzwerkschnittstelle (Windows);
• mode - mögliche Werte:
  bytes - Anzahl der Bytes (Standard)
  packets - Anzahl der Pakete
  errors - Anzahl der Fehler
  dropped - Anzahl der verworfenen Pakete
  overruns (fifo) - Anzahl der FIFO-Pufferfehler
  frame - Anzahl der Paket-Frame-Fehler
  compressed - Anzahl der vom Gerätetreiber empfangenen komprimierten Pakete
  multicast - Anzahl der vom Gerätetreiber empfangenen Multicast-Frames

Kommentare:

• Sie können diesen Schlüssel zusammen mit dem Vorverarbeitungsschritt Änderung pro Sekunde verwenden, um die Statistik in Bytes pro Sekunde zu erhalten.
• Der Modus dropped wird nur unter Linux, FreeBSD, HP-UX, MacOS X, OpenBSD und NetBSD unterstützt.
• Die Modi overruns, frame, compressed und multicast werden nur unter Linux unterstützt.
• Unter HP-UX liefert dieser Datenpunkt keine Details zu Loopback-Schnittstellen (z. B. lo0).

Beispiele:

net.if.in[eth0]
net.if.in[eth0,errors]

net.if.out[if,<mode>]

Die Statistik des ausgehenden Datenverkehrs auf einer Netzwerkschnittstelle.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. Auf NetBSD sind Root-Rechte erforderlich.

Parameter:

• if - Name der Netzwerkschnittstelle (Unix); vollständige Beschreibung der Netzwerkschnittstelle oder IPv4-Adresse; oder, in geschweiften Klammern, die GUID der Netzwerkschnittstelle (Windows);
• mode - mögliche Werte:
  bytes - Anzahl der Bytes (Standard)
  packets - Anzahl der Pakete
  errors - Anzahl der Fehler
  dropped - Anzahl der verworfenen Pakete
  overruns (fifo) - Anzahl der FIFO-Pufferfehler
  collisions (colls) - Anzahl der auf der Schnittstelle erkannten Kollisionen
  carrier - Anzahl der vom Gerätetreiber erkannten Trägerverluste
  compressed - Anzahl der vom Gerätetreiber übertragenen komprimierten Pakete

Kommentare:

• Sie können diesen Schlüssel zusammen mit dem Präprozessierungsschritt Änderung pro Sekunde verwenden, um die Statistik in Bytes pro Sekunde zu erhalten.
• Der Modus dropped wird nur unter Linux und HP-UX unterstützt.
• Die Modi overruns, collision, carrier, compressed werden nur unter Linux unterstützt.
• Unter HP-UX liefert dieser Datenpunkt keine Details zu Loopback-Schnittstellen (z. B. lo0).

Beispiele:

net.if.out[eth0]
net.if.out[eth0,errors]

net.if.total[if,<mode>]

Die Summe der Statistiken des eingehenden und ausgehenden Datenverkehrs auf einer Netzwerkschnittstelle.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris⁵, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. Auf NetBSD sind Root-Rechte erforderlich.

Parameter:

• if - Name der Netzwerkschnittstelle (Unix); vollständige Beschreibung der Netzwerkschnittstelle oder IPv4-Adresse; oder, in geschweiften Klammern, die GUID der Netzwerkschnittstelle (Windows);
• mode - mögliche Werte:
  bytes - Anzahl der Bytes (Standard)
  packets - Anzahl der Pakete
  errors - Anzahl der Fehler
  dropped - Anzahl der verworfenen Pakete
  overruns (fifo) - Anzahl der FIFO-Pufferfehler
  collisions (colls) - Anzahl der auf der Schnittstelle erkannten Kollisionen
  compressed - Anzahl der vom Gerätetreiber übertragenen oder empfangenen komprimierten Pakete

Kommentare:

• Sie können diesen Schlüssel zusammen mit dem Vorverarbeitungsschritt Änderung pro Sekunde verwenden, um die Statistik in Bytes pro Sekunde zu erhalten.
• Der Modus dropped wird nur unter Linux und HP-UX unterstützt. Verworfene Pakete werden nur unterstützt, wenn auf Ihrer Plattform sowohl net.if.in als auch net.if.out für verworfene Pakete funktionieren.
• Die Modi overruns, collision, compressed werden nur unter Linux unterstützt.
• Unter HP-UX liefert dieser Datenpunkt keine Details zu Loopback-Schnittstellen (z. B. lo0).

Beispiele:

net.if.total[eth0]
net.if.total[eth0,errors]

net.tcp.listen[port]

Prüft, ob sich dieser TCP-Port im Status LISTEN befindet.
Rückgabewerte: 0 - er befindet sich nicht im Status LISTEN; 1 - er befindet sich im Status LISTEN.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, MacOS X, Windows.

Parameter:

• port - TCP-Portnummer

Unter Linux-Kernels 2.6.14 und höher werden Informationen über lauschende TCP-Sockets nach Möglichkeit über die NETLINK-Schnittstelle des Kernels abgerufen. Andernfalls werden die Informationen aus den Dateien /proc/net/tcp und /roc/net/tcp6 abgerufen.

Beispiel:

net.tcp.listen[80]

net.tcp.port[<ip>,port]

Prüft, ob es möglich ist, eine TCP-Verbindung zum angegebenen Port herzustellen.
Rückgabewerte: 0 - Verbindung nicht möglich; 1 - Verbindung möglich.
Siehe unterstützte Plattformen.

Parameter:

• ip - die IP-Adresse oder der DNS-Name (Standard ist 127.0.0.1);
• port - die Portnummer.

Kommentare:

• Für einfache TCP-Performance-Tests verwenden Sie net.tcp.service.perf[tcp,<ip>,<port>].
• Diese Prüfungen können zu zusätzlichen Meldungen in den Logdateien von System-Daemons führen (SMTP- und SSH-Sitzungen werden üblicherweise protokolliert).

Beispiel:

net.tcp.port[,80] #dieser Datenpunkt kann verwendet werden, um die Verfügbarkeit des Web-Servers auf Port 80 zu testen

net.tcp.service[service,<ip>,<port>]

Prüft, ob ein Dienst läuft und TCP-Verbindungen akzeptiert.
Rückgabewerte: 0 - Dienst ist nicht verfügbar; 1 - Dienst läuft.
Siehe unterstützte Plattformen.

Parameter:

• service - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https oder telnet (siehe Details);
• ip - die IP-Adresse oder der DNS-Name (Standard ist 127.0.0.1);
• port - die Portnummer (standardmäßig wird die Standard-Portnummer des Dienstes verwendet).

Kommentare:

• Diese Prüfungen können zu zusätzlichen Meldungen in den Logdateien der System-Daemons führen (üblicherweise werden SMTP- und SSH-Sitzungen protokolliert).
• Die Prüfung verschlüsselter Protokolle (wie IMAP auf Port 993 oder POP auf Port 995) wird derzeit nicht unterstützt. Als Umgehungslösung verwenden Sie bitte net.tcp.port[] für solche Prüfungen.
• Die Prüfung von LDAP und HTTPS unter Windows wird nur von Zabbix Agent 2 unterstützt.
• Die Telnet-Prüfung sucht nach einer Login-Aufforderung (':' am Ende).

Beispiel:

net.tcp.service[ftp,,45] #dieser Datenpunkt kann verwendet werden, um die Verfügbarkeit des FTP-Servers auf TCP-Port 45 zu testen

net.tcp.service.perf[service,<ip>,<port>]

Prüft die Performance eines TCP-Dienstes.
Rückgabewerte: Float (0 - Dienst ist nicht verfügbar; Sekunden - die Anzahl der Sekunden, die auf eine Antwort des Dienstes gewartet wurde).
Siehe unterstützte Plattformen.

Parameter:

• service - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https oder telnet (siehe Details);
• ip - die IP-Adresse oder der DNS-Name (Standard ist 127.0.0.1);
• port - die Portnummer (standardmäßig wird die Standard-Portnummer des Dienstes verwendet).

Kommentare:

• Die Prüfung verschlüsselter Protokolle (wie IMAP auf Port 993 oder POP auf Port 995) wird derzeit nicht unterstützt. Als Umgehungslösung verwenden Sie bitte net.tcp.service.perf[tcp,<ip>,<port>] für solche Prüfungen.
• Die Telnet-Prüfung sucht nach einer Login-Aufforderung (':' am Ende).

Beispiel:

net.tcp.service.perf[ssh] #dieser Datenpunkt kann verwendet werden, um die Geschwindigkeit der ersten Antwort des SSH-Servers zu testen

net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]

Gibt die Anzahl der TCP-Sockets zurück, die den Parametern entsprechen.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, Windows.

Parameter:

• laddr - die lokale IPv4/6-Adresse oder das CIDR-Subnetz;
• lport - die lokale Portnummer oder der Dienstname;
• raddr - die entfernte IPv4/6-Adresse oder das CIDR-Subnetz;
• rport - die entfernte Portnummer oder der Dienstname;
• state - der Verbindungsstatus (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, close_wait, last_ack, listen, closing).

Beispiel:

net.tcp.socket.count[,80,,,established] #die Anzahl der Verbindungen zu lokalem TCP-Port 80 im Status established

net.udp.listen[port]

Prüft, ob sich dieser UDP-Port im Status LISTEN befindet.
Rückgabewerte: 0 - er befindet sich nicht im Status LISTEN; 1 - er befindet sich im Status LISTEN.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, MacOS X.

Parameter:

• port - UDP-Portnummer

Beispiel:

net.udp.listen[68]

net.udp.service[service,<ip>,<port>]

Prüft, ob ein Dienst läuft und auf UDP-Anfragen antwortet.
Rückgabewerte: 0 - Dienst ist nicht verfügbar; 1 - Dienst läuft.
Siehe unterstützte Plattformen.

Parameter:

• service - ntp (siehe Details);
• ip - die IP-Adresse oder der DNS-Name (Standard ist 127.0.0.1);
• port - die Portnummer (standardmäßig wird die Standard-Portnummer des Dienstes verwendet).

Beispiel:

net.udp.service[ntp,,45] #this item can be used to test the availability of NTP service on UDP port 45

net.udp.service.perf[service,<ip>,<port>]

Prüft die Leistung eines UDP-Dienstes.
Rückgabewerte: Float (0 - Dienst ist nicht verfügbar; Sekunden - die Anzahl der Sekunden, die auf eine Antwort des Dienstes gewartet wurde).
Siehe unterstützte Plattformen.

Parameter:

• service - ntp (siehe Details);
• ip - die IP-Adresse oder der DNS-Name (Standard ist 127.0.0.1);
• port - die Portnummer (standardmäßig wird die Standard-Portnummer des Dienstes verwendet).

Beispiel:

net.udp.service.perf[ntp] #dieser Datenpunkt kann verwendet werden, um die Antwortzeit des NTP-Dienstes zu testen

net.udp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]

Gibt die Anzahl der UDP-Sockets zurück, die den Parametern entsprechen.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, Windows.

Parameter:

• laddr - die lokale IPv4/6-Adresse oder das CIDR-Subnetz;
• lport - die lokale Portnummer oder der Dienstname;
• raddr - die entfernte IPv4/6-Adresse oder das CIDR-Subnetz;
• rport - die entfernte Portnummer oder der Dienstname;
• state - der Verbindungsstatus (established, unconn).

Beispiel:

net.udp.socket.count[,,,,established] #gibt die Anzahl der UDP-Sockets im verbundenen Zustand zurück

proc.cpu.util[<name>,<user>,<type>,<cmdline>,<mode>,<zone>]

Die prozentuale CPU-Auslastung des Prozesses.
Rückgabewert: Float.
Unterstützte Plattformen: Linux, Solaris⁶.

Parameter:

• name - der Prozessname (Standard ist alle Prozesse);
• user - der Benutzername (Standard ist alle Benutzer);
• type - der Typ der CPU-Auslastung: total (Standard), user oder system;
• cmdline - nach Befehlszeile filtern (regulärer Ausdruck);
• mode - der Modus für die Datenerfassung: avg1 (Standard), avg5 oder avg15;
• zone - die Zielzone: current (Standard) oder all. Dieser Parameter wird nur unter Solaris unterstützt.

Kommentare:

• Der zurückgegebene Wert basiert auf der prozentualen Auslastung eines einzelnen CPU-Kerns. Beispielsweise beträgt die CPU-Auslastung eines Prozesses, der zwei Kerne vollständig nutzt, 200 %.
• Die Daten zur CPU-Auslastung des Prozesses werden von einem Kollektor erfasst, der maximal 1024 eindeutige Abfragen (nach Name, Benutzer und Befehlszeile) unterstützt. Abfragen, auf die in den letzten 24 Stunden nicht zugegriffen wurde, werden aus dem Kollektor entfernt.
• Wenn der Parameter zone auf current (oder den Standardwert) gesetzt ist und der Agent auf einem Solaris ohne Zonenunterstützung kompiliert wurde, aber auf einem neueren Solaris mit Zonenunterstützung läuft, gibt der Agent NOTSUPPORTED zurück (der Agent kann die Ergebnisse nicht nur auf die aktuelle Zone beschränken). all wird in diesem Fall jedoch unterstützt.

Beispiele:

proc.cpu.util[,root] #CPU-Auslastung aller Prozesse, die unter dem Benutzer "root" laufen
proc.cpu.util[zabbix_server,zabbix] #CPU-Auslastung aller zabbix_server-Prozesse, die unter dem Benutzer zabbix laufen

proc.get[<name>,<user>,<cmdline>,<mode>]

Die Liste der Betriebssystemprozesse und ihrer Parameter. Kann für Low-Level-Discovery verwendet werden.
Rückgabewert: JSON-String.
Unterstützte Plattformen: Linux, FreeBSD, Windows, OpenBSD, NetBSD.

Parameter:

• name - der Prozessname (Standard: alle Prozesse);
• user - der Benutzername (Standard: alle Benutzer);
• cmdline - nach Befehlszeile filtern (dies ist ein regulärer Ausdruck). Dieser Parameter wird unter Windows nicht unterstützt; auf anderen Plattformen wird er nicht unterstützt, wenn mode auf 'summary' gesetzt ist.
• mode - mögliche Werte:
  process (Standard), thread (für NetBSD nicht unterstützt), summary. Siehe die Liste der Prozessparameter, die für jeden Modus und jedes Betriebssystem zurückgegeben werden.

Kommentare:

• Wenn ein Wert nicht abgerufen werden kann, zum Beispiel aufgrund eines Fehlers (Prozess bereits beendet, fehlende Berechtigungen, Fehler beim Systemaufruf), wird -1 zurückgegeben.
• Siehe die Hinweise zur Auswahl von Prozessen mit den Parametern name und cmdline (Linux-spezifisch).

Beispiele:

proc.get[zabbix_server,zabbix,,process] #Liste aller zabbix_server-Prozesse, die unter dem Benutzer zabbix laufen; gibt einen Eintrag pro PID zurück
proc.get[java,,,thread] #Liste aller Java-Prozesse; gibt einen Eintrag pro Thread zurück
proc.get[,zabbix,,summary] #Kombinierte Daten für Prozesse jedes Typs, die unter dem Benutzer zabbix laufen; gibt einen Eintrag pro Prozessnamen zurück

proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>]

Der vom Prozess verwendete Speicher in Byte.
Rückgabewert: Integer - bei mode als max, min, sum; Float - bei mode als avg
Unterstützte Plattformen: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

Parameter:

• name - der Prozessname (Standard ist alle Prozesse);
• user - der Benutzername (Standard ist alle Benutzer);
• mode - mögliche Werte: avg, max, min oder sum (Standard);
• cmdline - Filter nach Befehlszeile (dies ist ein regulärer Ausdruck);
• memtype - der vom Prozess verwendete Speichertyp

Kommentare:

• Der Parameter memtype wird nur unter Linux, FreeBSD, Solaris⁶ und AIX unterstützt.
• Wenn mehrere Prozesse gemeinsam genutzten Speicher verwenden, kann die Summe des von den Prozessen verwendeten Speichers zu großen, unrealistischen Werten führen.
  
  Siehe die Hinweise zur Auswahl von Prozessen mit den Parametern name und cmdline (Linux-spezifisch).
  
  Wenn dieser Datenpunkt über die Befehlszeile aufgerufen wird und einen Befehlszeilenparameter enthält (z. B. bei Verwendung des Agent-Testmodus: zabbix_agentd -t proc.mem[,,,apache2]), wird ein zusätzlicher Prozess gezählt, da der Agent sich selbst mitzählt.

Beispiele:

proc.mem[,root] #der von allen Prozessen verwendete Speicher, die unter dem Benutzer "root" laufen
proc.mem[zabbix_server,zabbix] #der von allen zabbix_server-Prozessen verwendete Speicher, die unter dem Benutzer zabbix laufen
proc.mem[,oracle,max,oracleZABBIX] #der von dem speicherintensivsten Prozess verwendete Speicher, der unter Oracle läuft und oracleZABBIX in seiner Befehlszeile enthält

proc.num[<name>,<user>,<state>,<cmdline>,<zone>]

Die Anzahl der Prozesse.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris⁶, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parameter:

• name - der Prozessname (Standard ist alle Prozesse);
• user - der Benutzername (Standard ist alle Benutzer);
• state - mögliche Werte:
  all (Standard),
  disk - nicht unterbrechbarer Schlaf,
  run - wird ausgeführt,
  sleep - unterbrechbarer Schlaf,
  trace - angehalten,
  zomb - Zombie;
• cmdline - Filter nach Befehlszeile (es handelt sich um einen regulären Ausdruck);
• zone - die Zielzone: current (Standard) oder all. Dieser Parameter wird nur unter Solaris unterstützt.

Kommentare:

• Die Zustandsparameter disk und trace werden nur unter Linux, FreeBSD, OpenBSD und NetBSD unterstützt.
• Unter Windows werden nur die Parameter name und user unterstützt.
• Wenn dieser Datenpunkt über die Befehlszeile aufgerufen wird und einen Befehlszeilenparameter enthält (z. B. bei Verwendung des Agent-Testmodus: zabbix_agentd -t proc.num[,,,apache2]), wird ein zusätzlicher Prozess gezählt, da der Agent sich selbst mitzählt.
• Wenn der Parameter zone auf current gesetzt wird (oder standardmäßig verwendet wird) und der Agent auf einem Solaris ohne Zonenunterstützung kompiliert wurde, aber auf einem neueren Solaris mit Zonenunterstützung ausgeführt wird, gibt der Agent NOTSUPPORTED zurück (der Agent kann die Ergebnisse nicht auf die aktuelle Zone beschränken). all wird in diesem Fall jedoch unterstützt.
• Siehe Hinweise zur Auswahl von Prozessen mit den Parametern name und cmdline (nur für Linux).

Beispiele:

proc.num[,mysql] #die Anzahl der Prozesse, die unter dem Benutzer mysql ausgeführt werden
proc.num[apache2,www-data] #die Anzahl der apache2-Prozesse, die unter dem Benutzer www-data ausgeführt werden
proc.num[,oracle,sleep,oracleZABBIX] #die Anzahl der Prozesse im sleep-Zustand, die unter Oracle ausgeführt werden und oracleZABBIX in ihrer Befehlszeile haben

sensor[device,sensor,<mode>]

Messwert des Hardware-Sensors.
Rückgabewert: Float.
Unterstützte Plattformen: Linux, OpenBSD.

Parameter:

• device - der Gerätename;
• sensor - der Sensorname;
• mode - mögliche Werte: avg, max oder min.

Kommentare:

• Liest /proc/sys/dev/sensors unter Linux 2.4.
• Liest /sys/class/hwmon unter Linux 2.6+. Eine ausführlichere Beschreibung des Datenpunkts sensor unter Linux finden Sie hier.
• Liest die MIB hw.sensors unter OpenBSD.
• Unter Linux 2.4 werden, wenn mode angegeben ist, device und sensor als reguläre Ausdrücke behandelt.
• Unter Linux 2.6+ und OpenBSD oder wenn mode weggelassen wird, werden device und sensor als Literalwerte behandelt.

Beispiele:

sensor[w83781d-i2c-0-2d,temp1]
sensor[cpu0,temp0] #the temperature of one CPU
sensor["cpu[0-2]$",temp,avg] #the average temperature of the first three CPUs

system.boottime

Die Systemstartzeit.
Rückgabewert: Integer (Unix-Zeitstempel).
Unterstützte Plattformen: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

system.cpu.discovery

Die Liste der erkannten CPUs/CPU-Kerne. Wird für Low-Level-Discovery verwendet.
Rückgabewert: JSON-String.
Siehe unterstützte Plattformen.

system.cpu.intr

Die Geräte-Interrupts.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.load[<cpu>,<mode>]

Die CPU-Last.
Rückgabewert: Float.
Siehe unterstützte Plattformen.

Parameter:

• cpu – mögliche Werte: all (Standard) oder percpu (die Gesamtlast geteilt durch die Anzahl der online befindlichen CPUs);
• mode – mögliche Werte: avg1 (Ein-Minuten-Durchschnitt, Standard), avg5 oder avg15.

Beispiel:

system.cpu.load[,avg5]

system.cpu.num[<type>]

Die Anzahl der CPUs.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Parameter:

• type - mögliche Werte: online (Standard) oder max

Der Parameter max wird nur unter Linux, FreeBSD, Solaris und MacOS X unterstützt.

Beispiel:

system.cpu.num

system.cpu.switches

Die Anzahl der Kontextwechsel.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.util[<cpu>,<type>,<mode>,<logical or physical>]

Die CPU-Auslastung in Prozent.
Rückgabewert: Float.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parameter:

• cpu - <CPU-Nummer> oder all (Standard);
• type - mögliche Werte: user (Standard), idle, nice, system, iowait, interrupt, softirq, steal, spin (unter OpenBSD), guest (unter Linux-Kernels 2.6.24 und höher) oder guest_nice (unter Linux-Kernels 2.6.33 und höher);
• mode - mögliche Werte: avg1 (Ein-Minuten-Durchschnitt, Standard), avg5 oder avg15;
• logical or physical - mögliche Werte: logical (Standard) oder physical. Dieser Parameter wird nur unter AIX unterstützt.

Kommentare:

• Der Typparameter nice wird nur unter Linux, FreeBSD, HP-UX, OpenBSD und NetBSD unterstützt.
• Der Typparameter iowait wird nur unter Linux 2.6 und höher, Solaris und AIX unterstützt.
• Der Typparameter interrupt wird nur unter Linux 2.6 und höher, FreeBSD und OpenBSD unterstützt.
• Die Typparameter softirq, steal, guest, guest_nice werden nur unter Linux 2.6 und höher unterstützt.
• Die Modusparameter avg5 und avg15 werden unter Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD und NetBSD unterstützt.

Beispiel:

system.cpu.util[0,user,avg5]

system.hostname[<type>,<transform>]

Der System-Hostname.
Rückgabewert: String.
Siehe unterstützte Plattformen.

Parameter:

• type – mögliche Werte: netbios (Standard unter Windows), host (Standard unter Linux), shorthost (gibt den Teil des Hostnamens vor dem ersten Punkt zurück, bei Namen ohne Punkte die vollständige Zeichenfolge), fqdn (gibt den Fully Qualified Domain Name zurück);
• transform – mögliche Werte: none (Standard) oder lower (in Kleinbuchstaben umwandeln).

Der Wert wird ermittelt, indem nodename aus der Ausgabe der System-API uname() verwendet wird.

Beispiele für zurückgegebene Werte:

system.hostname → linux-w7x1
system.hostname → example.com
system.hostname[shorthost] → example
system.hostname → WIN-SERV2008-I6
system.hostname[host] → Win-Serv2008-I6LonG
system.hostname[host,lower] → win-serv2008-i6long
system.hostname[fqdn,lower] → blog.zabbix.com

system.hw.chassis[<info>]

Die Gehäuseinformationen.
Rückgabewert: String.
Unterstützte Plattformen: Linux.

Parameter:

• info – mögliche Werte: full (Standard), model, serial, type oder vendor

Kommentare:

• Dieser Datenpunktschlüssel hängt von der Verfügbarkeit der SMBIOS-Tabelle ab.
• Es wird versucht, die DMI-Tabelle aus sysfs zu lesen; falls der Zugriff auf sysfs fehlschlägt, wird versucht, direkt aus dem Speicher zu lesen.
• Root-Berechtigungen sind erforderlich, da der Wert durch Lesen aus sysfs oder dem Speicher ermittelt wird.

Beispiel:

system.hw.chassis[full] → Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop

system.hw.cpu[<cpu>,<info>]

Die CPU-Informationen.
Rückgabewert: String oder Integer.
Unterstützte Plattformen: Linux.

Parameter:

• cpu - <CPU-Nummer> oder all (Standard);
• info - mögliche Werte: full (Standard), curfreq, maxfreq, model oder vendor.

Kommentare:

• Sammelt Informationen aus /proc/cpuinfo und /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq.
• Wenn eine CPU-Nummer und curfreq oder maxfreq angegeben ist, wird ein numerischer Wert zurückgegeben (Hz).

Beispiel:

system.hw.cpu[0,vendor] → AuthenticAMD

system.hw.devices[<type>]

Die Auflistung der PCI- oder USB-Geräte.
Rückgabewert: Text.
Unterstützte Plattformen: Linux.

Parameter:

• type - pci (Standard) oder usb

Gibt die Ausgabe des Dienstprogramms lspci bzw. lsusb zurück (jeweils ohne Parameter ausgeführt).

Beispiel:

system.hw.devices → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge

system.hw.macaddr[<interface>,<format>]

Die Auflistung der MAC-Adressen.
Rückgabewert: String.
Unterstützte Plattformen: Linux.

Parameter:

• interface - all (Standard) oder ein regulärer Ausdruck;
• format - full (Standard) oder short

Kommentare:

• Listet die MAC-Adressen der Schnittstellen auf, deren Name mit dem angegebenen regulären Ausdruck interface übereinstimmt (all listet alle Schnittstellen auf).
• Wenn format als short angegeben ist, werden Schnittstellennamen und identische MAC-Adressen nicht aufgelistet.

Beispiel:

system.hw.macaddr["eth0$",full] → [eth0] 00:11:22:33:44:55

system.localtime[<type>]

Die Systemzeit.
Rückgabewert: Integer - mit type als utc; String - mit type als local.
Siehe unterstützte Plattformen.

Parameter:

• type - mögliche Werte: utc - (Standard) die Zeit seit der Epoche (00:00:00 UTC, 1. Januar 1970), gemessen in Sekunden, oder local - die Zeit im Format 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm'

Muss als passiver Check für den Zabbix Agent verwendet werden; in Zabbix Agent 2 kann er als aktiver Check konfiguriert werden.

Beispiel:

system.localtime[local] #Erstellen Sie einen Datenpunkt mit diesem Schlüssel und verwenden Sie ihn dann, um die Host-Zeit im Dashboard-Widget *Uhr* anzuzeigen.

system.run[command,<mode>]

Führt den angegebenen Befehl auf dem Host aus.
Rückgabewert: Text-Ergebnis des Befehls oder 1 - bei mode als nowait (unabhängig vom Befehlsresultat).
Siehe unterstützte Plattformen.

Parameter:

• command - Befehl zur Ausführung;
  
• mode - mögliche Werte: wait - auf das Ende der Ausführung warten (Standard) oder nowait - nicht warten.

Kommentare:

• Dieser Datenpunkt ist standardmäßig deaktiviert. Erfahren Sie, wie Sie ihn aktivieren.
• Der Rückgabewert des Datenpunkts ist die Standardausgabe zusammen mit der Standardfehlerausgabe, die vom Befehl erzeugt wird. Prüfung des Exit-Codes wird nicht durchgeführt.
• Damit die Verarbeitung korrekt erfolgt, muss der Rückgabewert des Befehls vom Datentyp text sein. Ein leeres Ergebnis ist ebenfalls zulässig.
• Der Rückgabewert ist auf 16 MB begrenzt (einschließlich nachfolgender Leerzeichen, die abgeschnitten werden); Datenbanklimits gelten ebenfalls.
• Siehe auch: Befehlsausführung.

Beispiel:

system.run[ls -l /] #gibt eine detaillierte Dateiliste des Stammverzeichnisses zurück

system.stat[resource,<type>]

Die Systemstatistiken.
Rückgabewert: Integer oder float.
Unterstützte Plattformen: AIX.

Parameter:

• ent - die Anzahl der Prozessoreinheiten, die diese Partition erhalten darf (float);
• kthr,<type> - Informationen über Kernel-Thread-Zustände:
  r - durchschnittliche Anzahl ausführbarer Kernel-Threads (float)
  b - durchschnittliche Anzahl von Kernel-Threads, die in der Warteschlange des Virtual Memory Manager warten (float)
• memory,<type> - Informationen über die Nutzung von virtuellem und realem Speicher:
  avm - aktive virtuelle Seiten (integer)
  fre - Größe der Freiliste (integer)
• page,<type> - Informationen über Seitenfehler und Paging-Aktivität:
  fi - Datei-Seiteneinlagerungen pro Sekunde (float)
  fo - Datei-Seitenauslagerungen pro Sekunde (float)
  pi - aus dem Auslagerungsspeicher eingelagerte Seiten (float)
  po - in den Auslagerungsspeicher ausgelagerte Seiten (float)
  fr - freigegebene Seiten (Seitenersetzung) (float)
  sr - vom Seitenersetzungsalgorithmus gescannte Seiten (float)
• faults,<type> - Trap- und Interrupt-Rate:
  in - Geräte-Interrupts (float)
  sy - Systemaufrufe (float)
  cs - Kontextwechsel von Kernel-Threads (float)
• cpu,<type> - Aufschlüsselung der prozentualen Nutzung der Prozessorzeit:
  us - Benutzerzeit (float)
  sy - Systemzeit (float)
  id - Leerlaufzeit (float)
  wa - Leerlaufzeit, während der das System ausstehende Festplatten-/NFS-I/O-Anfrage(n) hatte (float)
  pc - Anzahl der genutzten physischen Prozessoren (float)
  ec - der Prozentsatz der genutzten zugewiesenen Kapazität (float)
  lbusy - gibt den Prozentsatz der Auslastung logischer Prozessoren an, der bei der Ausführung auf Benutzer- und Systemebene auftrat (float)
  app - gibt die verfügbaren physischen Prozessoren im Shared Pool an (float)
• disk,<type> - Festplattenstatistiken:
  bps - gibt die Datenmenge an, die pro Sekunde zum Laufwerk übertragen wurde (gelesen oder geschrieben), in Byte (integer)
  tps - gibt die Anzahl der Übertragungen pro Sekunde an, die an die physische Festplatte bzw. das Bandgerät gesendet wurden (float)

Kommentare:

• Beachten Sie die folgenden Einschränkungen bei diesen Datenpunkten:
  system.stat[cpu,app] - nur auf AIX-LPAR vom Typ "Shared" unterstützt;
  system.stat[cpu,ec] - auf AIX-LPAR vom Typ "Shared" und "Dedicated" unterstützt ("Dedicated" gibt immer 100 (Prozent) zurück);
  system.stat[cpu,lbusy] - nur auf AIX-LPAR vom Typ "Shared" unterstützt;
  system.stat[cpu,pc] - auf AIX-LPAR vom Typ "Shared" und "Dedicated" unterstützt;
  system.stat[ent] - auf AIX-LPAR vom Typ "Shared" und "Dedicated" unterstützt.

system.sw.arch

Die Informationen zur Softwarearchitektur.
Rückgabewert: String.
Siehe unterstützte Plattformen.

Die Informationen werden über die Funktion uname() ermittelt.

Beispiel:

system.sw.arch → i686

system.sw.os[<info>]

Die Informationen zum Betriebssystem.
Rückgabewert: String.
Unterstützte Plattformen: Linux, Windows.

Parameter:

• info – mögliche Werte: full (Standard), short oder name

Die Informationen werden aus folgenden Quellen bezogen (beachten Sie, dass nicht alle Dateien und Optionen in allen Distributionen vorhanden sind):

• /proc/version (full) unter Linux;
• /proc/version_signature (short) unter Linux;
• der Parameter PRETTY_NAME aus /etc/os-release auf Linux-Systemen, die dies unterstützen, oder /etc/issue.net (name);
• der Registrierungsschlüssel HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion unter Windows.

Beispiele:

system.sw.os[short] → Ubuntu 2.6.35-28.50-generic 2.6.35.11
system.sw.os[full] → [s|Windows 10 Enterprise 22621.1.asd64fre.ni_release.220506-1250 Build 22621.963]

system.sw.os.get

Detaillierte Informationen über das Betriebssystem (Version, Typ, Name der Distribution, Neben- und Hauptversion usw.).
Rückgabewert: JSON-String.
Unterstützte Plattformen: Linux, Windows.

system.sw.packages[<regexp>,<manager>,<format>]

Die Auflistung der installierten Pakete.
Rückgabewert: Text.
Unterstützte Plattformen: Linux.

Parameter:

• regexp - all (Standard) oder ein regulärer Ausdruck;
• manager - all (Standard) oder ein Paketmanager;
• format - full (Standard) oder short.

Kommentare:

• Listet (alphabetisch) installierte Pakete auf, deren Name dem angegebenen regulären Ausdruck entspricht (all listet alle auf).
• Unterstützte Paketmanager (ausgeführter Befehl):
  dpkg (dpkg --get-selections)
  pkgtool (ls /var/log/packages)
  rpm (rpm -qa)
  pacman (pacman -Q)
  portage
• Wenn format als full angegeben ist, werden Pakete nach Paketmanagern gruppiert (jeder Manager in einer eigenen Zeile, beginnend mit seinem Namen in eckigen Klammern).
• Wenn format als short angegeben ist, werden Pakete nicht gruppiert und in einer einzigen Zeile aufgelistet.

Beispiel:

system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal

system.sw.packages.get[<regexp>,<manager>]

Eine detaillierte Auflistung der installierten Pakete.
Rückgabewert: JSON-String.
Unterstützte Plattformen: Linux.

Parameter:

• regexp - all (Standard) oder ein regulärer Ausdruck;
• manager - all (Standard) oder ein Paketmanager (mögliche Werte: rpm, dpkg, pkgtool, pacman oder portage).

Kommentare:

• Gibt unformatiertes JSON mit den installierten Paketen zurück, deren Name dem angegebenen regulären Ausdruck entspricht.
• Die Ausgabe ist ein Array von Objekten, die jeweils die folgenden Schlüssel enthalten: name, manager, version, size, architecture, buildtime und installtime (siehe weitere Details).

system.swap.in[<device>,<type>]

Die Statistik für Swap-In (vom Gerät in den Speicher).
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, OpenBSD.

Parameter:

• device - gibt das für das Swapping verwendete Gerät an (nur Linux) oder all (Standard);
• type - mögliche Werte: count (Anzahl der Swap-Ins, Standard auf Nicht-Linux-Plattformen), sectors (eingetauschte Sektoren) oder pages (eingetauschte Seiten, Standard unter Linux).

Kommentare:

• Die Quelle dieser Informationen ist:
  /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
  /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
• Beachten Sie, dass pages nur funktioniert, wenn kein device angegeben wurde.
• Der Typ-Parameter sectors wird nur unter Linux unterstützt.

Beispiel:

system.swap.in[,pages]

system.swap.out[<device>,<type>]

Die Statistiken zum Auslagern (aus dem Speicher auf das Gerät).
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, OpenBSD.

Parameter:

• device - gibt das zum Auslagern verwendete Gerät an (nur Linux) oder all (Standard);
• type - mögliche Werte: count (Anzahl der Auslagerungsvorgänge, Standard auf Nicht-Linux-Plattformen), sectors (ausgelagerte Sektoren) oder pages (ausgelagerte Seiten, Standard unter Linux).

Kommentare:

• Die Quelle dieser Informationen ist:
  /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
  /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
• Beachten Sie, dass pages nur funktioniert, wenn device nicht angegeben wurde.
• Der Parameter sectors für den Typ wird nur unter Linux unterstützt.

Beispiel:

system.swap.out[,pages]

system.swap.size[<device>,<type>]

Die Größe des Swap-Speichers in Byte oder als Prozentsatz der Gesamtkapazität.
Rückgabewert: Integer - für Byte; Float - für Prozentangaben.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, AIX, OpenBSD, Windows.

Parameter:

• device - gibt das zum Swapping verwendete Gerät an (nur FreeBSD) oder all (Standard);
• type - mögliche Werte: free (freier Swap-Speicher, Standard), pfree (freier Swap-Speicher in Prozent), pused (verwendeter Swap-Speicher in Prozent), total (gesamter Swap-Speicher) oder used (verwendeter Swap-Speicher).

Kommentare:

• Beachten Sie, dass pfree und pused unter Windows nicht unterstützt werden, wenn die Swap-Größe 0 ist.
• Wenn kein Gerät angegeben ist, berücksichtigt der Zabbix Agent nur Swap-Geräte (-Dateien); der physische Speicher wird ignoriert. Zum Beispiel umfasst auf Solaris-Systemen der Befehl swap -s einen Teil des physischen Speichers und der Swap-Geräte (im Gegensatz zu swap -l).

Beispiel:

system.swap.size[,pfree] → Prozentsatz des freien Swap-Speichers

system.uname

Identifikation des Systems.
Rückgabewert: String.
Siehe unterstützte Plattformen.

Kommentare:

• Unter UNIX wird der Wert für diesen Datenpunkt mit dem Systemaufruf uname() ermittelt.
• Unter Windows gibt der Datenpunkt die Betriebssystemarchitektur zurück, während er unter UNIX die CPU-Architektur zurückgibt.

Beispiele:

system.uname → FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386
system.uname → Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86

system.uptime

Die Systemlaufzeit in Sekunden.
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Verwenden Sie in der Datenpunkt-Konfiguration die Einheiten s oder uptime, um lesbare Werte zu erhalten.

system.users.num

Die Anzahl der angemeldeten Benutzer.
Rückgabewert: Integer.
Siehe unterstützte Plattformen.

Der Befehl who wird auf der Agent-Seite verwendet, um den Wert zu ermitteln.

vfs.dev.discovery

Die Liste der Blockgeräte und ihres Typs. Wird für Low-Level-Discovery verwendet.
Rückgabewert: JSON-String.
Unterstützte Plattformen: Linux.

vfs.dev.read[<device>,<type>,<mode>]

Die Statistik der Festplattenlesevorgänge.
Rückgabewert: Integer - bei type in sectors, operations, bytes; Float - bei type in sps, ops, bps.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parameter:

• device - Festplattengerät (Standard ist all ³);
• type - mögliche Werte: sectors, operations, bytes, sps, ops oder bps (sps, ops, bps stehen jeweils für: sectors, operations, bytes per second);
• mode - mögliche Werte: avg1 (Durchschnitt über eine Minute, Standard), avg5 oder avg15. Dieser Parameter wird nur mit type in: sps, ops, bps unterstützt.

Kommentare:

• Wenn ein Aktualisierungsintervall von drei Stunden oder mehr² verwendet wird, gibt dieser Datenpunkt immer '0' zurück.
• Die Typparameter sectors und sps werden nur unter Linux unterstützt.
• Der Typparameter ops wird nur unter Linux und FreeBSD unterstützt.
• Der Typparameter bps wird nur unter FreeBSD unterstützt.
• Der Typparameter bytes wird nur unter FreeBSD, Solaris, AIX, OpenBSD unterstützt.
• Der Parameter mode wird nur unter Linux und FreeBSD unterstützt.
• Sie können relative Gerätenamen (zum Beispiel sda) sowie optional ein /dev/-Präfix (zum Beispiel /dev/sda) verwenden.
• LVM-логische Volumes werden unterstützt.
• Die Standardwerte des Parameters 'type' für verschiedene Betriebssysteme:
  AIX - operations
  FreeBSD - bps
  Linux - sps
  OpenBSD - operations
  Solaris - bytes
• sps, ops und bps sind auf unterstützten Plattformen auf 1024 Geräte begrenzt (1023 einzelne und eines für all).

Beispiel:

vfs.dev.read[,operations]

vfs.dev.write[<device>,<type>,<mode>]

Die Statistiken zu Schreibvorgängen auf der Festplatte.
Rückgabewert: Integer - bei type in sectors, operations, bytes; Float - bei type in sps, ops, bps.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parameter:

• device - Festplattengerät (Standard ist all ³);
• type - mögliche Werte: sectors, operations, bytes, sps, ops oder bps (sps, ops, bps stehen jeweils für: Sektoren, Operationen, Bytes pro Sekunde);
• mode - mögliche Werte: avg1 (Ein-Minuten-Durchschnitt, Standard), avg5 oder avg15. Dieser Parameter wird nur mit type in: sps, ops, bps unterstützt.

Kommentare:

• Wenn ein Aktualisierungsintervall von drei Stunden oder mehr verwendet wird², gibt dieser Datenpunkt immer '0' zurück.
• Die Parameter sectors und sps werden nur unter Linux unterstützt.
• Der Parameter ops wird nur unter Linux und FreeBSD unterstützt.
• Der Parameter bps wird nur unter FreeBSD unterstützt.
• Der Parameter bytes wird nur unter FreeBSD, Solaris, AIX, OpenBSD unterstützt.
• Der Parameter mode wird nur unter Linux und FreeBSD unterstützt.
• Sie können relative Gerätenamen (zum Beispiel sda) sowie optional ein /dev/-Präfix (zum Beispiel /dev/sda) verwenden.
• LVM-Logische Volumes werden unterstützt.
• Die Standardwerte des Parameters 'type' für verschiedene Betriebssysteme:
  AIX - operations
  FreeBSD - bps
  Linux - sps
  OpenBSD - operations
  Solaris - bytes
• sps, ops und bps sind auf unterstützten Plattformen auf 1024 Geräte begrenzt (1023 einzelne und eines für all).

Beispiel:

vfs.dev.write[,operations]

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

Die Anzahl der Verzeichniseinträge.
Rückgabewert: Integer.
Siehe unterstützte Plattformen.

Parameter:

• dir - der absolute Pfad zum Verzeichnis;
• regex incl - ein regulärer Ausdruck, der das Namensmuster des einzuschließenden Objekts (Datei, Verzeichnis, symbolischer Link) beschreibt; wenn leer, werden alle eingeschlossen (Standardwert);
• regex excl - ein regulärer Ausdruck, der das Namensmuster des auszuschließenden Objekts (Datei, Verzeichnis, symbolischer Link) beschreibt; wenn leer, wird nichts ausgeschlossen (Standardwert);
• types incl - zu zählende Verzeichniseintragstypen, mögliche Werte: file - reguläre Datei, dir - Unterverzeichnis, sym - symbolischer Link, sock - Socket, bdev - Blockgerät, cdev - Zeichengerät, fifo - FIFO, dev - synonym zu "bdev,cdev", all - alle Typen (Standard), d. h. "file,dir,sym,sock,bdev,cdev,fifo". Mehrere Typen müssen durch Komma getrennt und in Anführungszeichen gesetzt werden.
• types excl - Verzeichniseintragstypen (siehe types incl), die NICHT gezählt werden sollen. Wenn ein Eintragstyp sowohl in types incl als auch in types excl enthalten ist, werden Verzeichniseinträge dieses Typs NICHT gezählt.
• max depth - die maximale Tiefe der zu durchlaufenden Unterverzeichnisse:
  -1 (Standard) - unbegrenzt,
  0 - kein Abstieg in Unterverzeichnisse.
• min size - die minimale Größe (in Bytes), damit eine Datei gezählt wird. Kleinere Dateien werden nicht gezählt. Speicher-Suffixe können verwendet werden.
• max size - die maximale Größe (in Bytes), damit eine Datei gezählt wird. Größere Dateien werden nicht gezählt. Speicher-Suffixe können verwendet werden.
• min age - das Mindestalter (in Sekunden) eines Verzeichniseintrags, damit er gezählt wird. Aktuellere Einträge werden nicht gezählt. Zeit-Suffixe können verwendet werden.
• max age - das Höchstalter (in Sekunden) eines Verzeichniseintrags, damit er gezählt wird. Einträge dieses Alters und älter werden nicht gezählt (Änderungszeit). Zeit-Suffixe können verwendet werden.
• regex excl dir - ein regulärer Ausdruck, der das Namensmuster des auszuschließenden Verzeichnisses beschreibt. Der gesamte Inhalt des Verzeichnisses wird ausgeschlossen (im Gegensatz zu regex_excl)

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Umgebungsvariablen, z. B. %APP_HOME%, $HOME und %TEMP%, werden nicht unterstützt.
• Pseudo-Verzeichnisse "." und ".." werden niemals gezählt.
• Symbolische Links werden bei der Verzeichnisdurchquerung niemals verfolgt.
• Sowohl regex incl als auch regex excl werden bei der Berechnung der Anzahl der Einträge auf Dateien und Verzeichnisse angewendet, aber beim Auswählen der zu durchlaufenden Unterverzeichnisse ignoriert (wenn regex incl "(?i)^.+\.zip$" ist und max depth nicht gesetzt ist, werden alle Unterverzeichnisse durchlaufen, aber nur Dateien vom Typ zip werden gezählt).
• Die Ausführungszeit ist durch den Timeout-Wert in der Agent Konfiguration begrenzt (3 Sek.). Da das Durchlaufen großer Verzeichnisstrukturen länger dauern kann, werden keine Daten zurückgegeben und der Datenpunkt wird nicht unterstützt. Eine teilweise Anzahl wird nicht zurückgegeben.
• Beim Filtern nach Größe haben nur reguläre Dateien aussagekräftige Größen. Unter Linux und BSD haben auch Verzeichnisse eine von null verschiedene Größe (typischerweise einige KB). Geräte haben eine Größe von null, z. B. spiegelt die Größe von /dev/sda1 nicht die jeweilige Partitionsgröße wider. Daher wird bei Verwendung von <min_size> und <max_size> empfohlen, <types_incl> als "file" anzugeben, um Überraschungen zu vermeiden.

Beispiele:

vfs.dir.count[/dev] #überwacht die Anzahl der Geräte in /dev (Linux)
vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] #überwacht die Anzahl der Dateien in einem temporären Verzeichnis

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

Die Liste der Verzeichniseinträge.
Rückgabewert: JSON-String.
Siehe unterstützte Plattformen.

Parameter:

• dir - der absolute Pfad zum Verzeichnis;
• regex incl - ein regulärer Ausdruck, der das Namensmuster der einzuschließenden Entität (Datei, Verzeichnis, symbolischer Link) beschreibt; wenn leer, werden alle eingeschlossen (Standardwert);
• regex excl - ein regulärer Ausdruck, der das Namensmuster der auszuschließenden Entität (Datei, Verzeichnis, symbolischer Link) beschreibt; wenn leer, wird nichts ausgeschlossen (Standardwert);
• types incl - aufzulistende Typen von Verzeichniseinträgen, mögliche Werte: file - reguläre Datei, dir - Unterverzeichnis, sym - symbolischer Link, sock - Socket, bdev - Blockgerät, cdev - Zeichengerät, fifo - FIFO, dev - synonym zu "bdev,cdev", all - alle Typen (Standard), d. h. "file,dir,sym,sock,bdev,cdev,fifo". Mehrere Typen müssen durch Komma getrennt und in Anführungszeichen gesetzt werden.
• types excl - Typen von Verzeichniseinträgen (siehe types incl), die NICHT aufgelistet werden sollen. Wenn ein Eintragstyp sowohl in types incl als auch in types excl enthalten ist, werden Verzeichniseinträge dieses Typs NICHT aufgelistet.
• max depth - die maximale Tiefe der zu durchlaufenden Unterverzeichnisse:
  -1 (Standard) - unbegrenzt,
  0 - kein Abstieg in Unterverzeichnisse.
• min size - die minimale Größe (in Bytes), damit eine Datei aufgelistet wird. Kleinere Dateien werden nicht aufgelistet. Speicher-Suffixe können verwendet werden.
• max size - die maximale Größe (in Bytes), damit eine Datei aufgelistet wird. Größere Dateien werden nicht aufgelistet. Speicher-Suffixe können verwendet werden.
• min age - das Mindestalter (in Sekunden) des Verzeichniseintrags, damit er aufgelistet wird. Aktuellere Einträge werden nicht aufgelistet. Zeitsuffixe können verwendet werden.
• max age - das Höchstalter (in Sekunden) des Verzeichniseintrags, damit er aufgelistet wird. So alte und ältere Einträge werden nicht aufgelistet (Änderungszeit). Zeitsuffixe können verwendet werden.
• regex excl dir - ein regulärer Ausdruck, der das Namensmuster des auszuschließenden Verzeichnisses beschreibt. Der gesamte Inhalt des Verzeichnisses wird ausgeschlossen (im Gegensatz zu regex excl)

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Umgebungsvariablen, z. B. %APP_HOME%, $HOME und %TEMP%, werden nicht unterstützt.
• Pseudo-Verzeichnisse "." und ".." werden niemals aufgelistet.
• Symbolische Links werden bei der Verzeichnisdurchquerung niemals verfolgt.
• Sowohl regex incl als auch regex excl werden beim Erzeugen der Eintragsliste auf Dateien und Verzeichnisse angewendet, werden jedoch beim Auswählen der zu durchlaufenden Unterverzeichnisse ignoriert (wenn regex incl "(?i)^.+\.zip$" ist und max depth nicht gesetzt ist, werden alle Unterverzeichnisse durchlaufen, aber nur die Dateien vom Typ zip werden gezählt).
• Die Ausführungszeit ist durch den Timeout-Wert in der Agent-Konfiguration konfiguriert begrenzt. Da eine umfangreiche Verzeichnisdurchquerung länger dauern kann, werden keine Daten zurückgegeben und der Datenpunkt wird nicht unterstützt. Eine teilweise Liste wird nicht zurückgegeben.
• Beim Filtern nach Größe haben nur reguläre Dateien aussagekräftige Größen. Unter Linux und BSD haben auch Verzeichnisse eine von Null verschiedene Größe (typischerweise einige KB). Geräte haben eine Größe von Null, z. B. spiegelt die Größe von /dev/sda1 nicht die jeweilige Partitionsgröße wider. Daher wird bei Verwendung von min size und max size empfohlen, types incl als "file" anzugeben, um Überraschungen zu vermeiden.

Beispiele:

vfs.dir.get[/dev] #ruft die Geräteliste in /dev ab (Linux)
vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] #ruft die Dateiliste in einem temporären Verzeichnis ab

vfs.dir.size[dir,<regex incl>,<regex excl>,<mode>,<max depth>,<regex excl dir>]

Die Verzeichnisgröße (in Byte).
Rückgabewert: Integer.
Unterstützte Plattformen: Linux, Windows. Der Datenpunkt kann auch auf anderen UNIX-ähnlichen Plattformen funktionieren.

Parameter:

• dir - der absolute Pfad zum Verzeichnis;
• regex incl - ein regulärer Ausdruck, der das Namensmuster der einzuschließenden Entität (Datei, Verzeichnis, symbolischer Link) beschreibt; wenn leer, werden alle eingeschlossen (Standardwert);
• regex excl - ein regulärer Ausdruck, der das Namensmuster der auszuschließenden Entität (Datei, Verzeichnis, symbolischer Link) beschreibt; wenn leer, wird nichts ausgeschlossen (Standardwert);
• mode - mögliche Werte: apparent (Standard) - ermittelt die scheinbare Dateigröße statt der Plattenbelegung (entspricht du -sb dir), disk - ermittelt die Plattenbelegung (entspricht du -s -B1 dir). Im Gegensatz zum Befehl du berücksichtigt der Datenpunkt vfs.dir.size bei der Berechnung der Verzeichnisgröße auch versteckte Dateien (entspricht du -sb .[^.]* * innerhalb von dir).
• max depth - die maximale Tiefe der zu durchlaufenden Unterverzeichnisse: -1 (Standard) - unbegrenzt, 0 - kein Abstieg in Unterverzeichnisse.
• regex excl dir - ein regulärer Ausdruck, der das Namensmuster des auszuschließenden Verzeichnisses beschreibt. Der gesamte Inhalt des Verzeichnisses wird ausgeschlossen (im Gegensatz zu regex excl)

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Es werden nur Verzeichnisse berechnet, für die der Benutzer zabbix mindestens Leseberechtigung hat. Bei Verzeichnissen mit nur Leseberechtigung wird nur die Größe des Verzeichnisses selbst berechnet. Verzeichnisse mit Lese- und Ausführungsberechtigung werden einschließlich ihres Inhalts berechnet.
• Bei großen Verzeichnissen oder langsamen Laufwerken kann für diesen Datenpunkt aufgrund der Einstellung Timeout in den Konfigurationsdateien von Agent und Server/Proxy eine Zeitüberschreitung auftreten. Erhöhen Sie die Timeout-Werte bei Bedarf.
• Die Dateigrößenbegrenzung hängt von der Unterstützung für große Dateien ab.

Beispiele:

vfs.dir.size[/tmp,log] #berechnet die Größe aller Dateien in /tmp, die 'log' in ihrem Namen enthalten
vfs.dir.size[/tmp,log,^.+\.old$] #berechnet die Größe aller Dateien in /tmp, die 'log' in ihrem Namen enthalten, ausgenommen Dateien, deren Namen auf '.old' enden

vfs.file.cksum[file,<mode>]

Die Prüfsumme der Datei, berechnet mit dem UNIX-Algorithmus cksum.
Rückgabewert: Integer - bei mode als crc32, String - bei mode als md5, sha256.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei;
• mode - crc32 (Standard), md5 oder sha256.

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Die Dateigrößenbeschränkung hängt von der Unterstützung großer Dateien ab.

Beispiel:

vfs.file.cksum[/etc/passwd]

Beispiele für zurückgegebene Werte (jeweils crc32/md5/sha256):

675436101
9845acf68b73991eb7fd7ee0ded23c44
ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc

vfs.file.contents[file,<encoding>]

Abrufen des Inhalts einer Datei⁷.
Rückgabewert: Text.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei;
• encoding - die Codepage-Kennung.

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Der Rückgabewert ist auf 16 MB begrenzt (einschließlich nachfolgender Leerzeichen, die abgeschnitten werden); Datenbankgrenzen gelten ebenfalls.
• Ein leerer String wird zurückgegeben, wenn die Datei leer ist oder nur LF-/CR-Zeichen enthält.
• Die Byte Order Mark (BOM) wird aus der Ausgabe ausgeschlossen.

Beispiel:

vfs.file.contents[/etc/passwd]

vfs.file.exists[file,<types incl>,<types excl>]

Prüft, ob die Datei existiert.
Rückgabewert: 0 - nicht gefunden; 1 - Datei des angegebenen Typs existiert.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei;
• types incl - die Liste der einzuschließenden Dateitypen, mögliche Werte: file (reguläre Datei, Standardwert (wenn types_excl nicht gesetzt ist)), dir (Verzeichnis), sym (symbolischer Link), sock (Socket), bdev (Blockgerät), cdev (Zeichengerät), fifo (FIFO), dev (synonym zu "bdev,cdev"), all (alle genannten Typen, Standardwert, wenn types_excl gesetzt ist).
• types excl - die Liste der auszuschließenden Dateitypen, mögliche Werte siehe types_incl (standardmäßig werden keine Typen ausgeschlossen)

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Mehrere Typen müssen durch Kommas getrennt werden, und die gesamte Menge muss in doppelte Anführungszeichen "" eingeschlossen werden.
• Wenn derselbe Typ sowohl in <types_incl> als auch in <types_excl> enthalten ist, werden Dateien dieses Typs ausgeschlossen.
• Die Dateigrößenbeschränkung hängt von der Unterstützung für große Dateien ab.

Beispiele:

vfs.file.exists[/tmp/application.pid]
vfs.file.exists[/tmp/application.pid,"file,dir,sym"]
vfs.file.exists[/tmp/application_dir,dir]

vfs.file.get[file]

Gibt Informationen über eine Datei zurück.
Rückgabewert: JSON-String.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Unterstützte Dateitypen auf UNIX-ähnlichen Systemen: reguläre Datei, Verzeichnis, symbolischer Link, Socket, Blockgerät, Zeichengerät, FIFO.
• Das Limit für die Dateigröße hängt von der Unterstützung großer Dateien ab.

Beispiel:

vfs.file.get[/etc/passwd] #gibt ein JSON mit Informationen über die Datei /etc/passwd zurück (Typ, Benutzer, Berechtigungen, SID, uid usw.)

vfs.file.md5sum[file]

Die MD5-Prüfsumme der Datei.
Rückgabewert: Zeichenkette (MD5-Hash der Datei).
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Die Dateigrößenbeschränkung hängt von der Unterstützung großer Dateien ab.

Beispiel:

vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf]

Beispiel für den Rückgabewert:

b5052decb577e0fffd622d6ddc017e82

vfs.file.owner[file,<ownertype>,<resulttype>]

Ruft den Eigentümer einer Datei ab.
Rückgabewert: String.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei;
• ownertype - user (Standard) oder group (nur Unix);
• resulttype - name (Standard) oder id; bei id wird unter Unix uid/gid, unter Windows SID zurückgegeben.

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Die Dateigrößenbeschränkung hängt von der Unterstützung für große Dateien ab.

Beispiele:

vfs.file.owner[/tmp/zabbix_server.log] #return the file owner of /tmp/zabbix_server.log
vfs.file.owner[/tmp/zabbix_server.log,,id] #return the file owner ID of /tmp/zabbix_server.log

vfs.file.permissions[file]

Gibt eine 4-stellige Zeichenfolge zurück, die die Oktalzahl mit UNIX-Berechtigungen enthält.
Rückgabewert: String.
Unterstützte Plattformen: Linux. Der Datenpunkt kann auch auf anderen UNIX-ähnlichen Plattformen funktionieren.

Parameter:

• file - der vollständige Pfad zur Datei

Die Dateigrößenbeschränkung hängt von der Unterstützung großer Dateien ab.

Beispiel:

vfs.file.permissions[/etc/passwd] #gibt die Berechtigungen von /etc/passwd zurück, zum Beispiel '0644'

vfs.file.regexp[file,regexp,<encoding>,<start line>,<end line>,<output>]

Ruft eine Zeichenkette in der Datei ab⁷.
Rückgabewert: Die Zeile, die die übereinstimmende Zeichenkette enthält, oder wie durch den optionalen Parameter output angegeben.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei;
• regexp - ein regulärer Ausdruck, der das erforderliche Muster beschreibt;
• encoding - der Codepage-Bezeichner;
• start line - die Nummer der ersten zu durchsuchenden Zeile (standardmäßig die erste Zeile der Datei);
• end line - die Nummer der letzten zu durchsuchenden Zeile (standardmäßig die letzte Zeile der Datei);
• output - eine optionale Vorlage für die Ausgabeformatierung. Die Escape-Sequenz \0 wird durch den übereinstimmenden Teil des Textes ersetzt (vom ersten Zeichen, bei dem die Übereinstimmung beginnt, bis zu dem Zeichen, bei dem die Übereinstimmung endet), während eine Escape-Sequenz \N (wobei N=1...9) durch die N-te übereinstimmende Gruppe ersetzt wird (oder durch eine leere Zeichenkette, wenn N die Anzahl der erfassten Gruppen überschreitet).

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Die Begrenzung der Dateigröße hängt von der Unterstützung großer Dateien ab.
• Es wird nur die erste übereinstimmende Zeile zurückgegeben.
• Wenn keine Zeile mit dem Ausdruck übereinstimmt, wird eine leere Zeichenkette zurückgegeben.
• Die Byte Order Mark (BOM) wird von der Ausgabe ausgeschlossen.
• Die Extraktion des Inhalts mithilfe des Parameters output erfolgt auf dem Agent.

Beispiele:

vfs.file.regexp[/etc/passwd,zabbix]
vfs.file.regexp[/path/to/some/file,"([0-9]+)$",,3,5,\1]
vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] → Abrufen der ID des Benutzers *zabbix*

vfs.file.regmatch[file,regexp,<encoding>,<start line>,<end line>]

Sucht eine Zeichenkette in der Datei⁷.
Rückgabewerte: 0 - keine Übereinstimmung gefunden; 1 - gefunden.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei;
• regexp - ein regulärer Ausdruck, der das erforderliche Muster beschreibt;
• encoding - der Bezeichner der Codepage;
• start line - die Nummer der ersten zu durchsuchenden Zeile (standardmäßig die erste Zeile der Datei);
• end line - die Nummer der letzten zu durchsuchenden Zeile (standardmäßig die letzte Zeile der Datei).

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Die Dateigrößenbeschränkung hängt von der Unterstützung für große Dateien ab.
• Die Bytereihenfolgemarkierung (BOM) wird ignoriert.

Beispiel:

vfs.file.regmatch[/var/log/app.log,error]

vfs.file.size[file,<mode>]

Die Dateigröße (in Byte).
Rückgabewert: Integer.
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei;
• mode - mögliche Werte: bytes (Standard) oder lines (leere Zeilen werden ebenfalls gezählt).

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Die Datei muss Leseberechtigungen für den Benutzer zabbix haben.
• Die Größenbeschränkung der Datei hängt von der Unterstützung für große Dateien ab.

Beispiel:

vfs.file.size[/var/log/syslog]

vfs.file.time[file,<mode>]

Die Zeitinformationen der Datei.
Rückgabewert: Integer (Unix-Zeitstempel).
Siehe unterstützte Plattformen.

Parameter:

• file - der vollständige Pfad zur Datei;
• mode - mögliche Werte:
  modify (Standard) - der letzte Zeitpunkt der Änderung des Dateiinhalts,
  access - der letzte Zeitpunkt des Lesens der Datei,
  change - der letzte Zeitpunkt der Änderung der Dateieigenschaften

Kommentare:

• Unter Windows folgt dieser Datenpunkt UNC-Pfaden, was ein Sicherheitsrisiko darstellen kann.
• Die Dateigrößenbeschränkung hängt von der Unterstützung großer Dateien ab.

Beispiel:

vfs.file.time[/etc/passwd,modify]

vfs.fs.discovery

Die Liste der eingehängten Dateisysteme mit ihrem Typ und den Einhängeoptionen. Wird für Low-Level-Discovery verwendet.
Rückgabewert: JSON-String.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

vfs.fs.get

Die Liste der eingehängten Dateisysteme mit ihrem Typ, verfügbarem Speicherplatz, Inode-Statistiken und Einhängeoptionen. Kann für Low-Level-Discovery verwendet werden.
Rückgabewert: JSON string.
Unterstützte Plattformen: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Kommentare:

• Dateisysteme mit einer Inode-Anzahl von null, was bei Dateisystemen mit dynamischen Inodes (z. B. btrfs) der Fall sein kann, werden ebenfalls gemeldet.
• Verfügbarer Speicherplatz und Inode-Statistiken werden nur zurückgegeben, wenn der Benutzer des Zabbix Agent über Traverse-Berechtigungen für jedes Verzeichnis im Pfad des Einhängepunkts verfügt; andernfalls wird das Dateisystem aus der Ausgabe ausgelassen.
• Siehe auch: Erkennung eingehängter Dateisysteme.

vfs.fs.inode[fs,<mode>]

Die Anzahl oder der Prozentsatz der Inodes.
Rückgabewert: Integer - für die Anzahl; Float - für den Prozentsatz.
Siehe unterstützte Plattformen.

Parameter:

• fs - das Dateisystem;
• mode - mögliche Werte: total (Standard), free, used, pfree (frei, in Prozent) oder pused (belegt, in Prozent).

Wenn die Anzahl der Inodes gleich null ist, was bei Dateisystemen mit dynamischen Inodes der Fall sein kann (z. B. btrfs), werden die Werte für pfree/pused jeweils als „100“ und „0“ gemeldet.

Beispiel:

vfs.fs.inode[/,pfree]

vfs.fs.size[fs,<mode>]

Der Festplattenspeicher in Byte oder als Prozentsatz der Gesamtkapazität.
Rückgabewert: Integer - für Byte; Float - für Prozentangaben.
Siehe unterstützte Plattformen.

Parameter:

• fs - das Dateisystem;
• mode - mögliche Werte: total (Standard), free, used, pfree (frei, in Prozent) oder pused (belegt, in Prozent).

Kommentare:

• Wenn das Dateisystem nicht eingehängt ist, wird die Größe eines lokalen Dateisystems zurückgegeben, auf dem sich der Einhängepunkt befindet.
• Der reservierte Speicherplatz eines Dateisystems wird berücksichtigt und bei Verwendung des Modus free nicht einbezogen.

Beispiel:

vfs.fs.size[/tmp,free]

vm.memory.size[<mode>]

Die Speichergröße in Byte oder als Prozentsatz der Gesamtmenge.
Rückgabewert: Integer - für Byte; Float - für Prozentangaben.
Siehe unterstützte Plattformen.

Parameter:

• mode - mögliche Werte: total (Standard), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (verwendet, prozentual), available oder pavailable (verfügbar, prozentual).

Kommentare:

• Dieser Datenpunkt akzeptiert drei Kategorien von Parametern:
  • total - Gesamtspeichermenge;
  • plattformspezifische Speichertypen: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired;
  • Schätzwerte auf Benutzerebene dafür, wie viel Speicher verwendet wird und verfügbar ist: used, pused, available, pavailable.
• Der Modusparameter active wird nur unter FreeBSD, HP-UX, MacOS X, OpenBSD und NetBSD unterstützt.
• Die Modusparameter anon, exec, file werden nur unter NetBSD unterstützt.
• Der Modusparameter buffers wird nur unter Linux, FreeBSD, OpenBSD und NetBSD unterstützt.
• Der Modusparameter cached wird nur unter Linux, FreeBSD, AIX, OpenBSD und NetBSD unterstützt.
• Die Modusparameter inactive, wired werden nur unter FreeBSD, MacOS X, OpenBSD und NetBSD unterstützt.
• Der Modusparameter pinned wird nur unter AIX unterstützt.
• Der Modusparameter shared wird nur unter Linux 2.4, FreeBSD, OpenBSD und NetBSD unterstützt.
• Siehe auch zusätzliche Details zu diesem Datenpunkt.

Beispiel:

vm.memory.size[pavailable]

web.page.get[host,<path>,<port>]

Ruft den Inhalt einer Webseite ab.
Rückgabewert: Quelltext der Webseite als Text (einschließlich Headern).
Siehe unterstützte Plattformen.

Parameter:

• host - der Hostname oder die URL (als scheme://host:port/path, wobei nur host obligatorisch ist). Zulässige URL-Schemata: http, https⁴. Ein fehlendes Schema wird als http behandelt. Wenn eine URL angegeben ist, müssen path und port leer sein. Die Angabe von Benutzername/Passwort beim Verbinden mit Servern, die eine Authentifizierung erfordern, zum Beispiel: http://user:[email protected], ist nur mit cURL-Unterstützung möglich ⁴. Punycode wird in Hostnamen unterstützt.
• path - der Pfad zu einem HTML-Dokument (Standard ist /);
• port - die Portnummer (Standard ist 80 für HTTP)

Kommentare:

• Dieser Datenpunkt wird auf nicht unterstützt gesetzt, wenn die in host angegebene Ressource nicht existiert oder nicht verfügbar ist.
• host kann ein Hostname, Domainname, eine IPv4- oder IPv6-Adresse sein. Für IPv6-Adressen muss der Zabbix Agent jedoch mit aktivierter IPv6-Unterstützung kompiliert sein.

Beispiele:

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

Die Ladezeit einer vollständigen Webseite (in Sekunden).
Rückgabewert: Float.
Siehe unterstützte Plattformen.

Parameter:

• host - der Hostname oder die URL (als scheme://host:port/path, wobei nur host obligatorisch ist). Zulässige URL-Schemata: http, https⁴. Ein fehlendes Schema wird als http behandelt. Wenn eine URL angegeben ist, müssen path und port leer sein. Die Angabe von Benutzername/Passwort beim Verbinden mit Servern, die eine Authentifizierung erfordern, zum Beispiel http://user:[email protected], ist nur mit cURL-Unterstützung möglich ⁴. Punycode wird in Hostnamen unterstützt.
• path - der Pfad zu einem HTML-Dokument (Standard ist /);
• port - die Portnummer (Standard ist 80 für HTTP)

Kommentare:

• Dieser Datenpunkt wird auf nicht unterstützt gesetzt, wenn die in host angegebene Ressource nicht existiert oder nicht verfügbar ist.
• host kann ein Hostname, Domainname, eine IPv4- oder IPv6-Adresse sein. Für IPv6-Adressen muss der Zabbix Agent jedoch mit aktivierter IPv6-Unterstützung kompiliert sein.

Beispiele:

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

Sucht eine Zeichenkette auf der Webseite.
Rückgabewert: Die gefundene Zeichenkette oder wie durch den optionalen Parameter output angegeben.
Siehe unterstützte Plattformen.

Parameter:

• host - der Hostname oder die URL (als scheme://host:port/path, wobei nur host obligatorisch ist). Zulässige URL-Schemata: http, https⁴. Ein fehlendes Schema wird als http behandelt. Wenn eine URL angegeben ist, müssen path und port leer sein. Die Angabe von Benutzername/Passwort beim Verbinden mit Servern, die eine Authentifizierung erfordern, zum Beispiel http://user:[email protected], ist nur mit cURL-Unterstützung möglich ⁴. Punycode wird in Hostnamen unterstützt.
• path - der Pfad zu einem HTML-Dokument (Standard ist /);
• port - die Portnummer (Standard ist 80 für HTTP)
• regexp - ein regulärer Ausdruck, der das erforderliche Muster beschreibt;
• length - die maximale Anzahl von zurückzugebenden Zeichen;
• output - eine optionale Vorlage für die Ausgabeformatierung. Die Escape-Sequenz \0 wird durch den übereinstimmenden Teil des Textes ersetzt (vom ersten Zeichen, bei dem die Übereinstimmung beginnt, bis zu dem Zeichen, bei dem die Übereinstimmung endet), während eine Escape-Sequenz \N (wobei N=1...9) durch die N-te gefundene Gruppe ersetzt wird (oder durch eine leere Zeichenkette, wenn N die Anzahl der erfassten Gruppen überschreitet).

Kommentare:

• Dieser Datenpunkt wird nicht unterstützt, wenn die in host angegebene Ressource nicht existiert oder nicht verfügbar ist.
• host kann ein Hostname, Domainname, eine IPv4- oder IPv6-Adresse sein. Für IPv6-Adressen muss der Zabbix Agent jedoch mit aktivierter IPv6-Unterstützung kompiliert sein.
• Die Extraktion von Inhalten mit dem Parameter output erfolgt auf dem Agent.

Beispiele:

web.page.regexp[www.example.com,index.php,80,OK,2]
web.page.regexp[https://www.example.com,,,OK,2]

agent.hostmetadata

Die Host-Metadaten des Agent.
Rückgabewert: String.
Siehe unterstützte Plattformen.

Gibt den Wert der Parameter HostMetadata oder HostMetadataItem zurück oder eine leere Zeichenfolge, wenn keine definiert sind.

agent.hostname

Der Hostname des Agent.
Rückgabewert: String.
Siehe unterstützte Plattformen.

Gibt zurück:

• Als passive Prüfung – den Namen des ersten Host, der im Parameter Hostname der Agent-Konfigurationsdatei aufgeführt ist;
• Als aktive Prüfung – den Namen des aktuellen Hostnamens.

agent.ping

Die Verfügbarkeitsprüfung des Agent.
Rückgabewert: Nichts – nicht verfügbar; 1 – verfügbar.
Siehe unterstützte Plattformen.

Verwenden Sie die Auslöserfunktion nodata(), um die Nichtverfügbarkeit des Host zu prüfen.

agent.variant

Die Variante des Zabbix Agent (Zabbix Agent oder Zabbix Agent 2).
Rückgabewert: 1 - Zabbix Agent; 2 - Zabbix Agent 2.
Siehe unterstützte Plattformen.

agent.version

Die Version des Zabbix Agent.
Rückgabewert: String.
Siehe unterstützte Plattformen.

Beispiel für einen Rückgabewert:

6.0.3

zabbix.stats[<ip>,<port>]

Gibt eine Reihe interner Metriken des Zabbix Server oder Proxy zurück. Wenn ip und port angegeben sind, werden die Metriken von der Remote-Instanz abgerufen, andernfalls von der lokalen Instanz.
Rückgabewert: JSON-String.
Siehe unterstützte Plattformen.

Parameter:

• ip - die IP-/DNS-/Netzwerkmaskenliste der Server/Proxys, die remote abgefragt werden sollen (Standard ist 127.0.0.1);
• port - der Port des Server/Proxy, der remote abgefragt werden soll (Standard ist 10051)

Kommentare:

• Eine ausgewählte Menge interner Metriken wird von diesem Datenpunkt zurückgegeben. Einzelheiten finden Sie unter Remote monitoring of Zabbix stats.
• Beachten Sie, dass die Statistikabfrage nur von den Adressen akzeptiert wird, die im Parameter 'StatsAllowedIP' des Server/Proxy auf der Zielinstanz aufgeführt sind.

zabbix.stats[<ip>,<port>,queue,<from>,<to>]

Gibt die Anzahl der überwachten Datenpunkte in der Warteschlange zurück, die auf dem Zabbix Server oder Proxy verzögert sind. Wenn ip und port angegeben sind, werden Metriken von der Remote-Instanz abgerufen, andernfalls von der lokalen Instanz.
Rückgabewert: JSON-String.
Siehe unterstützte Plattformen.

Parameter:

• ip - die IP-/DNS-/Netzwerkmaskenliste der Server/Proxys, die per Remote-Abfrage abgefragt werden sollen (Standard ist 127.0.0.1);
• port - der Port des Server/Proxy, der per Remote-Abfrage abgefragt werden soll (Standard ist 10051)
• queue - Konstante (unverändert zu verwenden)
• from - um mindestens verzögert (Standard ist 6 Sekunden)
• to - um höchstens verzögert (Standard ist unendlich)

Beachten Sie, dass die Statistikabfrage nur von den Adressen akzeptiert wird, die im Parameter 'StatsAllowedIP' des Server/Proxy auf der Zielinstanz aufgeführt sind.

Fußnoten

¹Ein Linux-spezifischer Hinweis. Der Zabbix Agent muss schreibgeschützten Zugriff auf das Dateisystem /proc haben. Kernel-Patches von www.grsecurity.org beschränken die Zugriffsrechte nicht privilegierter Benutzer.

² vfs.dev.read[], vfs.dev.write[]: Der Zabbix Agent beendet „veraltete“ Geräteverbindungen, wenn auf die Werte der Datenpunkte länger als 3 Stunden nicht zugegriffen wird. Dies kann passieren, wenn ein System Geräte mit dynamisch wechselnden Pfaden hat oder wenn ein Gerät manuell entfernt wird. Beachten Sie auch, dass diese Datenpunkte bei Verwendung eines Aktualisierungsintervalls von 3 Stunden oder mehr immer „0“ zurückgeben.

³ vfs.dev.read[], vfs.dev.write[]: Wenn für den ersten Parameter der Standardwert all verwendet wird, gibt der Schlüssel zusammenfassende Statistiken zurück, einschließlich aller Blockgeräte wie sda, sdb und ihrer Partitionen (sda1, sda2, sdb3 ...) sowie mehrerer Geräte (MD raid), die auf diesen Blockgeräten/Partitionen basieren, und logischer Volumes (LVM), die auf diesen Blockgeräten/Partitionen basieren. In solchen Fällen sollten die zurückgegebenen Werte nur als relative Werte (zeitlich dynamisch), nicht jedoch als absolute Werte betrachtet werden.

⁴ SSL (HTTPS) wird nur unterstützt, wenn der Agent mit cURL-Unterstützung kompiliert wurde. Andernfalls wird der Datenpunkt nicht unterstützt.

⁵ Die Werte bytes und errors werden für Loopback-Schnittstellen auf Solaris-Systemen bis einschließlich Solaris 10 6/06 nicht unterstützt, da Byte-, Fehler- und Auslastungsstatistiken vom Kernel nicht gespeichert und/oder gemeldet werden. Wenn Sie jedoch ein Solaris-System über net-snmp überwachen, können Werte zurückgegeben werden, da net-snmp Legacy-Code aus cmu-snmp enthält, der bis ins Jahr 1997 zurückreicht und beim Fehlschlagen des Lesens von Byte-Werten aus den Schnittstellenstatistiken den Paketzähler (der auf Loopback-Schnittstellen vorhanden ist) mit einem beliebigen Wert von 308 multipliziert. Dabei wird angenommen, dass die durchschnittliche Länge eines Pakets 308 Oktette beträgt, was eine sehr grobe Schätzung ist, da das MTU-Limit auf Solaris-Systemen für Loopback-Schnittstellen 8892 Byte beträgt. Es sollte nicht davon ausgegangen werden, dass diese Werte korrekt oder auch nur annähernd genau sind. Es sind grobe Schätzwerte. Der Zabbix Agent nimmt keine Schätzungen vor, aber net-snmp gibt für diese Felder einen Wert zurück.

⁶ Die Befehlszeile auf Solaris, die aus /proc/pid/psinfo abgerufen wird, ist auf 80 Byte begrenzt und enthält die Befehlszeile so, wie sie beim Start des Prozesses war.

⁷ Die Datenpunkte vfs.file.contents[], vfs.file.regexp[], vfs.file.regmatch[] können zum Abrufen von Dateiinhalten verwendet werden. Wenn Sie den Zugriff auf bestimmte Dateien mit sensiblen Informationen einschränken möchten, führen Sie den Zabbix Agent unter einem Benutzer aus, der keine Berechtigung zum Anzeigen dieser Dateien hat.

Verwendung mit Befehlszeilenprogrammen

Beachten Sie, dass Sie beim Testen oder Verwenden von Datenpunktschlüsseln mit zabbix_agentd oder zabbix_get über die Befehlszeile auch die Shell-Syntax berücksichtigen sollten.

Wenn beispielsweise ein bestimmter Parameter des Schlüssels in doppelte Anführungszeichen eingeschlossen werden muss, müssen Sie die doppelten Anführungszeichen explizit maskieren. Andernfalls werden sie von der Shell als Sonderzeichen entfernt und nicht an das Zabbix-Dienstprogramm übergeben.

Beispiele:

zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'

zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]

Kodierungseinstellungen

Um sicherzustellen, dass die erfassten Daten nicht beschädigt werden, können Sie die korrekte Kodierung für die Verarbeitung der Prüfung (z. B. 'vfs.file.contents') im Parameter encoding angeben. Die Liste der unterstützten Kodierungen (Codepage-Identifikatoren) finden Sie in der Dokumentation zu libiconv (GNU-Projekt) oder in der Microsoft-Windows-SDK-Dokumentation zu "Code Page Identifiers". Beachten Sie, dass Microsoft einige Codepages manchmal als "nur für verwaltete Anwendungen verfügbar" kennzeichnet — d. h. sie sind nur über die .NET-Laufzeitumgebung verfügbar und nicht über die nativen Win32-APIs. Der Zabbix Agent implementiert seine eigene Logik zur Kodierungsumwandlung, daher werden diese Codepages vom Zabbix Agent auch dann unterstützt, wenn die nativen Windows-Funktionen sie nicht bereitstellen.

Wenn im Parameter encoding keine Kodierung angegeben ist, werden die folgenden Auflösungsstrategien angewendet:

• Wenn keine Kodierung angegeben ist (oder ein leerer String), wird UTF-8 angenommen, die Daten werden "wie sie sind" verarbeitet;
• BOM-Analyse - anwendbar für die Datenpunkte 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. Es wird versucht, die korrekte Kodierung anhand der Byte Order Mark (BOM) am Anfang der Datei zu bestimmen. Wenn kein BOM vorhanden ist, wird stattdessen die Standardauflösung (siehe oben) angewendet.

Fehlerbehebung bei Agent-Datenpunkten

Bei passiven Prüfungen ist Folgendes zu beachten, damit ein Datenpunkt keinen Wert verliert, weil die Anfrage des Servers an den Agent zuerst eine Zeitüberschreitung erreicht:

• Wenn die Agent-Version älter ist als die Server-Version, muss der Wert Timeout in der Datenpunkt-Konfiguration (oder das globale Timeout) möglicherweise höher sein als der Timeout-Wert in der Agent-Konfigurationsdatei.
• Wenn die Agent-Version neuer ist als die Server-Version, muss der Timeout-Wert in der Server-Konfigurationsdatei möglicherweise höher sein als der Timeout-Wert in der Agent-Konfigurationsdatei.