配置 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 文档均在信息中心中的编程接口 (API) 部分进行详细说明,而且还可以在 ${wlp.install.dir}/dev 目录的某个 javadoc 子目录下的单独 .zip 文件中找到。
过程
下列步骤说明如何配置示例 Liberty 功能部件(称为 myfeature),以使用 Liberty 的跟踪和日志记录机制。