[comment]: # ({d3fd8a91-0aa26ab0}) # 1 Testen der Vorverarbeitung [comment]: # ({/d3fd8a91-0aa26ab0}) [comment]: # ({168568ad-ad67af50}) ### Testen Das Testen von Vorverarbeitungsschritten ist nützlich, um sicherzustellen, dass komplexe Vorverarbeitungspipelines die erwarteten Ergebnisse liefern, ohne darauf zu warten, dass der Datenpunktwert empfangen und vorverarbeitet wird. ![](../../../../../assets/en/manual/config/items/test_item_steps.png){width="600"} Es ist möglich zu testen: - gegen einen hypothetischen Wert - gegen einen realen Wert von einem Host Jeder Vorverarbeitungsschritt kann einzeln getestet werden, ebenso können alle Schritte zusammen getestet werden. Wenn Sie im Aktionsblock auf die Schaltfläche *Test* oder *Alle Schritte testen* klicken, wird ein Testfenster geöffnet. [comment]: # ({/168568ad-ad67af50}) [comment]: # ({28a496d9-45423233}) ##### Testen eines hypothetischen Werts ![](../../../../../assets/en/manual/config/items/test_item_p.png){width="600"} |Parameter|Beschreibung| |--|--------| |*Get value from host*|Wenn Sie einen hypothetischen Wert testen möchten, lassen Sie dieses Kontrollkästchen deaktiviert.
Siehe auch: [Echten Wert testen](#testing-real-value).| |*Value*|Geben Sie den Eingabewert ein, der getestet werden soll.
Wenn Sie in das Parameterfeld oder auf die Schaltfläche zum Anzeigen/Bearbeiten ![](../../../../../assets/en/manual/config/items/pencil.png) klicken, wird ein Textbereich geöffnet, in den Sie den Wert oder einen Codeblock eingeben können.| |*Not supported*|Aktivieren Sie dieses Kontrollkästchen, um einen nicht unterstützten Wert zu testen.
Diese Option ist nützlich, um den Preprocessing-Schritt *Auf nicht unterstützten Wert prüfen* zu testen.| |*Error*|Geben Sie den Fehlertext ein.
Dieses Feld ist aktiviert, wenn *Get value from host* deaktiviert ist, aber *Not supported* aktiviert ist.
Wenn *Get value from host* aktiviert ist, wird dieses Feld mit der tatsächlichen Fehlermeldung (schreibgeschützt) vom Host gefüllt.| |*Time*|Die Zeit des Eingabewerts wird angezeigt: `now` (schreibgeschützt).| |*Previous value*|Geben Sie einen vorherigen Eingabewert zum Vergleichen ein.
Nur für die Preprocessing-Schritte *Change* und *Throttling*.| |*Previous time*|Geben Sie die Zeit des vorherigen Eingabewerts zum Vergleichen ein.
Nur für die Preprocessing-Schritte *Change* und *Throttling*.
Der Standardwert basiert auf dem Feldwert 'Update interval' 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`.| |*Macros*|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.| |*End of line sequence*|Wählen Sie die Zeilenendesequenz für mehrzeilige Eingabewerte aus:
**LF** - LF-Sequenz (Line Feed)
**CRLF** - CRLF-Sequenz (Carriage Return Line Feed).| |*Preprocessing steps*|Die Preprocessing-Schritte werden aufgelistet; das Testergebnis wird für jeden Schritt angezeigt, nachdem die Schaltfläche *Test* geklickt wurde.
Testergebnisse werden auf eine maximale Größe von 512 KB gekürzt, wenn sie an das Frontend gesendet werden. Wenn ein Ergebnis gekürzt wird, wird ein Warnsymbol angezeigt. Die Warnungsbeschreibung wird beim Überfahren mit der Maus angezeigt. Beachten Sie, dass Daten mit einer Größe von mehr als 512 KB von Zabbix Server weiterhin vollständig verarbeitet werden.
Wenn der Schritt beim Testen fehlgeschlagen ist, wird ein Fehlersymbol angezeigt. Die Fehlerbeschreibung wird beim Überfahren mit der Maus angezeigt.
Falls für den Schritt "Custom on fail" angegeben ist und diese Aktion ausgeführt wird, erscheint direkt nach der Zeile des Preprocessing-Testschritts eine neue Zeile, die zeigt, welche Aktion ausgeführt wurde und welches Ergebnis sie erzeugt hat (Fehler oder Wert).| |*Result*|Das Endergebnis der Prüfung der Preprocessing-Schritte wird in allen Fällen angezeigt, in denen alle Schritte gemeinsam getestet werden (wenn Sie auf die Schaltfläche *Test all steps* klicken).
Auch der Typ der Konvertierung in den Werttyp des Datenpunkts wird angezeigt, zum Beispiel `Result converted to Numeric (unsigned)`.
Testergebnisse werden auf eine maximale Größe von 512 KB gekürzt, wenn sie an das Frontend gesendet werden. Wenn ein Ergebnis gekürzt wird, wird ein Warnsymbol angezeigt. Die Warnungsbeschreibung wird beim Überfahren mit der Maus angezeigt. Beachten Sie, dass Daten mit einer Größe von mehr als 512 KB von Zabbix Server weiterhin vollständig verarbeitet werden.| Klicken Sie auf *Test*, um das Ergebnis nach jedem Preprocessing-Schritt anzuzeigen. Testwerte werden zwischen Testsitzungen entweder für einzelne Schritte oder für alle Schritte gespeichert, sodass der Benutzer Preprocessing-Schritte oder die Datenpunktkonfiguration ändern und dann zum Testfenster zurückkehren kann, ohne 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 Preprocessing-Schritte (mit erweiterten Benutzermakros). Für die Schritte *Change* und *Throttling* können ein optionaler vorheriger Wert und eine Zeit angegeben werden. Der Server antwortet mit Ergebnissen für jeden Preprocessing-Schritt. Alle technischen Fehler oder Eingabevalidierungsfehler werden im Fehlerfeld oben im Testfenster angezeigt. [comment]: # ({/28a496d9-45423233}) [comment]: # ({e1608e2f-43637da5}) ##### Testen eines realen Werts Um die Vorverarbeitung anhand eines realen Werts zu testen: - Aktivieren Sie das Kontrollkästchen *Wert vom Host abrufen* - Geben Sie Host-Parameter ein oder prüfen Sie sie (Host-Adresse, Port, Proxy-Name/kein Proxy) sowie datensatzspezifische 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, werden die Informationen aus der ausgewählten Agent-Schnittstelle des Hosts übernommen - Die Werte müssen für Vorlagen-Datenpunkte manuell ausgefüllt werden - Klartext-Makrowerte werden aufgelöst - Wenn der Feldwert (oder ein Teil des Werts) ein Geheimnis oder ein Vault-Makro ist, bleibt das Feld leer und muss manuell ausgefüllt werden. Wenn ein Datenpunktparameter einen geheimen Makrowert 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 Datensatztyps 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 ![](../../../../../assets/en/manual/config/items/test_item_p2.png){width="600"} Wenn Sie im Konfigurationsformular des Datenpunkts eine Wertzuordnung angegeben haben (Feld 'Wert anzeigen'), zeigt der Testdialog des Datenpunkts nach dem Endergebnis eine weitere Zeile mit dem Namen 'Ergebnis mit angewendeter Wertzuordnung' 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 Informationen zur Konfiguration einer SNMP-Schnittstelle (v1, v2 und v3) finden Sie unter [SNMP-Überwachung konfigurieren](/manual/config/items/itemtypes/snmp#step-2).
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 (falls vorhanden) ausgefüllt.| |*Wert*|Vom Host abgerufener Wert.
Wenn Sie in das Parameterfeld oder auf die Schaltfläche zum Anzeigen/Bearbeiten ![](../../../../../assets/en/manual/config/items/pencil.png) klicken, wird ein Textbereich mit dem Wert oder Codeblock geöffnet.
Werte werden nur im 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.| Für die übrigen Parameter siehe oben [Hypothetischen Wert testen](#testing-hypothetical-value). [comment]: # ({/e1608e2f-43637da5})