Der Trace-Knoten generiert Tracesätze, mit denen Sie das Verhalten eines Nachrichtenflusses überwachen können.
Dieses Thema ist in folgende Abschnitte eingeteilt:
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 im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Die folgenden Mustercodes verdeutlichen die Verwendung dieses Knotens:
Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.
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.
Nachdem Sie den Nachrichtenfluss getestet und auf seinen ordnungsgemäßen Betrieb überprüft haben, entfernen Sie die Trace-Knoten aus dem Nachrichtenfluss, oder schalten Sie sie aus.
Nachdem Sie eine Instanz des Trace-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
In der folgenden Tabelle werden die Terminals des Trace-Knotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingabeterminal (In) | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Ausgang | 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 | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Ziel | 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 | Der vollständig qualifizierte Name der Datei, in die Tracesätze geschrieben werden. Diese Eigenschaft ist nur gültig, wenn als Zieladresse die Option Datei ausgewählt wurde. | filePath | |
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 hier gezeigte Muster enthält einige der verfügbaren Optionen. Es schreibt
eine erste Textzeile, protokolliert zwei Elemente der aktuellen Nachricht und fügt eine einfache
Zeitmarke hinzu:
Daraus ergibt sich folgender Tracesatz:
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. Weitere Informationen finden Sie im Abschnitt Nachrichtenkataloge erstellen. | ||
Nachrichtennummer | Nein | Nein | 3051 | Die Fehlernummer der geschriebenen Nachricht. |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Ereignisse | Nein | Nein | Ohne | Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten
definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss
Überwachungsereignisse definiert. Über Hinzufügen,
Bearbeiten und Löschen können Sie
Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe
Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren). Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren. |