日志级别设置

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

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

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

注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.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 级别进行跟踪,无论跟踪字符串中指定的其他子句如何都是如此。例如,如果指定以下跟踪字符串:
*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all  
等同于仅仅指定:
*=all
因为最后一个子句将覆盖字符串中该子句前面指定的所有子句。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 及更高版本记录级别 内容/意义
off 关闭了记录。
fatal 任务无法继续,并且组件、应用程序和服务器无法运行。
severe 任务无法继续,但是组件、应用程序和服务器仍然可以运行。此级别也可以表明即将发生的不可恢复的错误。
warning 潜在或即将发生的错误。此级别也可以表明正在向故障发展(例如,潜在的资源泄漏)。
audit 影响服务器状态或资源的重大事件
info 概述总体任务进度的一般信息
config 配置更改或状态
detail 详细说明子任务进度的一般信息
fine 跟踪信息 - 一般跟踪 + 方法入口、出口和返回值
finer 跟踪信息 - 详细跟踪信息
finest 跟踪信息 - 更详细的跟踪信息,包含调试问题所需的所有详细信息
all 记录全部事件。如果创建了定制级别,那么 all 将包括那些级别,并且能提供比 finest 更详细的跟踪。
在 V6.0 及更高版本中启用某种日志记录级别时,还将启用所有严重性更高的级别。例如,如果对 V6.x 应用程序服务器将日志记录级别设置为 warning,那么将处理 warningseverefatal 事件。

[基本方式日志记录] 跟踪信息(级别为 fine、finer 和 finest 的事件)只能写入跟踪日志。因此,如果未启用诊断跟踪,那么将日志详细信息级别设置为 fine、finer 或 finest 将不会影响记录的数据。

相关
指定您要启用的相关设置。选中启用日志和跟踪相关复选框以启用应用程序服务器相关。清除启用日志和跟踪相关复选框以禁用应用程序服务器相关。根据需要选中在日志和跟踪记录中包括请求标识在日志和跟踪记录中包括请求标识并创建相关日志记录在日志和跟踪记录中包括请求标识,创建相关日志记录,并捕获数据快照
最佳实践 最佳实践: 当需要了解在所有线程和应用程序服务器进程中与同一请求相关的日志和跟踪条目时,请让 XCT 在日志和跟踪文件中包括请求标识。请求标识仅在使用 HPEL 日志和跟踪方式时才会记录,可供使用 logViewer 命令进行查看和用于过滤。bprac
最佳实践 最佳实践: 当要记录请求在线程和进程之间的分支情况,并了解有关每个请求的更多信息时,请让 XCT 创建相关日志记录。 让 XCT 创建相关日志记录可能对您的系统性能有显著影响,所以最适合测试和开发环境。bprac
最佳实践 最佳实践: 当您将整个请求和响应主体存储到文件系统时,请让 XCT 捕获数据快照。让 XCT 捕获数据快照可能对您的系统性能有显著影响,所以最适合测试和开发环境。XCT 捕获由 SIBus 处理的消息请求和响应的数据快照。bprac
避免故障 避免故障: 数据快照将捕获并写入到 $SERVER_LOG_ROOT/snapdata 目录中。 应用程序服务器不会自动从此目录中清除文件。当启用数据快照捕获时,您将需要定期从此目录中删除文件。数据快照会存储整个请求和响应内容,并且可以包括敏感信息。此选项可能不适合在生产环境中使用。gotcha
同时将运行时更改保存到配置中
指定对正在运行的服务器的动态状态和服务器配置都进行了更改,这些更改在下次重新启动时生效。如果未选中此复选框,那么服务器不会将这些设置复制到服务器配置中。

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=utrb_loglevel
文件名:utrb_loglevel.html