Einstellungen des Diagnostic Trace Service

Auf dieser Seite können Sie die Merkmale des Diagnose-Trace-Service überprüfen und ändern.

Klicken Sie zum Anzeigen dieser Seite auf Fehlerbehebung > Protokolle und Trace > Server > Diagnose-Trace.

Register "Konfiguration"

Trace aktivieren
Aktiviert den Trace-Service.

Wenn diese Option nicht ausgewählt ist, werden die folgenden Konfigurationsmerkmale beim Start des Servers nicht an den Trace-Service des Anwendungsservers übergeben.

Trace-Spezifikation
Gibt Details zum Tracing an.

Geben Sie eine Trace-Zeichenfolge ein, die die Komponenten, Pakete oder Gruppen angibt, für die ein Tracing durchgeführt werden soll. Die Trace-Zeichenfolge muss mit der nachfolgend beschriebenen, spezifischen Grammatik übereinstimmen. Sie können die Trace-Zeichenfolge direkt eingeben oder über das grafische Trace-Interface generieren. Klicken Sie auf Ändern, um das grafische Trace-Interface zu starten.

Wenn Sie das grafische Trace-Interface über das Register "Konfiguration" starten, wird eine Liste bekannter Komponenten, Pakete und Gruppen angezeigt. Diese Liste ist möglicherweise nicht vollständig.

Wenn Sie das grafische Trace-Interface über das Register "Laufzeit" starten, werden in der Liste der Komponenten, Pakete und Gruppen alle Komponenten angezeigt, die gegenwärtig auf dem aktiven Server registriert sind.

Das Format der Tracing-Spezifikation lautet wie folgt:

<Komponente> = <Trace-Typ>= enabled | disabled
Dabei gilt: <Komponente> ist die Komponente, für die das Tracing aktiviert oder inaktiviert wird, und <Trace-Typ> ist der Typ des Tracing, der aktiviert oder inaktiviert werden soll.Mehrere Tracing-Spezifikationen werden mit Doppelpunkten (:) voneinander getrennt.

Komponenten entsprechen Java-Paketen und -Klassen bzw. Gruppen von Java-Paketen. Verwenden Sie einen Stern (*), um Komponenten anzuzeigen, die alle Klassen der in der angegebenen Komponente enthaltenen Pakete umfassen. Beispiel:

*
Gibt den gesamten Code an, der auf dem Anwendungsserver einschließlich des Systemcodes des WebSphere Application Server und des Benutzercodes ausgeführt wird und für den ein Tracing durchgeführt werden soll.
com.ibm.ws.*
Gibt alle Klassen an, deren Paketname mit com.ibm.ws beginnt.
com.ibm.ws.classloader.JarClassLoader
Gibt nur die JarClassLoader-Klasse an.

Weitere Informationen zur Grammatik von Trace-Zeichenfolgen enthält der Abschnitt Trace aktivieren im InfoCenter des WebSphere Application Server.

Anmerkung: Es kann ein Fehler auftreten, wenn Sie eine Trace-Spezifikation in der Administrationskonsole definieren und sowohl in der Liste "Gruppen" als auch in der Liste "Komponenten" Einträge ausgewählt wurden. Manchmal gehen die in einer Liste ausgewählten Einträge nicht verloren, wenn ein Eintrag in der anderen Liste ausgewählt wird. Um dieses Problem zu umgehen, geben Sie die gewünschte Trace-Spezifikation direkt in das Feld "Trace-Spezifikation" ein.

Trace-Ausgabe  
Gibt an, in welche Datei die Trace-Ausgabe geschrieben werden soll.

Die Trace-Ausgabe kann direkt in eine Ausgabedatei geschrieben oder in einen Speicher gestellt und auf Anforderung über die Option "Speicherauszug" auf der Seite "Laufzeit" in eine Datei geschrieben werden.

Speicherpuffer
Gibt an, dass die Trace-Ausgabe in einen Ringpuffer im Speicher geschrieben werden soll. Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:
Maximale Puffergröße
Gibt die Anzahl der Einträge, die im Puffer zwischengespeichert werden können, an (in Tausend). Wenn dieser Wert überschritten wird, werden alte Werte von neuen Werten überschrieben.
Name der Speicherauszugsdatei
Der Name der Datei, in die der Speicherpuffer bei Erstellung eines Speicherauszugs geschrieben wird. Diese Option ist nur über das Register "Laufzeit" verfügbar.

Datei
Gibt an, dass die Trace-Ausgabe in eine selbstverwaltete Protokolldatei geschrieben werden soll.

