7.3.14 パラメタを含むプロセス稼働監視

機能説明

パラメタを含むプロセスの稼働状態を一定間隔で取得し、プロセスが停止していた場合に任意のイベントを通知します。プロセスの停止状態が続く場合はイベントを通知しません。プロセスが稼働状態になり再び停止状態に変化したときにイベントを通知します。本スクリプト再起動時には、再度イベントを通知します。

最大50プロセスまで監視できます。

図7.2 パラメタを含むプロセス稼働監視スクリプトの運用例

(1) 運用管理サーバから監視対象サーバへ、Systemwalkerスクリプトをポリシー配付します。

(2) 監視対象サーバ上でSystemwalkerスクリプトを起動し、パラメタを含むプロセスの起動数を監視します。

(3) パラメタを含むプロセスの起動数が不足している場合、プロセスが停止している旨のイベントを運用管理サーバへ通知します。

運用管理サーバ、部門管理サーバ、および業務サーバにおいて、本スクリプトによる監視ができます。

各サーバで、本スクリプトをコマンドから実行する場合は、スクリプトの文字コードを各サーバの文字コードに変換して使用してください。

以下の2つのスクリプトファイルを提供します。

動作させるサーバのOS種別により、対応するスクリプトファイルを使用してください。

動作させるサーバのOS	スクリプトファイル名
Windows	apaParamProcessCheckWin.swt
Solaris Linux	apaParamProcessCheckUnix.swt

サンプルスクリプトファイル

OS種別	格納場所とファイル名
Windows	Systemwalkerインストールディレクトリ\mpwalker.dm\mpsc\sample \apaParamProcessCheckWin.swt Systemwalkerインストールディレクトリ\mpwalker.dm\mpsc\sample \apaParamProcessCheckUnix.swt
Linux	/etc/opt/FJSVssc/sample/apaParamProcessCheckWin.swt /etc/opt/FJSVssc/sample/apaParamProcessCheckUnix.swt

実行に必要な権限

Windowsの場合、Administrator権限が必要です。

UNIXの場合、root権限が必要です。

編集可能な項目

下記すべての設定が必要です。

稼働監視間隔設定

監視する間隔の時間（分）を定義します。

1～1439（1分から23時間59分）の範囲で指定します。

発行イベントテキスト

チェックするプロセスが停止状態の場合に発行するイベントテキストを定義します。

%sは監視しているプロセスの表示名に置き換わります。なお、%sは複数設定できません。

エラー種別、ラベル等を含んだ書式で定義することができます。

イベントテキストは2047バイト以内で設定します。表示名を組み込む場合は、表示名を組み込んだイベントテキストが2047バイト以内になるように設定してください。

空文字列を設定することはできません。

監視対象プロセス登録

以下の形式で複数の監視対象プロセスを定義します。

監視できるプロセス数は最大で50です。

識別キー

監視するプロセスを識別するためのキーを設定します。

01から50までの連番で設定します。

監視するプロセス

監視するプロセスとパラメタを定義します。

設定した値と部分一致するプロセスが監視対象になります。

空文字列を設定することはできません。

表示名

プロセスの表示名を入力します。

ここで設定した表示名が発行イベントテキストに埋め込まれます。

プロセス起動数（下限値）

監視対象のプロセスの最低起動数を1～99の間で設定します。

この値より少ない場合に停止状態と判断して発行イベントテキストを通知します。

この値以上のプロセス数になると稼働状態と判断します。

注意事項

本スクリプトが動作するためには、アプリケーション管理機能がインストールされている必要があります。
apaParamProcessCheckWin.swtの動作には「Windows PowerShell 5.1」がインストールされている必要があります。
本スクリプトを1つのシステムで同時に複数起動した場合、正しく動作できません。
複数起動する場合は、起動するすべてのファイル名を異なるファイル名に変更してください。
例）2つのスクリプトを同時に起動する場合
apaParamProcessCheckWinNO1.swt
apaParamProcessCheckWinNO2.swt

プロセスの検出は、以下のコマンド実行により行います。

Windows		"wmic process get commandline"
Solaris (注1)	ゾーン有	"ps -opid -ofname -oargs -z ZNAME" ZNAME:ゾーンの文字列識別子
	ゾーン無	"ps -e -opid -ofname -oargs"
Linux(注2)		"ps -e -opid -ofname -oargs"

注1)監視するプロセス(プロセスとパラメタ)で特定できる長さは、上記コマンドで表示されるプロセスの長さまでです。
注2)監視するプロセス(プロセスとパラメタ)で特定できる長さは、8191バイトまでです。

