Das z/OS-Anforderungsprotokollierungsfeature zosRequestLogging-1.0 stellt Informationen zu HTTP-Anforderungen zusammen und zeichnet die Informationen im z/OS-SMF-Datenspeicher auf. Wenn das z/OS-Anforderungsprotokollierungsfeature aktiviert und RACF ordnungsgemäß konfiguriert ist, werden Datensätze des Typs "SMF Type 120 Subtype 11 Version 2" generiert. Es werden keine Daten für Teile der Anforderung erfasst, die asynchron erstellt werden.
Vorgehensweise
- Aktivieren Sie die Anforderungsprotokollierung, indem Sie das Feature zosRequestLogging-1.0 im Element featureManager der Konfigurationsdatei server.xml hinzufügen.
<feature>zosRequestLogging-1.0</feature>
- Konfigurieren Sie RACF, um die SMF-Datensätze zu schreiben, indem Sie die folgenden Befehle absetzen:
RDEFINE FACILITY BPX.SMF UACC(NONE)
PERMIT BPX.SMF ID(MSTONE1) ACCESS(READ) CLASS(FACILITY)
SETROPTS GENERIC(FACILITY) REFRESH
SETROPTS RACLIST(FACILITY) REFRESH
- Optional: Fügen Sie den SMF-Datensätzen Benutzerdaten hinzu, indem Sie die API UserData in Ihren Servlets implementieren.
Ein Servlet kann die Methode UserData add verwenden, um eigene anforderungsspezifische Daten dem Datensatz des Typs "SMF 120, Subtype 11, Version 2" hinzuzufügen, der für die HTTP-Anforderung geschrieben wird. Die UserData-Schnittstelle befindet sich im Paket com.ibm.websphere.zos.request.logging.
Das folgende Beispiel veranschaulicht, wie ein Servlet dem SMF-Datensatz eigene anforderungsspezifische Daten hinzufügen kann:
InitialContext ic = new InitialContext();
try {
UserData userData = (UserData) ic.lookup("com/ibm/websphere/zos/request/logging/UserData");
int rc = userData.add(65535,"My request-specific data");
} catch (NamingException e) {
}