Sie können einen Datenpunkt auch erstellen, indem Sie einen vorhandenen öffnen, auf die Schaltfläche Clone klicken und ihn dann unter einem anderen Namen speichern.

Konfiguration

Die Registerkarte Item enthält allgemeine Item-Attribute.

Alle Pflichtfelder sind mit einem roten Sternchen markiert.

Parameter	Beschreibung
Name	Item-Name. Benutzer-Makros werden unterstützt.
Type	Item-Typ. Siehe die einzelnen Abschnitte zu Item-Typen.
Key	Item-Schlüssel (bis zu 2048 Zeichen). Die unterstützten Item-Schlüssel finden Sie in den einzelnen Abschnitten zu den Item-Typen. Der Schlüssel muss innerhalb eines einzelnen Host eindeutig sein. Wenn der Schlüsseltyp 'Zabbix agent', 'Zabbix agent (active)' oder 'Simple check' ist, muss der Schlüsselwert von Zabbix agent oder Zabbix Server unterstützt werden. Siehe auch: das korrekte Schlüsselformat.
Type of information	Der Datentyp, der zum Validieren des Item-Werts und zum Speichern in der Datenbank verwendet wird, jeweils nach eventuellen Konvertierungen: Numeric (unsigned) - vorzeichenlose 64-Bit-Ganzzahl; Numeric (float) - 64-Bit-Gleitkommazahl; Character - kurzer Text; Log - langer Text mit oder ohne Protokolleigenschaften (Zeitstempel, Quelle, Schweregrad, Log-Ereignis-ID); Text - langer Text; Binary - Binärwert (nur für abhängige Items unterstützt); JSON - strukturierte JSON-Daten, nativ in der Datenbank gespeichert (für berechnete Items nicht unterstützt). Items, die Werte mit dem Datentyp Binary oder JSON zurückgeben, werden in Formeln für berechnete Items oder in Ausdrücken für Auslöser nicht unterstützt. Siehe Item-Datenlimits für Speicherlimits pro Datentyp und Datenbank-Backend. Für Items, die Daten in einem einzelnen spezifischen Format zurückgeben, wird automatisch ein passender Datentyp ausgewählt - zum Beispiel geben `system.cpu.load` und `system.cpu.util` beide eine 64-Bit-Gleitkommazahl zurück, daher wird automatisch Numeric (float) ausgewählt.
Host interface	Wählen Sie die Host-Schnittstelle aus. Dieses Feld ist verfügbar, wenn ein Item auf Host-Ebene bearbeitet wird.
Units	Wenn ein Einheitensymbol gesetzt ist, wendet Zabbix eine Nachverarbeitung auf den empfangenen Item-Wert an und zeigt ihn mit dem angegebenen Einheiten-Suffix an. Unterstützte Einheitensymbole mit spezieller Formatierung (und Beispiele für empfangenen Item-Wert → angezeigten Wert): B - Bytes (1024 → 1 KB) Bps - Bytes pro Sekunde (1024 → 1 KBps) s - Sekunden, angezeigt mit bis zu drei größten ungleich null Zeit-Einheiten (881764 → 10d 4h 56m) uptime - verstrichene Zeit in hh:mm:ss oder N days, hh:mm:ss (881764 → 10 days, 04:56:04) unixtime - Unix-Zeitstempel, formatiert als yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); für die korrekte Formatierung muss der empfangene Item-Wert Numeric (unsigned) sein. Für andere Einheiten (wie Hz, W usw.) wird der Wert, wenn er 1000 überschreitet, durch 1000 geteilt und mit einem entsprechenden Präfix angezeigt (5000 → 5 KHz, 881764 → 881.76 KW). Wenn dem Einheitensymbol `!` vorangestellt ist, sind Einheitenumrechnung und Präfixbildung deaktiviert (1024 !B → 1024 B, 61 !s → 61 s). Weitere Beispiele und Details zu Einheitensymbolen und Einheitenumrechnung finden Sie unter Item-Wert-Suffixe.
Update interval	Rufen Sie alle N Sekunden einen neuen Wert für dieses Item ab. Das maximal zulässige Aktualisierungsintervall beträgt 86400 Sekunden (1 Tag). Zeitsuffixe werden unterstützt, z. B. 30s, 1m, 2h, 1d. Benutzer-Makros werden unterstützt. Ein einzelnes Makro muss das gesamte Feld ausfüllen. Mehrere Makros in einem Feld oder Makros zusammen mit Text werden nicht unterstützt. Hinweis: Das Aktualisierungsintervall kann nur auf '0' gesetzt werden, wenn benutzerdefinierte Intervalle mit einem von null verschiedenen Wert vorhanden sind. Wenn es auf '0' gesetzt ist und ein benutzerdefiniertes Intervall (flexibel oder geplant) mit einem von null verschiedenen Wert vorhanden ist, wird das Item während der Dauer des benutzerdefinierten Intervalls abgefragt. Hinweis: Die erste Abfrage des Items nach seiner Aktivierung oder nach einer Änderung des Aktualisierungsintervalls kann früher als der konfigurierte Wert erfolgen. Neue Items werden innerhalb von 60 Sekunden nach ihrer Erstellung geprüft, sofern sie nicht über ein geplantes oder flexibles Aktualisierungsintervall verfügen und das Update interval auf 0 gesetzt ist. Ein vorhandenes passives Item kann sofort auf einen Wert abgefragt werden, indem die Schaltfläche Execute now button verwendet wird.
Custom intervals	Sie können benutzerdefinierte Regeln für die Prüfung des Items erstellen: Flexible - erstellt eine Ausnahme zum Update interval (Intervall mit anderer Frequenz). Scheduling - erstellt einen benutzerdefinierten Abfrageplan. Ausführliche Informationen finden Sie unter Custom intervals. Zeitsuffixe werden im Feld Interval unterstützt, z. B. 30s, 1m, 2h, 1d. Benutzer-Makros werden unterstützt. Ein einzelnes Makro muss das gesamte Feld ausfüllen. Mehrere Makros in einem Feld oder Makros zusammen mit Text werden nicht unterstützt.
Timeout	Legen Sie das Timeout für die Item-Prüfung fest (verfügbar für unterstützte Item-Typen). Wählen Sie die Timeout-Option: Global - Proxy-/Global-Timeout wird verwendet (im ausgegrauten Feld Timeout angezeigt). Override - benutzerdefiniertes Timeout wird verwendet (im Feld Timeout festgelegt; zulässiger Bereich: 1 - 600s). Zeitsuffixe, z. B. 30s, 1m, und Benutzer-Makros werden unterstützt. Wenn Sie auf den Link Timeouts klicken, können Sie Proxy-Timeouts oder globale Timeouts konfigurieren (wenn kein Proxy verwendet wird). Beachten Sie, dass der Link Timeouts nur für Benutzer vom Typ Super admin mit Berechtigungen für die Frontend-Bereiche Administration > General oder Administration > Proxies sichtbar ist.
History	Wählen Sie entweder: Do not store - Item-Historie wird nicht gespeichert. Nützlich für Master-Items, wenn nur abhängige Items Historie behalten müssen. Diese Einstellung kann nicht durch globale Housekeeper-Einstellungen überschrieben werden. Store up to - geben Sie die Dauer an, für die detaillierte Historie in der Datenbank aufbewahrt wird (1 Stunde bis 25 Jahre). Ältere Daten werden vom Housekeeper entfernt. Speicherung in Sekunden. Zeitsuffixe werden unterstützt, z. B. 2h, 1d. Benutzer-Makros werden unterstützt. Der Wert Store up to kann global unter Administration > Housekeeping überschrieben werden. Wenn eine globale Überschreibungseinstellung vorhanden ist, wird ein oranges Info-Symbol angezeigt. Wenn Sie den Mauszeiger darauf positionieren, wird eine Warnmeldung angezeigt, z. B. Overridden by global housekeeper settings (1d). Es wird empfohlen, die aufgezeichneten Werte nur für die kleinstmögliche Zeit aufzubewahren, um die Größe der Wert-Historie in der Datenbank zu reduzieren. Anstatt eine lange Historie von Werten zu speichern, können Sie längere Trenddaten speichern. Siehe auch History and trends.
Trends	Wählen Sie entweder: Do not store - Trends werden nicht gespeichert. Diese Einstellung kann nicht durch globale Housekeeper-Einstellungen überschrieben werden. Store up to - geben Sie die Dauer an, für die aggregierte Historie (stündlich min, max, avg, count) in der Datenbank aufbewahrt wird (1 Tag bis 25 Jahre). Ältere Daten werden vom Housekeeper entfernt. Speicherung in Sekunden. Zeitsuffixe werden unterstützt, z. B. 24h, 1d. Benutzer-Makros werden unterstützt. Der Wert Store up to kann global unter Administration > Housekeeping überschrieben werden. Wenn eine globale Überschreibungseinstellung vorhanden ist, wird ein oranges Info-Symbol angezeigt. Wenn Sie den Mauszeiger darauf positionieren, wird eine Warnmeldung angezeigt, z. B. Overridden by global housekeeper settings (7d). Hinweis: Das Speichern von Trends ist für nicht-numerische Daten - Character, Log und Text - nicht verfügbar. Siehe auch History and trends.
Value mapping	Wenden Sie eine Wertzuordnung auf dieses Item an. Wertzuordnung ändert die empfangenen Werte nicht, sie dient nur zur Anzeige von Daten. Sie funktioniert mit Items vom Typ Numeric(unsigned), Numeric(float) und Character. Zum Beispiel "Windows service states".
Log time format	Nur für Items vom Typ Log verfügbar. Unterstützte Platzhalter: y: Jahr (1970-2038). M: Monat (01-12). d: Tag (01-31). h: Stunde (00-23). m: Minute (00-59). s: Sekunde (00-59). Wenn das Feld leer gelassen wird, wird der Zeitstempel in Unix-Zeit auf 0 gesetzt, was dem 1. Januar 1970 entspricht. Betrachten Sie zum Beispiel die folgende Zeile aus der Protokolldatei des Zabbix agent: " 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)." Sie beginnt mit sechs Zeichenpositionen für die PID, gefolgt von Datum, Uhrzeit und dem restlichen Meldungstext. Das Log-Zeitformat für diese Zeile wäre "pppppp:yyyyMMdd:hhmmss". Beachten Sie, dass die Zeichen "p" und ":" Platzhalter sind und beliebige Zeichen außer "yMdhms" sein können.
Populates host inventory field	Sie können ein Host-Inventarfeld auswählen, das durch den Wert des Items befüllt wird. Dies funktioniert, wenn die automatische Inventar-Befüllung für den Host aktiviert ist und bei Items vom Typ Numeric(unsigned), Numeric(float), Character und Text.
Description	Geben Sie eine Item-Beschreibung ein. Benutzer-Makros werden unterstützt.
Enabled	Aktivieren Sie das Kontrollkästchen, um das Item zu aktivieren, damit es verarbeitet wird. Wenn Sie das Item deaktivieren, wird es sofort aus dem History-Cache entfernt (mit Ausnahme des letzten Werts, der für Protokolle beibehalten wird).
Latest data	Klicken Sie auf den Link, um die neuesten Daten für das Item anzuzeigen. Dieser Link ist nur verfügbar, wenn ein bereits vorhandenes Item bearbeitet wird.

