在 z/OS 上啟用 Liberty 的要求記載

z/OS®「要求記載」特性 zosRequestLogging-1.0 會收集 HTTP 要求的相關資訊,並將資訊記錄到 z/OS SMF 資料儲存庫。 當 z/OS「要求記載」特性已啟動,且 RACF® 正確設定時,便會產生 SMF 類型 120 子類型 11 第 2 版記錄。 對於非同步建立的局部要求,不會擷取資料。

程序

  1. server.xml 配置檔的 featureManager 元素中,新增 zosRequestLogging-1.0 特性來啟用要求記載。
    <feature>zosRequestLogging-1.0</feature>
  2. 發出下列指令,配置 RACF 寫入 SMF 記錄:
    RDEFINE FACILITY BPX.SMF UACC(NONE)
    PERMIT BPX.SMF ID(MSTONE1) ACCESS(READ) CLASS(FACILITY)
    SETROPTS GENERIC(FACILITY) REFRESH
    SETROPTS RACLIST(FACILITY) REFRESH
  3. 選擇性的: 在 Servlet 中實作 UserData API,將使用者新增至 SMF 記錄。

    Servlet 可以使用 UserData add 方法,將其本身的要求特定資料新增至 SMF 120 子類型 11 第 2 版記錄(針對 HTTP 要求而寫入)。 UserData 介面在 com.ibm.websphere.zos.request.logging 套件中。

    下列範例顯示 Servlet 如何將其本身的要求特定資料,新增至 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) {
    }

結果

您的 Liberty 伺服器會將 HTTP 要求的相關資訊,記載到 SMF 120 子類型 11 第 2 版記錄中。如需產生的資料如何對映的相關資訊,請參閱 SMF 類型 120 子類型 11 第 2 版記錄對映

指示主題類型的圖示 作業主題

檔名:twlp_zosrequestlogging.html