4.2.3 コマンドでの設定

ここでは,コマンドを実行してプロセスの稼働・非稼働情報を収集するための設定をする方法について説明します。

プロセスの稼働・非稼働情報の収集は,PFM - Web Consoleの[エージェント階層]画面で設定できますが,コマンドを使うと,バッチ処理によって,メンテナンス時の設定作業などを自動化できます。

<この項の構成>
(1) 監視対象を設定する
(2) 監視対象の設定を削除する

(1) 監視対象を設定する

監視対象は,次の流れで設定します。

  1. アプリケーション定義ファイルを作成する
  2. アプリケーションを作成する
  3. 監視エージェントにアラームテーブルをバインドする

プロセス単位またはサービス単位で稼働・非稼働情報を収集する場合,アプリケーション定義ファイル作成時に,アプリケーションにプロセスまたはサービスを一つだけ設定します。アプリケーション単位で稼働・非稼働情報を収集する場合,アプリケーション定義ファイル作成時に,アプリケーションにプロセスまたはサービスを複数設定します。

監視対象の設定方法の詳細を次に示します。

(a) アプリケーション定義ファイルを作成する

プロセスの稼働・非稼働情報を収集するために必要な条件を,アプリケーション定義ファイル(XML形式)に記述します。アプリケーション定義ファイルは,アプリケーション作成時に,jpcprocdef createコマンドのパラメーターファイルとして使用します。

jpcprocdef createコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。また,jpcprocdef createコマンドを実行するためには,事前に,PFM - Web Consoleがインストールされているホストで,jpcmkkeyコマンドを実行して,認証用キーファイルを作成しておく必要があります。jpcprocdef createコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

新規に作成する場合は,次のサンプルファイルをひな形として使用できます。

監視対象ホストがWindowsの場合
PFM - Web Consoleのインストール先フォルダ¥sample¥processmonitoringcommand¥jpcprocdef-parameters-windows.xml
監視対象ホストがUNIXの場合
/opt/jp1pcwebcon/sample/processmonitoringcommand/jpcprocdef-parameters-unix.xml

すでにアプリケーション定義が存在し,その定義内容を編集して新しいアプリケーション定義を作成したいときは,jpcprocdef outputコマンドで出力してください。

jpcprocdef outputコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。また,jpcprocdef outputコマンドを実行するためには,事前に,PFM - Web Consoleがインストールされているホストで,jpcmkkeyコマンドを実行して,認証用キーファイルを作成しておく必要があります。jpcprocdef outputコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

(b) アプリケーションを作成する

-fオプションにアプリケーション定義ファイルを指定してjpcprocdef createコマンドを実行し,アプリケーションを作成します。

jpcprocdef createコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。また,jpcprocdef createコマンドを実行するためには,事前に,PFM - Web Consoleがインストールされているホストで,jpcmkkeyコマンドを実行して,認証用キーファイルを作成しておく必要があります。jpcprocdef createコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

jpcprocdef createコマンドでは,一つのエージェントに対してアプリケーションを作成できます。複数のエージェントに対してアプリケーションを作成する場合は,バッチ処理によって,コマンドを繰り返し実行してください。

(c) 監視エージェントにアラームテーブルをバインドする

jpctool alarm bindコマンドを実行して,監視エージェントに,稼働・非稼働情報を監視するためのアラームテーブルをバインドします。

jpctool alarm bindコマンドは,PFM - Managerがインストールされているホストにログインして実行します。jpctool alarm bindコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

稼働・非稼働情報を監視するためのアラームは,Application Statusアラームです。必要に応じて編集してください。Application Statusアラームについては,「5. 監視テンプレート」の「Application Status」を参照してください。

すでに,アラームテーブルをバインドしている場合は,監視対象を設定するたびにバインドする必要はありません。

アラームテーブルをバインドする場合,次の方法があります。

PFM RM Platform Template Alarms [APP] 09.10のアラームテーブルをバインドする場合のjpctool alarm bindコマンドの指定例を次に示します。

