binaryLog 命令选项
使用 binaryLog 命令来查看或复制二进制日志记录存储库的内容,或者列示该存储库中可用的服务器进程实例。binaryLog 命令等价于完整概要文件应用程序服务器的概要文件 bin 目录中的 logViewer 命令。
语法
命令语法如下所示:
binaryLog action {serverName | repositoryPath} [options]
options 的值随 action 的值不同而不同。
参数
下列操作可用于 binaryLog 命令:
- view
- 读取存储库,可以选择对其进行过滤,并创建用户可以读取的版本。
命令语法如下所示:
binaryLog view {serverName | repositoryPath} [options]
serverName
指定具有要从其中读取的存储库的 Liberty 服务器的名称。
repositoryPath
指定要从其中读取的存储库的路径。这通常是同时包含 logdata 和 tracedata 目录的目录。
注: 如果在命令行上既未指定 serverName,也未指定 repositoryPath,那么将对缺省服务器实例 defaultServer(如果它存在)执行此任务。 过滤器选项:
所有过滤器均为可选。当使用多个过滤器时,它们将在逻辑上相“与”。
- --minDate=value
根据最早记录创建日期进行过滤。必须按日期(例如,--minDate="2/20/13")或者日期和时间(例如,--minDate="2/20/13 16:47:21:445 EST")指定值。
- --maxDate=value
根据最迟记录创建日期进行过滤。必须按日期(例如,--maxDate="2/20/13")或者日期和时间(例如,--maxDate="2/20/13 16:47:21:445 EST")指定值。
- --minLevel=value
根据最低级别进行过滤。值必须为下列其中一个值:FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL。
- --maxLevel=value
根据最高级别进行过滤。值必须为下列其中一个值:FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL。
- --includeLogger=value[,value]*
包括具有所指定的记录器名称的记录。值可包含 * 或 ? 作为通配符。
- --includeMessage=value
根据消息名称进行过滤。值可包含 * 或 ? 作为通配符。
- --includeThread=value
包括具有所指定的线程标识的记录。值必须采用十六进制(例如,--includeThread=2a)。
- --includeExtension=name=value[,name=value]*
包括具有所指定的扩展名和值的记录。值可包含 * 或 ? 作为通配符。要在值中包含逗号,必须使用“\,”
- --includeInstance=value
包括所指定服务器实例中的记录。值必须为 "latest" 或者有效的实例标识。请使用 listInstances 操作来运行此命令以查看有效实例标识的列表。
- --minDate=value
- 监视选项:
- --monitor
连续监视存储库并输出所生成的新内容。
输出选项:- --format={basic | advanced | CBE-1.0.1}
指定要使用的输出格式。"basic" 为缺省格式。
- --encoding=value
指定要用于输出的字符编码。
- --format={basic | advanced | CBE-1.0.1}
- copy
- 读取存储库,可以选择对其进行过滤,并将内容写入新的存储库。
- 命令语法如下所示:
binaryLog copy {serverName | repositoryPath} targetPath [options]
- serverName
指定具有要从其中读取的存储库的 Liberty 服务器的名称。
- repositoryPath
指定要从其中读取的存储库的路径。这通常是包含 logdata 和 tracedata 目录的目录。
- targetPath
指定要在其中创建新的存储库的路径。必须指定 targetPath。
- 注: 必须指定 serverName 或 repositoryPath,以及 targetPath。
过滤器选项:
- 所有过滤器均为可选。当使用多个过滤器时,它们将在逻辑上相“与”。
- --minDate=value
根据最早记录创建日期进行过滤。必须按日期(例如,--minDate="2/20/13")或者日期和时间(例如,--minDate="2/20/13 16:52:32:808 EST")指定值。
- --maxDate=value
根据最迟记录创建日期进行过滤。必须按日期(例如,--maxDate="2/20/13")或者日期和时间(例如,--maxDate="2/20/13 16:52:32:808 EST")指定值。
- --minLevel=value
根据最低级别进行过滤。值必须为下列其中一个值:FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL。
- --maxLevel=value
根据最高级别进行过滤。值必须为下列其中一个值:FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL。
- --includeLogger=value[,value]*
包括具有所指定的记录器名称的记录。值可包含 * 或 ? 作为通配符。
- --excludeLogger=value[,value]*
排除具有所指定的记录器名称的记录。值可包含 * 或 ? 作为通配符。
- --includeMessage=value
根据消息名称进行过滤。值可包含 * 或 ? 作为通配符。
- --includeThread=value
包括具有所指定的线程标识的记录。值必须采用十六进制(例如,--includeThread=2a)。
- --includeExtension=name=value[,name=value]*
包括具有所指定的扩展名和值的记录。值可包含 * 或 ? 作为通配符。要在值中包含逗号,必须使用“\,”
- --includeInstance=value
包括所指定服务器实例中的记录。值必须为 "latest" 或者有效的实例标识。请使用 listInstances 操作来运行此命令以查看有效实例标识的列表。
- --minDate=value
- listInstances
- 列示存储库中的服务器实例的标识。服务器实例是从服务器启动直到停止期间写入的所有日志记录/跟踪记录的集合。可将服务器实例标识与 binaryLog 查看操作的 --includeInstance 选项配合使用。
- 命令语法如下所示:
binaryLog listInstances {serverName | repositoryPath}
- serverName
指定具有要从其中读取的存储库的 Liberty 服务器的名称。
- repositoryPath
指定要从其中读取的存储库的路径。这通常是包含 logdata 和 tracedata 目录的目录。
- 注: 如果在命令行上既未指定 serverName,也未指定 repositoryPath,那么将对缺省服务器实例 defaultServer(如果它存在)执行此任务。
- 请了解 binaryLog 过滤优化。binaryLog 工具在与下列过滤选项配合使用时,能够最高效地过滤日志和跟踪数据:
- --minDate
- --maxDate
- --includeThread
- --minLevel
- --maxLevel
- 用法示例
请参阅 binaryLog 命令的下列示例。
- 显示 defaultServer 存储库中在 2013 年 7 月 19 日到 2013 年 8 月 2 日期间发生的所有事件。
binaryLog view --minDate=07/19/13 --maxDate=08/02/13
- 显示 myServer 服务器中发生的、其指定级别为 WARNING 或更高级别的新事件,并在服务器将其写入日志存储库时使用高级格式。
binaryLog view myServer --monitor --minLevel=WARNING --format=advanced
- 写入来自存储库(位于 /apps/server1/logs)中的日志消息;仅包括已写入特定存储库的错误流的那些消息。
binaryLog view /apps/server1/logs --includeLogger=SystemErr
- 查看 defaultServer 存储库中在 2012 年 9 月 14 日美国东部夏令时下午 4:28 之前发生的事件。
binaryLog view --maxDate="09/14/12 16:28:00:000 EDT"
- 写入 defaultServer 存储库中包含“thread”扩展名并且具有以下值的事件:'Default Executor-thread-4'
binaryLog view --includeExtension=thread="Default Executor-thread-4" --format=advanced
- 查看 defaultServer 存储库中的服务器实例的列表:
binaryLog listInstances 使用 D:\wlp\usr\servers\defaultServer\logs 作为存储库目录。 实例标识 开始日期 1358809441761 1/21/13 18:04:01:761 EST 1358864476191 1/22/13 9:21:16:191 EST 1358869523192 1/22/13 10:45:23:192 EST 1358871281166 1/22/13 11:14:41:166 EST 1358879829000 1/22/13 13:37:09:000 EST 1358892222067 1/22/13 17:03:42:067 EST
- 查看 defaultServer 中的使用前一示例中的其中一个实例标识的事件:
binaryLog view --includeInstance=1358871281166
- 将 defaultServer 中的指定级别为 WARNING 或更高级别的事件从最新服务器实例复制到 d:\toSupport 目录中的新存储库。
binaryLog copy defaultServer d:\toSupport --minLevel=warning --includeInstance=latest
- 显示 defaultServer 存储库中在 2013 年 7 月 19 日到 2013 年 8 月 2 日期间发生的所有事件。