lseventlog

使用 lseventlog 指令可顯示系統事件日誌的簡要視圖,也可顯示日誌中某一項目的詳細視圖。

語法

讀取語法圖表略過語法圖表
>>-lseventlog--+--------------------------------+--------------->
               '- -filtervalue--attribute_value-'   

>--+----------------+--+--------------------+--+---------+------>
   '- -filtervalue?-'  '- -delim--delimiter-'  '- -nohdr-'   

>--+------------------+--+--------------------+----------------->
   '- -alert--+-yes-+-'  '- -message--+-yes-+-'   
              '-no--'                 '-no--'     

>--+-----------------------+--+--------------------+------------>
   '- -monitoring--+-yes-+-'  '- -expired--+-yes-+-'   
                   '-no--'                 '-no--'     

>--+------------------+--+----------------------+--------------->
   '- -fixed--+-yes-+-'  '- -count--entry_limit-'   
              '-no--'                               

>--+-----------------------+--+-----------------+--------------><
   '- -order--+-date-----+-'  '-sequence_number-'   
              '-severity-'                          

參數

-filtervalue attribute=value
(選用)指定一或多個過濾器的清單。只會傳回其值符合過濾器屬性值的物件。如果指定容量,也必須包括單位。
註: 某些過濾器容許您在輸入指令時使用萬用字元。在CLI 中使用萬用字元時,有下列規則:
  • 萬用字元是星號 (*)。
  • 指令最多可包含一個萬用字元。
  • 使用萬用字元時,必須用雙引號 ("") 將過濾項目引起來,如下所示:
    lseventlog -filtervalue "object_name=ob*"
-nohdr
(選用)依預設,會在簡要樣式視圖中顯示每個資料直欄的標題,以及在詳細樣式視圖中顯示每個資料項目的標題。-nohdr 參數會暫停顯示這些標題。
註: 如果沒有要顯示的資料,就不會顯示標題。
-delim delimiter
(選用)依預設,簡要視圖中的所有資料直欄都以空格區隔。每個直欄的寬度都會設為各資料項目的最大寬度。在詳細視圖中,每個資料項目本身都有一列,如果顯示標頭,會用空格來區隔資料與標頭。-delim 參數會置換此行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :,則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目;例如,直欄不會出現間距。在詳細視圖中,會用指定的定界字元來區隔資料與其標頭。
-alert yes | no
(選用)包含(或排除)狀態為 alert 的事件。
-message yes | no
(選用)包含狀態為 message 的事件。
-monitoring yes | no
(選用)包含狀態為 monitoring 的事件。
-expired yes | no
(選用)包含(或排除)狀態為 expired 的事件。
-fixed yes | no
(選用)包含(或排除)狀態為 fixed 的事件。
-count entry_limit
(選用)指出要顯示的事件數上限。
-order date | severity
(選用)指出事件必須依循的順序。依 date 排序會先顥示最舊的事件。依嚴重性排序則會先顯示嚴重性最高的事件。如果多個事件有相同的嚴重性,則會依日期排序,最先顯示最舊的事件。
下列清單顯示嚴重性順序,從最嚴重的開始:
  1. 未修正的警示(依錯誤碼排序;最低錯誤碼的嚴重性最高)
  2. 未修正的訊息
  3. 監視事件(依錯誤碼排序;最低錯誤碼的嚴重性最高)
  4. 已到期的事件
  5. 已修正的警示和訊息
-filtervalue?
(選用)顯示 -filtervalue attribute=value 參數的有效過濾器屬性清單:
  • copy_id
  • error_code
  • event_count
  • event_id
  • fixed
  • last_timestamp
  • object_id
  • object_name
  • object_type
  • report_node
  • reporting_node_name
  • root_sequence_number
  • sequence_number status
sequence_number
(選用)指出指令是否必須顯示事件的完整視圖。

說明

這個指令會顯示系統事件日誌的簡要視圖,或是日誌中某個項目的詳細視圖。您可以依嚴重性或經歷時間來排序事件和項目。

所包含事件的預設值為:
  • alert=yes
  • expired=no
  • fixed=no
  • message=yes
  • monitoring=no
表 1 提供了可顯示為輸出視圖資料的屬性值。
表 1. lseventlog 輸出
屬性 說明
machine_type 指出節點機型和型號。 該值為英數字串(最多包含 7 個字元)。
序號 指出節點序號。 該值為英數字串(最多包含 7 個字元)。
sequence_number 指示事件的序號。 該值為 08000000 之間的數字。
first_timestamp 指示事件新增至日誌的時間。 該值的格式為 YYMMDDHHMMSS
first_timestamp_epoch 指示新紀元發生之後事件新增至日誌的時間(以秒為單位)。 該值為 32 位元數值。
last_timestamp 指示事件的最近更新時間。 該值的格式為 YYMMDDHHMMSS
last_timestamp_epoch 指示新紀元之後事件的最近更新時間(以秒為單位)。 該值為 32 位元數值。
fixed_timestamp 指示修正事件時的時間戳記。 該值的格式為 YYMMDDHHMMSS
fixed_timestamp_epoch 指示新紀元發生之後修正事件時的時間戳記(以秒為單位)。 該值為數值字串。
fru 指示錯誤或事件的現場可更換單元 (FRU);該欄位包含可能的 FRU(以逗點區隔)。 該值為 ASCII 字串(最多包含 255 個字元)。
object_type 指示記載事件時針對的物件類型。 值如下:
  • mdisk
  • mdiskgrp
  • volume(或 volume copy)
  • node
  • host
  • io_grp (iogroup in dumperrlog)
  • fc_consist_grp (fcgrpin dumperrlog)
  • rc_consist_grp(rcgrp in dumperrlog)
  • fc_map (fcmap in dumperrlog; flash in caterrlog)
  • rc_relationship (rcmapin dumperrlog; remote in caterrlog)
  • cluster
  • controller (devicein caterrlogand dumperrlog)
  • quorum
  • migrate
  • email_server (emailserver in caterrlogand dumperrlog)
  • enclosure
  • drive
