Erstellen eines Datenpunkts

Übersicht

Um einen Datenpunkt im Zabbix Frontend zu erstellen, gehen Sie wie folgt vor:

1. Gehen Sie zu Datensammlung > Hosts.
2. Klicken Sie in der Zeile des Hosts auf Datenpunkte.
3. Klicken Sie in der oberen rechten Ecke des Bildschirms auf Datenpunkt erstellen.
4. Geben Sie die Parameter des Datenpunkts im Formular ein.

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

Konfiguration

Die Registerkarte Datenpunkt enthält allgemeine Attribute des Datenpunkts.

Alle Pflichtfelder sind mit einem roten Sternchen gekennzeichnet.

Parameter	Beschreibung
Name	Name des Datenpunkts. Benutzermakros werden unterstützt.
Typ	Datenpunkttyp. Siehe die einzelnen Abschnitte zu Datenpunkttypen.
Schlüssel	Datenpunktschlüssel (bis zu 2048 Zeichen). Die unterstützten Datenpunktschlüssel sind in den einzelnen Abschnitten zu den Datenpunkttypen aufgeführt. Der Schlüssel muss innerhalb eines einzelnen Hosts eindeutig sein. Wenn der Schlüsseltyp „Zabbix agent“, „Zabbix agent (aktiv)“ oder „Einfache Prüfung“ lautet, muss der Schlüsselwert vom Zabbix agent oder Zabbix server unterstützt werden. Siehe auch: das korrekte Schlüsselformat.
Informationstyp	Der Datentyp, der zur Validierung des Datenpunktwerts und zu seiner Speicherung in der Datenbank verwendet wird, jeweils nach etwaigen Konvertierungen: Numerisch (vorzeichenlos) – vorzeichenlose 64-Bit-Ganzzahl; Numerisch (Gleitkommazahl) – 64-Bit-Gleitkommazahl; Zeichen – kurzer Text; Protokoll – langer Text mit oder ohne Protokolleigenschaften (Zeitstempel, Quelle, Schweregrad, Ereignis-ID des Protokolls); Text – langer Text; Binär – Binärzahl (nur für abhängige Datenpunkte unterstützt); JSON – strukturierte JSON-Daten, nativ in der Datenbank gespeichert (für berechnete Datenpunkte nicht unterstützt). Datenpunkte, die Werte mit dem Datentyp „Binär“ oder „JSON“ zurückgeben, werden in Formeln für berechnete Datenpunkte oder Ausdrücken von Auslösern nicht unterstützt. Unter Datenlimits für Datenpunkte finden Sie die Speichergrenzen für die einzelnen Datentypen und Datenbank-Backends. Bei Datenpunkten, die Daten in einem einzigen bestimmten Format zurückgeben, wird automatisch ein passender Datentyp ausgewählt – beispielsweise geben system.cpu.load und system.cpu.util beide eine 64-Bit-Gleitkommazahl zurück, daher wird Numerisch (Gleitkommazahl) automatisch ausgewählt.
Host-Schnittstelle	Wählen Sie die Host-Schnittstelle aus. Dieses Feld ist verfügbar, wenn ein Datenpunkt auf Host-Ebene bearbeitet wird.
Einheiten	Wenn ein Einheitensymbol festgelegt ist, wendet Zabbix eine Nachverarbeitung auf den empfangenen Datenpunktwert an und zeigt ihn mit dem angegebenen Einheitenpräfix an. Unterstützte Einheitensymbole mit spezieller Formatierung (und Beispiele für empfangenen Datenpunktwert → angezeigten Wert): B – Byte (1024 → 1 KB) Bps – Byte pro Sekunde (1024 → 1 KBps) s – Sekunden, angezeigt mit bis zu drei größten Einheiten ungleich null (881764 → 10d 4h 56m) uptime – verstrichene Zeit im Format hh:mm:ss oder N Tage, 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 eine korrekte Formatierung muss der empfangene Datenpunktwert Numerisch (vorzeichenlos) sein. Bei anderen Einheiten (z. B. Hz, W usw.) wird der empfangene 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 ein ! vorangestellt wird, sind Einheitenkonvertierung und Präfixierung deaktiviert (1024 !B → 1024 B, 61 !s → 61 s). Weitere Beispiele und Informationen zu Einheitensymbolen und Einheitenkonvertierung finden Sie unter Suffixe für Datenpunktwerte.
Aktualisierungsintervall	Ruft alle N Sekunden einen neuen Wert für diesen Datenpunkt ab. Das maximal zulässige Aktualisierungsintervall beträgt 86400 Sekunden (1 Tag). Zeitsuffixe werden unterstützt, z. B. 30s, 1m, 2h, 1d. Benutzermakros 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 Wert ungleich null vorhanden sind. Wenn es auf „0“ gesetzt ist und ein benutzerdefiniertes Intervall (flexibel oder geplant) mit einem Wert ungleich null vorhanden ist, wird der Datenpunkt während der Dauer des benutzerdefinierten Intervalls abgefragt. Beachten Sie, dass die erste Abfrage des Datenpunkts nach seiner Aktivierung oder nach einer Änderung des Aktualisierungsintervalls früher als der konfigurierte Wert erfolgen kann. Neue Datenpunkte werden innerhalb von 60 Sekunden nach ihrer Erstellung geprüft, sofern sie nicht über ein geplantes oder flexibles Aktualisierungsintervall verfügen und das Aktualisierungsintervall auf 0 gesetzt ist. Ein vorhandener passiver Datenpunkt kann sofort durch Klicken auf die Schaltfläche Jetzt ausführen button auf seinen Wert abgefragt werden.
Benutzerdefinierte Intervalle	Sie können benutzerdefinierte Regeln für die Prüfung des Datenpunkts erstellen: Flexibel – erstellt eine Ausnahme für das Aktualisierungsintervall (Intervall mit einer anderen Häufigkeit). Planung – erstellt einen benutzerdefinierten Abfragezeitplan. Detaillierte Informationen finden Sie unter Benutzerdefinierte Intervalle. Zeitsuffixe werden im Feld Intervall unterstützt, z. B. 30s, 1m, 2h, 1d. Benutzermakros 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.
Zeitüberschreitung	Legt die Zeitüberschreitung für die Datenpunktprüfung fest (verfügbar für unterstützte Datenpunkttypen). Wählen Sie die Option für die Zeitüberschreitung aus: Global – die Proxy-/globale Zeitüberschreitung wird verwendet (im ausgegrauten Feld Zeitüberschreitung angezeigt). Überschreiben – eine benutzerdefinierte Zeitüberschreitung wird verwendet (im Feld Zeitüberschreitung festgelegt; zulässiger Bereich: 1–600 s). Zeitsuffixe, z. B. 30s, 1m, und Benutzermakros werden unterstützt. Über den Link Zeitüberschreitungen können Sie Proxy-Zeitüberschreitungen oder globale Zeitüberschreitungen konfigurieren (wenn kein Proxy verwendet wird). Beachten Sie, dass der Link Zeitüberschreitungen nur Benutzern vom Typ Super-Admin angezeigt wird, die über Berechtigungen für die Frontend-Bereiche Administration > Allgemein oder Administration > Proxies verfügen.
Historie	Wählen Sie eine der folgenden Optionen aus: Nicht speichern – die Datenpunkthistorie wird nicht gespeichert. Dies ist für Master-Datenpunkte nützlich, wenn nur abhängige Datenpunkte die Historie speichern müssen. Diese Einstellung kann nicht durch globale Einstellungen des Housekeepers überschrieben werden. Speichern bis – gibt an, wie lange die detaillierte Historie in der Datenbank aufbewahrt wird (1 Stunde bis 25 Jahre). Ältere Daten werden vom Housekeeper entfernt. Die Dauer wird in Sekunden gespeichert. Zeitsuffixe werden unterstützt, z. B. 2h, 1d. Benutzermakros werden unterstützt. Der Wert Speichern bis kann global unter Administration > Housekeeping überschrieben werden. Wenn eine globale Überschreibungseinstellung vorhanden ist, wird ein oranges Informationssymbol angezeigt. Wenn Sie den Mauszeiger darauf positionieren, wird eine Warnmeldung angezeigt, z. B. Durch globale Housekeeper-Einstellungen überschrieben (1d). Es wird empfohlen, die aufgezeichneten Werte so kurz wie möglich aufzubewahren, um die Größe der Werthistorie in der Datenbank zu reduzieren. Statt eine lange Wertehistorie zu speichern, können Sie Trenddaten länger aufbewahren. Siehe auch Historie und Trends.
Trends	Wählen Sie eine der folgenden Optionen aus: Nicht speichern – Trends werden nicht gespeichert. Diese Einstellung kann nicht durch globale Einstellungen des Housekeepers überschrieben werden. Speichern bis – gibt an, wie lange aggregierte (stündlicher Minimalwert, Maximalwert, Durchschnitt, Anzahl) Historie in der Datenbank aufbewahrt wird (1 Tag bis 25 Jahre). Ältere Daten werden vom Housekeeper entfernt. Die Dauer wird in Sekunden gespeichert. Zeitsuffixe werden unterstützt, z. B. 24h, 1d. Benutzermakros werden unterstützt. Der Wert Speichern bis kann global unter Administration > Housekeeping überschrieben werden. Wenn eine globale Überschreibungseinstellung vorhanden ist, wird ein oranges Informationssymbol angezeigt. Wenn Sie den Mauszeiger darauf positionieren, wird eine Warnmeldung angezeigt, z. B. Durch globale Housekeeper-Einstellungen überschrieben (7d). Hinweis: Die Aufbewahrung von Trends ist für nicht numerische Daten – Zeichen, Protokoll und Text – nicht verfügbar. Siehe auch Historie und Trends.
Wertzuordnung	Wendet eine Wertzuordnung auf diesen Datenpunkt an. Eine Wertzuordnung ändert die empfangenen Werte nicht, sondern dient nur zur Anzeige von Daten. Sie funktioniert mit Datenpunkten vom Typ Numerisch (vorzeichenlos), Numerisch (Gleitkommazahl) und Zeichen. Beispiel: „Windows-Dienststatus“.
Zeitformat des Protokolls	Nur für Datenpunkte vom Typ Protokoll 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 bleibt, wird der Zeitstempel auf 0 in der Unix-Zeit gesetzt, was den 1. Januar 1970 darstellt. Betrachten Sie beispielsweise 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 Text. Das Zeitformat des Protokolls 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.
Füllt Inventarfeld des Hosts	Sie können ein Inventarfeld des Hosts auswählen, das mit dem Wert des Datenpunkts gefüllt wird. Dies funktioniert, wenn die automatische Inventarisierung für den Host aktiviert ist und Datenpunkte vom Typ Numerisch (vorzeichenlos), Numerisch (Gleitkommazahl), Zeichen oder Text verwendet werden.
Beschreibung	Geben Sie eine Beschreibung des Datenpunkts ein. Benutzermakros werden unterstützt.
Aktiviert	Aktivieren Sie das Kontrollkästchen, um den Datenpunkt zu aktivieren und verarbeiten zu lassen. Wenn Sie den Datenpunkt deaktivieren, wird er sofort aus dem Verlaufscache entfernt (mit Ausnahme seines letzten Werts, der für Protokolle beibehalten wird).
Neueste Daten	Klicken Sie auf den Link, um die neuesten Daten für den Datenpunkt anzuzeigen. Dieser Link ist nur verfügbar, wenn ein bereits vorhandener Datenpunkt bearbeitet wird.

