Benutzertrace

Der Benutzertrace gehört zu den beiden Arten in WebSphere Message Broker verfügbarer optionaler Tracefunktionen. Standardmäßig ist der Benutzertrace inaktiv, er muss explizit über einen Befehl oder über Optionen in der Workbench aktiviert werden, wenn Sie über die Einträge im Ereignisprotokoll hinausgehende Informationen benötigen.

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.

Für die Steuerung der meisten der von Ihnen benötigten Aktivitäten können Sie die Workbench verwenden. Durch die Workbench wird auch das Starten und Stoppen der Tracefunktion auf fernen Systemen aktiviert.

Durch Aktivierung des Benutzertrace wird für jede Aktivität in der verfolgten Komponente zusätzliche Verarbeitung verursacht. Die Komponenten generieren große Datenmengen. Die Durchführung der Benutzertracefunktion wirkt sich auf die Systemleistung aus. 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.

Protokolldateien des Benutzertrace

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 platform Windows
Wenn Sie den Arbeitspfad mithilfe des Parameters -w im Befehl mqsicreatebroker festlegen, lautet die Speicherposition workpath\log.
Wenn Sie den Brokerarbeitspfad nicht angegeben haben, wird standardmäßig die Speicherposition %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\log verwendet, wobei die Standardeinstellung für die Umgebungsvariable '%ALLUSERSPROFILE%' C:\Dokumente und Einstellungen\All Users lautet. Möglicherweise weicht der tatsächliche Wert auf Ihrem Computer von diesen Angaben ab.
Linux platformUNIX platform Linux und UNIX
/var/mqsi/common/log
z/OS platform z/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 WBRK_BROKER erstellt haben, sind möglicherweise die folgenden Dateien im Unterverzeichnis des Protokolls zu sehen:
WBRK_BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.1
WBRK_BROKER.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 Traceknotens

Wenn Sie bei der Entwicklung und dem Test Ihrer Nachrichtenflüsse einen Traceknoten 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 Traceknotens finden Sie im Abschnitt Trace-Knoten.

Zugehörige Konzepte
Protokolle
Trace
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:34

an01310_