概要

システム上で実行中のプロセスが突然終了し、原因についての手がかりがほとんどない場合があります。プロセス自体には、ターミナルやログファイルにエラーを出力する機会がありません。

これはプロセスがクラッシュした場合だけでなく、システム上で実行中の別のプロセスによって強制終了された場合にも起こり得ます。たとえば、一部のウイルス対策ソフトウェアは、潜在的な脅威があると判断したプロセスを独自の判断で強制終了することがあります。プログラムが強制終了されたとき、どのプロセスが原因であるかを知りたいと思うでしょう。通常は、gFlags のようなデバッグツールを使用して、どのプロセスが終了シグナルを送信したかを追跡します。しかし、そのツールがマシンにインストールされていない場合や、本番環境でそのようなツールを使用したくない場合もあります。

バージョン 3.5.42 以降、Wrapper は予期せず終了したときに Windows イベントログへ出力を記録するよう設定できます。監視対象の Java プロセスに対しても、同じ動作を設定できます。

この機能は、以下のプロパティの値を変更するだけで有効または無効にできます。

上記のプロパティを有効にするには、Wrapper を '--setup' 付きで実行する必要があります。管理者権限がまだ付与されていない場合は、資格情報の入力が求められます。

例 1(コマンドラインでセットアップを実行):
> .\wrapper.exe --setup ../conf/wrapper.conf
wrapperm | Registering to the Event Log system...
wrapperm | Enabling silent exit monitoring for the Wrapper process...
wrapperm | Diabling silent exit monitoring for the Java process...
wrapperm | Setup done successfully.

Wrapper がインストールされている src/bin フォルダーには、'SetupApp.bat.in' というテンプレートバッチファイルも用意されています。テンプレートバッチファイルのカスタマイズ方法については、次のページを参照してください。バッチファイルの準備ができたら、それを実行するだけでセットアップを実行できます。

例 2(バッチファイルでセットアップを実行):
> .\SetupTestWrapper.bat
wrapperm | Registering to the Event Log system...
...

監視を有効にすると、Wrapper が終了するたびに Windows イベントログへ出力が生成されます。イベント ビューアー(「コントロール パネル > 管理ツール」内)を開くと、「アプリケーション」セクションに次のような出力が表示されます:

ご覧のとおり、この出力には Wrapper を強制終了したプロセス(この例では Taskmgr.exe)と、Wrapper プロセスの終了コードが表示されます。

終了監視を無効にするには、wrapper.monitor_exit(または wrapper.java.monitor_exit)を DISABLED に設定し、'--setup' コマンド付きで Wrapper を再実行します。あるいは、プロパティはそのままにして、Wrapper を '--teardown' コマンド付きで実行するか、teardown バッチファイルを実行することもできます。

注意

この監視機能が有効な場合、終了コードに関係なく、Wrapper または Java プロセスが終了するたびにイベントログへ出力が記録されます。通常の状況では、イベントログが煩雑になるのを避けるため、この機能を無効にすることをお勧めします。

警告

監視機能はプロセス単位ではなく、バイナリ名単位で有効になります。つまり、同じバイナリ名でマシン上で実行されている他の Wrapper インスタンス(または Java を監視している場合は他の Java プロセス)がある場合、イベントログはそれらのプロセス終了も検出し、対応します。

特定の Wrapper インスタンスのみを監視したい場合は、wrapper.exe の名前を変更して、マシン上で一意の名前を付けることができます。

監視が有効になっている状態で、同じバイナリ名の別の Wrapper インスタンスが起動し、その設定ファイルで wrapper.monitor_exit が ENABLED に設定されていない場合、Wrapper は次の警告をログに記録します:

wrapper  | Exit Monitoring is enabled for the Wrapper process.
wrapper  |  Whenever the process exits, an output indicating the reason/origin of the
wrapper  |  termination will be logged to the Event Log. In normal situations you might
wrapper  |  want disable this feature to avoid cluttering the Event Log.
wrapper  |  If this feature should be enabled set the wrapper.monitor_exit property to 'ENABLED',
wrapper  |  otherwise set it to 'DISABLED' and run the Wrapper with the '--setup' command.

Wrapper プロセスの終了の監視

wrapper.monitor_exit

対応バージョン :3.5.42
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)Alpine Linux (未対応)FreeBSD (未対応)Solaris (未対応)IBM z/Linux (未対応)

Wrapper プロセスがサイレントに終了したときに、イベントログへ出力を記録するかどうかを指定します。

指定可能な値は次のとおりです:

  • [ENABLED] :

    機能を有効にします。

  • [DISABLED] :

    機能を無効にします。

  • [UNCHANGED] :

    機能を現状のままにします。

デフォルト値は UNCHANGED です。

例(Wrapper プロセスの終了を監視):
wrapper.monitor_exit=ENABLED

Java プロセスの終了の監視

wrapper.java.monitor_exit

対応バージョン :3.5.42
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)Alpine Linux (未対応)FreeBSD (未対応)Solaris (未対応)IBM z/Linux (未対応)

Java プロセスがサイレントに終了したときに、イベントログへ出力を記録するかどうかを指定します。

指定可能な値は次のとおりです:

  • [ENABLED] :

    機能を有効にします。

  • [DISABLED] :

    機能を無効にします。

  • [UNCHANGED] :

    機能を現状のままにします。

デフォルト値は UNCHANGED です。

例(Java プロセスの終了を監視):
wrapper.java.monitor_exit=ENABLED

注意

Wrapper の起動時、'--version' 引数付きで Java を起動して Java のバージョンを取得します。Java プロセスの終了監視が有効な場合、イベントログに出力が 1 件追加されます。