Trace-Knoten

Der Trace-Knoten generiert Tracesätze, mit denen Sie das Verhalten eines Nachrichtenflusses überwachen können.

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Tracesätze können Text, Nachrichteninhalt sowie Datums- und Zeitangaben enthalten und damit die Überwachung des Nachrichtenflussablaufs ermöglichen.

Sie können die Sätze in die Benutzertracedatei, eine andere Datei oder in das lokale Fehlerprotokoll schreiben (welches Fehlermeldungen und Informationsnachrichten enthält, die von allen anderen WebSphere Nachrichtenbroker-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:

Symbol für Traceknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Die folgenden Beispielprogramme verdeutlichen die Verwendung dieses Knotens:

Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker 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 auf Grund 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.

Trace-Knoten konfigurieren

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.

Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Stern gekennzeichnet.

Konfigurieren Sie den Trace-Knoten folgendermaßen:
  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Auf der Registerkarte Grundeinstellungen:
    1. Legen Sie die Eigenschaft fest, um anzugeben, wohin die Ausgabe des Trace-Knotens geschrieben werden soll. Die Zieladresse ist der Rechner, der als Host für den Broker fungiert, auf dem der Trace-Knoten implementiert ist:
      • Wenn der Tracesatz in das lokale Systemfehlerprotokoll geschrieben werden soll, wählen Sie die Option Lokales Fehlerprotokoll aus.

        Die Informationen, die Sie in den Tracesatz einschließen, werden in eine der folgenden Positionen geschrieben:

        • Windows platform Unter Windows werden die Daten in das Ereignisprotokoll (Anwendungsansicht) geschrieben.
        • Linux platform UNIX platform Unter Linux und UNIX werden die Daten in das Systemprotokoll geschrieben.
        • z/OS platform Unter z/OS werden die Daten in die Bedienerkonsole geschrieben.

        Wenn Sie Lokales Fehlerprotokoll auswählen, geben Sie die Nummer der zu schreibenden Tracenachricht sowie den Nachrichtenkatalog an, in dem die Nachricht definiert ist.

        • Wenn Sie Nachrichtenkatalog leer lassen, wird der zum Lieferumfang von WebSphere Message Broker gehörende Standardnachrichtenkatalog als Quelle der zu schreibenden Nachricht verwendet.

          Sie müssen auch die Fehlernummer des Satzes unter Nachrichtennummer eingeben. Dazu sind sind im (Standard-)Katalog von WebSphere Message Broker die Zahlen 3051 bis 3099 reserviert. Der Text der Nachrichten im Standardnachrichtenkatalog ist identisch. Wenn Sie jedoch jeweils eine andere Zahl aus diesem Bereich für Situationen verwenden, in denen Sie die Tracefunktion ausführen, können Sie den genauen Grund für den Fehler identifizieren. Die standardmäßige Nachrichtennummer lautet 3051.

        • Wenn Sie Ihren eigenen Nachrichtenkatalog erstellen, geben Sie unter Nachrichtenkatalog den vollständig qualifizierten Dateinamen des Katalogs ein.

          Zudem müssen Sie unter Nachrichtennummer die entsprechende Nummer für die Nachricht in den Katalog eingeben, die in das lokale Fehlerprotokoll geschrieben werden soll. Auf einigen Systemen sind Nachrichten, die mit 00 enden, zur Verwendung durch das System reserviert. Nehmen Sie keine Nachrichten mit Zahlen wie 3100 in Ihren Nachrichtenkatalog auf.

      • Wenn der Tracesatz in das systemgenerierte Benutzertraceprotokoll geschrieben werden soll, wählen Sie Benutzertrace aus.

        Diese Sätze werden unabhängig von der Einstellung der Benutzertrace-Eigenschaft für den implementierten Nachrichtenfluss geschrieben.

        Der Benutzertrace wird in das Unterverzeichnis \log des Stammverzeichnisses geschrieben (das Standardverzeichnis unter Windows lautet beispielsweise C:\Dokumente und Einstellungen\All Users\Application Data\IBM\MQSI\common\log). Der Dateiname setzt sich aus dem Namen des Brokers, der Broker-UUID und dem Suffix userTrace.bin zusammen (z. B. broker.e51906cb-dd00-0000-0080-b10e69a5d551.userTrace.bin.0). Führen Sie, bevor Sie das Benutzertraceprotokoll anzeigen, die Befehle mqsireadlog und mqsiformatlog aus.

      • Wenn der Tracesatz in eine Datei Ihrer Wahl geschrieben werden soll, wählen Sie Datei aus.

        Wenn Sie diese Option auswählen, müssen Sie auch unter Dateipfad den vollständig qualifizierten Pfadnamen für den Trace angeben. Wenn Sie den Pfad nicht angeben, ist der Standort der Datei vom jeweiligen System abhängig. Unter z/OS wird die Datei beispielsweise im Ausgangsverzeichnis der Broker-Service-ID erstellt.

        Für die Tracedatei kann ein beliebiger Name verwendet werden, z. B. c:\user\trace\trace.log.

        Falls Sie den Namen einer noch nicht vorhandenen Datei angeben, wird die Datei automatisch erstellt. Verzeichnisse werden jedoch nicht erstellt, daher muss der vollständige Pfad bereits vorhanden sein.

        Die Datei wird als Textdatei in dem durch die Eigenschaft Muster angegebenen Format erstellt. Die Befehle mqsireadlog oder mqsiformatlog müssen Sie für die Datei nicht ausführen.

      • Wenn keine Tracesätze geschrieben werden sollen, wählen Sie Keine aus. Sie könnenTrace-Knoten auch ausschalten.
    2. Erstellen Sie unter Muster 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.
      • Sie können einfachen Text schreiben, der 1:1 in den Tracesatz kopiert wird.
      • Sie können Teile der Nachricht festlegen, die in den Tracesatz geschrieben werden sollen, indem Sie die vollständigen Feld-IDs zwischen den Zeichen ${ und } angeben. Geben Sie zur Aufzeichnung der gesamten Nachricht ${Root} an.
      • Sie können mit Hilfe der ESQL-Funktionen zusätzliche Informationen bereitstellen, z. B. mit der ESQL-Funktion CURRENT_DATE das Datum und/oder die Uhrzeit der Erstellung des Tracesatzes aufzeichnen.

      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.

Terminals und Eigenschaften

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 M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Stern, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn zu implementieren).

In der folgenden Tabelle werden die Beschreibungseigenschaften des Trace-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp 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 M C Standardwert Beschreibung
Zieladresse Ja Nein Benutzertrace Die Zieladresse des vom Knoten geschriebenen Tracesatzes. Gültige Werte sind Benutzertrace, Datei, Lokales Fehlerprotokoll und Keine.
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.
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.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac04840_