Auf der Registerkarte Tags können Sie Tags auf Datenpunktebene definieren.

Vorverarbeitung von Datenpunktwerten

Auf der Registerkarte Vorverarbeitung können Sie Transformationsregeln für die empfangenen Werte definieren.

Item-Test

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.

Schaltflächen des Formulars

Mit den Schaltflächen am unteren Rand des Formulars können Sie mehrere Vorgänge ausführen.

	Einen Datenpunkt hinzufügen. Diese Schaltfläche ist nur für neue Datenpunkte verfügbar.
	Die Eigenschaften eines Datenpunkts aktualisieren.
	Einen weiteren Datenpunkt basierend auf den Eigenschaften des aktuellen Datenpunkts erstellen.
	Eine Prüfung auf einen neuen Datenpunktwert sofort ausführen. Wird nur für passive Prüfungen unterstützt (siehe weitere Details). Hinweis: Beim sofortigen Prüfen eines Werts wird der Konfigurations-Cache nicht aktualisiert. Daher berücksichtigt der Wert möglicherweise sehr aktuelle Änderungen an der Datenpunktkonfiguration nicht.
	Testen, ob die Datenpunktkonfiguration korrekt ist, indem ein Wert abgerufen wird.
	Den Verlauf und die Trends des Datenpunkts 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:

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:

Item-Timeout

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

Wenn der Timeout erreicht wird, wird die Prüfung abgebrochen, auch wenn die Datenerfassung noch nicht abgeschlossen ist. Wenn Daten nur teilweise empfangen werden, wird das Item als nicht unterstützt markiert und eine Fehlermeldung protokolliert (zum Beispiel, 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 benutzerdefinierter Timeout pro einzelnes Item ist nützlich, wenn Sie für ein bestimmtes Item einen längeren Timeout festlegen möchten, während die Timeouts für andere Items niedrig bleiben.

Timeout-Priorität

1. Der Timeout für ein einzelnes Item hat Vorrang vor allen anderen Timeouts.
2. Timeouts auf Proxy-Ebene haben Vorrang vor globalen Timeouts.

Der Timeout aus der Zabbix-Server- oder Proxy-Konfiguration 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).