4.2.1 ワークグループ情報の収集の設定
ワークグループ情報の収集の設定について説明します。
- <この項の構成>
- (1) ワークグループ情報の収集の設定手順
- (2) ワークグループファイルの設定
- (3) アラーム運用例
- (4) PFM - Web Consoleの設定
(1) ワークグループ情報の収集の設定手順
PFM - Agent for Platformでワークグループ情報を収集し,PFM - Web Consoleで監視するには,次の手順で設定します。
- ワークグループファイルを設定する。
- PFM - Web Consoleで,Workgroup Summary(PI_WGRP)レコードのパフォーマンスデータをStoreデータベースに格納するように設定する。
PFM - Web Consoleで履歴レポートを表示する場合に必要です。
- PFM - Agent for Platformを再起動する。
修正した定義を有効にするには,PFM - Agent for Platformを停止して再起動する必要があります。
(2) ワークグループファイルの設定
ワークグループ情報を収集するには,まず,ワークグループファイルを設定する必要があります。ワークグループファイルとは,ワークグループ名などの情報を設定するファイルです。
使用できるワークグループファイルは,一つだけです。また,このファイルの名前を変更すると無効になります。
ワークグループファイル名を次に示します。
/opt/jp1pc/agtu/agent/wgfile
このワークグループファイルには,コメント行(行の先頭に「#」が記述されている)だけが記述されています。設定する場合,このワークグループファイルを直接編集するか,またはコピーしてから編集してください。
(a) ワークグループファイルの設定手順
ワークグループファイルの設定手順を次に示します。
- テキストエディターで,ワークグループファイルを開く。
- ワークグループファイルに次のパラメーターを追加する。
パラメーターの指定方法は「(b) ワークグループファイルの指定法」を参照してください。
- 複数のワークグループの情報を収集する場合,情報を収集するワークグループごとにパラメーターを指定する。
- ワークグループファイルを保存する。
必ず,デフォルトのワークグループファイル名「wgfile」で保存してください。
なお,wgfileファイルの設定内容をインストール時の状態に戻すには,wgfileファイルのモデルファイルであるwgfile.modelをwgfileにコピーしてください。
(b) ワークグループファイルの指定法
●パラメーター指定の書式
パラメーターを指定する際の書式について説明します。
パラメーターの書式は次のようになります。
workgroup=ワークグループ名
[users=UNIXユーザー名] または [users_02=UNIXユーザー名]
[groups=UNIXグループ名] または [groups_02=UNIXグループ名]
[programs=プログラム名] または [programs_02=プログラム名]
[arguments_02=監視プログラムの引数]
[regexp=監視条件]
- 注意
- 各ファイルパラメーターの終端は改行です。
- workgroupパラメーターは,必ず先頭に指定してください。それ以外のパラメーターの順序は任意です。
- [ ]で囲まれているパラメーターは省略可能です。ただし,workgroupパラメーターのほかに一つ以上のパラメーターを指定する必要があります。
- 各パラメーターの大文字小文字は区別しません。
- 「=」の前後に空白文字やタブ文字を挿入しないでください。
- 一つのパラメーターが複数行にわたる場合,行の末尾にコンマ「,」を記述してください。
- コメント行を挿入する場合は,行の先頭に「#」を記述してください。
- パラメーターの指定に正規表現を使用できます。正規表現については,各OSのマニュアルを参照してください。また,正規表現を使った指定例については,「(c) ワークグループファイルの指定例」を参照してください。
- workgroup以外のパラメーターでは,複数の指定値を設定できます。各指定値は区切り文字を使って区切ります。区切り文字は,通常コンマや空白文字を使いますが,arguments_02,groups_02,programs_02,およびusers_02の各パラメーターで,指定値の先頭に「"」を指定して監視対象を指定する場合だけ,区切り文字として「",」を,終端文字として「"¥n(改行)」を使用します。詳細は以降で説明する「パラメーターの詳細」を参照してください。
- arguments_02,groups_02,programs_02,およびusers_02のパラメーターで,指定値の先頭に「"」を指定して監視対象を指定する場合,対になる区切り文字が存在しないときは,文字列の範囲指定ができないため監視対象として認識されません。
- arguments_02,groups_02,programs_02,およびusers_02の各パラメーターで,指定値の先頭に「"」を指定して監視対象を指定する場合,対になる区切り文字との間に単独で存在する「"」は無視されます。「"」を監視対象に含みたい場合は「""」と記述してください。
- arguments_02,groups_02,programs_02,およびusers_02の各パラメーターでは,指定値の先頭に「"」を指定して監視対象を指定する指定法と指定値の先頭に「"」を指定しない指定値を混在させることもできます。
●パラメーターの詳細
各パラメーターについて説明します。パラメーターの設定例は「(c) ワークグループファイルの指定例」を参照してください。
- workgroup=ワークグループ名
- 監視するワークグループの名前を英数字で指定します。名前に使用できる文字列の上限は改行文字を含めて2,037バイトです。ただし,Storeデータベースに記録されるのは29バイトまでです。同じワークグループ名を複数指定した場合,あとに指定された条件(行番が高い方のワークグループ条件)が有効となります。
- ワークグループ名は,必ず指定してください。
- users=UNIXユーザー名
- ワークグループとして情報を収集するUNIXユーザーを名前で指定します。改行文字を含めて2,041バイト以内の半角英数字で指定します。ただし,Storeデータベースに記録されるのは29バイトまでで,最後の文字は「>」となります。
- 複数のUNIXユーザー名を指定する場合,それぞれの名前を一つ以上のコンマまたは空白文字で区切ってください。指定したすべてのユーザーが監視対象になります。
- ここで指定した値は,Workgroup Summary(PI_WGRP)レコードのUsers(USERS)フィールドに表示されます。
- ここには,Process Detail(PD)レコードのReal User(REAL_USER_NAME)フィールドに格納される値を指定します。
- users_02=UNIXユーザー名
- ワークグループとして情報を収集するUNIXユーザーを名前で指定します。このパラメーターはusersパラメーターを拡張して指定するためのものです。
- 指定値の先頭に「"」を付けた場合,次の区切り文字(「",」または「"¥n(改行)」)までが指定値と認識されます。例えば,usersパラメーターでの区切り文字である空白文字やコンマも指定値に含めることができます。「"」を付けない場合は,usersパラメーターと同じ動作をします。拡張した指定方法を使用した場合,「",」はパラメーターの区切り文字,「"¥n(改行)」はパラメーターの終端文字として扱われます。拡張した指定方法で「"」文字を指定値にする場合は,「""」と入力してください。改行文字を含めて2,038バイト以内の半角英数字で指定します。ただし,Storeデータベースに記録されるのは29バイトまでで,最後の文字は「>」となります。
- ここで指定した値は,Workgroup Summary(PI_WGRP)レコードのUsers(USERS)フィールドに表示されます。
- ここには,Process Detail(PD)レコードのReal User(REAL_USER_NAME)フィールドに格納される値を指定します。
- groups=UNIXグループ名
- ワークグループとして情報を収集するUNIXグループ名を,名前で指定します。改行文字を含めて2,040バイト以内の半角英数字で指定します。ただし,Storeデータベースに記録されるのは29バイトまでで,最後の文字は「>」となります。
- 複数のUNIXグループ名を指定する場合,それぞれの名前を一つ以上のコンマまたは空白文字で区切ってください。指定したすべてのグループが監視対象になります。
- ここで指定した値は,Workgroup Summary(PI_WGRP)レコードのGroups(GROUPS)フィールドに表示されます。
- ここには,Process Detail(PD)レコードのReal Group(REAL_GROUP_NAME)フィールドに格納される値を指定します。
- groups_02=UNIXグループ名
- ワークグループとして情報を収集するUNIXグループ名を,名前で指定します。このパラメーターはgroupsパラメーターを拡張して指定するためのものです。
- 指定値の先頭に「"」を付けた場合,次の区切り文字(「",」または「"¥n(改行)」)までが指定値と認識されます。例えば,groupsパラメーターでの区切り文字である空白文字やコンマも指定値に含めることができます。「"」を付けない場合は,groupsパラメーターと同じ動作をします。拡張した指定方法を使用した場合,「",」はパラメーターの区切り文字,「"¥n(改行)」はパラメーターの終端文字として扱われます。拡張した指定方法で「"」文字を指定値にする場合は,「""」と入力してください。改行文字を含めて2,037バイト以内の半角英数字で指定します。ただし,Storeデータベースに記録されるのは29バイトまでで,最後の文字は「>」となります。
- ここで指定した値は,Workgroup Summary(PI_WGRP)レコードのGroups(GROUPS)フィールドに表示されます。
- ここには,Process Detail(PD)レコードのReal Group(REAL_GROUP_NAME)フィールドに格納される値を指定します。
- programs=プログラム名
- ワークグループとして情報を収集する,プロセスによって実行されているプログラム名を指定します。改行文字を含めて2,038バイト以内の半角英数字で指定します。ただし,Storeデータベースに記録されるのは29バイトまでで,最後の文字は「>」となります。
- 複数のプログラム名を指定する場合,それぞれの名前を一つ以上のコンマまたは空白文字で区切ってください。指定したすべてのプログラムが監視対象になります。
- ここで指定した値は,Workgroup Summary(PI_WGRP)レコードのPrograms(PROGRAMS)フィールドに表示されます。
- ここには,Process Detail(PD)レコードのProgram(PROGRAM_NAME)フィールドに格納される値を指定します。
- programs_02=プログラム名
- ワークグループとして情報を収集する,プロセスによって実行されているプログラム名を指定します。このパラメーターはprogramsパラメーターを拡張して指定するためのものです。
- 指定値の先頭に「"」を付けた場合,次の区切り文字(「",」または「"¥n(改行)」)までが指定値と認識されます。例えば,programsパラメーターでの区切り文字である空白文字やコンマも指定値に含めることができます。「"」を付けない場合は,programsパラメーターと同じ動作をします。拡張した指定方法を使用した場合,「",」はパラメーターの区切り文字,「"¥n(改行)」はパラメーターの終端文字として扱われます。拡張した指定方法で「"」文字を指定値にする場合は,「""」と入力してください。改行文字を含めて2,035バイト以内の半角英数字で指定します。ただし,Storeデータベースに記録されるのは29バイトまでで,最後の文字は「>」となります。
- ここで指定した値は,Workgroup Summary(PI_WGRP)レコードのPrograms(PROGRAMS)フィールドに表示されます。
- ここには,Process Detail(PD)レコードのProgram(PROGRAM_NAME)フィールドに格納される値を指定します。
- arguments_02=監視プログラムの引数
- このワークグループの一部として監視するプログラムの引数を指定します。改行文字を含めて2,034バイト以内の半角英数字で指定します。ただし,Storeデータベースに記録されるのは29バイトまでで,最後の文字は「>」となります。複数の引数を指定する場合,それぞれの引数を一つ以上のコンマまたは空白文字で区切ってください。指定したすべての引数が監視対象となります。
- また,このパラメーターは拡張して指定することもできます。指定値の先頭に「"」を付けた場合,次の区切り文字(「",」または「"¥n(改行)」までが指定値と認識されます。例えば,区切り文字である空白文字やコンマも指定値に含めることができます。
- 指定値の先頭に「"」を付けない場合,通常のパラメーターと同じ動作をします。拡張した指定方法を使用した場合,「",」はパラメーターの区切り文字,「"¥n(改行)」はパラメーターの終端文字として扱われます。拡張した指定方法で「"」文字を指定値にする場合は,「""」と入力してください。
- ここで指定した値は,Workgroup Summary(PI_WGRP)レコードのArgument Lists(PI_ARGUMENT_LISTS)フィールドに表示されます。ここには,Process Detail(PD)レコードのArgument List(ARGUMENT_LIST)フィールドに格納される値を指定します。
- regexp=監視条件
- このワークグループの一部として監視するプロセスを,arguments_02,groups,groups_02,programs,programs_02,users,およびusers_02の条件を使って指定します。指定する際に,正規表現を使用できます。この条件は部分一致でプロセス監視をします。
- 複数の式を指定した場合は,ORステートメント(論理和)とみなされます。
- 改行文字を含めて2,040バイト以内の半角英数字で指定します。ただし,arguments_02,groups,groups_02,programs,programs_02,users,およびusers_02の各条件式に30バイト以上の文字を指定した場合,Storeデータベースに記録されるのはそれぞれ29バイトまでで,最後の文字は「>」となります。
- 拡張正規表現については,各OSのマニュアルを参照してください。
- POSIX(Portable Operating System Interface for UNIX)でも指定できます。サフィックス「/i」を使用すると,大文字と小文字を区別しないで定義情報をWorkgroup Summary (PI_WGRP)レコードに格納します。
- 指定例は「(c) ワークグループファイルの指定例」を参照してください。
(c) ワークグループファイルの指定例
ワークグループファイルの指定例を次に示します。
- 例1
- 次の情報を指定する例を次に示します。
- ワークグループ名:sysadmin
- UNIXユーザー名:root
- UNIXグループ名:sys,user,system
- プログラム名:netscape,turkey
![[図データ]](figure/zuu04002.gif)
- 例2
- 次の情報を指定する例を示します。
- ワークグループ名:argument
- UNIXユーザー名:root
- UNIXグループ名:sys
- プログラム名:emacs
- 引数:data.ini
![[図データ]](figure/zuu04003.gif)
- 例3
- 次の情報を指定する例を示します。
- ワークグループ名:programs
- UNIXユーザー名:root
- UNIXグループ名:sys
- プログラム名:space△key,emacs(△は空白文字)
![[図データ]](figure/zuu04004.gif)
- 例4
- 次に示す引数と完全一致するプロセスを定義する例を示します。
- ワークグループ名:development
- 引数:jpcagtu△-d△/opt/jp1pc/agtu/agent(△は空白文字)
![[図データ]](figure/zuu04005.gif)
- 例5
- 次の情報を指定する例を示します。
- ワークグループ名:development
- UNIXグループ名:systemまたはsys
- 引数:quota_"_middle
![[図データ]](figure/zuu04006.gif)
- 例6
- 正規表現を使用して,ユーザー名,グループ名,プログラム名を指定する例を次に示します。
- 正規表現は,各パラメーターとその値を「{」 と「}」で囲むことで使用できます。また,正規表現をコンマ(「,」)で区切って複数指定することもできます。
- 正規表現を使用して次の情報を指定する例を示します。
- UNIXユーザー名:△.*adm.?(△は空白文字)
- UNIXグループ名:.*adm.*
- プログラム名:jpcagt.*,△.*grd△(△は空白文字)
![[図データ]](figure/zuu04007.gif)
- また,上記正規表現を次の情報で指定する例を示します。
- ワークグループ名:perfMonTools
- プログラム名:jpcagtu.*(大文字と小文字を区別しない),.*perfmon,top,monitor,vmstat,iostat,sar
- 引数:ex△process(△は空白文字)
![[図データ]](figure/zuu04008.gif)
(3) アラーム運用例
ワークグループ情報を収集する機能を用いたアラームの設定例について説明します。ここでは,同じプロセス名で複数起動しているプロセスを監視し,プロセスの起動状況がn個以下になった場合にアラームを発行するときの設定内容について説明します。
ワークグループファイルの指定およびアラーム条件の設定内容を次に示します。
- ワークグループファイルの指定
- workgroup=ワークグループ名
- programs=監視したいプログラム名(Process Detail(PD)レコードのProgram(PROGRAM_NAME)フィールドに格納される値を指定します)
- アラームに設定する条件
- Workgroup Summary(PI_WGRP)レコードに対して,次の条件を異常と検知するアラームを定義します。
- workgroup=ワークグループ名
- AND Process Count<=n
- 注意
- nはプロセス数を示します。
(4) PFM - Web Consoleの設定
履歴レポートを表示する場合,PFM - Web Consoleで,Workgroup Summary(PI_WGRP)レコードの情報を収集するように設定します。
設定する方法については,マニュアル「JP1/Performance Management システム構築・運用ガイド」の,稼働監視データの管理について説明している章を参照してください。