Itemspezifische Felder werden auf den entsprechenden Seiten beschrieben.

Beim Bearbeiten eines vorhandenen Items auf Vorlage-Ebene auf Host-Ebene sind eine Reihe von Feldern schreibgeschützt. Sie können den Link im Formularkopf verwenden und zur Vorlagenebene wechseln, um sie dort zu bearbeiten. Beachten Sie dabei, dass Änderungen auf Vorlagenebene das Item für alle Hosts ändern, mit denen die Vorlage verknüpft ist.

Die Registerkarte Tags ermöglicht die Definition von Tags auf Item-Ebene.

Vorverarbeitung von Datenpunkt-Werten

Die Registerkarte Vorverarbeitung ermöglicht es, Transformationsregeln für die empfangenen Werte zu definieren.

Item-Test

Um das Testen von Datenpunkten durchzuführen, stellen Sie sicher, dass die Systemzeit auf dem Server und dem Proxy synchronisiert ist. Falls die Serverzeit hinterherhinkt, kann das Testen von Datenpunkten die Fehlermeldung "The task has been expired." zurückgeben. Wenn auf dem Server und dem Proxy unterschiedliche Zeitzonen eingestellt sind, hat dies jedoch keinen Einfluss auf das Testergebnis.

Es ist möglich, einen Datenpunkt zu testen und, wenn er korrekt konfiguriert ist, einen echten Wert zurückzuerhalten. Das Testen kann sogar erfolgen, bevor ein Datenpunkt gespeichert wird.

