Der Trace-Knoten generiert Tracesätze, mit denen Sie das Verhalten eines Nachrichtenflusses überwachen können.
Dieses Kapitel enthält folgende Abschnitte:
Tracesätze können Text, Nachrichteninhalt sowie Datums- und Zeitangaben enthalten und damit die Überwachung des Nachrichtenflusses ermöglichen.
Sie können die Sätze in die Benutzertracedatei, eine andere Datei oder in das lokale Fehlerprotokoll schreiben (das Fehlermeldungen und Informationsnachrichten enthält, die von allen anderen WebSphere Message Broker-Komponenten geschrieben wurden). Wenn Sie Traces in das lokale Fehlerprotokoll schreiben, können Sie eine Nachricht aus dem Standardnachrichtenkatalog ausgeben, der zum Lieferumfang von WebSphere Message Broker gehört, oder einen eigenen Nachrichtenkatalog erstellen.
Der Betrieb des Trace-Knotens hängt nicht von den Einstellungen der Benutzertraceverarbeitung für den Nachrichtenfluss ab, in dem er sich befindet. Der Trace-Knoten schreibt auch dann Sätze in das Benutzertraceprotokoll, wenn der Benutzertrace gerade nicht für den Nachrichtenfluss aktiviert ist.
Der Trace-Knoten befindet sich im Ablagefach Aufbau der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Die folgenden Beispielprogramme verdeutlichen die Verwendung dieses Knotens:
Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Brokers Toolkit integriert ist.
Schließen Sie einen Trace-Knoten mit ein, um Fehler im Nachrichtenfluss zu diagnostizieren. Durch die Verfolgung des Nachrichteninhalts an verschiedenen Stellen im Nachrichtenfluss können Sie die Verarbeitungsreihenfolge bestimmen. Sie können den Trace-Knoten so konfigurieren, dass der Nachrichteninhalt aufgezeichnet und die Aktion eines bestimmten Knotens in der Nachricht geprüft wird. Sie können beispielsweise einen Trace-Knoten unmittelbar nach einem Compute-Knoten einschließen, um zu prüfen, ob die Ausgabenachricht das erwartete Format hat.
Mit dem Trace-Knoten können Sie auch Informationen zur Fehlerbehandlung in Ihren Nachrichtenflüssen bereitstellen. So können Sie beispielsweise mit diesem Knoten Störungen bei der Verarbeitung aufgrund von fehlerhaftem Nachrichteninhalt oder Nachrichtenformat protokollieren.
Entfernen Sie die Trace-Knoten aus dem Nachrichtenfluss, nachdem Sie ihn auf seinen ordnungsgemäßen Betrieb überprüft haben.
Nachdem Sie eine Instanz des Trace-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Klicken Sie zum Anzeigen der Knoteneigenschaften im Eigenschaftendialog entweder doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste und anschließend auf Eigenschaften. Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Stern gekennzeichnet.
In der folgenden Tabelle werden die Terminals des Trace-Knotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingangsterminal | Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Ausgangsterminal | Das Ausgabeterminal, über das die Nachricht weitergegeben wird. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des Trace-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | Der Knotentyp: Trace | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens. | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
In der folgenden Tabelle werden die Basiseigenschaften des Trace-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Zieladresse | Ja | Nein | Benutzertrace | Die Zieladresse des vom Knoten geschriebenen Tracesatzes. Die Zieladresse ist der Rechner, der als Host für den Broker fungiert, auf dem der Trace-Knoten implementiert ist:
|
Dateipfad | Nein | Ja | Vollständig qualifizierter Name der Datei, in die Tracesätze geschrieben werden. Diese Eigenschaft ist nur gültig, wenn als Zieladresse die Option Datei ausgewählt wurde. | |
Muster | Nein | Nein | Die in den Tracesatz aufzunehmenden Daten. Erstellen Sie ein ESQL-Muster, um
die Informationen anzugeben, die geschrieben werden sollen.
Wenn der Tracesatz in das lokale
Fehlerprotokoll geschrieben wird, bestimmt das Muster die Informationen, die in den Text der
ausgewählten Nachrichtennummer geschrieben werden. Wenn Sie den Standardnachrichtenkatalog und eine Zahl zwischen 3051 und 3099verwenden, werden die Musterinformationen als &1 in den Nachrichtentext eingefügt.
Das folgende Muster zeigt einige der verfügbaren Optionen. Es schreibt
eine erste Textzeile, protokolliert zwei Elemente der aktuellen Nachricht und fügt eine einfache
Zeitmarke hinzu:
Nachricht mit folgenden Feldern übermittelt: Speichername ist ${Body.storedetailselement.storename} Gesamtsumme ist ${Body.totalselement.totalsales} Zeit: ${EXTRACT(HOUR FROM CURRENT_TIMESTAMP)} :${EXTRACT(MINUTE FROM CURRENT_TIMESTAMP)} Daraus ergibt sich folgender Tracesatz:
Nachricht mit folgenden Feldern übermittelt: Speichername ist 'SRUCorporation' Gesamtsumme ist '34,98' Zeit: 11:19 Ein Muster mit Syntaxfehlern verhindert nicht die Implementierung eines Nachrichtenflusses, der einen Trace-Knoten enthält. Der Knoten schreibt allerdings keine Tracesätze. |
|
Nachrichtenkatalog | Nein | Nein | Der Name des Nachrichtenkatalogs, aus dem der Fehlertext für die Fehlernummer
der Ausnahme extrahiert wird. Der Standardwert (leer) zeigt an, dass die Nachricht aus dem mit
WebSphere Message Broker gelieferten Nachrichtenkatalog stammt. ![]() ![]() |
|
Nachrichtennummer | Nein | Nein | 3051 | Die Fehlernummer der geschriebenen Nachricht. |