提案定義ファイル（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":"監視を一時停止する"
}
}
]