12.3.2　JP1/IMと連携するためのセットアップ（Performance Managementで発生したイベントをJP1/IMで監視するための設定）

(1)　JP1イベントの発行を設定する

設定方法を次に示します。

1. 監視コンソールのWebブラウザからPFM - Web Consoleにログインする。

   管理ユーザー権限を持つユーザーアカウントでログインします。

   ［サービス階層］画面での操作には，管理ユーザー権限が必要です。

2. ［メイン］画面のナビゲーションフレームで，［サービス階層］タブを選択する。

3. ［サービス階層］画面のナビゲーションフレームで，設定するサービスを選択する。

   選択したサービスにチェックマークが表示されます。

4. 発行したいJP1イベントに応じて，プロパティの値を設定します。

   発行したいJP1イベントと対象サービスごとの設定個所を次の表に示します。

   表12‒10　発行したいJP1イベントと対象サービスごとの設定個所

   発行したいイベント	イベント発行対象となるサービス	設定個所（サービスのプロパティ）	設定手順の参照先
   PFMサービスの状態変更，運用に関するイベント （JP1システムイベントのイベントID：00004800〜00004830）	PFM - Managerサービス Name Server Master Manager Master Store Correlator Trap Generator View Server	Master Managerの［JP1 Event Configurations］ノード	12.3.2(1)(a)
   	PFM - AgentおよびPFM - RMサービス Agent CollectorまたはRemote Monitor Collector Agent StoreまたはRemote Monitor Store マルチインスタンスエージェントの場合，インスタンスごとに適用されます。	Agent CollectorまたはRemote Monitor Collectorの［JP1 Event Configurations］ノード
   	Status Serverサービス※2 Status Server	Master Manager，Agent Collector，Remote Monitor Collector，またはAction Handlerの［JP1 Event Configurations］ノード※1
   	Action Handlerサービス Action Handler
   エージェントの状態変更に関するイベント （JP1システムイベントのイベントID：00004850）※3	PFM - AgentおよびPFM - RMサービス Agent CollectorまたはRemote Monitor Collector Agent StoreまたはRemote Monitor Store マルチインスタンスエージェントの場合，インスタンスごとに適用されます。	Agent CollectorまたはRemote Monitor Collectorの［JP1 Event Configurations］ノード
   アラームイベント（アラームのJP1システムイベント発行） （JP1システムイベントのイベントID：00004840）	−	アラームでアクション実行に指定したAction Handlerサービスがあるホストの，Master Manager，Agent Collector，Remote Monitor Collector，またはAction Handlerの［JP1 Event Configurations］−［Alarm］ノード	12.3.2(1)(b)
   監視の一時停止または再開に関するイベント （JP1システムイベントのイベントID：00004870，00004871，00004880，00004881）	−	Master Managerの［JP1 Event Configurations］−［System］ノード	12.3.2(1)(c)
   ヘルスチェックの状態変更に関するイベント （JP1システムイベントのイベントID：00004860）	−	ヘルスチェックAgent Collectorの［Health Check Configurations］ノード	12.3.2(1)(d)

   （凡例）

   −：該当なし

   注※1

   同一ホスト上のすべての設定個所で同じ設定値を共有します。

   注※2

   論理ホスト上のサービスにはStatus Serverサービスは表示されません。

   注※3

   JP1/IM2と連携する場合，PFM - AgentおよびPFM - RMホストにJP1/Baseがインストールされていないときは，JP1/IM2連携コマンド（jpcconf im2コマンド）でエージェントステータス変更イベントの一括発行機能を有効に設定して，このJP1システムイベントの発行を有効にしてください。

   PFM - AgentおよびPFM - RMホストにJP1/Baseがインストールされているときは，手順4の方法でもこのJP1システムイベントの発行を有効にできます。なお，両方の方法で重複して設定しないようにしてください。

   PFM - AgentおよびPFM - RMホストにJP1/Baseがインストールされているかどうかに対するエージェントステータス変更イベントの一括発行機能の推奨設定を次の表に示します。

   表12‒11　エージェントステータス変更イベントの一括発行機能の推奨設定

   Agent CollectorおよびRemote Monitor CollectorサービスのJP1イベント発行の設定	エージェントステータス変更イベントの一括発行機能の推奨設定
   すべてのサービスがJP1イベントを発行しない	有効
   すべてのサービスがJP1イベントを発行する	無効

   注

   Agent CollectorおよびRemote Monitor CollectorサービスのJP1イベント発行の設定とエージェントステータス変更イベントの一括発行機能の設定がどちらも有効の場合，エージェントの状態変更を通知するJP1イベントが2つ発行されます。そのため，一部のAgent CollectorおよびRemote Monitor CollectorサービスのJP1イベント発行の設定が有効になっているときは，システム内のAgent CollectorおよびRemote Monitor CollectorサービスのJP1イベント発行の設定が，上記の表のどちらかの設定になるように統一してください。

