JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス
形式
イベント条件 : 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 イベントID B.ID
- 一致する
- 一致しない
- 複数指定できる。複数指定では最大100件指定できる。
- イベントIDの大文字,小文字は区別しない。
- 指定できる範囲は0〜7FFFFFFFである。
2 登録要因 B.REASON
- 一致する
- 一致しない
- 複数指定できる。複数指定では最大100件指定できる。
- 指定できる範囲は,-2,147,483,648〜2,147,483,647である。
3 発行元プロセスID B.PROCESSID 4 発行元ユーザーID B.USERID 5 発行元グループID B.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
All Rights Reserved. Copyright (C) 2009, 2011, Hitachi, Ltd.