Das Testen ist für Host- und Vorlagen-Datenpunkte, Datenpunktprototypen und Low-Level-Discovery-Regeln verfügbar. Das Testen ist für aktive Datenpunkte nicht verfügbar.

Das Testen von Datenpunkten ist für die folgenden passiven Datenpunkttypen verfügbar:

Zabbix Agent
SNMP Agent (v1, v2, v3)
IPMI Agent
SSH-Prüfungen
Telnet-Prüfungen
JMX Agent
Einfache Prüfungen (außer icmpping*, vmware.* Datenpunkte)
Zabbix intern
Berechnete Datenpunkte
Externe Prüfungen
Datenbankmonitor
HTTP Agent
Skript
Browser

Um einen Datenpunkt zu testen, klicken Sie unten im Konfigurationsformular des Datenpunkts auf die Schaltfläche Test. Beachten Sie, dass die Schaltfläche Test für Datenpunkte, die nicht getestet werden können, deaktiviert ist (z. B. aktive Prüfungen, ausgeschlossene einfache Prüfungen).

Das Formular zum Testen von Datenpunkten enthält Felder für die erforderlichen Host-Parameter (Host-Adresse, Port, Test mit Server/Proxy (Proxy-Name)) und datenpunktspezifische Details (z. B. SNMPv2-Community oder SNMPv3-Sicherheitsanmeldedaten). Diese Felder sind kontextabhängig:

