イベントレポート出力のフィルターファイル

形式

イベント条件
   :
OR
イベント条件
   :
EXCLUDE
イベント条件
   :

ファイル

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

イベントレポート出力時のフィルター条件を指定する定義ファイルです。-fオプションを指定してjcoevtreportコマンドを実行すると読み込まれます。

このファイルの最大サイズは,256キロバイト(262,144バイト)です。

定義の反映時期

-fオプションを指定してjcoevtreportコマンドを実行すると,指定した項目ファイルを読み込み,指定された条件と一致するJP1イベントを統合監視DBから取得してイベントレポート出力します。

ファイル内容

通過条件群,除外条件群
jcoevtreportコマンドは,すべての除外条件群に一致しないJP1イベント,かつ,通過条件群のどれか一つが一致するJP1イベントを出力対象のJP1イベントと判断します。フィルター条件には,0~5件の通過条件群と0~5件の除外条件群を記述できます。
通過条件群または除外条件群には,0~50件のイベント条件を指定できます。ただし,拡張属性(固有情報)のイベント条件は,一つの通過条件群または除外条件群に最大5件指定できます。
OR
条件群を複数指定する場合は,各条件群の間に「OR」を記述します。
EXCLUDE
通過条件群と除外条件群の間には,「EXCLUDE」を記述します。「EXCLUDE」以降のイベント条件は,除外条件群と見なします。「EXCLUDE」以降にイベント条件がない場合は,通過条件群だけが有効になります。
イベント条件
イベント条件は,次の形式で指定します。

 属性名 比較キーワード オペランド [ オペランド]…

なお,半角スペース,または,タブだけで構成された行は,無視して処理を続行します。
属性名
属性名には,比較したい属性の名称を記述します。基本属性を指定する場合は,名称の前に「B.」を付けます。拡張属性(共通情報),拡張属性(固有情報)を指定する場合は,名称の前に「E.」を付けます。英小文字と英大文字を区別します。
比較キーワード
比較キーワードには,「BEGIN(から始まる)」,「IN(と一致する)」,「NOTIN(と一致しない)」,「SUBSTR(を含む)」,「NOTSUBSTR(を含まない)」,「REGEX(正規表現)」のどれか一つを指定できます。英小文字と英大文字を区別します。
オペランド
比較キーワードで属性値と比較する値を文字列で指定します。英小文字と英大文字を区別します。
オペランドを複数指定する場合は,一つ以上の連続した半角スペースまたはタブをオペランドとオペランドの間に挿入して区切ります。オペランドとオペランドは,OR条件となります。ただし,比較キーワードに正規表現を指定している場合は,複数指定できません。
オペランドに,半角スペース,タブ,改行コード(CR,LF)および%を指定したい場合,次のように記述します。
項番指定したい値指定方法
1タブ(0x09)%09
2半角スペース(0x20)%20
3%(0x25)%25
4改行コード LF(0x0a)%0a
5改行コード CR(0x0d)%0d
定義フォーマットの上限チェックの場合,%20,%25は1文字として扱います。複数選択した場合の定義例「IDが100と200に一致する」を示します。

B.ID△IN△100△200

(凡例) △:半角スペース(0x20)

オペランドは,イベント条件1件当たり4,096バイトまで,イベント条件ブロック1件当たり4,096バイト(イベント条件ブロックに記述したオペランドの合計バイト数)まで指定できます。
イベント条件で指定できる属性名,比較キーワードおよびオペランドについて次の表に示します。
項番項目属性名比較キーワードオペランド
1イベントIDB.ID
  • 一致する
  • 一致しない
  • 複数指定できる。複数指定では最大100件指定できる。
  • イベントIDの大文字,小文字は区別しない。
  • 指定できる範囲は0~7FFFFFFFである。
2登録要因B.REASON
  • 一致する
  • 一致しない
  • 複数指定できる。複数指定では最大100件指定できる。
  • 指定できる範囲は,-2,147,483,648~2,147,483,647である。
3発行元プロセスIDB.PROCESSID
4発行元ユーザーIDB.USERID
5発行元グループIDB.GROUPID
  • から始まる
  • 一致する
  • 一致しない
  • を含む
  • を含まない
  • 正規表現
  • 複数指定できる。複数指定では最大100件指定できる。ただし,正規表現では複数指定はできない。