5. JP1/IM2と連携する場合は，JP1/IM2連携コマンド（jpcconf im2コマンド）を実行して，JP1/IM2連携機能を有効に設定します。

   JP1/IM2連携コマンドの実行手順については，「12.3.2(7)　JP1/IM2と連携するための設定」を参照してください。

ページの先頭へ

(2)　JP1システムイベントのオプション設定をする

1. 監視コンソールのWebブラウザからPFM - Web Consoleにログインする。

   管理ユーザー権限を持つユーザーアカウントでログインします。

   ［サービス階層］画面での操作には，管理ユーザー権限が必要です。

2. ［メイン］画面のナビゲーションフレームで，［サービス階層］タブを選択する。

3. Master Manager，Agent Collector，Remote Monitor Collector，またはAction Handlerのどれかで［JP1 Event Configurations］ノードを選択する。

   Master Manager，Agent Collector，Remote Monitor Collector，およびAction Handlerは，同一ホスト上のすべての設定個所で同じ設定値を共有します。

   ［JP1 Event Send Host］

   JP1/Baseの接続先イベントサーバ名を，255バイト以内の半角英数字で指定します。JP1イベントを発行するPFMサービスと同一マシンの論理ホストまたは物理ホストで動作している，イベントサーバだけを指定できます。IPアドレスでは指定できません。なお，指定した値の先頭と末尾の空白は無視されます。

   範囲外の値が指定された場合，または値が指定されていない場合は，物理ホストがイベント発行元ホストとして設定されます。

   デフォルト値は空白です。

   論理ホストを設定した場合で，ヘルスチェックの状態変更に関わるイベント（JP1システムイベントのイベントID：00004860）を設定しているときは，ヘルスチェックAgent Collectorサービスの「Health Check Configurations」ノードのプロパティを，次のとおり設定してください。

   ［JP1 Event - Send Host Mode］：JP1 Event Send Host Value

   ［Monitoring Console Host］

   JP1/IM - Managerのモニター起動でPFM - Web Consoleを起動する場合，起動させたいPFM - Web Consoleのホスト名を指定します。JP1/IM2と連携する場合も，PFM - Managerホストのこのプロパティを指定する必要があります。

   255バイト以内の半角英数字で指定します。IPアドレスでは指定できません。なお，指定した値の先頭と末尾の空白は無視されます。

   範囲外の値が指定された場合，または値が指定されていない場合は，PFM - Agentの接続先PFM - Managerのホスト名が設定されます。

   デフォルト値は空白です。

   ［Monitoring Console Port］

   起動するPFM - Web Consoleのポート番号（httpリクエストポート番号）を指定します。JP1/IM2と連携する場合も，PFM - Managerホストのこのプロパティを指定する必要があります。

   指定が省略された場合は，20358が設定されます。

   デフォルト値は空白です。

   ［Monitoring Console Https］

   JP1/IM - Managerのモニター起動でPFM - Web Consoleを起動する場合，PFM - Web Consoleにhttpsを使用した暗号化通信で接続するかどうかを指定します。JP1/IM2と連携する場合も，PFM - Managerホストのこのプロパティを指定する必要があります。

   デフォルト値は「No」です。

ページの先頭へ

(3)　アラームとJP1イベントおよびレポートを関連づける

PFM - Web Consoleの［アラーム階層］画面で次の項目を設定します。

• アクションとしてJP1イベントの発行を設定する

  アラームが発行されたときのアクションとして，JP1イベントを発行するように設定します。

• アラームとレポートを関連づける

  JP1/IMのイベントコンソールから，PFM - Web Consoleの画面でレポートを表示できるようにします。

アラーム定義の詳細については「6.　アラームによる稼働監視」を参照してください。

ここでは，主にJP1イベントを発行するように設定する操作，およびアラームとレポートを関連づける操作について説明します。

1. 管理ユーザー権限を持つユーザーアカウントでPFM - Web Consoleにログインする。

2. ［メイン］画面のナビゲーションフレームで［アラーム階層］タブを選択する。

3. ［アラーム階層］画面のナビゲーションフレームで，JP1イベントを発行させたいアラーム定義を選択する。

   選択したアラームにチェックマークが表示されます。

4. メソッドフレームで，［編集］メソッドを選択する。

5. インフォメーションフレームの［編集 > 基本情報］画面で［次へ >］ボタンをクリックする。

6. ［編集 > アクション］画面の［実行するアクション］を設定する。

   ［コマンド］のうち，JP1イベントを発行させたいアラームの状態（［異常］，［警告］，および［正常］）をチェックします。

7. ［表示するレポート］で［参照］ボタンをクリックし，アラームに関連づけるレポートを選択する。

   選択したレポートにチェックマークが表示されます。

8. ［完了］ボタンをクリックする。

9. ［次へ >］ボタンをクリックする。

10. ［編集 > アクション定義］画面の［コマンドの定義］エリアで［JP1イベント設定］ボタンをクリックする。

11. ［新規アラーム > アクション定義 > JP1 イベント設定］画面のイベントIDなどを設定する。

    例えば，次の条件でJP1イベントを発行したいとします。

    条件：

    • イベントIDを「001」とする

    • イベントメッセージを［新規アラームテーブル > 基本情報］ダイアログボックスの［メッセージテキスト］に設定したメッセージテキスト(%MTS)の内容とする

    • アラームの状態をJP1イベントの重大度に変換する

    この場合，次のように設定します。

    ［イベントID］：001

    ［メッセージ］：%MTS

    ［アラームレベルを重大度に変換する］：選択する

    注意

    JP1/IMの監視オブジェクトと連携する場合は，JP1イベントの属性を変更しないでください。

    JP1システムイベントの場合，［イベントID］で設定した情報はJP1イベントの拡張属性の識別イベントID（JPC_USER_EVENTID）として出力されます。JP1ユーザーイベントの場合，［イベントID］で設定した情報はJP1イベントの基本属性のイベントIDとして出力されます。

    JP1イベントの種類については，「12.2　Performance ManagementがJP1/IMに発行するJP1イベントについて」を参照してください。

12. ［OK］ボタンをクリックする。

    アラームのアクションとしてJP1イベント発行が定義され，選択したレポートが関連づけられます。発行されるJP1イベントについては，「12.6　JP1/IMと連携する場合に発行されるJP1イベントの属性一覧」を参照してください。

13. JP1イベントを発行するホストのAction Handlerサービスを選択する。

    ［JP1イベント設定］で設定すると［アクションハンドラ］の設定が自動的に変更されます。デフォルトでは，PFM - Managerホスト上のAction Handlerサービスが選択されます。PFM - Managerホスト以外のホストでJP1イベントを発行する場合は，［アクションハンドラ］の設定を変更してください。

    注1

    JP1イベントを発行する場合は，イベントを発行するAction Handlerと同じホストにJP1/Baseが必要です。

    注2

    JP1/IMのセントラルスコープによるPerformance Managementの監視で，JP1イベントを発行する場合は，PFM - Managerと同一ホスト上にあるAction Handlerサービスを選択する必要があります。

    注3

    どのホストのAction Handlerサービスが選択されるかは，初期設定ファイル（config.xml）のselectAHModeForJP1Eventを設定することで変更できます。初期設定ファイル（config.xml）の設定方法については，マニュアル「JP1/Performance Management リファレンス」の付録の，初期設定ファイル（config.xml）について説明している個所を参照してください。

    また，自動的に選択されたホスト以外でJP1イベントを発行する場合は，手動で［アクションハンドラ］の設定を変更してください。

14. 論理ホスト環境で，論理ホストにJP1イベントを発行する場合は，［コマンド引数］に「-r 論理ホスト名」オプションを追加する。

    このオプションの指定がない場合，JP1イベントは物理ホストに登録されます。

15. ［完了］ボタンをクリックする。

ページの先頭へ

(4)　連携のための定義ファイルの編集・コピー

JP1/IMを使用してJP1イベントを監視するには，Performance Managementが提供するJP1/IMの定義ファイルを環境に合わせて編集し，JP1/IMの対応するディレクトリにそれぞれコピーしておく必要があります。

ヒント

