Tracing und Protokollierung für Features in Liberty konfigurieren
Sie können die Tracing- und Protokollierungsmechanismen von Liberty für Liberty-Features verwenden. Der Protokollierungsservice wird vom Liberty-Kernel bereitgestellt, daher müssen Sie kein Feature in der Datei server.xml angeben, um ihn nutzen zu können.
Informationen zu diesem Vorgang
Liberty bietet die folgenden SPIs, mit dem Sie das Tracing und die Protokollierung in Ihrem angepassten Feature-Code integrieren können:
- com.ibm.websphere.ras
- Das Paket com.ibm.websphere.ras stellt Klassen zu Protokollnachrichten und Tracedatensätzen sowie zu einigen Erweiterungspunkten bereit. Im Allgemeinen kann Feature-Code das Paket java.util.logging verwenden, um Trace und Nachrichten zu protokollieren und die Ausgabe über die Konfiguration der Liberty-Protokollierung zu steuern, aber die erweiterte Funktionalität des WebSphere-Pakets ist manchmal nützlich, und die Tracewächter sind ein wenig effizienter, wenn der Trace inaktiviert wird.
- com.ibm.websphere.ras.annotations
- Das Paket com.ibm.websphere.ras.annotations enthält Annotationen für die Verwendung mit Klassen in den anderen Paketen. Beispielsweise kann eine @Sensitive-Annotation verwendet werden, um zu verhindern, dass der Inhalt der annotierten Variablen in Trace- oder Nachrichtenausgabe erscheint.
- com.ibm.ws.ffdc
- Das Paket com.ibm.ws.ffdc Paket stellt Funktionen zum Schreiben von FFDC-Datensätzen (First-Failure Data Capture, Erfassung von Fehlerdaten beim ersten Auftreten) bereit, mit denen Fehler im Zusammenhang mit nicht erwarteten Ausnahmebedingungen behoben werden können.
- com.ibm.wsspi.logging
- Das Paket com.ibm.wsspi.logging stellt Abfangpunkte von Protokoll- und FFDC-Datensätzen bereit.
Die Java™-SPI-Dokumentation für die einzelnen Liberty-APIs ist als eigenständige .zip-Datei in einem der Javadoc-Unterverzeichnisse des Verzeichnisses ${wlp.install.dir}/dev verfügbar.
Vorgehensweise
Im Folgenden wird beschrieben, wie ein Liberty-Beispielfeature mit dem Namen myfeature so konfiguriert wird, dass die Liberty-Tracing- und -Protokollierungsmechanismen verwendet werden.