Die Werte werden, wenn möglich, vorab ausgefüllt, d. h. bei Datenpunkten, die einen Agent erfordern, indem die Informationen aus der ausgewählten Agent-Schnittstelle des Hosts übernommen werden.
Die Werte müssen für Vorlagen-Datenpunkte manuell ausgefüllt werden.
Makrowerte im Klartext werden aufgelöst.
Felder, deren Wert (oder ein Teil des Werts) ein Secret- oder Vault-Makro ist, sind leer und müssen manuell eingegeben werden. Wenn ein Datenpunktparameter einen Secret-Makro-Wert enthält, wird die folgende Warnmeldung angezeigt: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
Die Felder sind deaktiviert, wenn sie im Kontext des Datenpunkttyps nicht benötigt werden (z. B. sind das Feld für die Host-Adresse und das Proxy-Feld für berechnete Datenpunkte deaktiviert)

Um den Datenpunkt zu testen, klicken Sie auf Get value. Wenn der Wert erfolgreich abgerufen wurde, wird er das Feld Value füllen, wobei der aktuelle Wert (falls vorhanden) in das Feld Previous value verschoben wird. Gleichzeitig wird das Feld Prev. time berechnet, d. h. die Zeitdifferenz zwischen den beiden Werten (Klicks), und es wird versucht, eine EOL-Sequenz zu erkennen und auf CRLF umzuschalten, wenn im abgerufenen Wert "\n\r" erkannt wird.

Klicken Sie auf Get value and test, um die Vorverarbeitung zu testen.

Von einem Host abgerufene Werte und Testergebnisse werden auf eine maximale Größe von 512 KB begrenzt, wenn sie an das Frontend gesendet werden. Wenn ein Testergebnis gekürzt wurde, wird ein Warnsymbol angezeigt; fahren Sie mit der Maus darüber, um Details anzuzeigen. Wenn ein Wert gekürzt wird, kann dies bei aufeinanderfolgenden Tests, die große Werte vergleichen (z. B. JSON), zu einem Fehler bei der Datentypvalidierung führen; in solchen Fällen wird eine Fehlermeldung angezeigt. Beachten Sie, dass Daten, die größer als 512 KB sind, von Zabbix Server weiterhin vollständig verarbeitet werden.