• JP1/IMの定義ファイルの修正を有効にするためには，JP1/IMの再起動が必要となる場合があります。定義ファイルの再起動のタイミングおよび定義ファイルが有効になるタイミングについては，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」，マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」，およびマニュアル「JP1/Integrated Management 2 - Manager コマンド・定義ファイルリファレンス」を参照してください。

• JP1/IMの定義ファイルのコピー元とコピー先でOSが異なる場合で，どちらか一方がLinuxのとき，テキストエディターやnkfコマンドなどを使用して，コピー先の定義ファイルの文字コードを変更してください。変更後の文字コードは次のとおりです。

コピー先のOSがLinuxの場合

UTF-8

コピー元のOSがLinuxの場合

シフトJISまたはEUC

Performance Managementが提供するJP1/IMの定義ファイルは，次のフォルダに格納されています。

• Windowsの場合

  PFM - Web Consoleのインストール先フォルダ\sample\imconf

• UNIXの場合

  /opt/jp1pcwebcon/sample/imconf/

ページの先頭へ

(5)　JP1/IMの監視オブジェクト機能と連携してシステムの稼働状態をアイコンで監視する

JP1/IMの監視オブジェクト機能と連携して，Performance Management上でのシステムの稼働状態をアイコンで監視する場合，PFM - Managerホストで監視オブジェクト連携コマンド（jpcconf imコマンド）を実行したあと，監視ツリーの自動生成を実施します。これは，JP1/IMがPerformance Managementの定義情報を収集するために必要です。また，クラスタ環境で利用する場合は，PFM - ManagerとJP1/Baseの論理ホスト名を同じにする必要があります。

1. PFM - Managerホストでjpcconf imコマンドを実行する。

   JP1/IMとの連携を開始する場合は，PFM - Managerホストで，jpcconf imコマンドを次のように実行します。

   jpcconf im enable

   JP1/IMとの連携を停止する場合はコマンドを次のように実行します。

   jpcconf im disable

   なお，PFM - Managerが論理ホスト環境の場合は，実行系/待機系マシンでそれぞれ1回ずつ実行してください。

2. JP1/IMのセントラルスコープで，監視ツリーの自動生成を実施する。

   手順の詳細については，マニュアル「JP1/Integrated Management 2 - Manager 導入・設計ガイド」，「JP1/Integrated Management 2 - Manager 構築ガイド」，および「JP1/Integrated Management 2 - Manager コマンド・定義ファイルリファレンス」を参照してください。

ページの先頭へ

(6)　JP1ユーザーイベントのメッセージを囲む引用符を設定する

UNIXの場合は，JP1ユーザーイベントのメッセージを引用符で囲むことができます。メッセージを引用符で囲みたい場合は，アクションを実行するAction Handlerサービスのホストにあるjpccomm.iniファイルの内容を直接編集します。設定方法を次に示します。

1. 設定対象のAction Handlerサービスを停止する。

   論理ホスト環境の場合は，論理ホストのAction Handlerサービスを停止してください。

2. jpccomm.iniファイルを編集する。

   jpccomm.iniファイルは，次の場所に格納されています。

   物理ホストの場合

   /opt/jp1pc/

   論理ホストの場合

   環境ディレクトリ/jp1pc/

   jpccomm.iniファイルで編集するセクション名，ラベル名，設定できる値の範囲などを，次の表に示します。

   表12‒12　JP1ユーザーイベントのメッセージを引用符で囲むかどうかの設定項目

   セクション名	ラベル名	値の範囲	デフォルト値	説明
   [Common Section]	JP1 Event Double Quote	0｜1	1	JP1ユーザーイベントのメッセージを引用符で囲むかどうかを設定する。 0：引用符で囲まない 1：引用符で囲む

   このラベルは，UNIXの場合だけ有効です。Windowsの場合は設定しても無視されます。

3. 設定対象のAction Handlerサービスを起動する。

ページの先頭へ

(7)　JP1/IM2と連携するための設定

設定方法を次に示します。

1. 次の設定をして，JP1/IM2とPFM - Web Console間で通信できるようにする。

   • JP1/IM - ManagerホストからPFM - Web Consoleホストに対して，PFM - Web Consoleのポート番号（デフォルトは20358）で通信できるようにファイアウォールを設定する。

   • PFM - Web Consoleのメモリー使用量を拡張する。

     PFM - Web Consoleサービスが使用するメモリーの上限値を1,024MBytesから1,536MBytesに拡張してください。メモリー拡張方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録の，PFM - Web Consoleのメモリー拡張方法について記載している個所を参照してください。

