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
.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 der Protokollfunktion weitergeleitet.
- Protokollierung und Traceerstellung für potenziell sensible Daten inaktivieren
- Der Anwendungsserver hat eine Liste mit Protokollfunktionen, die, sofern aktiviert, potenziell sensible Daten in das Protokoll schreiben und verfolgen. Wenn Sie z. B. bestimmte HTTP-Protokollfunktionen 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 sensibler 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: 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
äquivalent zur einfachen Angabe*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all
Der Grund dafür ist, dass die letzte Klausel alle anderen Klauseln, die vorher in der Zeichenfolge angegeben wurden, überschreibt. gotcha*=all
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.

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". |
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 Implementierungsumgebungen 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.