Tracing und Protokollierung für Features im Liberty-Profil konfigurieren
Sie können die Tracing- und Protokollierungsmechanismen des Liberty-Profils 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
Das Liberty-Profil 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™-API-Dokumentation für die einzelnen Liberty Profile-SPIs wird detailliert im Abschnitt Programmierschnittstellen (APIs) des Information Center beschrieben und ist außerdem als eigenständige .zip-Datei in einem der Javadoc-Unterverzeichnisse des Verzeichnisses ${wlp.install.dir}/dev verfügbar.
Vorgehensweise
Im Folgenden wird beschrieben, wie das Liberty-Beispielfeature myfeature konfiguriert wird, die Tracing- und Protokollierungsmechanismen des Liberty-Profils zu verwenden: