日志级别设置
使用本主题来配置和管理日志级别设置。
要查看此管理控制台页面，请单击
通过使用日志级别，可以控制 Java™ 日志记录处理哪些事件。 更改记录器的级别时，更改将传播到记录器的子代。
提示: 本主题引用一个或多个应用程序服务器日志文件。 作为建议的替代方法，您可以将服务器配置为使用高性能可扩展日志记录 (HPEL) 日志和跟踪基础结构，而不是在分布式系统和 IBM® i 系统上使用 SystemOut.log ， SystemErr.log， trace.log和 activity.log 文件。 您还可以将 HPEL 与本机 z/OS® 日志记录工具结合使用。 如果您正在使用 HPEL，那么可以从服务器概要文件 bin 目录使用
LogViewer 命令行工具来访问所有日志和跟踪信息。 有关使用 HPEL 的更多信息，请参阅 有关使用 HPEL 对应用程序进行故障诊断的信息。
- 禁止记录和跟踪潜在敏感数据
- 应用程序服务器具有记录器列表，已知他们在启用后会潜在地将敏感信息写至日志并进行跟踪。 例如，在 FINEST 级别启用某些 HTTP 相关记录器可能导致在跟踪文件中存储来自 HTTP 请求的用户指定的机密信息。 如果您希望服务器避免在已知道要用于潜在敏感信息的级别启用这些记录器，请选中禁止记录和跟踪潜在敏感数据复选框。 服务器启动时，或运行时期间修改日志详细信息级别规范时，服务器会将日志详细信息级别规范中指定的记录器和级别列表与敏感记录器列表中的记录器和级别列表进行比较，并根据需要更新日志详细信息级别规范。
- 更改日志详细信息级别
输入指定要跟踪的组件、包或组的日志详细信息级别。 日志详细信息级别字符串必须符合本主题中描述的特定语法。 您可以直接输入日志详细信息级别字符串，或者使用图形跟踪界面生成。
如果选择配置选项卡并展开组件和组，那么将显示熟知组件、包和组的静态列表。 此列表可能并不详尽。
如果选择运行时选项卡，并展开组件和组，那么将显示组件、包和组的列表以及正在运行的应用程序服务器上已注册且位于静态列表中的所有组件。
日志详细信息级别规范的格式为：<component> = <level>
其中， <component> 是要为其设置日志详细信息级别的组件， <level> 是有效记录器级别 (off ， fatal ， severe ， warning ， audit ， info ， config ， detail ， fine ， finer ， finest 和 all) 之一。 使用冒号 (:) 分隔多个日志详细信息级别规范。 如果未指定任何子句，那么将使用 *=info 缺省值。
避免麻烦: 因此，如果多个跟踪规范子句应用于给定记录器，那么指定的最后一个值是确定系统为该记录器记录的跟踪级别的值。 如果将*=info指定为最后一个子句，那么跟踪将在信息级别进行，而与跟踪字符串中指定的其他子句无关。 另一个示例是，如果您指定了以下跟踪字符串：
那么相当于仅指定：*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all:*=fine
因为最后一个子句将覆盖字符串中该子句之前指定的所有子句。*=fine组件对应于 Java 包和类或对应于 Java 包的集合。 使用星号 (*) 作为通配符以指示某些组件，这些组件具有所指定组件包含的所有包中所有的类。 例如：- *
- 指定应用程序服务器中运行的所有可跟踪代码，包括产品系统代码和客户代码。
- com.ibm.ws.*
- 指定所有包名以 com.ibm.ws 开头的类。
- com.ibm.ws.classloader.JarClassLoader
- 仅指定 JarClassLoader 类。
从管理控制台设置日志详细信息级别规范时，如果既从“组”列表又从“组件”列表进行选择，那么会发生错误。 在某些情况下，从某个列表进行了选择，又从另一个列表添加选择时，前一个选择会丢失。 要解决此问题，请直接将日志详细信息级别规范输入到日志详细信息级别输入字段中。
选择组件或组以设置日志详细信息级别。 下表列出了 WebSphere® Application Server V 6 及更高版本的应用程序服务器的有效级别。
在 V6.0 及更高版本中启用某种日志记录级别时，还将启用所有严重性更高的级别。 例如，如果对 V6.x 应用程序服务器将日志记录级别设置为警告，那么将处理警告、严重和致命事件。
避免麻烦: 日志记录级别值区分大小写，以小写字母开头。
| V6 及更高版本日志记录级别 | 内容/重要性 |
|---|---|
| off | 日志记录已关闭。 |
| 致命 | 任务无法继续，并且组件、应用程序和服务器无法工作。 |
| 严重 | 任务无法继续，但是组件、应用程序和服务器仍可工作。 此级别也可以表明即将发生的不可恢复的错误。 |
| 警告 | 可能发生错误或即将发生错误。 此级别也可以表明正在向故障发展（例如，潜在的资源泄漏）。 |
| 审计 | 影响服务器状态或资源的重大事件 |
| info | 概述总体任务进度的一般信息 |
| config | 配置更改或状态 |
| 详细信息 | 详细说明子任务进度的一般信息 |
| 精细 | 跟踪信息 - 常规跟踪 + 方法入口、出口和返回值 |
| 更精细 | 跟踪信息 - 详细跟踪 |
| 最精细 | 跟踪信息 - 更详细的跟踪信息，包含调试问题所需的所有详细信息 |
| 全部 | 记录所有事件。 如果创建了定制级别，那么“所有”将包括那些级别，并且能提供比“最精细”更详细的跟踪。 |
[基本方式记录] 跟踪信息（级别为精细、更精细和最精细的事件）只能写入跟踪日志。 因此，如果未启用诊断跟踪，那么将日志详细信息级别设置为“良好”、“更好”或“最好”将不会影响记录的数据。
- 相关
- 指定您要启用的相关设置。 选中启用日志和跟踪相关复选框以启用应用程序服务器相关。 取消选中启用日志和跟踪相关复选框以禁用应用程序服务器相关。 根据需要选中在记录和跟踪记录中包括请求标识、在记录和跟踪记录中包括请求标识并创建相关日志记录或在记录和跟踪记录中包括请求标识，创建相关日志记录，并捕获数据快照。
- 当需要了解在所有线程和应用程序服务器进程中与同一请求相关的记录和跟踪条目时，请让 XCT 在记录和跟踪文件中包括请求标识。 请求标识仅在使用 HPEL 记录和跟踪方式时才会记录，可供使用 logViewer 命令进行查看和用于过滤。
- 当要记录请求在线程和进程之间的分支情况，并了解有关每个请求的更多信息时，请让 XCT 创建相关日志记录。 让 XCT 创建相关日志记录可能对您的系统性能有显著影响，所以最适合测试和开发环境。
- 当要存储针对文件系统的整个请求和响应主体时，请让 XCT 捕获数据快照。 让 XCT 捕获数据快照可能对您的系统性能有显著影响，所以最适合测试和开发环境。 XCT 捕获由 SIBus 处理的消息请求和响应的数据快照。
避免麻烦: 捕获数据快照并将其写入 $SERVER_LOG_ROOT/snapdata 目录。 应用程序服务器不会自动从此目录中清除文件。 当启用数据快照捕获时，您将需要定期从此目录中删除文件。 数据快照会存储整个请求和响应内容，并且可以包括敏感信息。 此选项可能不适合在生产环境中使用。
- 同时将运行时更改保存到配置中
- 指定对正在运行的服务器的动态状态和服务器配置都进行了更改，这些更改在下次重新启动时生效。 如果未选中此复选框，那么服务器不会将这些设置复制到服务器配置中。