1 Testen der Vorverarbeitung

Testen

Das Testen von Vorverarbeitungsschritten ist nützlich, um sicherzustellen, dass komplexe Vorverarbeitungs-Pipelines die von ihnen erwarteten Ergebnisse liefern, ohne darauf warten zu müssen, dass der Datenpunkt-Wert empfangen und vorverarbeitet wird.

Es ist möglich, zu testen:

• mit einem hypothetischen Wert
• mit einem realen Wert von einem Host

Jeder Vorverarbeitungsschritt kann einzeln getestet werden, ebenso können alle Schritte zusammen getestet werden. Wenn Sie im Block Aktionen auf die Schaltfläche Test bzw. Alle Schritte testen klicken, wird ein Testfenster geöffnet.

Testen eines hypothetischen Werts

Parameter	Beschreibung
Wert vom Host abrufen	Wenn Sie einen hypothetischen Wert testen möchten, lassen Sie dieses Kontrollkästchen deaktiviert. Siehe auch: Testen eines echten Werts.
Wert	Geben Sie den Eingabewert zum Testen ein. Ein Klick in das Parameterfeld oder auf die Schaltfläche zum Anzeigen/Bearbeiten öffnet ein Textbereichsfenster zur Eingabe des Werts oder eines Codeblocks.
Nicht unterstützt	Aktivieren Sie dieses Kontrollkästchen, um einen nicht unterstützten Wert zu testen. Diese Option ist nützlich, um den Vorverarbeitungsschritt Prüfung auf nicht unterstützten Wert zu testen.
Fehler	Geben Sie den Fehlertext ein. Dieses Feld ist aktiviert, wenn Wert vom Host abrufen deaktiviert ist, aber Nicht unterstützt aktiviert ist. Wenn Wert vom Host abrufen aktiviert ist, wird dieses Feld mit der tatsächlichen Fehlermeldung (schreibgeschützt) vom Host gefüllt.
Zeit	Die Zeit des Eingabewerts wird angezeigt: now (schreibgeschützt).
Vorheriger Wert	Geben Sie einen vorherigen Eingabewert zum Vergleichen ein. Nur für die Vorverarbeitungsschritte Änderung und Drosselung.
Vorherige Zeit	Geben Sie die Zeit des vorherigen Eingabewerts zum Vergleichen ein. Nur für die Vorverarbeitungsschritte Änderung und Drosselung. Der Standardwert basiert auf dem Feldwert des Datenpunkts für „Aktualisierungsintervall“ (wenn „1m“, dann wird dieses Feld mit now-1m gefüllt). Wenn nichts angegeben ist oder der Benutzer keinen Zugriff auf den Host hat, ist der Standardwert now-30s.
Makros	Wenn Makros verwendet werden, werden sie zusammen mit ihren Werten aufgelistet. Die Werte können zu Testzwecken bearbeitet werden, die Änderungen werden jedoch nur im Testkontext gespeichert.
Zeilenendesequenz	Wählen Sie die Zeilenendesequenz für mehrzeilige Eingabewerte aus: LF - LF-Sequenz (line feed) CRLF - CRLF-Sequenz (carriage-return line-feed).
Vorverarbeitungsschritte	Die Vorverarbeitungsschritte werden aufgelistet; das Testergebnis wird für jeden Schritt angezeigt, nachdem auf die Schaltfläche Test geklickt wurde. Testergebnisse werden beim Senden an das Frontend auf eine maximale Größe von 512 KB gekürzt. Testergebnisse können kopiert werden (nicht mehr als die gekürzten 512 KB). Wenn ein Ergebnis gekürzt wird, wird ein Warnsymbol angezeigt. Die Beschreibung der Warnung wird beim Überfahren mit der Maus angezeigt. Beachten Sie, dass Daten größer als 512 KB von Zabbix Server dennoch vollständig verarbeitet werden. Wenn der Schritt beim Testen fehlschlägt, wird ein Fehlersymbol angezeigt. Die Fehlerbeschreibung wird beim Überfahren mit der Maus angezeigt. Falls für den Schritt „Benutzerdefiniert bei Fehler“ angegeben ist und diese Aktion ausgeführt wird, erscheint direkt nach der Zeile des Vorverarbeitungstestschritts eine neue Zeile, die anzeigt, welche Aktion ausgeführt wurde und welches Ergebnis sie erzeugt hat (Fehler oder Wert).
Ergebnis	Das Endergebnis des Testens der Vorverarbeitungsschritte wird in allen Fällen angezeigt, wenn alle Schritte zusammen getestet werden (wenn Sie auf die Schaltfläche Alle Schritte testen klicken). Auch die Art der Konvertierung in den Werttyp des Datenpunkts wird angezeigt, zum Beispiel Ergebnis konvertiert zu Numerisch (vorzeichenlos). Testergebnisse werden beim Senden an das Frontend auf eine maximale Größe von 512 KB gekürzt. Das Endergebnis kann kopiert werden (nicht mehr als die gekürzten 512 KB). Wenn ein Ergebnis gekürzt wird, wird ein Warnsymbol angezeigt. Die Beschreibung der Warnung wird beim Überfahren mit der Maus angezeigt. Beachten Sie, dass Daten größer als 512 KB von Zabbix Server dennoch vollständig verarbeitet werden.

