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.

Hypothetischen Wert testen

Parameter	Beschreibung
Wert vom Host abrufen	Wenn Sie einen hypothetischen Wert testen möchten, lassen Sie dieses Kontrollkästchen deaktiviert. Siehe auch: Realen Wert testen.
Wert	Geben Sie den Eingabewert zum Testen ein. Ein Klick in das Parameterfeld oder auf die Anzeigen/Bearbeiten-Schaltfläche öffnet ein Textbereichsfenster zur Eingabe des Werts oder 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 von 'Aktualisierungsintervall' des Datenpunkts (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: 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 Warnbeschreibung 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). Der Typ der Konvertierung in den Werttyp des Datenpunkts wird ebenfalls 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 Warnbeschreibung 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.

Der Test 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 realen Werts

So testen Sie die Vorverarbeitung mit einem realen 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, werden die Informationen von der ausgewählten Agent-Schnittstelle des Hosts übernommen
  • 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, bleibt das Feld leer und muss manuell ausgefüllt werden. Wenn ein Datenpunkt-Parameter einen geheimen Makrowert enthält, wird folgende Warnmeldung angezeigt: "Datenpunkt enthält benutzerdefinierte Makros mit geheimen Werten. Die 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 Dialog zum Testen des Datenpunkts nach dem Endergebnis eine weitere Zeile mit dem Namen „Ergebnis mit angewendeter Wertezuordnung“ an.

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

Parameter	Beschreibung
Wert vom Host abrufen	Aktivieren Sie dieses Kontrollkästchen, um einen realen 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.)	Weitere Details zur Konfiguration einer SNMP-Schnittstelle (v1, v2 und v3) finden Sie unter Configuring SNMP monitoring. Diese Felder werden automatisch aus der Host-Schnittstelle des Datenpunkts ausgefüllt.
Proxy	Geben Sie den Proxy an, wenn der Host von einem 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 Schaltfläche zum Anzeigen/Bearbeiten ö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 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.

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