1 Erstellen eines Datenpunkts

Übersicht

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

• Gehen Sie zu: Data collection > Hosts
• Klicken Sie in der Zeile des Hosts auf Items
• Klicken Sie oben rechts auf dem Bildschirm auf Create item
• Geben Sie die Parameter des Datenpunkts im Formular ein

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 Datenpunkt enthält allgemeine Datenpunktattribute.

Alle obligatorischen Eingabefelder sind mit einem roten Sternchen markiert.

Parameter	Beschreibung
Name	Name des Datenpunkts. Benutzermakros werden unterstützt.
Type	Datenpunkttyp. Siehe die einzelnen Abschnitte zu Datenpunkttypen.
Key	Datenpunkt-Schlüssel (bis zu 2048 Zeichen). Die unterstützten Datenpunktschlüssel finden Sie in den einzelnen Abschnitten zu den Datenpunkttypen. 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	Datentyp, wie er nach eventuellen Konvertierungen in der Datenbank gespeichert wird. Numeric (unsigned) - vorzeichenlose 64-Bit-Ganzzahl. Beachten Sie, dass ein Gleitkommawert, der für einen Ganzzahl-Datenpunkt empfangen wird, auf seinen Dezimalteil gekürzt wird. Numeric (float) - 64-Bit-Gleitkommazahl. Dieser Typ erlaubt eine Genauigkeit von ungefähr 15 Stellen und einen Bereich von ungefähr -1.79E+308 bis 1.79E+308 (mit Ausnahme von PostgreSQL 11 und früheren Versionen). Auch Werte in wissenschaftlicher Notation werden unterstützt, z. B. 1.23E+7, 1e308, 1.1E-4. Character - kurze Textdaten. Log - lange Textdaten mit optionalen protokollbezogenen Eigenschaften (Zeitstempel, Quelle, Schweregrad, logeventid). Text - lange Textdaten. Siehe auch Grenzen für Textdaten. Binary - Binärzahl (nur für abhängige Datenpunkte unterstützt). Datenpunkte, die Werte mit dem Binärdatentyp zurückgeben, werden in Formeln für berechnete Datenpunkte oder in Ausdrücken für Auslöser nicht unterstützt. Für Datenpunktschlüssel, die Daten nur in einem bestimmten Format zurückgeben, wird der passende Typ automatisch ausgewählt.
Host interface	Wählen Sie die Host-Schnittstelle aus. Dieses Feld ist verfügbar, wenn ein Datenpunkt auf Host-Ebene bearbeitet wird.
Units	Wenn ein Einheitensymbol gesetzt ist, führt Zabbix eine Nachverarbeitung des empfangenen Datenpunktwerts durch und zeigt ihn mit dem angegebenen Einheiten-Suffix an. Unterstützte Einheitensymbole mit spezieller Formatierung (und Beispiele für empfangenen Datenpunktwert → angezeigter 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 Datenpunktwert Numeric (unsigned) sein. Für andere Einheiten (z. B. 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 Datenpunktwert-Suffixe.
Update interval	Rufen Sie 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 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 der Datenpunkt während der Dauer des benutzerdefinierten Intervalls abgefragt. Hinweis: Die erste Abfrage des Datenpunkts, nachdem er aktiv geworden ist oder nachdem das Aktualisierungsintervall geändert wurde, kann früher als der konfigurierte Wert erfolgen. 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 Update interval auf 0 gesetzt ist. Ein vorhandener passiver Datenpunkt 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 Datenpunkts erstellen: Flexible - erstellt eine Ausnahme zum Update interval (Intervall mit anderer Frequenz). Scheduling - erstellt einen benutzerdefinierten Abfrageplan. Ausführliche Informationen finden Sie unter Benutzerdefinierte Intervalle. Zeitsuffixe werden im Feld Interval 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.
Timeout	Legen Sie das Timeout für die Datenpunktprüfung fest (verfügbar für unterstützte Datenpunkttypen). Wählen Sie die Timeout-Option: Global - Proxy-/globales 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 Benutzermakros 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 - die Datenpunkthistorie wird nicht gespeichert. Nützlich für Master-Datenpunkte, wenn nur abhängige Datenpunkte die 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. Benutzermakros werden unterstützt. Der Wert Store up to kann global unter Administration > Housekeeping überschrieben werden. Wenn eine globale überschreibende Einstellung 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 so kurz wie möglich aufzubewahren, um die Größe der Wert-Historie in der Datenbank zu reduzieren. Statt eine lange Historie von Werten zu speichern, können Sie längere Trenddaten speichern. Siehe auch Historie und 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ündliches 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. Benutzermakros werden unterstützt. Der Wert Store up to kann global unter Administration > Housekeeping überschrieben werden. Wenn eine globale überschreibende Einstellung 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 nicht verfügbar - Character, Log und Text. Siehe auch Historie und Trends.
Value mapping	Wenden Sie eine Wertzuordnung auf diesen Datenpunkt an. Wertzuordnung ändert die empfangenen Werte nicht, sie dient nur zur Anzeige von Daten. Sie funktioniert mit Datenpunkten vom Typ Numeric(unsigned), Numeric(float) und Character. Zum Beispiel "Windows service states".
Log time format	Nur für Datenpunkte 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 bleibt, wird der Zeitstempel in der 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 Nachrichtentext. Das Protokollzeitformat 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 Datenpunkts befüllt wird. Dies funktioniert, wenn die automatische Inventar-Befüllung für den Host aktiviert ist. Dieses Feld ist nicht verfügbar, wenn Type of information auf 'Log' gesetzt ist.
Description	Geben Sie eine Beschreibung des Datenpunkts ein. Benutzermakros werden unterstützt.
Enabled	Aktivieren Sie das Kontrollkästchen, um den Datenpunkt zu aktivieren, damit er verarbeitet wird.
Latest data	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.

Die Registerkarte Tags ermöglicht die Definition von Tags auf Datenpunktebene.

Vorverarbeitung von Datenpunkt-Werten

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

Item-Test

Es ist möglich, ein 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, Datenpunkt-Prototypen und Low-Level-Discovery-Regeln verfügbar. Für aktive Datenpunkte ist das Testen nicht verfügbar.

Das Item-Testen ist für die folgenden passiven Datenpunkt-Typen 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 internal
• Berechnete Datenpunkte
• Externe Prüfungen
• Datenbankmonitor
• HTTP Agent
• Script
• 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)) sowie datenpunktspezifische Details (z. B. SNMPv2-Community oder SNMPv3-Sicherheitsanmeldedaten). Diese Felder sind kontextabhängig:

• Die Werte werden nach Möglichkeit 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, bei denen der Wert (oder ein Teil des Werts) ein Secret- oder Vault-Makro ist, bleiben 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 Datenpunkt-Typs 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 beim Senden an das Frontend auf eine maximale Größe von 512 KB gekürzt. Wenn ein Ergebnis gekürzt wurde, wird ein Warnsymbol angezeigt. Die Warnbeschreibung wird beim Überfahren mit der Maus 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.

Textdatenlimits

Textdatenlimits hängen vom Datenbank-Backend ab. Bevor Textwerte in der Datenbank gespeichert werden, werden sie gekürzt, um dem Limit des Datenbank-Werttyps zu entsprechen:

Benutzerdefiniertes Skriptlimit

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 Datenpunkt als unsupported markiert und eine Fehlermeldung protokolliert (zum Beispiel, wenn Daten nur für eines von mehreren OIDs in einer SNMP-Prüfung erfolgreich erfasst werden).

Für viele Datentypen 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 Konfiguration von Zabbix Server oder Proxy spielt bei Prüfungen, für die flexible Timeouts festgelegt sind, keine Rolle.

Unterstützung für flexible Timeouts

Flexible Datenpunkt-Timeouts werden für diese Datenpunkttypen 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 des Proxy.
  ² Für icmpping*-Datenpunkte wird der Timeout-Wert direkt im Datenpunktschlüssel angegeben. VMware-Überwachungsdatenpunkte verwenden ihren eigenen Parameter VMwareTimeout aus der Konfiguration des Server oder des Proxy.

Nicht unterstützte Datenpunkte

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

Ein Datenpunkt wird nicht unterstützt, wenn sein Wert aus irgendeinem Grund nicht abgerufen werden kann (z. B. Verbindungsfehler, keine konfigurierten Poller zur Verarbeitung des Datenpunkts). Darüber hinaus bleiben Datenpunkte, die keine historischen Daten erhalten, im Status Nicht unterstützt. Dies ist das erwartete Verhalten - ein Datenpunkt wechselt nur dann in den Status Normal, wenn er neue, gültige historische Daten 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 historischen Daten mehr verfügbar sind. Mit anderen Worten: Datenpunkte und Auslöser ändern ihren Status ausschließlich beim Empfang neuer Daten. Wenn ein Auslöserausdruck jedoch eine Funktion für Datum und Uhrzeit und/oder nodata() enthält, wird der Auslöser alle 30 Sekunden neu berechnet (siehe Berechnungszeit von Auslösern für Details).