BinaryLog 指令選項

請利用 binaryLog 指令來檢視或複製二進位記載儲存庫的內容,或列出儲存庫中可用的伺服器處理程序實例。 binaryLog 指令相當於傳統應用程式伺服器設定檔 bin 目錄中的 logViewer 指令。

二進位日誌和追蹤機能會以二進位格式來寫入儲存庫。 您可以利用 binaryLog 指令來檢視、查詢和過濾儲存庫。 binaryLog 指令提供許多選項來將儲存庫內容快速轉換成不同格式的文字檔,例如基本和進階格式。 指令也提供許多選項,讓您更容易從日誌中取得所需要的資料;例如,讓您利用層次、日誌程式名稱或日期和時間,來過濾您想要的日誌記錄。

語法

指令語法如下:

binaryLog action {serverName | repositoryPath} [options]

options 值會根據 action 值而不同。

參數

binaryLog 指令的可用動作如下:

view
讀取儲存庫,選擇性地加以過濾,再建立使用者能夠讀取的版本。

指令語法如下:

binaryLog view {serverName | repositoryPath} [options]

serverName

指定要讀取的儲存庫所在的 Liberty 伺服器名稱。

repositoryPath

指定要讀取的儲存庫的路徑。 這通常是同時包含 logdata 和 tracedata 目錄的目錄。

註: 如果指令行既未指定 serverName,也未指定 repositoryPath,若預設伺服器實例 defaultServer 存在,就會針對它來執行作業。

過濾選項:

所有過濾器都是選用的。當使用多個過濾器時,會用 AND 將它們邏輯地連結起來。

  • --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

    包括含有指定執行緒 ID 的記錄。值必須是十六進位(例如,--includeThread=2a)。

  • --includeExtension=name=value[,name=value]*

    包括含有指定延伸規格名稱和值的記錄。 值可能包含 * 或 ? 作為萬用字元。如果要在值中包含逗點,您必須使用 "\,"

  • --includeInstance=value

    包括指定伺服器實例中的記錄。值必須是 "latest" 或有效的實例 ID。請利用 listInstances 動作來執行這個指令,以查看有效實例 ID 的清單。

監視選項:
--monitor

持續監視儲存庫,產生新內容時,便輸出新內容。

輸出選項:
  • --format={basic | advanced | CBE-1.0.1}

    指定使用的輸出格式。"basic" 是預設格式。

  • --encoding=value

    指定輸出所用的字元編碼值。

copy
讀取儲存庫,選擇性地加以過濾,再將內容寫入新儲存庫中。
指令語法如下:
binaryLog copy {serverName | repositoryPath} targetPath [options]
serverName

指定要讀取的儲存庫所在的 Liberty 伺服器名稱。

repositoryPath

指定要讀取的儲存庫的路徑。 這通常是包含 logdata 和 tracedata 目錄的目錄。

targetPath

指定建立新儲存庫的路徑。必須指定 targetPath

註: 必須指定 serverNamerepositoryPath,以及 targetPath

過濾選項:

所有過濾器都是選用的。當使用多個過濾器時,會用 AND 將它們邏輯地連結起來。
  • --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

    包括含有指定執行緒 ID 的記錄。值必須是十六進位(例如,--includeThread=2a)。

  • --includeExtension=name=value[,name=value]*

    包括含有指定延伸規格名稱和值的記錄。 值可能包含 * 或 ? 作為萬用字元。如果要在值中包含逗點,您必須使用 "\,"

  • --includeInstance=value

    包括指定伺服器實例中的記錄。值必須是 "latest" 或有效的實例 ID。請利用 listInstances 動作來執行這個指令,以查看有效實例 ID 的清單。

listInstances
列出儲存庫中伺服器實例的 ID。伺服器實例是從伺服器啟動直到停止所寫入的所有日誌/追蹤記錄的集合。 伺服器實例 ID 可以搭配 binaryLog view 動作的 --includeInstance 選項來使用。
指令語法如下:
binaryLog listInstances {serverName | repositoryPath}
serverName

指定要讀取的儲存庫所在的 Liberty 伺服器名稱。

repositoryPath

指定要讀取的儲存庫的路徑。 這通常是包含 logdata 和 tracedata 目錄的目錄。

註: 如果在指令行中沒有指定 serverNamerepositoryPath,若預設伺服器實例 defaultServer 存在,就會針對它來執行作業。
請注意 binaryLog 過濾最佳化功能。在搭配下列過濾選項一起使用時,binaryLog 工具可以很有效率地過濾日誌和追蹤資料:
  • --minDate
  • --maxDate
  • --includeThread
  • --minLevel
  • --maxLevel

範例用法

請參閱下列 binaryLog 指令範例。

  • 顯示 2013 年 7 月 19 日至 2013 年 8 月 2 日之間,defaultServer 儲存庫中的所有事件。
    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 作為儲存庫目錄。
    
    實例 ID                      開始日期
    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
  • 利用前述範例的其中一個實例 ID 來檢視 defaultServer 中的事件:
    binaryLog view --includeInstance=1358871281166
  • 複製 defaultServer 中指定層次為 WARNING 或更高的事件,從最新的伺服器實例複製到位於 d:\toSupport 目錄的新儲存庫。
    binaryLog copy defaultServer d:\toSupport --minLevel=warning --includeInstance=latest

指示主題類型的圖示 參照主題



「時間戳記」圖示 前次更新: 2016 年 11 月 30 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_logviewer
檔名:rwlp_logviewer.html