Wenn die Konfiguration fehlerhaft ist, wird eine Fehlermeldung angezeigt, die die mögliche Ursache beschreibt.

Ein erfolgreich von einem Host abgerufener Wert kann auch zum Testen von Vorverarbeitungsschritten verwendet werden.

Formularschaltflächen

Mit den Schaltflächen am unteren Rand des Formulars können mehrere Operationen ausgeführt werden.


	Einen Datenpunkt hinzufügen. Diese Schaltfläche ist nur für neue Datenpunkte verfügbar.
	Die Eigenschaften eines Datenpunkts aktualisieren.
	Einen weiteren Datenpunkt auf Grundlage der Eigenschaften des aktuellen Datenpunkts erstellen.
	Eine Prüfung auf einen neuen Datenpunktwert sofort ausführen. Nur für passive Prüfungen unterstützt (siehe weitere Details). Beachten Sie, dass beim sofortigen Prüfen auf einen Wert der Konfigurations-Cache nicht aktualisiert wird; daher spiegelt der Wert keine sehr aktuellen Änderungen an der Datenpunktkonfiguration wider.
	Testen, ob die Datenpunktkonfiguration korrekt ist, indem ein Wert abgerufen wird.
	Den Datenpunktverlauf und die Trends löschen.
	Den Datenpunkt löschen.
	Die Bearbeitung der Datenpunkteigenschaften abbrechen.

Datenpunkt-Datenlimits

Die Datenlimits für Datenpunkte hängen vom Datenpunkttyp und vom Datenbank-Backend ab.

Numerische Werte (unsigned) werden unverändert gespeichert. Wenn ein Gleitkommawert empfangen wird, wird nur der Ganzzahlteil gespeichert (z. B. 1.23 → 1).

Numerische Werte (float) werden unverändert gespeichert und unterstützen ungefähr 15 bis 17 Stellen Genauigkeit, mit einem Bereich von ungefähr -1.79E+308 bis 1.79E+308. Werte in wissenschaftlicher Notation werden ebenfalls unterstützt (z. B. 1.23E+7, 1e308, 1.1E-4).

Textwerte werden vor dem Speichern abgeschnitten, um dem Limit des Datenbank-Wertyps zu entsprechen:

Database	Type of information
	Character	Log	Text
MySQL	255 Zeichen	65536 Bytes	65536 Bytes
PostgreSQL	255 Zeichen	65536 Zeichen	65536 Zeichen
SQLite (only Zabbix Proxy)	255 Zeichen	65536 Zeichen	65536 Zeichen

Binärwerte sind auf 16 MiB (16777216 Bytes) begrenzt. Werte, die dieses Limit überschreiten, werden verworfen, und ein entsprechender Fehler wird im Frontend angezeigt.

Werte mit dem JSON-Datentyp sind auf 128 MiB (134217728 Bytes) begrenzt. Werte, die dieses Limit überschreiten, werden verworfen, und ein entsprechender Fehler wird im Frontend angezeigt. Für MySQL/MariaDB sollten Sie erwägen, tägliche Partitionen für die Tabelle history_json einzurichten (die zum Speichern von JSON-Werten verwendet wird), da sie schnell groß werden und den Housekeeper über einen längeren Zeitraum blockieren kann. Wenn Ihr Anwendungsfall große JSON-Werte (1 MiB oder mehr) umfasst, lesen Sie, wie Sie Ihr System für Unterstützung großer JSON-Werte konfigurieren.

Wenn Zabbix beliebige Datenpunkte-Daten in die Datenbank schreibt, verwendet es INSERT-Abfragen und protokolliert diese (wenn DebugLevel auf 4 oder 5 gesetzt ist). Große Protokolleinträge werden auf 64 KB gekürzt.

Limit für benutzerdefinierte Skripte