Es werden Nachrichten in die selbstverwaltete Protokolldatei geschrieben, bis ein Größenkriterium erreicht ist. Wenn die Datei die angegebene Größe erreicht, wird die Protokollierung vorübergehend ausgesetzt, und die Protokolldatei wird geschlossen und umbenannt. Der neue Name basiert auf dem ursprünglichen Namen der Datei und beinhaltet zusätzlich eine Zeitmarke, die angibt, wann die Umbenennung erfolgt ist. Nach der Umbenennung wird eine neue, leere Protokolldatei mit dem ursprünglichen Namen erneut geöffnet, und die Protokollierung wird wieder aufgenommen. Die Fortführung der Datei führt nicht dazu, dass Nachrichten verloren gehen, allerdings besteht die Möglichkeit, dass eine einzelne Nachricht in zwei Dateien aufgeteilt wird.

Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:

Maximale Dateigröße
Gibt die maximale Größe in MB an, die die Ausgabedatei erreichen darf.

Dieses Attribut ist nur gültig, wenn das Attribut "Dateigröße" ausgewählt wurde. Wenn die Datei diese Größe erreicht, wird sie wie oben beschrieben fortgeführt.

Maximale Anzahl der Protokolldateien
Gibt die Maximalanzahl der fortgeführten Dateien an, die gespeichert werden können.
Dateiname
Gibt den Namen der Datei an, in die die Trace-Ausgabe geschrieben wird.

Format der Trace-Ausgabe  
Gibt das Format der Trace-Ausgabe an.

Sie können eine der folgenden drei Stufen für die Trace-Ausgabe angeben:

Basis (kompatibel)
Es werden nur grundlegende Trace-Informationen gespeichert. Wählen Sie diese Option aus, um den Speicherplatz für die Trace-Ausgabe zu verringern.
Erweitert
Es werden spezifischere Trace-Informationen gespeichert. Wählen Sie diese Option aus, wenn Sie detaillierte Trace-Informationen für die Fehlerbestimmung und -behebung anzeigen möchten.
Protokollanalyse
Es werden Trace-Informationen in einem Format gespeichert, das mit dem Protokollanalyse-Tool kompatibel ist. Wählen Sie diese Option aus, um die Trace-Ausgabe als Eingabe für das Tool Protokollanalyse verwenden möchten.

Register "Laufzeit"  
Gibt das Format der Trace-Ausgabe an.
Trace speichern
Speichert Änderungen, die unter dem Register "Laufzeit" vorgenommen wurden, auch in der Trace-Konfiguration.

Aktivieren Sie dieses Markierungsfeld, um Änderungen des Laufzeit-Trace auch in die Trace-Konfiguration zu kopieren. Wenn Sie diese Änderungen in der Trace-Konfiguration speichern, bleiben sie auch nach einem Neustart der Anwendung weiterhin wirksam.

Trace-Spezifikation
Gibt Details zum Tracing an.

Geben Sie eine Trace-Zeichenfolge ein, die die Komponenten, Pakete oder Gruppen angibt, für die ein Tracing durchgeführt werden soll. Die Trace-Zeichenfolge muss mit der nachfolgend beschriebenen, spezifischen Grammatik übereinstimmen. Sie können die Trace-Zeichenfolge direkt eingeben oder über das grafische Trace-Interface generieren. Klicken Sie auf Ändern, um das grafische Trace-Interface zu starten.

Wenn Sie das grafische Trace-Interface über das Register "Konfiguration" starten, wird eine Liste bekannter Komponenten, Pakete und Gruppen angezeigt. Diese Liste ist möglicherweise nicht vollständig.

Das Format der Tracing-Spezifikation lautet wie folgt:

<Komponente> = <Trace-Typ> = enabled | disabled

Dabei gilt: <Komponente> ist die Komponente, für die das Tracing aktiviert oder inaktiviert wird, und <Trace-Typ> ist der Typ des Tracing, der aktiviert oder inaktiviert werden soll. Mehrere Tracing-Spezifikationen werden mit Doppelpunkten (:) voneinander getrennt.

Komponenten entsprechen Java-Paketen und -Klassen bzw. Gruppen von Java-Paketen. Verwenden Sie einen Stern (*), um Komponenten anzuzeigen, die alle Klassen der in der angegebenen Komponente enthaltenen Pakete umfassen. Beispiel:

*
Gibt den gesamten Code an, der auf dem Anwendungsserver einschließlich des Systemcodes des WebSphere Application Server und des Benutzercodes ausgeführt wird und für den ein Tracing durchgeführt werden soll.
com.ibm.ws.*
Gibt alle Klassen an, deren Paketname mit com.ibm.ws beginnt.
com.ibm.ws.classloader.JarClassLoader
Gibt nur die JarClassLoader-Klasse an.

Weitere Informationen zur Grammatik von Trace-Zeichenfolgen enthält der Abschnitt "Trace aktivieren" im InfoCenter des WebSphere Application Server.