Klicken Sie auf Test, um das Ergebnis nach jedem Vorverarbeitungsschritt anzuzeigen.

Testwerte werden zwischen Testsitzungen entweder für einzelne Schritte oder für alle Schritte gespeichert, sodass der Benutzer Vorverarbeitungsschritte oder die Konfiguration des Datenpunkts ändern und dann zum Testfenster zurückkehren kann, ohne die Informationen erneut eingeben zu müssen. Bei einer Seitenaktualisierung gehen die Werte jedoch verloren.

Das Testen wird von Zabbix Server durchgeführt. Das Frontend sendet eine entsprechende Anfrage an den Server und wartet auf das Ergebnis. Die Anfrage enthält den Eingabewert und die Vorverarbeitungsschritte (mit erweiterten Benutzermakros). Für die Schritte Änderung und Drosselung können optional ein vorheriger Wert und eine vorherige Zeit angegeben werden. Der Server antwortet mit Ergebnissen für jeden Vorverarbeitungsschritt.

Alle technischen Fehler oder Fehler bei der Eingabevalidierung werden im Fehlerfeld oben im Testfenster angezeigt.

Testen eines echten Werts

So testen Sie die Vorverarbeitung mit einem echten Wert:

• Aktivieren Sie das Kontrollkästchen Wert vom Host abrufen
• Geben Sie die Host-Parameter ein oder prüfen Sie sie (Host-Adresse, Port, Proxy-Name/kein Proxy) sowie Datenpunkt-spezifische Details (wie SNMPv2-Community oder SNMPv3- Sicherheitsanmeldedaten). Diese Felder sind kontextabhängig:
  • Die Werte werden nach Möglichkeit vorausgefü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 bei Vorlagen-Datenpunkten manuell ausgefüllt werden
  • Makrowerte im Klartext werden aufgelöst
  • Wenn der Feldwert (oder ein Teil des Werts) ein geheimes Makro oder ein Vault-Makro ist, ist das Feld leer und muss manuell ausgefüllt werden. Wenn ein Datenpunkt-Parameter einen geheimen Makrowert enthält, wird die folgende Warnmeldung angezeigt: "Datenpunkt enthält benutzerdefinierte Makros mit geheimen Werten. Werte dieser Makros sollten manuell eingegeben werden."
  • Die Felder sind deaktiviert, wenn sie im Kontext des Datenpunkttyps nicht benötigt werden (z. B. sind die Felder für Host-Adresse und Proxy bei berechneten Datenpunkten deaktiviert)
• Klicken Sie auf Wert abrufen und testen, um die Vorverarbeitung zu testen

Wenn Sie im Konfigurationsformular des Datenpunkts eine Wertezuordnung angegeben haben (Feld „Wert anzeigen“), zeigt der Datenpunkt-Testdialog nach dem Endergebnis eine weitere Zeile mit dem Namen „Ergebnis mit angewendeter Wertezuordnung“ an.

Parameter, die speziell für das Abrufen eines echten Werts von einem Host gelten:

Parameter	Beschreibung
Wert vom Host abrufen	Aktivieren Sie dieses Kontrollkästchen, um einen echten Wert vom Host abzurufen.
Host-Adresse	Geben Sie die Host-Adresse ein. Dieses Feld wird automatisch mit der Adresse der Host-Schnittstelle des Datenpunkts ausgefüllt.
Port	Geben Sie den Host-Port ein. Dieses Feld wird automatisch mit dem Port der Host-Schnittstelle des Datenpunkts ausgefüllt.
Zusätzliche Felder für SNMP-Schnittstellen (SNMP-Version, SNMP-Community, Kontextname usw.)	Siehe SNMP-Monitoring konfigurieren für weitere Details zur Konfiguration einer SNMP-Schnittstelle (v1, v2 und v3). Diese Felder werden automatisch aus der Host-Schnittstelle des Datenpunkts ausgefüllt.
Proxy	Geben Sie den Proxy an, wenn der Host über einen Proxy überwacht wird. Dieses Feld wird automatisch mit dem Proxy des Hosts ausgefüllt (falls vorhanden).
Wert	Vom Host abgerufener Wert. Ein Klick in das Parameterfeld oder auf die Anzeigen-/Bearbeiten-Schaltfläche öffnet ein Textbereichsfenster mit dem Wert oder Codeblock. Werte werden nur im Frontend auf eine maximale Größe von 512 KB gekürzt. Wenn ein Ergebnis gekürzt wird, wird ein Warnsymbol angezeigt. Die Warnungsbeschreibung wird beim Überfahren mit der Maus angezeigt. Beachten Sie, dass Daten größer als 512 KB von Zabbix Server dennoch vollständig verarbeitet werden.

Zu den übrigen Parametern siehe Testen eines hypothetischen Werts oben.