4.8.3 JP1イベント取得
機能
指定したサーバのJP1/IM - Managerに対して，指定した期間，統合監視DBに登録されているJP1イベントの情報を，指定されたファイルにCSV形式で出力します。ファイルの出力フォーマットは，JP1/IMのjcoevtreportコマンドの出力結果と同じ形式です。登録時刻，到着時刻，および開始時刻と終了時刻の形式はYYYYMMDDhhmmss形式で，ヘッダーの出力形式はDISPで出力します。
この部品では，次のサーバを前提とします。
・監視サーバ(実行対象サーバ)
JP1/IM - Managerのイベント件数を取得するサーバです。
利用場面
JP1/IM - Managerに到着したイベントを調査するために利用することができます。
前提条件
【システム内前提製品】/【実行対象サーバ内前提製品】/【実行対象サーバ内前提製品の稼働OS】の最新のサポート状況については，リリースノートを参照してください。
【システム内前提製品】
(1)JP1/Automatic Operation 11-00以降
【実行対象サーバ内前提製品】
(1)JP1/Integrated 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) Windows Server 2019 Standard/Datacenter
(5) Red Hat Enterprise Linux Server 6 (32-bit x86)，Red Hat Enterprise Linux Server 6 (64-bit x86_64)
(6) Red Hat Enterprise Linux Server 7 (64-bit x86_64)
(7) Red Hat Enterprise Linux Server 8 (64-bit x86_64)
(8) AIX V6
(9) AIX V7
【実行対象サーバ内前提製品の使用条件】
(1)実行対象サーバのJP1/IM - Managerがクラスタ構成の場合，プロパティplugin.destinationHostにはJP1/IM - Managerの論理ホストが動作している物理ホスト名を，プロパティJP1IM.jp1imLHostNameにはJP1/IM - Managerの論理ホスト名を指定してください。
(2)統合監視DBで運用している必要があります。
(3)指定可能な日時の範囲は，(GMT) 1970/01/01 00:00:00 〜 2038/01/19 03:14:07です。コマンド実行ホストのタイムゾーンが日本時間の場合，(GMT+9:00) 1970/01/01 09:00:00 〜 2038/01/19 12:14:07となります。
(4)稼働OSがUNIXの場合は，エージェントレス接続先に定義された接続ユーザーのデフォルトロケールがJP1/IM - Managerの動作する言語コードに設定されている必要があります。
注意事項
(1)この部品を同一の実行対象サーバに対して複数同時に実行しないでください。
(2)この部品を実行すると同時にjcoevtreportを実行しないでください。
バージョン
02.00.00
部品のタグ
Gather JP1 information,IM,Windows,Linux,AIX
タスクログに表示される部品の名称
jp1imRetrieveEvent
戻り値
|
戻り値 |
説明 |
|---|---|
|
0 |
正常 |
|
11 |
異常(ユーザーミス) 定義ファイル内容の不正 |
|
12 |
異常(ユーザーミス) プロパティ不正 |
|
13 |
異常(ユーザーミス) 認証不可 |
|
20 |
異常(ユーザーミス) その他ユーザーエラー |
|
21 |
異常(環境不正) コマンドが見つからない(部品スクリプトでエラーを検知) |
|
22 |
異常(環境不正) メモリ/ディスク容量不足 |
|
23 |
異常(環境不正) 前提環境不正 |
|
24 |
異常(環境不正) 起動状態不正 |
|
25 |
異常(環境不正) 通信エラー |
|
26 |
異常(連携製品トラブル) 内部エラー |
|
41 |
異常(部品内でエラーを検知) プロパティ未入力(部品スクリプトでエラーを検知) |
|
42 |
異常(部品内でエラーを検知) 内部エラー(部品スクリプトでエラーを検知) |
プロパティ一覧
プロパティ一覧を次の表に示します。
|
プロパティキー |
プロパティ名 |
説明 |
デフォルト値 |
入出力種別 |
必須区分 |
|---|---|---|---|---|---|
|
JP1IM.outputFileName |
出力ファイル名 |
JP1イベントの情報をCSV形式にして出力するファイル名を指定します。 |
− |
入力 |
○ |
|
JP1IM.jp1imStartTime |
出力対象始点日 |
出力するイベントの始点日を指定します。指定形式はYYYY-MM-DDです。時刻は，00:00:00になります。 |
− |
入力 |
○ |
|
JP1IM.jp1imEndtime |
出力対象終点日 |
出力するイベントの終点日を指定します。指定形式はYYYY-MM-DDです。時刻は，00:00:00になります。 |
− |
入力 |
○ |
|
JP1IM.jp1imFilterName |
フィルターファイル名 |
イベントレポート出力のフィルターファイル名をフルパスで指定します。 |
− |
入力 |
△ |
|
JP1IM.jp1imLHostName |
JP1/IMの論理ホスト名 |
JP1/IMの論理ホスト名を指定します。 |
− |
入力 |
△ |
|
plugin.destinationHost |
実行対象サーバのホスト名 |
この部品を実行するサーバのホスト名またはIPアドレスを指定します。IPv6アドレスには対応していません。 |
− |
入力 |
○ |
|
common.returnValue |
部品の戻り値 |
この部品の戻り値が格納されます。 |
− |
出力 |
△ |