Anmerkung: Es kann ein Fehler auftreten, wenn Sie eine Trace-Spezifikation in der Administrationskonsole definieren und sowohl in der Liste "Gruppen" als auch in der Liste "Komponenten" Einträge ausgewählt wurden. Manchmal gehen die in einer Liste ausgewählten Einträge nicht verloren, wenn ein Eintrag in der anderen Liste ausgewählt wird. Um dieses Problem zu umgehen, geben Sie die gewünschte Trace-Spezifikation direkt in das Feld "Trace-Spezifikation" ein.

Trace-Ausgabe  
Gibt an, in welche Datei die Trace-Ausgabe geschrieben werden soll.

Gibt an, in welche Datei die Trace-Ausgabe geschrieben werden soll.

Die Trace-Ausgabe kann direkt in eine Ausgabedatei geschrieben oder in einen Speicher gestellt und auf Anforderung über die Option "Speicherauszug" auf der Seite "Laufzeit" in eine Datei geschrieben werden.

Speicherpuffer
Gibt an, dass die Trace-Ausgabe in einen Ringpuffer im Speicher geschrieben werden soll. Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:
Maximale Puffergröße
Gibt die Anzahl der Einträge, die im Puffer zwischengespeichert werden können, an (in Tausend). Wenn dieser Wert überschritten wird, werden alte Werte von neuen Werten überschrieben.
Name der Speicherauszugsdatei
Der Name der Datei, in die der Speicherpuffer bei Erstellung eines Speicherauszugs geschrieben wird. Diese Option ist nur über das Register "Laufzeit" verfügbar.
Datei
Gibt an, dass die Trace-Ausgabe in eine selbstverwaltete Protokolldatei geschrieben werden soll.

Es werden Nachrichten in die selbstverwaltete Protokolldatei geschrieben, bis ein Größenkriterium erreicht ist. Wenn die Datei die angegebene Größe erreicht, wird die Protokollierung vorübergehend ausgesetzt, und die Protokolldatei wird geschlossen und umbenannt. Der neue Name basiert auf dem ursprünglichen Namen der Datei und beinhaltet zusätzlich eine Zeitmarke, die angibt, wann die Umbenennung erfolgt ist. Nach der Umbenennung wird eine neue, leere Protokolldatei mit dem ursprünglichen Namen erneut geöffnet, und die Protokollierung wird wieder aufgenommen. Die Fortführung der Datei führt nicht dazu, dass Nachrichten verloren gehen, allerdings besteht die Möglichkeit, dass eine einzelne Nachricht in zwei Dateien aufgeteilt wird.

Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:

Maximale Dateigröße
Gibt die maximale Größe in MB an, die die Ausgabedatei erreichen darf.

Dieses Attribut ist nur gültig, wenn das Attribut "Dateigröße" ausgewählt wurde. Wenn die Datei diese Größe erreicht, wird sie wie oben beschrieben fortgeführt.

Maximale Anzahl der Protokolldateien
Gibt die Maximalanzahl der fortgeführten Dateien an, die gespeichert werden können.
Dateiname
Gibt den Namen der Datei an, in die die Trace-Ausgabe geschrieben wird.

Register "Laufzeit"

Trace speichern
Speichert Änderungen, die unter dem Register "Laufzeit" vorgenommen wurden, auch in der Trace-Konfiguration.

Aktivieren Sie dieses Markierungsfeld, um Änderungen des Laufzeit-Trace auch in die Trace-Konfiguration zu kopieren. Wenn Sie diese Änderungen in der Trace-Konfiguration speichern, bleiben sie auch nach einem Neustart der Anwendung weiterhin wirksam.

Trace-Spezifikation
Gibt Details zum Tracing an.

Geben Sie eine Trace-Zeichenfolge ein, die die Komponenten, Pakete oder Gruppen angibt, für die ein Tracing durchgeführt werden soll. Die Trace-Zeichenfolge muss mit der nachfolgend beschriebenen, spezifischen Grammatik übereinstimmen. Sie können die Trace-Zeichenfolge direkt eingeben oder über das grafische Trace-Interface generieren. Klicken Sie auf Ändern, um das grafische Trace-Interface zu starten.

Wenn Sie das grafische Trace-Interface über das Register "Konfiguration" starten, wird eine Liste bekannter Komponenten, Pakete und Gruppen angezeigt. Diese Liste ist möglicherweise nicht vollständig.

Wenn Sie das grafische Trace-Interface über das Register "Laufzeit" starten, werden in der Liste der Komponenten, Pakete und Gruppen alle Komponenten angezeigt, die gegenwärtig auf dem aktiven Server registriert sind.

Das Format der Tracing-Spezifikation lautet wie folgt:

