11.5.2 エージェントホスト停止時に影響のある実行エージェントを確認する
この項では,エージェントホスト停止時に影響のある実行エージェントを確認する提案テンプレートについて説明します。
この提案テンプレートの対処アクションを実行すると,JP1/AJS3 - Agentがインストールされているエージェントホストが停止した場合に,影響のある実行エージェント一覧を表示するJP1/IM2の画面に自動的に移動します。
- 〈この項の構成〉
(1) 前提条件
エージェントホスト停止時に影響のある実行エージェントを確認する提案テンプレートを使用する場合は,次の前提条件を満たしていることを確認してください。
-
JP1/AJS3 - ManagerおよびJP1/AJS3 - Web Consoleのバージョンが12-50以降であること。
-
JP1/AJS3 - AgentがインストールされているホストをJP1/PFMのヘルスチェック機能を使用して監視していること。
-
JP1/IM2およびJP1/PFM - Managerのバージョンが12-50以降であること。
-
JP1/IM2がJP1/AJS3およびJP1/PFMからシステム構成情報を取得できていること。
JP1/IM2とJP1/AJS3が連携するための設定については,「11.3 JP1/IM2連携時のセットアップ」を参照してください。
また,JP1/IM2とJP1/PFMが連携するための設定については,マニュアル「JP1/Performance Management 運用ガイド」を参照してください。JP1/PFMのヘルスチェック機能の詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」を参照してください。
(2) 提案テンプレート
提案テンプレートのファイル名称,概要および記述例を次に示します。
- ファイル名称
-
- JP1/IM2が日本語版の場合
-
imdd_suggestion_ajs_check_failed_agent_list_ja.conf
- JP1/IM2が英語版の場合
-
imdd_suggestion_ajs_check_failed_agent_list_en.conf
提案テンプレートの格納先については,マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」を参照してください。
- 概要
-
この提案テンプレートの概要を次の表に示します。
項番
項目
概要
1
提案情報を表示するノード
Management ApplicationsカテゴリのJP1/PFM監視エージェントを示すノード
2
提案情報を表示するJP1権限
JP1_JPQ_User以上かつJP1_PFM_Operator以上
3
提案活性条件
-
停止したホストをジョブの実行先として使用している
-
JP1/PFMがホスト停止を検知していて,JP1/IM2上では未対処になっている
-
JP1/PFMから停止したホストの情報が取得できている
-
条件判定時点において対象ホストがホスト停止状態から復旧していない
4
対処アクション
JP1/AJS3 - Web Consoleに移動し,実行エージェントタブで停止したホストを実行先ホストとする実行エージェントを表示する
-
この提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて,JP1/IM2上では未対処になっている」では,JP1/PFMの発行するJP1イベントが次に示す条件の重要イベントとしてJP1/IM2に登録されているかを判定します。
項番 |
JP1イベントの属性 |
値 |
---|---|---|
1 |
イベントID |
4860 |
2 |
メッセージ |
文字列(hcsstatus=Host Not Available)が含まれる |
3 |
重大度 |
エラー |
4 |
対処状況 |
未対処 |
- 注意事項
-
-
JP1/IM2でJP1イベントの重大度や重要イベント定義を変更している場合
JP1/IM2の次の機能を使用しているときは,エージェントホストが停止した際にこの提案テンプレートによる対処アクションが提案されません。
・重大度変更機能
・重要イベント定義機能
・重要イベント解除機能
・重要イベント削除機能
提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて,JP1/IM2上では未対処となっている」を,監視しているJP1イベントの重大度や重要イベント定義に合わせてカスタマイズしてください。
-
JP1/PFMで発行するJP1イベントの重大度を変更している場合
ヘルスチェックの状態が「Host Not Available」のときに発行するJP1イベントの重大度を,デフォルト(エラー)から変更している場合,エージェントホストが停止した際にこの提案テンプレートによる対処アクションが提案されません。提案テンプレートの提案活性条件「JP1/PFMがホスト停止を検知していて,JP1/IM2上では未対処となっている」を,監視しているJP1イベントの重大度に合わせてカスタマイズしてください。
-
- 記述例
{ "meta":{ "version":"1" }, "suggestions":[ { "suggestionId":"jp1_ajs_check_failed_agent_list", "label":"影響のある実行エージェントを確認する", "node":"_CATEGORY_m.*_OBJECT_JP1PFM-A([^1478]|[1478].*%5B([^%]*%5D|(.|..|[^A]..|.[^l].|..[^l]|.{4,})%40))", "permissions":[ ["JP1_PFM_Admin","JP1_JPQ_User"], ["JP1_PFM_Admin","JP1_JPQ_Operator"], ["JP1_PFM_Admin","JP1_JPQ_Admin"], ["JP1_PFM_Operator","JP1_JPQ_User"], ["JP1_PFM_Operator","JP1_JPQ_Operator"], ["JP1_PFM_Operator","JP1_JPQ_Admin"] ], "cases":[ [ { "type":"struct", "key":{ "idType":"target", "sid":"${../../_OBJECT_JP1AJSAGT/<managerAgent:target:sid:}" }, "ope":"EXIST", "val":true, "description":"停止したホストをジョブの実行先として使用している" }, { "type":"event", "key":{ "statusFilter":[30], "sid":"${.:tree:sid:}", "B.ID":["00004860"], "REGEX_B.MESSAGE":"KAVL15022-E.*hcsstatus=Host Not Available", "E.@JP1IM_DEALT":[0] }, "ope":"EXIST", "val":true, "description":"JP1/PFMがホスト停止を検知していて,JP1/IM2上では未対処となっている" }, { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetAgentAllInformation", "args":{} }, "ope":"NOTIN", "val":"", "description":"JP1/PFMから停止したホストの情報が取得できている" }, { "type":"plugin", "key":{ "sid":"${.:tree:sid:}", "method":"jp1pfmSuggestionGetAgentInformation", "args":{ "allInformation":"${:plugin[1]::}", "member":"healthDetail" } }, "ope":"IN", "val":"Host Not Available", "description":"条件判定時点において対象ホストがホスト停止状態から復旧していない" } ] ], "action":{ "type":"jump", "params":{ "url":"http://(サーバ名):(ポート番号)/ajs/login.html?jt=${:user:jp1Token:URLENC}&manager=${../../_OBJECT_JP1AJSAGT/<managerAgent/../..:tree:value.label:URLENC}&type=agent&agentHost=${../../../:tree:value.label:URLENC}&eou=1", "target":"_blank" }, "description":"JP1/AJS3 - Web Consoleに移動し,実行エージェントタブで停止したホストを実行先ホストとする実行エージェントを表示する" } } ] }
提案テンプレートの各項目の詳細については,マニュアル「JP1/Integrated Management 2 - Manager コマンド・定義ファイル・APIリファレンス」の提案定義ファイルについての記載を参照してください。
(3) 適用する手順
提案テンプレートをJP1/IM2に適用する手順を次に示します。
-
JP1/IM2マネージャーホストで,提案テンプレートをJP1/IM2マネージャーホスト上の任意のフォルダにコピーする。
-
コピーした提案テンプレートをテキストエディターで開き,対処アクションの次の項目を編集する。
urlキーに指定するJP1/AJS3 - Web Consoleのサーバ名およびポート番号を,環境に合わせて変更してください。
"url":"http://Web Console サーバのホスト名またはIP アドレス:ポート番号/ajs/login.html",
-
JP1/IM2マネージャーホストでjddupdatesuggestionコマンドを使用し,引数で提案テンプレートをコピーしたフォルダのパスを指定する。
(4) カスタマイズする手順
この提案テンプレートでは,エージェントホスト停止の監視をJP1/PFM以外の監視製品に置き換えできます。ただし,エージェントホスト停止を監視する仕様は,置き換えた監視製品の仕様に従います。エージェントホスト停止の監視をJP1/PFM以外の監視製品に置き換える場合は,提案テンプレートの次の項目を使用する監視製品に合わせて変更します。
-
提案情報を表示するノード
-
提案情報を表示するJP1権限
-
提案活性条件のうちの次の三つの条件
-
JP1/PFMがホスト停止を検知し,かつJP1/IM2では未対処になっている。
-
JP1/PFMから停止したホストの情報が取得できている。
-
条件判定時点において対象ホストがホスト停止状態から復旧していない。
-
また,変更した提案情報を表示するノードを起点とした相対パスになるように,次に示す変数を変更します。
項番 |
項目 |
説明 |
変数 |
---|---|---|---|
1 |
接続先JP1/AJS3 - Managerノード |
停止したホストのJP1/AJS3 - AgentノードとmanagerAgent関連でつながっているJP1/AJS3 - Managerノードを示します。提案情報を表示するノードからの相対パスで指定します。 |
${../../_OBJECT_JP1AJSAGT/<managerAgent:target:sid:} |
2 |
接続先JP1/AJS3 - Managerのホスト名 |
停止したホストのJP1/AJS3 - AgentノードとmanagerAgent関連でつながっているJP1/AJS3 - Managerのラベル名を示します。提案情報を表示するノードからの相対パスで指定します。 |
${../../_OBJECT_JP1AJSAGT/<managerAgent/../..:tree:value.label:URLENC} |
3 |
停止したホストのホスト名 |
停止したホストのノードのラベル名を示します。提案情報を表示するノードからの相対パスで指定します。 |
${../../../:tree:value.label:URLENC} |
提案テンプレートをカスタマイズする手順を次に示します。
-
JP1/IM2マネージャーホストで,提案テンプレートをJP1/IM2マネージャーホスト上の任意のフォルダにコピーする。
-
コピーした提案テンプレートの名称を変更する。
コピーした提案テンプレートの名称を「imdd_suggestion_任意のファイル名.conf」に変更します。
-
コピーした提案テンプレートをテキストエディターで開く。
-
対処アクションの次の項目を編集する。
urlキーに指定しているJP1/AJS3 - Web Consoleのサーバ名およびポート番号を,環境に合わせて変更してください。
"url":"http://Web Console サーバのホスト名またはIP アドレス:ポート番号/ajs/login.html",
-
カスタマイズする項目を編集する。
-
JP1/IM2マネージャーホストでjddupdatesuggestionコマンドを使用し,引数で提案テンプレートをコピーしたフォルダのパスを指定する。
- 注意事項
-
提案テンプレートは,BOMのないUTF-8形式で保存してください。