7.3.2 監視AP定義ファイル
監視AP定義ファイルには，動作状態を監視するアプリケーション，プロセス，子プロセス，およびサービスを定義します。
- 〈この項の構成〉
(1) 書式
監視AP定義ファイルには，複数の監視対象アプリケーションを記述できます。監視アプリケーションの定義は，一つの監視アプリケーションに関する定義，監視アプリケーションに含まれる一つ以上の監視プロセスまたはサービスに関する定義，および監視プロセスに含まれる0個以上の監視子プロセスに関する定義から構成されています。監視AP定義ファイルの書式を，次に示します。
![[図データ]](GRAPHICS/SS060040.GIF)
(2) 監視アプリケーションに関する定義内容
APMが監視するアプリケーションを定義します。監視するアプリケーションの数だけ繰り返し定義してください。監視対象アプリケーションおよび監視サービスに関する定義内容を，次の表に示します。
|
キー名 |
値 |
|---|---|
|
apname ((128バイト以内の文字列)) |
監視するアプリケーション名を指定します。 「;（セミコロン）」，「,（コンマ）」，タブ，およびマルチバイトコードは指定できません。 |
|
apinfo ((128バイト以内の文字列)) |
監視アプリケーションの付加情報を指定します。 「;（セミコロン）」，タブ，およびマルチバイトコードは指定できません。 |
|
apcommand ((160バイト以内の文字列)) |
アプリケーションを起動または停止させるリモートコマンドを指定します。 この項目は複数指定できます。複数指定する場合，次のように，キー項目「apcommand」を，実行したいコマンドごとに複数行記述します。 例： apcommand=cmd /q /c C:\abc.bat apcommand=cmd /q /c C:\def.bat apcommand=cmd /q /c C:\ghi.bat |
|
psnumber((1以上の整数)) |
アプリケーションに登録するプロセスの数を指定します。 |
|
svcnumber((1以上の整数)) |
アプリケーションに登録するサービスの数を指定します。 |
監視アプリケーションに関する定義の注意事項を次に示します。
-
項目を省略する場合は，値だけを省略し，キー名と「=（イコール）」は必ず記述してください。
-
一つの定義ファイル内に，「apname」の値が同じである定義がある場合は，先に記述されているアプリケーションの定義を有効とし，以降に記述されている定義は無視します。
-
値を複数指定できる項目で，同じ値があった場合は，先に記述されている定義を有効とし，以降の定義は無視します。
-
一つの「apname」配下には「psnumber」と「svcnumber」を同時に指定できません。
-
リモートコマンドについては「2.5.2(4) 自動アクションおよびリモートコマンド」を参照してください。
(3) 監視プロセスに関する定義内容
APMが監視するプロセスを定義します。監視アプリケーションに関する定義の「psnumber」で指定した数だけ繰り返し定義してください。監視プロセスに関する定義内容を次の表に示します。なお，プロセス種別については，「2.5 プロセスおよびサービス監視機能」を参照してください。
|
キー名 |
値 |
|---|---|
|
psname ((CまたはE;60バイト以内の文字列)) |
監視対象のプロセス種別とプロセス名を「;（セミコロン）」で区切って指定します。プロセス名がコマンドライン名の場合は，プロセス種別にCを，実行ファイル名の場合は，プロセス種別にEを指定します。監視サーバがWindowsの場合，拡張子「.exe」を含まない名称でプロセスを指定してください。 ワイルドカードとして「*（アスタリスク）」および「?（疑問符）」を指定できます。 |
|
pscommand ((160バイト以内の文字列)) |
プロセスを起動または停止するリモートコマンドを指定します。この項目は複数指定できます。複数指定する場合，次のように，キー項目「pscommand」を，実行したいコマンドごとに複数行記述します。 例： pscommand=cmd /q /c C:\abc.bat pscommand=cmd /q /c C:\def.bat pscommand=cmd /q /c C:\ghi.bat |
|
psthreshold 《1;1》((0〜9999)) |
しきい値（同時に起動される数）の下限と上限を，「;（セミコロン）」で区切って指定します。上限には，下限と同じ値，またはそれ以上の値を指定してください。 |
|
cpsnumber ((0以上の整数)) |
プロセスに登録する子プロセスの数を指定します。0を指定した場合は，監視子プロセスの定義は不要です。 |
監視プロセスに関する定義の注意事項を次に示します。
-
項目を省略する場合は，値の記述だけを省略し，キー名と「=（イコール）」は必ず記述してください。
-
一つの定義ファイル内に，「psname」の値が同じである定義がある場合は，先に記述されているプロセスの定義を有効とし，以降に記述されている定義は無視します。
-
値を複数指定できる項目で，同じ値があった場合は，先に記述されている定義を有効とし，以降の定義は無視します。
-
リモートコマンドについては「2.5.2(4) 自動アクションおよびリモートコマンド」を参照してください。
(4) 監視子プロセスに関する定義内容
APMが監視する子プロセスを定義します。監視プロセスに関する定義の「cpsnumber」で指定した数だけ繰り返し定義してください。監視子プロセスに関する定義内容を次の表に示します。なお，子プロセスの種別については，「2.5 プロセスおよびサービス監視機能」を参照してください。
|
キー名 |
値 |
|---|---|
|
cpsname ((60バイト以内の文字列)) |
監視対象の子プロセスの種別と子プロセス名を「;（セミコロン）」で区切って指定します。子プロセス名がコマンドライン名の場合は，プロセス種別にCを，実行ファイル名の場合は，プロセス種別にEを指定します。 子プロセスがコマンドライン名の場合はC，実行ファイル名の場合はEを指定します。監視サーバがWindowsの場合，拡張子「.exe」を含まない名称でプロセスを指定してください。 ワイルドカードとして「*（アスタリスク）」および「?（疑問符）」を指定できます。 |
|
cpscommand ((160バイト以内の文字列)) |
子プロセスを起動または停止するリモートコマンドを指定します。 この項目は複数指定できます。複数指定する場合，次のように，キー項目「cpscommand」を，実行したいコマンドごとに複数行記述します。 例： cpscommand=cmd /q /c C:\abc.bat cpscommand=cmd /q /c C:\def.bat cpscommand=cmd /q /c C:\ghi.bat |
|
cpsthreshold 《1;1》((0〜9999)) |
しきい値（同時に起動される数）の下限と上限を，「;（セミコロン）」で区切って指定します。上限には，下限と同じ値，またはそれ以上の値を指定してください。 |
監視子プロセスに関する定義の注意事項を次に示します。
-
項目を省略する場合は，値の記述だけを省略し，キー名と「=（イコール）」は必ず記述してください。
-
一つの定義ファイル内に，「cpsname」の値が同じである定義がある場合は，先に記述されている子プロセスの定義を有効とし，以降に記述されている定義は無視します。
-
値を複数指定できる項目で，同じ値があった場合は，先に記述されている定義を有効とし，以降の定義は無視します。
-
リモートコマンドについては「2.5.2(4) 自動アクションおよびリモートコマンド」を参照してください。
(5) 監視サービスに関する定義内容
APMが監視するサービスを定義します。監視アプリケーションに関する定義でキー名「svcnumber」に記述した数だけ繰り返し記述してください。監視サービスに関する定義内容を次の表に示します。
|
キー名 |
値 |
|---|---|
|
svcname ((100バイト以内の文字列)) |
サービス名を指定します。サービス名には「;（セミコロン）」は使用できません。 サービス名に「*（アスタリスク）」または「?（疑問符）」を使用した場合，通常の文字として扱われ，ワイルドカードとしては指定できません。 サービス表示名による監視はできません。 |
|
svccommand ((160バイト以内の文字列)) |
サービスを起動または停止するリモートコマンドを指定します。この項目は複数指定できます。複数指定する場合，次のように，キー項目「svccommand」を，実行したいコマンドごとに複数行記述します。 例： svccommand=net start xxxxx svccommand=net stop yyyyy svccommand=cmd /q /c C:\abc.bat |
|
svcstatusmap |
監視サービスの状態ごとに正常または危険のどちらで扱うかを設定します。設定方法は，キー名に続き「起動」，「停止」，「中断」，「起動処理中」，「停止処理中」，「中断処理中」，「再開処理中」の順序固定で記述し，各状態間は「;（セミコロン）」で区切ります。 設定値は正常として扱う場合に「N」を，危険として扱う場合に「C」を設定してください。 |
監視サービスに関する定義の注意事項を次に示します。
-
項目を省略する場合は，値の記述だけを省略し，キー名と「=（イコール）」は必ず記述してください。
-
値を複数指定できる項目で，同じ値があった場合は，先に記述されている定義を有効とし，以降の定義は無視します。
-
一つの監視アプリケーションに関する定義内に，キー名「svcname」の値が，同じ監視サービスに関する定義に複数ある場合は，先に記述されている監視サービスに関する定義を有効とし，後に記述されている監視サービスに関する定義は無効とします。
-
リモートコマンドについては「2.5.2(4) 自動アクションおよびリモートコマンド」を参照してください。
(6) 定義例
監視AP定義ファイルの定義例を次に示します。
![[図データ]](GRAPHICS/SS060050.GIF)