<Komponente> = <Trace-Typ>= enabled | disabled
Dabei gilt: <Komponente> ist die Komponente, für die das Tracing aktiviert oder inaktiviert wird, und <Trace-Typ> ist der Typ des Tracing, der aktiviert oder inaktiviert werden soll.Mehrere Tracing-Spezifikationen werden mit Doppelpunkten (:) voneinander getrennt.

Komponenten entsprechen Java-Paketen und -Klassen bzw. Gruppen von Java-Paketen. Verwenden Sie einen Stern (*), um Komponenten anzuzeigen, die alle Klassen der in der angegebenen Komponente enthaltenen Pakete umfassen. Beispiel:

*
Gibt den gesamten Code an, der auf dem Anwendungsserver einschließlich des Systemcodes des WebSphere Application Server und des Benutzercodes ausgeführt wird und für den ein Tracing durchgeführt werden soll.
com.ibm.ws.*
Gibt alle Klassen an, deren Paketname mit com.ibm.ws beginnt.
com.ibm.ws.classloader.JarClassLoader
Gibt nur die JarClassLoader-Klasse an.

Weitere Informationen zur Grammatik von Trace-Zeichenfolgen enthält der Abschnitt Trace aktivieren im InfoCenter des WebSphere Application Server.

Anmerkung: Es kann ein Fehler auftreten, wenn Sie eine Trace-Spezifikation in der Administrationskonsole definieren und sowohl in der Liste "Gruppen" als auch in der Liste "Komponenten" Einträge ausgewählt wurden. Manchmal gehen die in einer Liste ausgewählten Einträge nicht verloren, wenn ein Eintrag in der anderen Liste ausgewählt wird. Um dieses Problem zu umgehen, geben Sie die gewünschte Trace-Spezifikation direkt in das Feld "Trace-Spezifikation" ein.

Trace-Ausgabe  
Gibt an, in welche Datei die Trace-Ausgabe geschrieben werden soll.

Die Trace-Ausgabe kann direkt in eine Ausgabedatei geschrieben oder in einen Speicher gestellt und auf Anforderung über die Option "Speicherauszug" auf der Seite "Laufzeit" in eine Datei geschrieben werden.

Speicherpuffer
Gibt an, dass die Trace-Ausgabe in einen Ringpuffer im Speicher geschrieben werden soll. Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:
Maximale Puffergröße
Gibt die Anzahl der Einträge, die im Puffer zwischengespeichert werden können, an (in Tausend). Wenn dieser Wert überschritten wird, werden alte Werte von neuen Werten überschrieben.
Name der Speicherauszugsdatei
Der Name der Datei, in die der Speicherpuffer bei Erstellung eines Speicherauszugs geschrieben wird. Diese Option ist nur über das Register "Laufzeit" verfügbar.

Datei
Gibt an, dass die Trace-Ausgabe in eine selbstverwaltete Protokolldatei geschrieben werden soll.

Es werden Nachrichten in die selbstverwaltete Protokolldatei geschrieben, bis ein Größenkriterium erreicht ist. Wenn die Datei die angegebene Größe erreicht, wird die Protokollierung vorübergehend ausgesetzt, und die Protokolldatei wird geschlossen und umbenannt. Der neue Name basiert auf dem ursprünglichen Namen der Datei und beinhaltet zusätzlich eine Zeitmarke, die angibt, wann die Umbenennung erfolgt ist. Nach der Umbenennung wird eine neue, leere Protokolldatei mit dem ursprünglichen Namen erneut geöffnet, und die Protokollierung wird wieder aufgenommen. Die Fortführung der Datei führt nicht dazu, dass Nachrichten verloren gehen, allerdings besteht die Möglichkeit, dass eine einzelne Nachricht in zwei Dateien aufgeteilt wird.

Bei Auswahl dieser Option müssen Sie die folgenden Parameter angeben:

Maximale Dateigröße
Gibt die maximale Größe in MB an, die die Ausgabedatei erreichen darf.

Dieses Attribut ist nur gültig, wenn das Attribut "Dateigröße" ausgewählt wurde. Wenn die Datei diese Größe erreicht, wird sie wie oben beschrieben fortgeführt.

Maximale Anzahl der Protokolldateien
Gibt die Maximalanzahl der fortgeführten Dateien an, die gespeichert werden können.
Dateiname
Gibt den Namen der Datei an, in die die Trace-Ausgabe geschrieben wird.

Zugehörige Informationen

Knöpfe in der Adminstrationskonsole
Geltungsbereichseinstellungen für die Administrationskonsole
Filtereinstellungen für die Administrationskonsole
Vorgaben für die Administrationskonsole
Funktionen auf den Seiten der Administrationskonsole