LogViewer 命令行工具
使用 LogViewer 命令可查询高性能可扩展日志记录 (HPEL) 记录和跟踪存储库的内容。 还可以使用 LogViewer 命令,在服务器向记录和跟踪存储库写入内容时,查看新的记录和跟踪存储库条目。
LogViewer
高性能可扩展日志记录 (HPEL) 设施以二进制格式向记录和跟踪存储库写入内容。可以使用 LogViewer 命令来查看、查询和过滤存储库。LogViewer 命令提供可将 HPEL 日志快速转换为多种格式(包括基本、高级和公共基本事件格式)的文本文件的选项。该命令还提供可更方便地从记录中获取所需数据的选项;例如,允许您按级别、记录器名称或日期和时间过滤所需的日志记录。
使用以下命令可查看记录和跟踪存储库的完整内容:
(Windows) logViewer.bat
(Unix 完整概要文件)logViewer.sh
(Unix Liberty 概要文件)logViewer
可选参数
- [Liberty 概要文件] servername
- 指定您希望 logViewer 命令使用其记录和跟踪数据存储库的服务器的名称。在仅创建了一个 Liberty 概要文件服务器的情况下,不需要使用此参数;在您使用 -repositoryDir 参数指定记录和跟踪数据存储库根目录的路径的情况下,也不需要使用此参数。
- -repositoryDir directory_name
- 指定存储库目录的路径。如果要同时查询记录和跟踪数据,请提供父目录的路径,该目录同时包含了日志数据和跟踪数据目录。如果使用缺省存储库位置 profile_root/logs/application_server/,并从概要文件 bin 目录运行此工具,那么此参数是可选参数。如果未提供位置,那么该工具会检查此缺省位置。如果在此概要文件中存在多个带有 HPEL 存储库的应用程序服务器,那么会提示您选择要查看的服务器记录和跟踪存储库。
- -outLog file_name
- 指定要向其写入文本输出的文件名。如果未提供此信息,那么文本输出将显示在控制台上。
- -format basic | advanced | cbe-1.0.1
- 指定输出格式。受支持的格式包括 basic、advanced 和 CBE-1.0.1 格式。如果未提供此信息,那么输出将为 basic 格式。
- -monitor [integer]
- 指定希望 logViewer 持续监控存储库并在创建新日志记录条目时将其输出。 可以在此参数后面提供一个可选整数参数,以指定希望 LogViewer 工具在存储库中查询新记录的频率。缺省情况下,logViewer 将每 5 秒查询一次存储库中的新记录。当与其他过滤选项配合使用时,将仅显示与过滤器条件匹配的那些新记录。
- -help
- 使用此参数可使 LogViewer 工具列示可用选项的完整集合。
- -startDatedate_time
- 可以按日期和时间过滤在存储库中显示的结果。使用 startDate 参数来过滤掉在作为自变量提供的日期或日期时间之后发生的日志条目。 请提供一个日期或日期和时间,并使用 MM/dd/yy 格式或 MM/dd/yy H:m:s:S z 格式输入。其中 z 指的是时区。
- -stopDate date_time
- 使用此参数来过滤掉在指定日期或日期时间之前发生的日志条目。请使用与 -startDate 选项相同的格式提供该参数。
- -level level_name
- 指定希望该工具仅显示与作为参数提供的级别名称匹配的那些日志事件。级别名称的有效值包括:FINEST、FINER、FINE、DETAIL、CONFIG、INFO、AUDIT、WARNING、SEVERE 和 FATAL。
- -minLevel level_name
- 指定希望该工具仅显示不低于指定级别的记录。级别名称的有效值包括:FINEST、FINER、FINE、DETAIL、CONFIG、INFO、AUDIT、WARNING、SEVERE 和 FATAL。
- -maxLevel level_name
- 指定希望该工具仅显示不高于指定级别的记录。级别名称的有效值包括:FINEST、FINER、FINE、DETAIL、CONFIG、INFO、AUDIT、WARNING、SEVERE 和 FATAL。
- -includeLoggers logger_name
- 使用此选项时,在 LogViewer 输出中将仅包括来自指定记录器的日志事件。请将多个条目用逗号隔开。可以使用星号 * 作为通配符以包括父记录器下的所有记录器。当与 -excludedLoggers 选项配合使用时,更具体的匹配将确定要包括还是排除日志事件。
- -excludeLoggers logger_name
- 使用此选项可在 LogViewer 输出中排除来自指定记录器的日志事件。请将多个条目用逗号隔开。可以使用星号 * 作为通配符以包括父记录器下的所有记录器。当与 -includeLoggers 选项配合使用时,更具体的匹配将确定要包括还是排除日志事件。
- -thread thread_id
- 使用此选项可将 LogViewer 输出限制为仅包含来自特定线程的那些日志事件。所有不是由作为此选项的参数提供的线程标识创建的日志消息均不会显示。 以十六进制格式指定线程标识。
- -extractToNewRepositorydirectory_name
- 此选项可将来自某个二进制存储库的记录和跟踪记录重定向到位于所指定位置的新二进制存储库。可以将此选项与其他过滤选项配合使用,以将部分记录和跟踪记录放入新存储库。此选项使用必须在其中写入新存储库的目录路径作为参数。因此,该目录必须是空目录。如果该目录不存在,那么将创建该目录。但是,在目录创建期间发生的错误可能会创建无关的目录。
- -listInstances
- 使用此选项可列示可与 -instance 选项配合使用的可用服务器过程实例的标识。如果使用 -listInstances 选项运行 LogViewer,那么可以使用 -instance 选项来调用 LogViewer,并用其中一个服务器过程实例标识作为参数。由于此选项不处理任何日志或跟踪记录,所以当指定此选项时将忽略所有其他选项。
- -instance instance_id
- 使用此选项可通过提供服务器实例标识来检索给定服务器过程实例的记录和跟踪数据。在使用此选项获取有效实例标识之前,请配合使用 -listInstances 选项运行 LogViewer。当查看来自包含子进程的环境(例如,z/OS® 操作系统)的日志和跟踪时,此选项是必需的。
- 如果将此选项与 -latestInstance 组合,那么将忽略 -instance。
- -latestInstance
- 使用此选项可检索来自最新的服务器实例的记录和跟踪数据。如果将此选项与 -instance 选项配合使用,那么将忽略 -instance 选项。
- -message match_string
- 使用此选项可仅检索带有与所请求文本匹配的某个消息字段的日志或跟踪数据。
- -includeExtensions name[=value][,name[=value]]*
- 使用此选项可检索扩展名与所请求名称匹配,并且扩展值与所请求值匹配的记录和跟踪数据。如果省略该选项的 =value 部分,那么还可以使用此选项检索扩展名与所请求名称匹配,并且扩展值与任何值均匹配的记录和跟踪数据。
- 以 advanced 格式显示的所有扩展名均可以使用。 请注意,“source”、“class”和“method”不作为扩展存储在日志/跟踪存储库中,所以不能使用此选项过滤。
- 请将多个 name=value 参数用逗号隔开。如果名称或值必须包含等号,请指定“==”(两个等号)代替“=”(一个等号)。 如果名称或值必须包含逗号,请指定“,,”(两个逗号)代替“,”(一个逗号)。
- -encoding character_set
- 指定 LogViewer 命令将为文本输出使用的字符集。
过滤注意事项
请了解 LogViewer 过滤优化。当与以下过滤选项配合使用时,LogViewer 工具能够最高效地过滤日志和跟踪数据:
- startDate
- stopDate
- thread
- level
- minLevel
- maxLevel
用法示例
请参阅在基于 UNIX 的系统上用于完整概要文件服务器的下列 LogViewer 命令示例。这些示例显示如何从概要文件 bin 目录运行 LogViewer,在此情况下不需要 repositoryDir 参数。
- 将缺省存储库中介于 2009 年 7 月 19 日和 2009 年 8 月 2 日之间的所有记录写入名为 /tmp/promo.logs 的文件中。
logViewer.sh -outLog /tmp/promo.logs -startDate 07/19/2009 -stopDate 08/02/2009
- 显示指定级别为 WARNING 或更高级别的新记录,并在服务器将其写到日志存储库时使用 advanced 格式。
logViewer.sh -monitor -minLevel WARNING -format advanced
- 仅将写到特定存储库错误流中的那些日志消息写到名为 logged_errors.txt 的文件中。
logViewer.sh -repositoryDir /apps/server1/logs -includeLoggers SystemErr -outLog logged_errors.txt
- 查看在 2009 年 9 月 14 日美国东部夏令时下午 4:28 之前发生的缺省存储库中的事件。
logViewer.sh -stopDate "09/14/2009 16:28:00:000 EDT"
- 写缺省存储库中包含“thread”扩展并带有值 WebContainer :
6 的事件。
logViewer.sh -includeExtensions thread="WebContainer : 6" -format advanced
- 写缺省存储库中属于 requestID 为 a856cb2c-79ed-4d62-a3cf-a9908b2db07b 的请求的事件。
logViewer.sh -includeExtensions requestID=a856cb2c-79ed-4d62-a3cf-a9908b2db07b
- 写线程上创建的缺省存储库中的事件,该线程用于向 PlantsByWebSphere 应用程序提供服务。
logViewer.sh -includeExtensions appName=PlantsByWebSphere
![[z/OS]](../images/ngzos.gif)
- 使用 -listInstances 选项调用 LogViewer;例如:
logViewer.sh -listInstances
以下示例是来自一个控制器和三个服务方的实例标识的列表:
Instance ID Start Date 1280334046 5/10/10 18:53:12:770 GMT 1280334046/000001BC00000002_BBOS1S_STC003119 5/10/10 18:53:39:220 GMT 1280334046/000001B400000002_BBOS1S_STC003120 5/10/10 18:54:44:339 GMT 1280334046/000001C000000001_BBOS1S_STC003121 5/10/10 18:55:43:520 GMT
通过使用以上示例中的一个实例标识,使用 -instance 选项调用 LogViewer。标识类型是控制器;例如:
logViewer.sh -instance 1280334046
- 针对服务方实例,使用 -instance 选项调用 LogViewer;例如:
logViewer.sh -instance 1280334046/000001BC00000002_BBOS1S_STC003119