WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Benutzertrace

Der Benutzertrace gehört zu den beiden Arten in WebSphere Message Broker verfügbarer optionaler Tracefunktionen und bietet Informationen, die über die Einträge im Administrationsprotokoll hinausgehen. Standardmäßig ist der Benutzertrace inaktiv, er muss explizit über einen Befehl oder über Optionen in der WebSphere Message Broker Toolkit aktiviert werden.

Weitere Informationen zu Protokollen finden Sie unter Protokolle.

In der Regel wird der Benutzertrace für das Debugging der Anwendungen verwendet, da damit ein Trace für Broker, Ausführungsgruppen und implementierte Nachrichtenflüsse durchgeführt werden kann.

Sie können mit der WebSphere Message Broker Toolkit die meisten Traceaktivitäten kontrollieren, die Sie benötigen. Mit der WebSphere Message Broker Toolkit können Sie außerdem die Tracefunktion auf fernen Systemen starten und stoppen.

Durch Aktivierung des Benutzertrace wird für jede Aktivität in der verfolgten Komponente zusätzliche Verarbeitung verursacht. Es werden große Datenmengen von den Komponenten generiert. Die Durchführung der Benutzertracefunktion beeinträchtigt die Systemleistung. Sie können diese zusätzliche Verarbeitung beschränken, indem Sie genau auswählen, was verfolgt werden soll, und die Zeit einschränken, während der die Verfolgung aktiv ist.

Die Benutzertraceprotokolldateien

Wenn für eine beliebige Komponente eine Tracefunktion aktiv ist, werden die Informationen in einem binären Format aufgezeichnet.

Die Speicherposition der Traceprotokolle ist von der Umgebung abhängig:
Windows platformWindows
Wenn Sie den Arbeitspfad mithilfe des Parameters -w im Befehl mqsicreatebroker festlegen, lautet die Speicherposition workpath\log.
Wenn Sie den Brokerarbeitspfad nicht angegeben haben, lautet die Standardposition %ALLUSERSPROFILE%\IBM\MQSI\common\log. Dabei ist %ALLUSERSPROFILE% die Umgebungsvariable zur Definition des Systemarbeitsverzeichnisses. Das Standardverzeichnis ist vom Betriebssystem abhängig.
  • Unter Windows XP and Windows Server 2003: C:\Dokumente und Einstellungen\All Users\IBM\MQSI\common\log
  • Unter Windows Vista und Windows Server 2008: C:\ProgramData\IBM\MQSI\common\log
Da auf Ihrem Computer möglicherweise nicht das Standardverzeichnis verwendet wird, sollten Sie %ALLUSERSPROFILE% angeben, um sicherzustellen, dass Sie auf das korrekte Verzeichnis zugreifen.
Linux platformUNIX platformLinux und UNIX
/var/mqsi/common/log
z/OS platformz/OS
/component_filesystem/log

Die Dateinamen stehen für die Komponente und Unterkomponente, für welche die Trace aktiv ist. Beispiel: Der Brokername und die eindeutige Ausführungsgruppenkennung bilden einen Teil des Dateinamens, wenn Sie Aktivitäten in der Ausführungsgruppe verfolgen.

Wenn Sie beispielsweise einen Broker mit der Bezeichnung MB8BROKER erstellt haben, sind möglicherweise die folgenden Dateien im Unterverzeichnis des Protokolls zu sehen:
MB8BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.1
MB8BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.2

Diese Dateien können nicht direkt angezeigt werden; Sie müssen zur Anzeige die Befehle verwenden, die für den Zugriff auf die Trace-Informationen und die Konvertierung in ein für die Anzeige geeignetes Format bereitgestellt wurden. Mit dem Befehl mqsireadlog wird das Traceprotokoll für die angegebene Komponente abgerufen. Setzen Sie den Befehl auf dem Rechner ab, auf dem das Protokoll generiert wurde. Sie können angeben, dass die Ausgabe in einer Datei erfolgen soll, die betriebssystemunabhängig ist und über den Befehl mqsiformatlog zur Anzeige oder Formatierung auf andere Systeme übertragen werden kann.

Verwendung eines Trace-Knotens

Wenn Sie bei der Entwicklung und dem Test Ihrer Nachrichtenflüsse einen Trace-Knoten in die Flüsse einfügen, haben Sie damit nicht nur die Möglichkeit, einen Trace für Nachrichten und Aktivitäten im Fluss durchzuführen, sondern können auch eine alternative Zieldatei für die Traceinhalte angeben, um die gewünschten Informationen einzugrenzen. Ausführliche Informationen zur Verwendung und Konfiguration eines Trace-Knotens finden Sie im Abschnitt Trace-Knoten.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:40


ReferenzthemaReferenzthema | Version 8.0.0.5 | an01310_