監視対象ホストがWindowsの場合

PFM - Managerのインストール先フォルダ¥tools¥jpctool alarm bind -key RMPlatform -table "PFM RM Platform Template Alarms [APP] 09.10" -id サービスID -add

監視対象ホストがUNIXの場合

/opt/jp1pc/tool/jpctool alarm bind -key RMPlatform -table "PFM RM Platform Template Alarms [APP] 09.10" -id サービスID -add

注※
サービスIDは,インスタンス名,監視対象名,PFM - RMホスト名などの条件によって異なります。例えば,インスタンス名が「inst1」,監視対象名が「targethost1」,PFM - RMホスト名が「lhost1」の場合,サービスIDは「7A1inst1[targethost1@lhost1]」となります。サービスIDの詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の付録に記載されている命名規則を参照してください。

jpctool alarm bindコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

ユーザーが作成したアラームテーブルをバインドする場合のjpctool alarm bindコマンドの指定例を次に示します。

監視対象ホストがWindowsの場合

PFM - Managerのインストール先フォルダ¥tools¥jpctool alarm bind -key RMPlatform -table ユーザー作成アラームテーブル名※1 -id サービスID※2 -add

監視対象ホストがUNIXの場合

/opt/jp1pc/tool/jpctool alarm bind -key RMPlatform -table ユーザー作成アラームテーブル名※1 -id サービスID※2 -add

注※1
ユーザー作成アラームテーブル名には,ユーザーが任意に作成したアラームテーブルの名称を指定できます。
注※2
サービスIDは,インスタンス名,監視対象名,PFM - RMホスト名などの条件によって異なります。例えば,インスタンス名が「inst1」,監視対象名が「targethost1」,PFM - RMホスト名が「lhost1」の場合,サービスIDは「7A1inst1[targethost1@lhost1]」となります。サービスIDの詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の付録に記載されている命名規則を参照してください。

jpctool alarm bindコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

特定のプロセスの状態だけを監視する場合は,次の条件式のアラームを作成して,監視できます。特定のプロセスの状態だけを監視する場合の条件式については,「4.2.1(1)(b) 監視エージェントにアラームテーブルをバインドする」の表4-4を参照してください。

(2) 監視対象の設定を削除する

監視対象は,次の流れで削除します。

  1. 削除するアプリケーション定義の定義名を確認する
  2. アラームテーブルをアンバインドする
  3. アプリケーション定義を削除する

(a) 削除するアプリケーション定義の定義名を確認する

jpcprocdef listコマンドを実行して,監視エージェントで定義されているアプリケーション定義の一覧から,削除したいアプリケーション定義の定義名を確認できます。

jpcprocdef listコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。また,jpcprocdef listコマンドを実行するためには,事前に,PFM - Web Consoleがインストールされているホストで,jpcmkkeyコマンドを実行して,認証用キーファイルを作成しておく必要があります。jpcprocdef listコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

(b) アラームテーブルをアンバインドする

jpctool alarm unbindコマンドを実行して,監視エージェントにバインドされているアラームテーブルをアンバインドして,監視を停止します。

jpctool alarm unbindコマンドは,PFM - Managerがインストールされているホストにログインして実行します。jpctool alarm unbindコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

すでに,アラームテーブルをアンバインドしている場合は,監視対象の設定を削除するたびにアンバインドする必要はありません。

(c) アプリケーション定義を削除する

jpcprocdef deleteコマンドを実行して,アプリケーション定義を削除します。

jpcprocdef deleteコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。また,jpcprocdef deleteコマンドを実行するためには,事前に,PFM - Web Consoleがインストールされているホストで,jpcmkkeyコマンドを実行して,認証用キーファイルを作成しておく必要があります。jpcprocdef deleteコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

jpcprocdef deleteコマンドでは,一つのエージェントに対してアプリケーション定義を削除できます。複数のエージェントに対してアプリケーション定義を削除する場合は,バッチ処理によって,コマンドを繰り返し実行してください。