監視対象プロセスの稼働違反検知後に、監視対象プロセスが起動し稼働違反から復旧しても、本スクリプトが通知したメッセージは自動で対処済になりません。
本スクリプトが監視するプロセスを、Systemwalkerコンソールにアプリケーション情報として登録しても、稼働状態は表示されません。
スクリプトを動作させるサーバのOSに対応したスクリプトを使用してください。
対応していないスクリプトを動作させた場合、スクリプトが異常終了します。OSごとのスクリプトは「機能説明」を参照してください。

使用例

パラメタを含む2つのプロセスの稼働を1時間間隔で確認する例について、Windows版/UNIX版それぞれ示します。

編集内容

【Windows版】

監視プロセス1
コマンドとパラメタ：C:\sample\sample1.exe -l parameter1
必要なプロセスの起動数：2
監視プロセス2
コマンドとパラメタ：C:\sample\sample1.exe -l parameter2_1 parameter2_2
必要なプロセスの起動数：3
動作していない場合の異常通知イベント
AP:apagt: ERROR: 10100: Process is not found (%s)

[稼働監視間隔設定]

set MonitorInterval 60

[発行イベントテキスト]

set OutMessage {AP:apagt: ERROR: 10100: Process is not found (%s)}

[監視対象プロセス登録]

set Chkno "01"
set TargetProcess($Chkno) {C:\sample\sample1.exe -l parameter1}
set Disp_Name($Chkno) "process1"
set Lower($Chkno) 2
set Chkno "02"
set TargetProcess($Chkno) {C:\sample\sample1.exe -l parameter2_1 parameter2_2}
set Disp_Name($Chkno) "process2"
set Lower($Chkno) 3

【UNIX版】

監視プロセス1
コマンドとパラメタ：/sample1/process1 -l parameter1
必要なプロセスの起動数：2
監視プロセス2
コマンドとパラメタ：/sample2/process2 -l parameter2_1 parameter2_2
必要なプロセスの起動数：3
動作していない場合の異常通知イベント
UX:apagt: ERROR: 10100: Process is not found (%s)

[稼働監視間隔設定]

set MonitorInterval 60

[発行イベントテキスト]

set OutMessage {UX:apagt: ERROR: 10100: Process is not found (%s)}

[監視対象プロセス登録]

set Chkno "01"
set TargetProcess($Chkno) "/sample1/process1 -l parameter1"
set Disp_Name($Chkno) "process1"
set Lower($Chkno) 2
set Chkno "02"
set TargetProcess($Chkno) "/sample2/process2 -l parameter2_1 parameter2_2"
set Disp_Name($Chkno) "process2"
set Lower($Chkno) 3

実行結果例

【Windows版】

[set Chkno "02"]で定義した2つ目のプロセスにおいて、起動しているプロセス数が3より少ない場合は、以下のイベントを発行します。

AP:apagt: ERROR: 10100: Process is not found (process2)

【UNIX版】

[set Chkno "02"]で定義した2つ目のプロセスにおいて、起動しているプロセス数が3より少ない場合は、以下のイベントを発行します。

UX:apagt: ERROR: 10100: Process is not found (process2)

エラーメッセージ

スクリプトが異常終了した場合、エラーメッセージを出力します。

メッセージ出力先

エラーメッセージの出力先は、スクリプトの起動方法により異なります。

ポリシー運用による起動の場合
出力先ディレクトリ：
Windows
%swinst%\MPWALKER.DM\mpsc\log
%swinst% は、Systemwalkerインストールディレクトリ
Solaris
Linux
/var/opt/FJSVssc/log
出力ファイル名：
at_実行名0.log
at_実行名1.log
例）実行名が apaParamProcessCheckWin.swt の場合
at_apaParamProcessCheckWin.swt0.log
at_apaParamProcessCheckWin.swt1.log
ポリシー運用により起動されたスクリプトの出力ファイルについては、“Systemwalker Centric Manager API・スクリプトガイド”の“ポリシーの設定”を参照してください。

スクリプト起動コマンドによる起動の場合
標準エラー出力

出力メッセージ

異常終了時は、以下の異常通知イベントがSystemwalkerコンソールに通知されます。

【Windows】

AP:apaagt: ERROR: 7000: The process operation monitoring script containing parameters terminated abnormally.

【Solaris】【Linux】

UX:apaagt: ERROR: 7000: The process operation monitoring script containing parameters terminated abnormally.

また、同時刻にログファイルまたは標準エラー出力にエラーメッセージが出力されます。エラーメッセージの対処方法に従って対処してください。

上記の異常通知イベントおよびログファイルまたは標準エラー出力に出力されるエラーメッセージの詳細については、“Systemwalker Centric Manager メッセージ説明書”を参照してください。