カスタム監視項目定義ファイル(monitoringitems.cfg)
機能
JP1/SLMと連携している環境で,任意のレコード・フィールドを監視項目として定義するファイルです。デフォルト監視項目にない値をJP1/SLMで分析したい場合に使用します。PFM - AgentおよびPFM - RMの種別,データモデルごとに54件まで定義できます。
ファイル名
monitoringitems.cfg(カスタム監視項目定義ファイル)
格納先
- Windows
-
-
物理ホストの場合
インストール先フォルダ\ITSLM\
-
論理ホストの場合
環境ディレクトリ\jp1pc\ITSLM\
-
- UNIX
-
-
物理ホストの場合
/opt/jp1pc/ITSLM/
-
論理ホストの場合
環境ディレクトリ/jp1pc/ITSLM/
-
注意事項
カスタム監視項目定義ファイル(monitoringitems.cfg)には,次に示す規則があります。
-
ラベルの設定値は,「ラベル名=設定値」の形式で指定します。
-
ラベル名または設定値の前後の空白文字(半角空白,タブ,垂直タブ,用紙送り文字)はすべて無視されます。
-
行頭から連続する空白文字を除く文字列が「#」で始まる行はコメント行として扱われます。
-
改行はCR,LF,CR+LFのどれかで認識されます。ただし,ファイル内の改行コードは統一してください。統一しない場合,実際にはエラーの無い項目がエラーとなることがあります。また,エラーメッセージで,エラーが発生した個所を示す行番号がエディターなどで表示される行番号とずれることがあります。
-
改行だけまたは空白文字と改行だけで記載された行は無視されます。
-
省略できるラベルは,ラベルそのものを記載しない場合および設定値だけを記載しない場合に,値を省略したものと見なされます。(設定値だけを記載しない場合,ラベル名の後の「=」は必要です)
-
[Agent]セクションを記載せずに[[Monitoring Item]]サブセクションを記載するなど,入力規則に従わない記載がある場合,カスタム監視項目定義ファイル全体の記載が無効になります。
-
[Agent]セクションのProductラベルの省略またはProductラベルの指定値に誤りがある場合,該当する[Agent]セクションおよび該当する[Agent]セクションの下にある[[Monitoring Item]]サブセクションすべてが無効になります。
-
サブセクション内で同じラベルを複数記載した場合,該当する[[Monitoring Item]]サブセクションは無効になります。
-
[[Monitoring Item]]サブセクション内の必須ラベルの省略またはラベルの指定値に誤りがある場合,該当する[[Monitoring Item]]サブセクションは無効になります。
-
[[Monitoring Item]]サブセクション内のラベルの記載順序は任意です。(サブセクション内で記載順序を変更しても動作に影響はありません)
-
PFM - AgentおよびPFM - RMの種別とデータモデルバージョン,レコード,フィールドが同一の定義がデフォルト監視項目として定義されている場合,デフォルト監視項目は無効になり,カスタム監視項目として指定したものだけが有効になります。
-
PFM - AgentおよびPFM - RMの種別とデータモデルバージョン,レコード,フィールドが同一の定義が複数指定されている場合,最もファイルの先頭近くで指定されたもの1つだけが有効になります。
変更手順
「カスタム監視項目定義ファイル(monitoringitems.cfg)の変更手順」を参照してください。
設定項目
項目 |
説明 |
||
---|---|---|---|
セクション |
サブセクション |
ラベル名 |
|
− |
− |
ITSLM Monitoring Items Definition File Version |
監視項目定義ファイルの構文のバージョンを指定します。
|
ITSLM Monitoring Items Definition File Code※1 |
監視項目定義ファイルを記述している文字コードを指定します。
|
||
[Agent] |
− |
− |
この項目はセクション名のため,変更できません。 PFM - AgentおよびPFM - RMのプロダクトID・データモデルバージョンごとにセクションを作成します。 |
Product |
PFM - AgentおよびPFM - RMの種別とデータモデルバージョンを指定します。
|
||
[[Monitoring Item]] |
− |
この項目はサブセクション名のため,変更できません。 定義する監視項目ごとにサブセクションを作成します。 プロダクトID・データモデルバージョンごとに54件まで定義できます。55件以上有効な定義がある場合は,55件目以降が無視されます。 |
|
Record |
監視する対象のレコードを指定します。
|
||
Field※4 |
監視する対象のレコードのフィールドを指定します。同一レコード,同一フィールドの指定が複数ある場合は,最も上に定義されている有効な定義が使用されます。
|
||
Key Field※4 |
収集されたレコードを一意にするための情報を指定します。監視項目がマルチインスタンスレコードの場合だけ指定できます。シングルインスタンスレコードの場合は指定しても無視されます。
|
||
Display Name.ja |
JP1/SLMに表示する監視項目名(日本語)を指定します。
|
||
Display Name.en |
JP1/SLMに表示する監視項目名(英語)を指定します。
|
||
Display Unit.ja |
JP1/SLMで使用する監視項目の単位(日本語)を指定します。
|
||
Display Unit.en |
JP1/SLMで使用する監視項目の単位(英語)を指定します。
|
||
Threshold |
しきい値種別を指定します。
|
データ型 |
サイズ |
JP1/SLM 連携可否 |
備考 |
||
---|---|---|---|---|---|
フィールド |
CおよびC++ |
Field |
Key Field |
||
char |
char |
1 |
○ |
○ |
− |
char(n)※ |
char[ ] |
n |
× |
○ |
数値型ではないので監視項目としては設定できません。 |
double |
double |
8 |
○ |
× |
浮動小数は完全一致のキーとして設定できません。 |
float |
float |
4 |
○ |
× |
浮動小数は完全一致のキーとして設定できません。 |
long |
long |
4 |
○ |
○ |
− |
short |
short |
2 |
○ |
○ |
− |
string |
char |
1 |
○ |
○ |
数値型を意図した型ではありませんが,長さ1では数値型と同等に使用できます。 |
string(n)※ |
char[ ] |
n |
× |
○ |
数値型ではないので監視項目としては設定できません。 |
time_t |
unsigned long |
4 |
○ |
× |
経過ミリ秒は完全一致のキーとして設定できません。 |
ulong |
unsigned long |
4 |
○ |
○ |
− |
utime |
utime(構造体) |
8 |
× |
× |
構造体であるため,監視項目,キーフィールドどちらとしても設定できません。 |
word |
unsigned short |
2 |
○ |
○ |
− |
(該当なし) |
unsigned char |
1 |
○ |
○ |
− |
定義例
カスタム監視項目定義ファイルの記述例を次に示します。
ITSLM Monitoring Items Definition File Version=0001 ITSLM Monitoring Items Definition File Code=Shift_JIS [Agent] Product=T8.0 …Agent for Platform(Windows)8.0の場合 [[Monitoring Item]] Record=PI …System Overviewレコードの場合 Field=PCT_PHYSICAL_MEMORY …% Physical Memフィールドの場合 Key Field= …シングルインスタンスレコードは省略できる Display Name.ja=物理メモリー使用率 Display Name.en=Physical Mem Usage Display Unit.ja= …日本語は省略でき,Display Unit.enが使用される Display Unit.en=% Threshold=High [[Monitoring Item]] …複数の監視項目を定義する場合は複数書く Record=PI_LOGD Field=PCT_DISK_USAGE Key Field=INSTANCE …マルチインスタンスレコードのため省略できない : [Agent] …続けてほかのプロダクトID,データモデルバージョンを記載する Product=U7.8 [[Monitoring Item]] Record=PI Field=PCT_PHYSICAL_MEMORY :