日志级别设置

使用本主题来配置和管理日志级别设置。

要查看此管理控制台页面，请单击故障诊断 > 日志和跟踪 > server_name > 更改日志详细级别

可以使用日志级别控制由 Java 记录处理哪些事件。更改记录器的级别时，更改将传播到记录器的子代。

注：本主题引用了一个或多个应用程序服务器日志文件。作为建议的替代方法，在分布式系统和 IBM® i 系统上，您可以将服务器配置为使用高性能可扩展日志记录 (HPEL) 日志和跟踪基础结构，而非使用 SystemOut.log、SystemErr.log、trace.log 和 activity.log 文件。还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL，那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有记录和跟踪信息。有关使用 HPEL 的更多信息，请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。

禁止记录和跟踪潜在敏感数据

应用程序服务器具有记录器列表，已知他们在启用后会潜在地将敏感信息写至日志并进行跟踪。例如，在“最精细”级别启用某些 HTTP 相关记录器可能导致来自 HTTP 请求的机密用户指定的信息存储在跟踪文件中。如果您希望服务器避免在已知道要用于潜在敏感信息的级别启用这些记录器，请选中禁止记录和跟踪潜在敏感数据复选框。服务器启动时，或运行时期间修改日志详细信息级别规范时，服务器会将日志详细信息级别规范中指定的记录器和级别列表与敏感记录器列表中的记录器和级别列表进行比较，并根据需要更新日志详细信息级别规范。

更改日志详细信息级别

输入指定要跟踪的组件、包或组的日志详细信息级别。日志详细信息级别字符串必须符合本主题中描述的特定语法。您可以直接输入日志详细信息级别字符串，或者使用图形跟踪界面生成它。

如果选择配置选项卡并展开组件和组，那么将显示熟知组件、包和组的静态列表。此列表可能并不详尽。

如果选择运行时选项卡并展开组件和组，那么将显示组件、包和组的列表以及在正在运行的应用程序服务器上注册的和静态列表中所有组件。

日志详细信息级别规范的格式是：

<component> = <level>

其中 <component> 是要为它设置日志详细信息级别的组件，而 <level> 是某个有效的记录器级别（关闭、致命、严重、警告、审计、信息、配置、详细信息、精细、较精细、最精细、全部）。用冒号 (:) 分隔多个日志详细信息级别规范。

避免故障：

对于跟踪规范中包括的子句，将按照它们在字符串中的显示顺序读取。因此，如果跟踪规范中包括 *=info 子句的多个变体，那么所指定的最后一个值将确定系统日志的跟踪级别。如果您指定 *=info 作为最后一个子句，那么将在 info 级别进行跟踪，而不考虑在跟踪字符串中所指定的其他子句。例如，如果您指定了以下跟踪字符串：

*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all

等价于只是指定以下内容：

*=all

因为最后一个子句将覆盖字符串中在它前面指定的所有子句。 [2013 年 6 月更新]

gotcha

组件相当于 Java 包和类，或者相当于 Java 包的集合。使用星号 (*) 作为通配符以指示某些组件，这些组件包含所指定组件包含的所有包中所有的类。例如：

*: 指定应用程序服务器中运行的所有可跟踪代码，包括产品系统代码和客户代码。
com.ibm.ws.*: 指定所有包名以 com.ibm.ws 开头的类。
com.ibm.ws.classloader.JarClassLoader: 仅指定 JarClassLoader 类。

从管理控制台设置日志详细信息级别规范时，如果既从“组”列表又从“组件”列表进行选择，那么会发生错误。在某些情况下，从某个列表进行了选择，又从另一个列表添加选择时，前一个选择会丢失。要解决此问题，请直接将日志详细信息级别指定输入到日志详细信息级别输入字段中。

选择组件或组以设置日志详细信息级别。下表列出了 WebSphere® Application Server V6 及更高版本应用程序服务器的有效级别。

避免故障：日志记录级别值区分大小写并以小写字母开头。gotcha

表 1. 有效记录级别. 下表列出了 WebSphere Application Server V6 及更高版本应用程序服务器的有效级别。
V6 及更高版本记录级别	内容/意义
关闭	关闭了记录。
致命	任务无法继续，并且组件、应用程序和服务器无法运行。
严重	任务无法继续，但是组件、应用程序和服务器仍然可以运行。此级别也可以表明即将发生的不可恢复的错误。
警告	潜在或即将发生的错误。此级别也可以表明正在向故障发展（例如，潜在的资源泄漏）。
审计	影响服务器状态或资源的重大事件
信息	概述总体任务进度的一般信息
配置	配置更改或状态
详细信息	详细说明子任务进度的一般信息
良好	跟踪信息 - 一般跟踪 + 方法入口、出口和返回值
更好	跟踪信息 - 详细跟踪信息
最好	跟踪信息 - 更详细的跟踪信息，包含调试问题所需的所有详细信息
所有	记录全部事件。如果创建了定制级别，那么“所有”将包括那些级别，并且能提供比“最精细”更详细的跟踪。

在 V6.0 及更高版本中启用某种日志记录级别时，还将启用所有严重性更高的级别。例如，如果对 V6.x 应用程序服务器将日志记录级别设置为警告，那么将处理警告、严重和致命事件。

[基本方式记录] 跟踪信息（级别为精细、更精细和最精细的事件）只能写入跟踪日志。因此，如果未启用诊断跟踪，那么将日志详细信息级别设置为“良好”、“更好”或“最好”将不会影响记录的数据。

相关: 指定您要启用的相关设置。选中启用记录和跟踪相关复选框以启用应用程序服务器相关。清除启用记录和跟踪相关复选框以禁用应用程序服务器相关。根据需要选中在记录和跟踪记录中包括请求标识、在记录和跟踪记录中包括请求标识并创建相关日志记录或在记录和跟踪记录中包括请求标识，创建相关日志记录，并捕获数据快照。
最佳实践：当需要了解在所有线程和应用程序服务器进程中与同一请求相关的记录和跟踪条目时，请让 XCT 在记录和跟踪文件中包括请求标识。请求标识仅在使用 HPEL 记录和跟踪方式时才会记录，可供使用 logViewer 命令进行查看和用于过滤。bprac

最佳实践：当要记录请求在线程和进程之间的分支情况，并了解有关每个请求的更多信息时，请让 XCT 创建相关日志记录。让 XCT 创建相关日志记录可能对您的系统性能有显著影响，所以最适合测试和开发环境。bprac

最佳实践：当要存储针对文件系统的整个请求和响应主体时，请让 XCT 捕获数据快照。让 XCT 捕获数据快照可能对您的系统性能有显著影响，所以最适合测试和开发环境。XCT 捕获由 SIBus 处理的消息请求和响应的数据快照。bprac

避免故障：数据快照将捕获并写入到 $SERVER_LOG_ROOT/snapdata 目录中。应用程序服务器不会自动从此目录中清除文件。当启用数据快照捕获时，您将需要定期从此目录中删除文件。数据快照会存储整个请求和响应内容，并且可以包括敏感信息。此选项可能不适合在生产环境中使用。gotcha

同时将运行时更改保存到配置中: 指定对正在运行的服务器的动态状态和服务器配置都进行了更改，这些更改在下次重新启动时生效。如果未选中此复选框，那么服务器不会将这些设置复制到服务器配置中。

文件名： utrb_loglevel.html