Einstellungen für Protokollstufe

Verwenden Sie diesen Artikel, um die Einstellungen für Protokollstufen zu konfigurieren und zu verwalten.

Klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Fehlerbehebung > Protokolle und Trace > Servername > Detaillierungsgrad für Protokolle ändern.

Mit Protokollstufen können Sie festlegen, welche Ereignisse mit Java-Protokollen verarbeitet werden. Wenn Sie die Stufe für eine Protokollfunktion (Logger) ändern, wird die Änderung an die untergeordneten Einheiten des Logger weitergeleitet.

Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Sie können alternativ (empfohlen) den Server dahingehend konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log, trace.log und activity.log auf verteilten Systemen und Systemen mit IBM i. Sie können HPEL auch in Verbindung mit Ihren nativen z/OS-Protokollierungsfunktionen verwenden. Wenn Sie HPEL verwenden, können Sie mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.

Protokollierung und Traceerstellung für potenziell sensible Daten inaktivieren

Der Anwendungsserver hat eine Liste mit Loggern, die, sofern aktiviert, potenziell sensible Daten in das Protokoll schreiben und verfolgen. Wenn Sie z. B. bestimmte HTTP-Logger auf der Stufe FINEST aktivieren, werden möglicherweise vertrauliche benutzerdefinierte Informationen aus HTTP-Anforderungen in die Tracedateien geschrieben. Wenn der Server vermeiden soll, dass diese Protokollfunktionen auf Ebenen aktiviert werden, die bekanntermaßen für potenziell sensible Daten verwendet werden, wählen Sie das Kontrollkästchen Protokollierung und Traceerstellung für potenziell sensible Daten inaktivieren aus. Wenn der Server gestartet wird oder die Spezifikation für die Protokollstufe während der Laufzeit geändert wird, vergleicht der Server die Liste der Protokollfunktionen und Stufen, die in der Spezifikation angegeben sind, mit der Liste der Protokollfunktionen und Stufen, die für sensible Daten angegeben sind, und aktualisiert bei Bedarf die Spezifikation.

Detailstufe für Protokoll ändern

Geben Sie eine Protokollstufe ein, die die Komponenten, Pakete oder Gruppen angibt, für die ein Tracing durchgeführt werden soll. Die Protokollstufe muss mit der nachfolgend beschriebenen, spezifischen Grammatik übereinstimmen. Sie können die Protokollstufe direkt eingeben oder über die grafische Traceschnittstelle generieren.

Wenn Sie die Registerkarte Konfiguration auswählen und Komponenten und Gruppen erweitern, wird eine statische Liste bekannter Komponenten, Pakete und Gruppen angezeigt. Diese Liste ist möglicherweise nicht vollständig.

Wenn Sie die Registerkarte Laufzeit auswählen und Komponenten und Gruppen erweitern, wird die Liste der Komponenten, Pakete und Gruppen mit allen Komponenten angezeigt, die im aktiven Anwendungsserver und in der statischen Liste registriert sind.

Das Format der Spezifikation für die Protokollstufe ist wie folgt:

<Komponente> = <Stufe>

<Komponente> steht für die Komponente, für die die Protokollstufe definiert wird, und <Stufe> für einen der gültigen Werte für Protokollstufe (Aus, Schwerwiegend, Ernst, Warnung, Prüfung, Information, Konfiguration, Detail, Fein, Feiner, Am feinsten, Alle). Wenn Sie mehrere Protokollstufen angeben möchten, müssen Sie sie durch Doppelpunkte voneinander (:) trennen.

Fehler vermeiden: [Aktualisierung Juni 2013]

Die in einer Tracespezifikation angegebenen Klauseln werden in der Reihenfolge gelesen, in der sie in der Zeichenfolge erscheinen. Wenn mehrere Varianten der Klausel "*=info" in einer Tracespezifikation angegeben sind, bestimmt daher der letzte angegebene Wert die Tracestufe, die vom System protokolliert wird. Wenn Sie *=info als letzte Klausel angeben, wird das Tracing unabhängig davon, ob andere Klauseln in der Tracezeichenfolge angegeben sind, auf der Stufe "Info" ausgeführt. Beispielsweise ist die Tracezeichenfolge

*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all

äquivalent zur einfachen Angabe

*=all

Der Grund dafür ist, dass die letzte Klausel alle anderen Klauseln, die vorher in der Zeichenfolge angegeben wurden, überschreibt. [Aktualisierung Juni 2013]

gotcha

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 Produkts 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.

Es kann ein Fehler auftreten, wenn Sie bei der Angabe der Protokollstufe in der Administrationskonsole Optionen in den Listen "Gruppen" und "Komponenten" auswählen. Manchmal gehen die in einer Liste ausgewählten Einträge verloren, wenn ein Eintrag in der anderen Liste ausgewählt wird. Sie können dieses Problem umgehen, indem Sie die gewünschte Protokollstufe direkt in das Feld "Detailstufe für Protokoll" eingeben.

Wählen Sie eine Komponente oder Gruppe aus, um die Protokollstufe festzulegen. In der folgenden Tabelle sind die gültigen Stufen für Anwendungsserver in WebSphere Application Server Version 6 und höher aufgelistet.

Fehler vermeiden: Bei den Werten für die Protokollstufe muss die Groß-/Kleinschreibung beachtet werden. Die Werte beginnen mit einem Kleinbuchstaben.gotcha