2. 次のコマンドを実行して，JP1/IM2連携機能を有効にする。

   jpcconf im2 enable

   エージェントステータス変更イベントの一括発行機能を無効に設定する場合は，-eventcompatオプションを指定します。

   クラスタ環境で利用する場合，実行系と待機系の両方で実施します。

   監視二重化の構成の場合，プライマリーとセカンダリーの両方で実施します。

3. Performance Managementの各サービスを起動する。

4. PFM - Web Consoleで，ヘルスチェックエージェントのJP1イベント発行設定を有効にする。

   JP1/IM2は，Performance ManagementのJP1イベントを受信したときに，JP1イベントの発行元に対応する構成情報のステータスを更新します。

   PFM - Web ConsoleホストがPFM - Managerホストと別ホストの場合は，PFM - Web Consoleホストのホスト名^※を次のプロパティに設定します。

   ［サービス階層］画面->［Master Manager］->［JP1 Event Configurations］->［Monitoring Console Host］

   注※

   JP1/IM - Managerホストから名前解決できるホスト名を設定してください。

   PFM - Web Consoleで使用するポート番号をデフォルトの「20358」から変更している場合は，変更後のポート番号を次のプロパティに設定します。

   ［サービス階層］画面->［Master Manager］->［JP1 Event Configurations］->［Monitoring Console Port］

   PFM - Web Consoleの暗号化通信を有効にしている場合は，次のプロパティに「Yes」を設定します。

   ［サービス階層］画面->［Master Manager］->［JP1 Event Configurations］->［Monitoring Console Https］

5. PFM - RMのポーリング設定を有効にする。

   サービス階層のPFM - RMのプロパティで，［Health Check Configurations］の［Health Check for Target Hosts］プロパティに「Yes」を設定します。

6. PFM - Web Consoleで，Performance Managementシステム内のすべてのAgent Collectorサービスに対して，エージェントイベントの発行の設定を有効にする。

   エージェントステータス変更イベントの一括発行機能の設定を有効にする場合は，上記の設定は不要です。^※

   注※

   エージェントステータス変更イベントの一括発行機能の設定を有効にした場合の注意事項を，次に示します。

   ・JP1イベントの発行元イベントサーバ名と発行元IPアドレスの属性には，それぞれ接続先PFM - Managerのホスト名とIPアドレスが設定されます。そのため，状態が変更された監視対象ホストの情報を確認する場合は，JP1イベントの事象発生元ホストの属性を参照してください。

   ・エージェントの状態変更を通知するJP1イベントの送信に成功した場合は，Performance Managementの共通メッセージログにメッセージを出力しません。JP1イベントの送信に失敗したときは，KAVE00577-Eメッセージを出力します。

   ・PFM - Managerを再起動した場合は，PFM - Managerの再起動後，各エージェントの初回のアラームイベントが発生したときに限り，エージェントの状態が変更されたかどうかにかかわらず，エージェントの状態変更を通知するJP1イベントを発行します。

7. JP1/IM2のトレンド情報表示またはメトリック一覧取得APIで，表示または取得するメトリックについて，デフォルトで提供しているメトリックの編集・削除，または新しいメトリックの追加をする場合は，メトリック定義ファイルを設定する。（JP1/IM2 12-10以降と連携する場合）

   メトリック定義ファイルの詳細については，マニュアル「JP1/Performance Management リファレンス」の，メトリック定義ファイルについて説明している章を参照してください。

8. JP1/PFMプラグインの動作をデフォルトから変更する場合は，JP1/PFMプラグイン設定ファイルを設定する。（JP1/IM2 12-10以降と連携する場合）

   JP1/PFMプラグイン設定ファイルの詳細については，マニュアル「JP1/Performance Management リファレンス」の，JP1/PFMプラグイン設定ファイルについて説明している章を参照してください。

9. JP1/IM2の性能情報取得APIで，Performance Managementのパフォーマンスデータを取得する場合は，該当するレコードに対して，パフォーマンスデータの蓄積の設定を有効にする。

10. JP1/IM2のトレンド情報表示または時系列データ取得APIで，Performance Managementのパフォーマンスデータを表示または取得する場合は，該当するレコードに対して，パフォーマンスデータの蓄積の設定を有効にする。（JP1/IM2 12-10以降と連携する場合）

ページの先頭へ