Für z/OS-Plattformen

Anforderungsprotokollierung für Liberty on z/OS aktivieren

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

  1. 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>
  2. 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   
  3. 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) {
    }

Ergebnisse

Ihr Liberty-Server protokolliert Informationen zu HTTP-Anforderungen in Datensätzen des Typs "SMF 120, Subtype 11, Version 2". Weitere Informationen darüber, wie die Ergebnisdaten zugeordnet werden, finden Sie unter Datensatzuordnung für SMF-Datensatz des Typs 120, Subtyp 11, Version 2.

Symbol das den Typ des Artikels anzeigt. Taskartikel

Dateiname: twlp_zosrequestlogging.html