Die verfügbare Länge benutzerdefinierter Skripte hängt von der verwendeten Datenbank ab:

Datenbank	Limit in Zeichen	Limit in Byte
MySQL	65535	65535
PostgreSQL	65535	nicht begrenzt
SQLite (nur Zabbix Proxy)	65535	nicht begrenzt

Item-Timeout

Der Item-Timeout legt fest, wie lange Zabbix warten soll, bevor die Prüfung als fehlgeschlagen abgebrochen wird.

Wenn das Timeout erreicht wird, wird die Prüfung abgebrochen, auch wenn die Datenabfrage noch nicht abgeschlossen ist. Wenn Daten nur teilweise empfangen werden, wird das Item als nicht unterstützt markiert und eine Fehlermeldung protokolliert (z. B. wenn bei einer SNMP-Prüfung Daten erfolgreich nur für einen von mehreren OIDs erfasst werden).

Für viele Item-Typen können Sie flexible Item-Timeouts festlegen:

pro einzelnes Item
pro Item-Typ (auf Proxy-Ebene)
pro Item-Typ (auf globaler-Ebene)

Ein benutzerdefiniertes Timeout pro einzelnes Item ist nützlich, wenn Sie für ein bestimmtes Item ein längeres Timeout festlegen möchten, während die Timeouts für andere Items niedrig bleiben.

Timeout-Priorität

Das Timeout eines einzelnen Items überschreibt alle anderen Timeouts.
Timeouts auf Proxy-Ebene überschreiben globale Timeouts.

Das Timeout aus der Konfiguration von Zabbix-Server oder Proxy spielt bei Prüfungen, für die flexible Timeouts festgelegt sind, keine Rolle.

Flexible Timeout-Unterstützung

Flexible Datenpunkt-Timeouts werden für diese Datenpunkt-Typen unterstützt:

Zabbix agent (sowohl passive als auch aktive Prüfungen)
SNMP agent (außer veraltete SNMP-Prüfungen¹)
Simple check (außer icmpping* und VMware-Datenpunkte²)
SSH agent
Telnet agent
External check
Database monitor
Script
HTTP agent
Browser

¹ Für veraltete SNMP-Prüfungen (Abfrage einer einzelnen OID) gelten die Timeout-Einstellungen des Server oder Proxy.
² Für icmpping*-Datenpunkte wird der Timeout-Wert direkt im Datenpunkt-Schlüssel angegeben; außerdem gilt ein fest codierter maximal möglicher Timeout von 600 Sekunden. VMware-Überwachungsdatenpunkte verwenden ihren eigenen VMwareTimeout-Parameter aus der Server- oder Proxy-Konfiguration.

Nicht unterstützte Datenpunkte

Nicht unterstützte Datenpunkte werden mit dem Status Nicht unterstützt gemeldet und weiterhin in ihrem normalen Aktualisierungsintervall erneut geprüft.

Ein Datenpunkt wird nicht unterstützt, wenn sein Wert aus irgendeinem Grund nicht abgerufen werden kann (z. B. Verbindungsfehler, keine Poller zur Verarbeitung des Datenpunkts konfiguriert). Außerdem bleiben Datenpunkte, die keine Verlaufsdaten erhalten, im Status Nicht unterstützt. Dies ist das erwartete Verhalten — ein Datenpunkt wechselt erst dann in den Status Normal, wenn er neue, gültige Verlaufsdaten erhält.

Wie Probleme werden auch nicht unterstützte Datenpunkte nur dann erneut ausgewertet, wenn neue Daten empfangen werden — selbst wenn für diesen Datenpunkt keine Verlaufsdaten mehr verfügbar sind. Mit anderen Worten: Datenpunkte und Auslöser ändern ihren Zustand ausschließlich beim Empfang neuer Daten. Enthält ein Auslöserausdruck jedoch eine Funktion für Datum und Uhrzeit und/oder nodata(), wird der Auslöser alle 30 Sekunden neu berechnet (siehe Berechnungszeit von Auslösern für Details).

What’s next?

1 Format des Datenpunktschlüssels

Docs

1 Erstellen eines Datenpunkts

Übersicht