6発行元ユーザー名B.USERNAME
7発行元グループ名B.GROUPNAME
8発行元イべントサーバ名B.SOURCESERVER
9送信先イベントサーバ名B.DESTSERVER
10メッセージB.MESSAGE
11重大度E.SEVERITY一致する
  • "Emergency"(緊急),"Alert"(警戒),"Critical"(致命的),"Error"(エラー),"Warning"(警告),"Notice"(通知),"Information"(情報),"Debug"(デバッグ)の中から指定できる。
  • 複数指定できる。ただし,重複した重大度は指定できない。
12拡張属性E.拡張属性名
  • から始まる
  • 一致する
  • 一致しない
  • を含む
  • を含まない
  • 正規表現
  • 拡張属性名には,先頭が英大文字で英大文字,数字,およびアンダーバー(_)から構成される32バイトまでの名称を設定できる。
  • 複数指定できる。複数指定では最大100件指定できる。ただし,正規表現では複数指定はできない。
13アクション種別E.@JP1IM_ACTTYPE
  • 一致する
  • 一致しない
  • 次の数値を指定できる。
    0(アクション対象外)
    1(コマンド)
    2(ルール)
    3(コマンド,ルール)
  • 複数指定できる。
14アクション抑止E.@JP1IM_ACTCONTROL
  • 次の数値を指定できる。
    0(アクション対象外)
    1(実行)
    2(抑止)
    3(一部抑止)
  • 複数指定できる。
15重要イベントE.@JP1IM_SEVERE
  • 次の数値を指定できる。
    0(重要イベントではない)
    1(重要イベント)
  • 複数指定できる。
16相関イベントE.@JP1IM_CORRELATE
  • 次の数値を指定できる。
    0(相関イベントではない)
    1(相関成立イベント)
    2(相関不成立イベント)
  • 複数指定できる。
17応答待ちイベントE.@JP1IM_RESPONSE
  • 次の数値を指定できる。
    0(応答待ちイベントではない)
    1(応答待ちイベント)
  • 複数指定できる。
18重大度(変更前)E.@JP1IM_ORIGINAL_SEVERITY
  • から始まる
  • 一致する
  • 一致しない
  • を含む
  • を含まない
  • 正規表現
  • 複数指定できる。複数指定では最大100件指定できる。ただし,正規表現では複数指定はできない。
19重大度変更E.@JP1IM_CHANGE_SEVERITY
  • 一致する
  • 一致しない
  • 次の数値を指定できる。
    0(重大度変更なし)
    1(重大度変更あり)
  • 複数指定できる。
20対処状況E.@JP1IM_DEALT
  • 次の数値を指定できる。
    0(未対処)
    1(対処済)
    2(処理中)
    3(保留)
  • 複数指定できる。
21重要イベント解除E.@JP1IM_RELEASE
  • 次の数値を指定できる。
    0(重要イベントを解除していない)
    1(重要イベントを解除している)
  • 複数指定できる。
22重要イベント削除E.@JP1IM_DISMISSED
  • 次の数値を指定できる。
    0(重要イベントを削除していない)
    1(重要イベントを削除している)
  • 複数指定できる。
23メモE.@JP1IM_MEMO
  • から始まる
  • 一致する
  • 一致しない
  • を含む
  • を含まない
  • 正規表現
  • 複数指定できる。
    複数指定では最大100件指定できる。ただし,正規表現では複数指定はできない。
注※
統合監視DBおよびIM構成管理DBが有効な場合に,比較キーワードが,「と一致する」「と一致しない」のとき,パス表記で業務グループ名を指定できます。
統合監視DBおよびIM構成管理DBが無効な場合,および[と一致する][と一致しない]以外を選択した場合,パス表記で業務グループ名を指定しても,ホスト名として扱われます。
jcoimdefコマンドの-ignorecasehostオプションの指定を「ON」にしている場合に,比較キーワードで[正規表現]以外を選択すると,文字列の英大文字・小文字を区別しません。

定義例

B.ID IN 1
B.MESSAGE SUBSTR 警告
B.SOURCESERVER IN host1 host2 host3 host4
OR
B.ID IN 1
B.MESSAGE SUBSTR エラー
B.SOURCESERVER IN host1 host2 host3 host4
EXCLUDE
B.SOURCESERVER IN host3