Benutzertrace

Der Benutzertrace ist eine von zwei optionalen Tracefunktionen, die in WebSphere Message Broker verfügbar sind. Der Benutzertrace ist standardmäßig inaktiviert und muss durch einen Befehl oder durch die Workbench explizit aktiviert werden, wenn Sie zusätzlich zu den Einträgen im Ereignisprotokoll weitere Informationen benötigen. Weitere Informationen zu Protokollen finden Sie unter Protokolle.

Der Benutzertrace wird normalerweise zur Fehlerbehebung Ihrer Anwendungen verwendet. Es kann auch ein Trace für Broker, Ausführungsgruppen und implementierte Nachrichtenflüsse durchgeführt werden.

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.

Beim Aktivieren der Benutzertracefunktion wird eine zusätzliche Verarbeitung aller Aktivitäten in der Komponente ausgelöst, für die Sie den Trace durchführen. Die Komponenten generieren große Datenmengen. Die Durchführung der Benutzertracefunktion wirkt sich auf die Systemleistung aus. Diese zusätzliche Verarbeitung können Sie einschränken, indem Sie genau auswählen, wofür Sie einen Trace durchführen, und den Zeitraum begrenzen, in dem die Tracefunktion 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 Traceprotokolle befinden sich an folgender Position:
Windows
Wenn Sie den Arbeitspfad mit Hilfe des Parameters-w des Befehls mqsicreatebroker festlegen, befinden sich die Protokolle unter workpath\log. Wenn Sie den Brokerpfad nicht angegeben haben, befinden sich die Protokolle unter C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\IBM\MQSI\common\log.
UNIX
/var/mqsi/common/log
z/OS
/component_filesystem/log

Die Dateinamen geben die Komponente und Unterkomponente an, für die der Trace durchgeführt wird. Beispiel: Der Brokername und die eindeutige ID der Ausführungsgruppe bilden einen Teil des Dateinamens, wenn Sie in dieser Ausführungsgruppe aktiv einen Trace durchführen.

Wenn Sie beispielsweise einen Broker mit der Bezeichnung WBRK_BROKER erstellt haben, werden im Unterverzeichnis des Protokolls möglicherweise die folgenden Dateien angezeigt:
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 angegeben, dass die Ausgabe in einer Datei erfolgt. Diese Datei ist plattformunabhängig und kann mit dem Befehl mqsiformatlog auf andere Systeme übertragen und dort angezeigt bzw. formatiert werden.

Traceknoten verwenden

Wenn Sie beim Entwickeln und Testen Ihrer Nachrichtenflüsse einen Traceknoten einfügen, können Sie mit dieser Option nicht nur einen Trace für Nachrichten und Aktivitäten im Fluss durchführen, sondern zusätzlich eine alternative Zieldatei für die Inhalte des Trace angeben, um die von Ihnen gewünschten Informationen einzugrenzen. Ausführliche Informationen zur Verwendung und Konfiguration von Traceknoten finden Sie im Abschnitt Traceknoten.

Zugehörige Konzepte
Protokolle
Trace
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
an01310_