6.8.2　ユーザー独自のパフォーマンスデータを収集するための設定

(1)　フィールドに格納する情報を決定する

ユーザーレコードのフィールドには，キー情報とデータ情報を格納します。それぞれに格納する内容を検討してください。

ページの先頭へ

(2)　ユーザーコマンドを作成する

ユーザーコマンドは，パフォーマンスデータを収集しユーザー作成データを作成するためのスクリプトです。ユーザー作成データのファイル形式に従ってパフォーマンスデータを出力するようにスクリプトを記述してください。

ユーザー作成データのファイル書式については，「6.8.4　ユーザー作成データのファイル形式」を参照してください。

ユーザー作成データは，jpcuserコマンドを実行するときに-fileオプションで指定できるパスに格納してください。詳細は，「6.8.3　jpcuserコマンドの形式」の引数の説明を参照してください。

なお，ユーザーコマンドで出力したユーザー作成データが正しいかどうかを確認する場合，jpcuserコマンドを次のように実行してください。

• 物理ホスト環境：

インストール先フォルダ\agtt\agent\jpcuser\jpcuser PI_UPI -file ユーザー作成データ -debug 1

• 論理ホスト環境：

インストール先フォルダ\agtt\agent\jpcuser\jpcuser PI_UPI -file ユーザー作成データ -debug 1 -lhost 論理ホスト名

上記コマンドを実行すると，次に示すデバッグログが生成されます。

• 物理ホスト環境：

インストール先フォルダ\agtt\agent\jpcuser\debug\jpcuser_dbg_01.log

• 論理ホスト環境：

環境フォルダ\jp1pc\agtt\agent\jpcuser\debug\jpcuser_dbg_01.log

デバッグログの内容を確認して，エラーが発生していないことを確認してください。

jpcuserコマンドの詳細については，「6.8.3　jpcuserコマンドの形式」を参照してください。

ページの先頭へ

(3)　ユーザー独自のパフォーマンスデータを定期的に収集するための設定をする

ユーザーコマンド定期実行機能を使って，定期的にユーザー独自のパフォーマンスデータを収集するための設定方法を説明します。

1. PFM - Web Consoleでユーザーレコードの収集設定を行う。

   ユーザーコマンド定期実行機能の実行間隔は，各ユーザーレコードのCollection Intervalの設定に依存します。

2. PFM - Web Consoleでユーザーコマンド定期実行機能のプロパティを設定する。

   ユーザーコマンド定期実行機能を実行するために，PFM - Web Consoleで各ユーザーレコードの次のプロパティを設定します^※。プロパティの設定方法は，PD_UPDレコード，PD_UPDBレコード，PI_UPIレコード，PI_UPIBレコード，およびPI_XUI1レコード〜PI_XUI5レコードで共通です。

注※

PFM - Web Consoleで定期的にユーザー独自のパフォーマンスデータを収集するための設定をする場合，物理ホスト運用時と論理ホスト運用時で選択するサービスが次のように異なることに注意してください。

• 物理ホスト環境：Windows<物理ホスト名> またはTA1物理ホスト名

• 論理ホスト環境：Windows<論理ホスト名> またはTA1論理ホスト名

メモ

Windowsのタスクスケジューラーを使って，定期的にユーザー独自のパフォーマンスデータを収集することもできます。タスクスケジューラーは，バッチファイルやプログラムなどを指定した時刻と間隔で自動実行できるWindowsの機能です。ユーザーコマンド，およびjpcuserコマンドを続けて実行するバッチファイルを作成し，タスクスケジューラーでそのバッチファイルを定期的に実行するように設定してください。

ページの先頭へ

(4)　ユーザーデータファイルを収集する設定をする

ユーザーデータファイルとは，jpcuserコマンドによって，ユーザー作成データをPFM - Agent for Platformが管理できるレコード形式に変換したデータファイルのことです。このユーザーデータファイルのデータは，PFM - Agent for Platformがレコードを収集するタイミングで，ユーザーレコードに格納されます。PFM - Agent for Platformがユーザーレコードを収集するように，PFM - Web Consoleで設定してください。

レコードの収集方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照してください。

ページの先頭へ

(5)　ユーザー独自のパフォーマンスデータの収集例（物理ホスト環境）

次の表に示す形式でプロセス情報をPI_UPIレコードに収集する例を示します。

ページの先頭へ

(6)　ユーザーコマンドの例（物理ホスト環境）

Windowsからプロセスの情報を取得し，ユーザー作成データを出力するユーザーコマンド（userproc1.vbs，userproc2.vbs）の例を次に示します。

userproc1.vbsの例

'ヘッダー出力
WScript.Echo "Product Name=PFM-Agent for Platform (Windows)"
WScript.Echo "FormVer=0001"
'オプションヘッダー出力
WScript.Echo "tt ki sm u"
'プロセス一覧を取得し，その内容を出力：注)空白を含む文字列は，Chr(34)で囲む。
for each Process in GetObject("winmgmts:").InstancesOf("win32_process")
  WScript.Echo "Process", Process.ProcessId, Chr(34) & Process.Name & Chr(34), Process.ThreadCount
next

userproc2.vbsの例

'ヘッダー出力
WScript.Echo "Product Name=PFM-Agent for Platform (Windows)"
WScript.Echo "FormVer=0001"
'オプションヘッダー出力
WScript.Echo "tt u"
'物理メモリーの合計を取得し，その内容を出力
for each Memory in GetObject("winmgmts:").InstancesOf("Win32_OperatingSystem")
  WScript.Echo "TotalPhysicalMemory", Memory.TotalVisibleMemorySize
next

上記ユーザーコマンドを実行したときのユーザー作成データを次に示します。

userproc1.vbsによって出力されるユーザー作成データの例

Product Name=PFM-Agent for Platform (Windows)
FormVer=0001
tt ki ks u
Process 0 "System Idle Process" 1
Process 8 "System" 41
Process 172 "SMSS.EXE" 6
Process 200 "CSRSS.EXE" 12
Process 196 "WINLOGON.EXE" 19
Process 248 "SERVICES.EXE" 41

userproc2.vbsによって出力されるユーザー作成データの例

Product Name=PFM-Agent for Platform (Windows)
FormVer=0001
tt u
TotalPhysicalMemory 1048052

メモ

• 利用ポート情報の収集例については，「3.1.8　利用ポート情報の収集例」を参照してください。

• PFM製品が導入されていない複数のホストからのパフォーマンスデータの収集例については，「3.1.9　PFM製品が導入されていない複数のホストからのパフォーマンスデータの収集例」を参照してください。

ページの先頭へ

(7)　定期的に収集するためのバッチファイルの例（物理ホスト環境）

ユーザーコマンド定期実行機能を使って定期的に実行するためのバッチファイル（userperf.bat）の例を次に示します。

REM フォルダの移動
cd C:\Program Files (x86)\Hitachi\jp1pc\agtt\agent\jpcuser
REM ユーザー作成データの生成
cscript //nologo userproc1.vbs > UPI1.txt
cscript //nologo userproc2.vbs > UPI2.txt
REM jpcuserコマンドによってユーザー作成データをレコード形式に変換
jpcuser PI_UPI -file UPI1.txt -file UPI2.txt※

注※

-debug 2を指定すると，次のフォルダにデバッグログが出力されます。

インストール先フォルダ\agtt\agent\jpcuser\debug\

なお，バッチファイル（userperf.bat）とVBスクリプトは次の場所に格納してください。

C:\Program Files (x86)\Hitachi\jp1pc\agtt\agent\jpcuser

メモ

このバッチファイルをWindowsのタスクスケジューラーを使って，定期的に実行することもできます。

ページの先頭へ

(8)　ユーザー独自のパフォーマンスデータの収集例（論理ホスト環境）

プロセス情報をPI_UPIレコードに収集するときの例を次の表に示します。論理ホスト環境の場合は，ユーザーコマンドを実行しているホスト名の情報を含めると，どのノードで実行しているかがわかりやすくなります。

ページの先頭へ

(9)　ユーザーコマンドの例（論理ホスト環境）

Windowsからプロセスの情報を取得し，ユーザー作成データを出力するユーザーコマンド（userproc1.vbs）の例を次に示します。

userproc1.vbsの例

'変数宣言
Dim objNetwork
Dim hostName
'ネットワークオブジェクトの生成
Set objNetwork = CreateObject("WScript.Network")
'ユーザーコマンドを実行しているホスト名を取得
hostName = objNetwork.ComputerName
'ヘッダー出力
WScript.Echo "Product Name=PFM-Agent for Platform (Windows)"
WScript.Echo "FormVer=0001"
'オプションヘッダー出力
WScript.Echo "tt ki sm u sm"
'プロセス一覧を取得し，その内容を出力：注)空白を含む文字列は，Chr(34)で囲む。
'末尾のフィールドにホスト名を含める
for each Process in GetObject("winmgmts:").InstancesOf("win32_process")
  WScript.Echo "Process", Process.ProcessId, Chr(34) & Process.Name & Chr(34), Process.ThreadCount, hostName
next
'ネットワークオブジェクトの解放
Set objNetwork = Nothing

userproc1.vbsによって出力されるユーザー作成データの例

Product Name=PFM-Agent for Platform (Windows)
FormVer=0001
tt ki sm u sm
Process 0 "System Idle Process" 1 jp1-aop
Process 8 "System" 41 jp1-aop
Process 172 "SMSS.EXE" 6 jp1-aop
Process 200 "CSRSS.EXE" 12 jp1-aop
Process 196 "WINLOGON.EXE" 19 jp1-aop
Process 248 "SERVICES.EXE" 41 jp1-aop

メモ

• 利用ポート情報の収集例については，「3.1.8　利用ポート情報の収集例」を参照してください。

• PFM製品が導入されていない複数のホストからのパフォーマンスデータの収集例については，「3.1.9　 PFM製品が導入されていない複数のホストからのパフォーマンスデータの収集例」を参照してください。

ページの先頭へ

(10)　定期的に収集するためのバッチファイルの例（論理ホスト環境）

ユーザーコマンド定期実行機能を使って定期的に収集するためのバッチファイル（userperf.bat）の例を次に示します。

REM フォルダの移動
cd S:\jp1\userdata
REM ユーザー作成データの生成
cscript //nologo userproc1.vbs > UPI1.txt
REM jpcuserコマンドによってユーザー作成データをレコード形式に変換
"C:\Program Files (x86)\Hitachi\jp1pc\agtt\agent\jpcuser\jpcuser" PI_UPI -file UPI1.txt -lhost jp1-halaop※

注※

-debug 2を指定すると，次のフォルダにデバッグログが出力されます。

環境フォルダ\jp1pc\agtt\agent\jpcuser\debug\

なお，バッチファイル（userperf.bat）とVBスクリプトは次の場所に格納してください。

S:\jp1\userdata

メモ

このバッチファイルをWindowsのタスクスケジューラーを使って，定期的に実行することもできます。

ページの先頭へ