提案定義ファイル(imdd_suggestion_任意の文字列.conf)の記述例
提案定義ファイル(提案テンプレート)に設定する提案活性条件と対処アクションの記述例を,次に示します。
- 〈このページの構成〉
CPU使用率が高騰したときに,原因のプロセスを特定するレポートを表示する場合の記述例
PFM - Agent for Platform(Windows)のパフォーマンスデータに対応するIM管理ノードで,CPU使用率が高騰しているときに,原因のプロセスを特定するレポートを表示する場合の記述例です。
■前提条件
-
PFM - Agent for Platform(Windows)のエージェントで,CPU使用率を監視する次のアラームをバインドしている。
アラームテーブル名:Windows Template Alarms [CPU] 09.00
アラーム名:CPU Usage
-
原因のプロセスを特定するレポートとして,次のレポートを表示する。
レポート名:/Windows/Operating System/Troubleshooting/Real-Time/CPU Usage - Top 10 Processes
レポートID:ac102ccb:1daa55:ebc5900de6:-79be
■提案活性条件と対処アクションの記述例
"suggestions":[ { "suggestionId":"jp1_pfm_display_report_for_Windows", "label":"CPU使用率高騰時に原因のプロセスを特定するレポートを表示する", "node":"_CATEGORY_[^m].*_OBJECT_JP1PFM-AT", "permissions":[ ["JP1_PFM_Operator"], ["JP1_PFM_Admin"] ], "cases":[ [ { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetAllAlarmStatuses", "args":{} }, "ope":"NOTIN", "val":"", "description":"全アラームの状態の取得が成功" }, { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetAlarmStatus", "args":{ "allAlarmStatuses":"${:plugin[1]::}", "alarmTableName":"Windows Template Alarms [CPU] 09.00", "alarmName":"CPU Usage" } }, "ope":"REGEX", "val":"Exception|Warning", "description":"CPU使用率を監視しているアラームの状態が警告または異常" }, { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionCreateReportURL", "args":{ "reportId":"ac102ccb:1daa55:ebc5900de6:-79be" } }, "ope":"NOTIN", "val":"", "description":"レポートURL生成が成功" } ] ], "action":{ "type":"jump", "params":{ "url":"${:plugin[3]::}" }, "description":"CPU使用率が高いプロセスの上位10個をリアルタイムで表示する" } } ]
アラームまたはエージェントの状態が正常に回復したときに,イベントの対処状況を「対処済」に変更する場合の記述例
監視エージェントのパフォーマンスデータに対応するIM管理ノードで,アラームまたはエージェントの状態に関してJP1イベントが発行されたが,現在は状態が正常に回復していたときに,イベントの対処状況を「対処済」に変更する記述例です。
■前提条件
対処状況を「対処済」に変更するイベントは,現在時刻から過去24時間以内のイベントとする。
■提案活性条件と対処アクションの記述例
"suggestions":[ { "suggestionId":"jp1_pfm_set_status_of_events_to_processed", "label":"アラーム,エージェントの状態が回復した時にイベントを対処済みにする", "node":"(_CATEGORY_[^m].*_OBJECT_JP1PFM-A|_OBJECT_JP1PFM-A.*%5BAll%40|_OBJECT_JP1PFMMGR)", "permissions":[ ["JP1_PFM_Admin"] ], "cases":[ [ { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetPerformanceEvents", "args":{ "startTime":"${:time:-24.h.:}", "endTime":"${:time::}" } }, "ope":"NOTIN", "val":"[]", "description":"過去24時間以内に対処状況が「未対処」であり,重要イベントであるアラームイベント,エージェントの状態変更イベントが存在" }, { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetAllAlarmStatuses", "args":{} }, "ope":"NOTIN", "val":"", "description":"全アラームの状態の取得が成功" }, { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetCurrentlyNormalEvents", "args":{ "events":"${:plugin[1]::}", "allAlarmStatuses":"${:plugin[2]::}" } }, "ope":"NOTIN", "val":"[]", "description":"現在の状態が正常なアラームまたはエージェントが存在(対処済みにできるイベントが存在)" } ] ], "action":{ "type":"plugin", "params":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionSetStatusOfEventsToProcessed", "args":{ "eventSids":"${:plugin[3]::}" } }, "description":"現在の状態が正常なアラームまたはエージェントのイベントの対処状況を「対処済」にする" } } ]
ホストをメンテナンスしているときに,監視を一時停止する場合の記述例
Performance Managementの監視ホストに対応するIM管理ノードで,現在時刻から過去1時間以内に,ホスト停止を示すPerformance Managementのヘルスチェックイベントが2個以上発行されているとき,または現在時刻から過去30分間以内に重大度がエラーであるPerformance Managementのアラームのイベントが3個以上発行されているときに,そのホストの監視を一時停止する記述例です。
■提案活性条件と対処アクションの記述例
"suggestions":[ { "suggestionId":"jp1_pfm_suspend_monitoring_for_performance_node", "label":"ホストのメンテナンス時に監視を一時停止する", "node":"_CATEGORY_[^m].*_OBJECT_JP1PFM-A", "permissions":[ ["JP1_PFM_Admin"] ], "cases":[ [ { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetHostName", "args":{} }, "ope":"NOTIN", "val":"", "description":"ホスト名の取得に成功" }, { "type":"plugin", "key":{ "sid":"${../../..:tree:sid:}", "method":"jp1pfmSuggestionExecManagerCmd", "args":{ "commandName":"jpctool", "commandArgs":"monitor list -host ${.:plugin[1]::}", "lhostOption":true, "successfulReturn":[0] } }, "ope":"REGEX", "val":"\nH . Act", "description":"選択中のホストの監視状態が監視一時停止中でない" }, { "type":"eventCount", "key":{ "sid":"${./<sameNode:tree:sid:}", "statusFilter":[30], "B.TIME":["${:time:-60.m.:}","${:time::}"], "B.ID":["00004860"], "REGEX_B.MESSAGE":"KAVL15022-E.*hcsstatus=Host Not Available", "E.@JP1IM_DEALT":[0] }, "ope":"GT", "val":1, "description":"1時間以内にホスト停止イベントが2個以上発行されている" } ], [ { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetHostName", "args":{} }, "ope":"NOTIN", "val":"", "description":"ホスト名の取得に成功" }, { "type":"plugin", "key":{ "sid":"${../../..:tree:sid:}", "method":"jp1pfmSuggestionExecManagerCmd", "args":{ "commandName":"jpctool", "commandArgs":"monitor list -host ${.:plugin[1]::}", "lhostOption":true, "successfulReturn":[0] } }, "ope":"REGEX", "val":"\nH . Act", "description":"選択中のホストの監視状態が監視一時停止中でない" }, { "type":"eventCount", "key":{ "sid":"${.:tree:sid:}", "statusFilter":[30], "B.TIME":["${:time:-30.m.:}","${:time::}"], "B.ID":["00004840"], "E.SEVERITY":["Error"], "E.@JP1IM_DEALT":[0] }, "ope":"GT", "val":2, "description":"30分以内にアラームイベントが3個以上発行されている(JP1システムイベント)" } ], [ { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetHostName", "args":{} }, "ope":"NOTIN", "val":"", "description":"ホスト名の取得に成功" }, { "type":"plugin", "key":{ "sid":"${../../..:tree:sid:}", "method":"jp1pfmSuggestionExecManagerCmd", "args":{ "commandName":"jpctool", "commandArgs":"monitor list -host ${.:plugin[1]::}", "lhostOption":true, "successfulReturn":[0] } }, "ope":"REGEX", "val":"\nH . Act", "description":"選択中のホストの監視状態が監視一時停止中でない" }, { "type":"eventCount", "key":{ "sid":"${.:tree:sid:}", "statusFilter":[30], "B.TIME":["${:time:-30.m.:}","${:time::}"], "E.PRODUCT_NAME":["/PFM/ALARM_EVENT"], "E.SEVERITY":["Error"], "E.@JP1IM_DEALT":[0] }, "ope":"GT", "val":2, "description":"30分以内にアラームイベントが3個以上発行されている(JP1ユーザーイベント)" } ] ], "action":{ "type":"plugin", "params":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionExecManagerCmd", "args":{ "commandName":"jpctool", "commandArgs":"monitor suspend -host ${.:plugin[1]::} -noquery", "lhostOption":true, "successfulReturn":[0,23] } }, "description":"監視を一時停止する" } } ]