4.10.4 アラームテーブルの情報取得(JP1/PFM)
機能
この部品は,JP1/PFM - Managerで定義されているアラームテーブルの一覧,およびアラームテーブルのバインド情報を取得します。
この部品では,次のサーバを前提とします。
・PFM管理サーバ(実行対象サーバ)
この部品を実行する対象です。JP1/PFM - Managerがセットアップされている必要があります。
この部品は,取得する内容によって指定が必要なプロパティが異なります。
(1) 該当するJP1/PFM - Agent(またはJP1/PFM - RM)用として定義したアラームテーブルの一覧を取得する場合
JP1PFM.serviceKeyプロパティだけ指定してください。
(2) 指定したアラームテーブルに含まれるアラーム名,アラームの有効/無効状態,バインドしているエージェントの一覧を取得する場合
JP1PFM.serviceKeyプロパティ,JP1PFM.alarmTableNameプロパティを指定してください。
(3) 指定したエージェントがバインドしているアラームテーブルの一覧を取得する場合
JP1PFM.agentServiceIDプロパティだけ指定してください。このプロパティは,PFM管理サーバのJP1/PFM - Managerのバージョンが08-50以降の場合だけ指定できます(08-50より前のバージョンの場合に指定すると,この部品は戻り値12で異常終了します)。
利用場面
JP1/PFM - Managerによって性能を監視しているシステムで,定義されているアラームテーブル名を確認する場合に使用できます。また,特定のJP1/PFM - Agent(またはJP1/PFM - RM)にバインドされているアラームテーブル名を確認する場合にも使用することができます。
前提条件
【システム内前提製品】/【実行対象サーバ内前提製品】/【実行対象サーバの稼働OS】の最新のサポート状況については,リリースノートを参照してください。
【システム内前提製品】
(1)JP1/Automatic Operation 11-00以降
【実行対象サーバ内前提製品】
(1)JP1/Performance Management - Manager 09-00以降
【実行対象サーバ内前提製品の稼働OS】
(1) Windows Server 2008 R2 Standard/Enterprise/Datacenter
(2) Windows Server 2012 Standard/Datacenter,Windows Server 2012 R2 Standard/Datacenter
(3) Windows Server 2016 Standard/Datacenter
(4) Red Hat Enterprise Linux Server 6 (32-bit x86),Red Hat Enterprise Linux Server 6 (64-bit x86_64)
(5) Red Hat Enterprise Linux Server 7 (64-bit x86_64)
(6) AIX V6.1,AIX V7.1,AIX V7.2
【実行対象サーバ内前提製品の使用条件】
(1) JP1/Performance Management - Managerの次のサービスが起動していること。
・Name Serverサービス
・Master Managerサービス
・View Serverサービス
(2) JP1/PFMのjpctool alarm listコマンド(JP1/PFM - Managerのバージョンが08-00以降の場合はjpcalarm listコマンド)の使用条件を満たしていること。
注意事項
(1)この部品を同一の実行対象サーバに対して多重実行しないでください。
(2)実行対象サーバのJP1/PFM - Managerがクラスタ構成の場合は,実行系ノードで部品を実行してください。
バージョン
02.00.00
部品のタグ
Gather JP1 information,PFM,Windows,Linux,AIX
タスクログに表示される部品の名称
jp1pfmShowAlarmBindList
戻り値
戻り値 |
説明 |
---|---|
0 |
正常 |
12 |
異常(ユーザーミス) プロパティ不正 |
13 |
異常(ユーザーミス) 認証不可 |
14 |
異常(ユーザーミス) ファイルアクセス不可 |
20 |
異常(ユーザーミス) その他ユーザーエラー |
21 |
異常(環境不正) コマンドが見つからない(部品スクリプトでエラーを検知) |
22 |
異常(環境不正) メモリ/ディスク容量不足 |
23 |
異常(環境不正) 前提環境不正 |
24 |
異常(環境不正) 起動状態不正 |
25 |
異常(環境不正) 通信エラー |
26 |
異常(連携製品トラブル) 内部エラー |
27 |
異常(エラー内容はタスクログで確認) |
41 |
異常(部品内でエラーを検知) プロパティ未入力(部品スクリプトでエラーを検知) |
プロパティ一覧
プロパティ一覧を次の表に示します。
プロパティキー |
プロパティ名 |
説明 |
デフォルト値 |
入出力種別 |
必須区分 |
---|---|---|---|---|---|
plugin.destinationHost |
実行対象サーバのホスト名 |
この部品を実行するサーバのホスト名またはIPアドレスを指定します。IPv6アドレスには対応していません。 |
− |
入力 |
○ |
JP1PFM.reportOutputFileName |
出力ファイル名 |
JP1/PFMのアラーム情報を出力するファイルのパスをフルパスで指定します。 |
− |
入力 |
○ |
JP1PFM.serviceKey |
JP1/PFMプロダクトのサービスキー |
JP1/PFM - Agent(またはJP1/PFM - RM)のサービスキーを指定します。プロダクト名表示機能が有効の場合,プロダクト名も指定できます。このプロパティはJP1PFM.agentServiceIDと同時に指定できません。 |
− |
入力 |
△ |
JP1PFM.alarmTableName |
アラームテーブル名 |
JP1/PFMのアラームテーブル名を指定します。このプロパティは,JP1PFM.serviceKeyと同時に指定します。 |
− |
入力 |
△ |
JP1PFM.agentServiceID |
エージェントのサービスID |
JP1/PFMのAgent Collectorサービス,Remote Monitor Collectorサービス,リモートエージェントまたはグループエージェントのサービスIDを指定します。JP1PFM.serviceKey,JP1PFM.alarmTableNameと同時に指定できません。 |
− |
入力 |
△ |
common.returnValue |
部品の戻り値 |
この部品の戻り値が格納されます。 |
− |
出力 |
△ |