ここでは,コマンドを実行してプロセスの稼働・非稼働情報を収集するための設定をする方法について説明します。
プロセスの稼働・非稼働情報の収集は,PFM - Web Consoleの[エージェント階層]画面で設定できますが,コマンドを使うと,バッチ処理によって,メンテナンス時の設定作業などを自動化できます。
監視対象は,次の流れで設定します。
プロセス単位またはサービス単位で稼働・非稼働情報を収集する場合,アプリケーション定義ファイル作成時に,アプリケーションにプロセスまたはサービスを1つだけ設定します。アプリケーション単位で稼働・非稼働情報を収集する場合,アプリケーション定義ファイル作成時に,アプリケーションにプロセスまたはサービスを複数設定します。
監視対象の設定方法の詳細を次に示します。
なお,jpcmkkeyコマンド,jpcprocdef createコマンド,jpcprocdef outputコマンド,およびjpctool alarm bindコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。
サービスIDは,PFM - Agentホスト名によって異なります。例えば,PFM - Agentホスト名が「pfmhost1」の場合,サービスIDは「TA1pfmhost1」となります。サービスIDの詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の付録に記載されている命名規則を参照してください。
PFM - Web Consoleがインストールされているホストで,jpcmkkeyコマンドを実行して,認証用キーファイルを作成します。作成済みの場合,この手順は不要です。
コマンド実行時のログイン認証に使用するユーザー名およびパスワードを,ADMINISTRATORおよびxxxxxとして認証用のキーファイルを作成する場合のコマンド実行例を次に示します。
jpcmkkey -user "ADMINISTRATOR" -password "xxxxx"
プロセスの稼働・非稼働情報を収集するために必要な条件を,アプリケーション定義ファイル(XML形式)に記述します。アプリケーション定義ファイルは,アプリケーション作成時に,jpcprocdef createコマンドのパラメーターファイルとして使用します。
jpcprocdef createコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。新規に作成する場合は,次のサンプルファイルをひな形として使用できます。
すでにアプリケーション定義が存在し,その定義内容を編集して新しいアプリケーション定義を作成したいときは,jpcprocdef outputコマンドで出力してください。
jpcprocdef outputコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。jpcprocdef outputコマンドの指定例を次に示します。
-fオプションにアプリケーション定義ファイルを指定してjpcprocdef createコマンドを実行し,アプリケーションを作成します。
jpcprocdef createコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。
jpcprocdef createコマンドでは,1つのエージェントに対してアプリケーションを作成できます。複数のエージェントに対してアプリケーションを作成する場合は,バッチ処理によって,コマンドを繰り返し実行してください。jpcprocdef createコマンドの指定例を次に示します。
jpctool alarm bindコマンドを実行して,監視エージェントに,稼働・非稼働情報を監視するためのアラームテーブルをバインドします。
jpctool alarm bindコマンドは,PFM - Managerがインストールされているホストにログインして実行します。
稼働・非稼働情報を監視するためのアラームは,Application Statusアラームです。必要に応じて編集してください。Application Statusアラームについては,「6. 監視テンプレート」の「Application Status」を参照してください。
すでに,アラームテーブルをバインドしている場合は,監視対象を設定するたびにバインドする必要はありません。
アラームテーブルをバインドする場合,次の方法があります。
PFM Windows Template Alarms [APP] 09.10のアラームテーブルをバインドする場合のjpctool alarm bindコマンドの指定例を次に示します。
ユーザーが作成したアラームテーブルをバインドする場合のjpctool alarm bindコマンドの指定例を次に示します。
特定のプロセスの状態だけを監視する場合は,次の条件式のアラームを作成して,監視できます。特定のプロセスの状態だけを監視する場合は,「表5-6」を参照してください。
監視対象は,次の流れで削除します。
なお,jpcmkkeyコマンド,jpcprocdef listコマンド,jpctool alarm unbindコマンド,およびjpcprocdef deleteコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。
サービスIDは,PFM - Agentホスト名によって異なります。例えば,PFM - Agentホスト名が「pfmhost3」の場合,サービスIDは「TA1pfmhost3」となります。サービスIDの詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の付録に記載されている命名規則を参照してください。
PFM - Web Consoleがインストールされているホストで,jpcmkkeyコマンドを実行して,認証用キーファイルを作成します。作成済みの場合,この手順は不要です。
コマンド実行時のログイン認証に使用するユーザー名およびパスワードを,ADMINISTRATORおよびxxxxxとして認証用のキーファイルを作成する場合のコマンド実行例を次に示します。
jpcmkkey -user "ADMINISTRATOR" -password "xxxxx"
jpcprocdef listコマンドを実行して,監視エージェントで定義されているアプリケーション定義の一覧から,削除したいアプリケーション定義の定義名を確認できます。
jpcprocdef listコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。jpcprocdef listコマンドの指定例を次に示します。
jpcprocdef list -agent サービスID
jpctool alarm unbindコマンドを実行して,監視エージェントにバインドされているアラームテーブルをアンバインドして,監視を停止します。
jpctool alarm unbindコマンドは,PFM - Managerがインストールされているホストにログインして実行します。jpctool alarm unbindコマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。
すでに,アラームテーブルをアンバインドしている場合は,監視対象の設定を削除するたびにアンバインドする必要はありません。
PFM Windows Template Alarms [APP] 09.10のアラームテーブルをアンバインドする場合のjpctool alarm unbindコマンドの指定例を次に示します。
jpctool alarm unbind -key Windows -table "PFM Windows Template Alarms [APP] 09.10" -id サービスID
jpcprocdef deleteコマンドを実行して,アプリケーション定義を削除します。
jpcprocdef deleteコマンドは,PFM - Web Consoleがインストールされているホストにログインして実行します。
jpcprocdef deleteコマンドでは,1つのエージェントに対してアプリケーション定義を削除できます。複数のエージェントに対してアプリケーション定義を削除する場合は,バッチ処理によって,コマンドを繰り返し実行してください。
jpcprocdef deleteコマンドでアプリケーション定義application5を削除する指定例を次に示します。
jpcprocdef delete -agent サービスID -name "application5"