object_id 指示記載事件時針對的物件 ID。 該值為 64 位元數值。對於非叢集系統的所有其他物件類型,會以十進位顯示該值。

對於叢集系統,此值為十六進位,但如果是 cluster 物件類型的事件,則此值為空白。

object_name 指示記載事件時針對的物件名稱。 該值為物件名稱格式;如果物件被刪除或不具有名稱,則該值為空白。
copy_id 指示記載事件時針對的磁區副本 ID。 該值為 01 的數值;如果不是 vdiskcopy 事件,則該值為空白。
reporting_node_id 指示報告事件的節點的 ID。 該值為 64 位元數值,如果事件由叢集系統報告,則該值為空白。
reporting_node_name 指示報告事件的節點的名稱。 該值為物件名稱格式;如果節點被刪除或事件是由叢集系統報告,則該值為空白。
root_sequence_number 指示根源或因果事件的序號
重要: 如果事件由另一個事件直接引起,則這裡將顯示相關事件的 sequence_number。
該值為 18000000 之間的數值;如果沒有主要原因或者事件不是由其他事件直接引起,則該值為空白。
event_count 指示已與此事件結合的已報告事件的數量 該值為 32 位元數值。
狀態 指示事件種類。 值如下:
  • alert
  • message
  • monitoring
  • expired
fixed 指示事件是標示為 fixed(針對警示)還是 read(針對訊息)。 值如下:
  • yes
  • no(針對無法修正或未修正的事件)
auto_fixed 指示事件是否標示為由程式碼修正。 值如下:
  • yes
  • no(針對無法修正或未修正的事件)
notification_type 指示事件通知的類型。 值如下:
  • error
  • warning
  • informational
  • none
event_id 指示事件 ID。 該值為 6 位數值。
event_id_text 指示與事件 ID 相關聯的說明。 該值為最多 200 個位元組的文字值。

會以 CLI 所要求的語言顯示。

error_code 指示與此事件相關聯的錯誤碼。 該值為 4 位數值;如果沒有錯誤碼,則該值為空白。
error_code_text 指示與錯誤碼相關聯的說明。 該值為最多 200 個位元組的文字值,如果沒有錯誤碼,則該值為空白。

該值會以 CLI 所要求的語言顯示。

description 指示與事件相關聯的說明。

如果事件有錯誤碼,則該值與 error_code_text 欄位相同;否則,它與 event_id_text 欄位相同

文字(最多 200 個位元組)。
sense1 指出 16 個位元組的十六進位編碼感應資料;最低有效位元組位於左側。 該值是 16 個二字元十六進位數字,以空格區隔。
sense2
sense3
sense4
sense5
sense6
sense7
sense8

呼叫範例

下例顯示 2010 年 1 月的事件:
lseventlog -filtervalue 'last_timestamp>=100101000000:last_timestamp<100201000000'
下例顯示所有未修正的 1065 錯誤,依發生時間排序:
lseventlog -filtervalue error_code=1065:fixed=no
下例列出最嚴重的事件:
lseventlog -order severity -count 1
下例顯示簡要視圖:
lseventlog  
sequence_number:last_timestamp:object_type:object_id:object_name:copy_id:status:fixed:event_id:error_code:description

400:100106132413:vdisk:2:my_vdisk:1:alert:no:060001:1865:Space Efficient Virtual Disk Copy offline due to insufficient space
401:100106140000:cluster::ldcluster-2::message:no:981001::Cluster Fabric View updated by fabric discovery
此範例顯示完整視圖:
lseventlog 120


sequence_number 120
first_timestamp 111130100419
first_timestamp_epoch 1322647459
last_timestamp 111130100419
last_timestamp_epoch 1322647459
object_type node
object_id 1
object_name node1
copy_id 
reporting_node_id 1
reporting_node_name node1
root_sequence_number 
event_count 1
status alert
fixed yes
auto_fixed no
notification_type error
event_id 073003
event_id_text More/Less fibre channel ports operational
error_code 1060
error_code_text Fibre Channel ports not operational
machine_type 21458F4
serial_number 75BZPMA
fru none
fixed_timestamp 111202141004
fixed_timestamp_epoch 1322835004


sense1 03 03 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
sense2 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
sense3 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
sense4 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
sense5 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
sense6 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
sense7 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
sense8 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00