Activer la journalisation des demandes pour Liberty sur z/OS

La fonction de journalisation des demandes (Request Logging) z/OS, zosRequestLogging-1.0, collecte des informations sur les demandes HTTP et les enregistre dans le magasin de données SMF de z/OS. Lorsque la fonction z/OS Request Logging est activée et que RACF est configuré correctement, des enregistrements SMF type 120, sous-type 11, version 2 sont générés. Aucune donnée n'est capturée pour les parties de la demande qui sont créées de manière asynchrone.

Procédure

  1. Activez la journalisation des demandes en ajoutant la fonction zosRequestLogging-1.0 à l'élément featureManager du fichier de configuration server.xml.
    <feature>zosRequestLogging-1.0</feature>
  2. Configurez RACF pour qu'il écrive les enregistrements SMF en émettant les commandes suivantes :
    RDEFINE FACILITY BPX.SMF UACC(NONE)                      
    PERMIT BPX.SMF ID(MSTONE1) ACCESS(READ) CLASS(FACILITY)  
    SETROPTS GENERIC(FACILITY) REFRESH                       
    SETROPTS RACLIST(FACILITY) REFRESH 
  3. Facultatif : Ajoutez des données utilisateur aux enregistrements SMF en implémentant l'API UserData dans vos servlets.

    Un servlet peut utiliser la méthode add de UserData pour ajouter des données spécifiques à sa propre demande à l'enregistrement SMF 120, sous-type 11, version 2 qui est écrit pour la demande HTTP. L'interface UserData est dans le package com.ibm.websphere.zos.request.logging.

    L'exemple suivant montre comment un servlet peut ajouter des données spécifiques à sa demande dans l'enregistrement SMF :
    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) {
    }

Résultats

Votre serveur Liberty consignera les informations relatives aux demandes HTTP dans des enregistrements SMF 120, sous-type 11, version. Pour des informations sur la manière dont les données résultantes sont mappées, consultez Mappage d'enregistrement de type SMF 120, sous-type 11, version 2.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_zosrequestlogging.html