Tabelle 1. Gültige Protokollstufen. In der folgenden Tabelle sind die gültigen Stufen für Anwendungsserver in WebSphere Application Server Version 6 und höher aufgelistet.
Protokollstufen der Version 6 und höher	Inhalt/Bedeutung
off	Die Protokollierung ist inaktiviert.
fatal	Task kann nicht fortgesetzt werden und die Komponente, die Anwendung und der Server sind nicht funktionsfähig.
severe	Die Task kann nicht fortgesetzt werden, aber die Komponente, die Anwendung und der Server sind weiterhin funktionsfähig. Auf dieser Stufe werden auch bevorstehende nicht behebbare Fehler angezeigt.
warning	Potenzieller oder bevorstehender Fehler. Auf dieser Stufe können auch fortschreitende Fehler (z. B. ein potenzieller Speichermangel) angezeigt werden.
audit	Wichtiges Ereignis mit Auswirkungen auf Serverstatus oder Serverressourcen
info	Allgemeine Informationen zum Gesamtfortschritt der Task
config	Konfigurationsänderung oder -status
detail	Allgemeine Informationen zum Fortschritt der Subtask
fine	Traceinformationen - allgemeiner Trace sowie Werte für Methodeneingang, Methodenausgang und Methodenrückgabe
finer	Traceinformationen - detaillierter Trace
finest	Traceinformationen. Liefert einen ausführlicheren Trace mit allen für das Debugging von Fehlern erforderlichen Details.
all	Es werden alle Ereignisse protokolliert. Wenn Sie angepasste Stufen erstellen, schließt die Einstellung "Alle" auch diese Stufen mit ein. Sie könnten damit unter Umständen einen detaillierteren Trace erhalten als mit der Stufe "Am feinsten".

Wenn Sie in Version 6.0 oder höher eine Protokollstufe aktivieren, aktivieren Sie damit auch alle darüberliegenden Stufen. Beispiel: Wenn Sie in Ihrem Anwendungsserver der Version 6.x Warnung als Protokollstufe festlegen, werden die Ereignisse der Protokollstufen Warnung, Schwerwiegend und Ernst verarbeitet.

Basismodus für die Protokollierung: Traceinformationen, d. h. Ereignisse auf den Stufen "Fein", "Feiner" und "Am feinsten", können nur in das Traceprotokoll geschrieben werden. Wenn Sie den Diagnosetrace nicht aktivieren, wirkt sich das Einstellen der Protokollstufe auf "Fein", "Feiner" oder "Am feinsten" nicht auf die protokollierten Daten aus.

Korrelation: Geben Sie die Korrelationseinstellungen an, die Sie aktivieren möchten. Wählen Sie das Kontrollkästchen Protokoll- und Tracekorrelation aktivieren aus, um die Korrelation für den Anwendungsserver zu aktivieren. Wählen Sie das Kontrollkästchen Protokoll- und Tracekorrelation aktivieren ab, um die Korrelation für den Anwendungsserver zu inaktivieren. Wählen Sie Anforderungs-IDs in Protokoll- und Tracedatensätze einschließen, Anforderungs-IDs in Protokoll-, Trace- und Korrelationsprotokollsätze einschließen oder Anforderungs-IDs in Protokoll- und Tracedatensätze einschließen, Korrelationsprotokolldatensätze erstellen und Datenmomentaufnahmen erfassen aus.
Bewährtes Verfahren: Aktivieren Sie XCT, um Anforderungs-IDs in Protokoll- und Tracedateien einzuschließen, wenn Sie anzeigen möchten, welche Protokoll- und Traceeinträge in allen Threads und Anwendungsserverprozessen sich auf dieselbe Anforderung beziehen. Anforderungs-IDs werden nur bei Verwendung des HPEL-Trace- und Protokollmodus erfasst und können mit dem Befehl "logViewer" angezeigt oder zur Filterung verwendet werden. bprac

Bewährtes Verfahren: Aktivieren Sie XCT, um Korrelationsprotokolldatensätze zu erstellen, wenn Sie die Anforderungsverzweigungen zwischen Threads und Prozessen protokollieren und zusätzliche Informationen zu jeder Anforderung anzeigen möchten. Die Aktivierung von XCT zur Erstellung von Korrelationsprotokolldatensätzen kann einen erheblichen Einfluss auf die Systemleistung zur Folge haben, daher sollte diese Option am besten für Test- und Entwicklungsumgebungen verwendet werden. bprac

Bewährtes Verfahren: Aktivieren Sie XCT, um Datenaufnahmen zu erfassen, wenn Sie Anforderungs- und Antwortteile in ihrer Gesamtheit im Dateisystem speichern möchten. Die Aktivierung von XCT zur Erfassung von Datenmomentaufnahmen kann einen erheblichen Einfluss auf die Systemleistung zur Folge haben, daher sollte diese Option am besten für Test- und Entwicklungsumgebungen verwendet werden. XCT erfasst Datenmomentaufnahmen für Nachrichtenanforderungen und -antworten, die vom SIBus verarbeitet werden.bprac

Fehler vermeiden: Datenmomentaufnahmen werden erfasst und in das Verzeichnis $SERVER_LOG_ROOT/snapdata geschrieben. Der Anwendungsserver entfernt Dateien, die sich in diesem Verzeichnis befinden, nicht automatisch. Wenn die Erfassung von Datenmomentaufnahmen aktiviert ist, müssen Sie die Dateien in regelmäßigen Abständen aus diesem Verzeichnis löschen. Datenmomentaufnahmen speichern den gesamten Inhalt von Anforderungen und Antworten und können sensible Daten enthalten. Daher ist die Verwendung dieser Option in Produktionsumgebungen möglicherweise nicht angebracht. gotcha

Laufzeitänderungen auch in der Konfiguration speichern: Gibt an, dass Änderungen am dynamischen Status des aktiven Servers und an der Serverkonfiguration vorgenommen werden, die beim nächsten Neustart wirksam werden. Wenn dieses Kontrollkästchen nicht ausgewählt ist, kopiert der Server die Einstellungen nicht in die Serverkonfiguration.

Dateiname: utrb_loglevel.html