在 Liberty 中配置特性的追蹤和記載
您可以使用 Liberty 中用於 Liberty 特性的追蹤和記載機制。記載服務是 Liberty 核心程式的一部分,因此您不需要在 server.xml 檔中指定特性即可使用。
關於這項作業
Liberty 提供下列 SPI,以在自訂特性程式碼中整合追蹤和記載功能:
- com.ibm.websphere.ras
- com.ibm.websphere.ras 套件提供了用來記載訊息及追蹤記錄的類別,以及一些延伸點。 一般而言,特性碼可以使用 java.util.logging 套件來記載追蹤和訊息,並透過 Liberty 記載配置來控制輸出,但 WebSphere® 套件的延伸功能有時候非常有用,而當追蹤已停用時,追蹤保護會稍有效率。
- com.ibm.websphere.ras.annotations
- com.ibm.websphere.ras.annotations 套件提供了一些註釋,可搭配其他套件中的類別使用。例如,@Sensitive 註釋可以用來避免已標註變數的內容出現在追蹤或訊息輸出中。
- com.ibm.ws.ffdc
- com.ibm.ws.ffdc 套件提供了一些機能來寫入首次失敗資料擷取 (FFDC) 記錄,以協助除錯非預期的異常狀況。
- com.ibm.wsspi.logging
- com.ibm.wsspi.logging 套件提供了日誌和 ffdc 記錄的攔截點。
每一個 Liberty SPI 的 Java™ API 文件都是以個別的 .zip 檔來提供 (其位於 ${wlp.install.dir}/dev 目錄下的其中一個 javadoc 子目錄中)。
程序
下列步驟展示如何配置稱為 myfeature 的 Liberty 特性範例來使用 Liberty 的追蹤和記載機制: