Wrapper を使う Java アプリケーションをデバッグする

Wrapper には、JVM がその現在の状況のダンプを吐くというリクエストのサポート機能が含まれています。 情報の正確な内容は、JVM の動作次第で変化します。

Oracle の JVM は、実行中のスレッドの全てを スタックトレースをコンソールへ表示します。

IBM の JVM は、もっと役に立つ情報を提供しています。 オブジェクトモニタリング状況同様に、全スレッドの スタックトレース が、コンソールへダンプされます。 それに加えて、ファイルが、カレントディレクトリーに作成され、コンソールに表示される情報に加えて、環境変数の全てを含むシステムについての有効な情報が含まれています。

スレッドダンプを要求するには、 Windows システム上では、［CTRL］＋［BREAK］、 Linux システム上では、［CTRL］＋［\］ のキー操作で要求できます。 スレッドダンプを呼び出すことは、JVM には影響を及ぼさず、通常どおりに動作を継続します。

Wrapper がインストールされた状態では、Linux や Solaris のスタートアップで、バックグランドスレッドで Wrapper を起動します。 それらのスクリプトを使ってスレッドダンプを要求するには、『dump』 パラメータで指定されたスクリプトを単純に再始動してください。

［wrapper.debug］ プロパティを「TRUE」に設定すると、デバッグのログ出力を素早く有効にすることができます。

多くのコンフィギュレーション問題は、コンソール出力のログレベル を ［DEBUG］ に設定すると、素早く解決することができます。 実行中の JVM のバージョン情報同様に、Java を起動するために使われる完全なコマンドは、コンソールに表示されます。 さらに詳しくは、ログ化コンフィギュレーションプロパティ をご覧ください。

コンフィギュレーションファイルで、 インクルードファイル（カスケード形式）を利用している場合には、 「デバッグメッセージを有効」にしてください。 もしライセンスに関する問題に遭遇した場合には、 ［wrapper.license.debug］ プロパティを 「TRUE」 に設定して、 インクルードファイル（カスケード形式）のデバッグを有効にしてください。 併用することで、ほとんどのコンフィギュレーション問題が明らかになります。

［wrapper.java.detect_debug_jvm］ プロパティを 「TRUE」 に設定して 「デバッグ検知」 が有効になっている間、 一部のタイムアウトを無視します。

• [ wrapper.adviser ] (3.1.0)

  よく発生する問題が検知された場合、アドバイスメッセージを表示します。

• [ wrapper.child.status.loglevel ] (3.4.0) ( プロフェッショナル版 )

  チャイルド（子）プロセスに関するメッセージのログレベルをコントロールします。

• [ wrapper.console.loglevel ] (1.0.0)

  コンソールへ出力されるメッセージをログレベルに応じてフィルタリングします。

• [ wrapper.java.command.loglevel ] (3.1.2)

  生成されたコマンドラインのログ出力のログレベルを設定します。

• [ wrapper.logdialog.loglevel ] (3.3.1)

  ログダイアログのメッセージをログレベルに応じてフィルタリングします。

• [ wrapper.logfile.loglevel ] (2.2.5)

  ログファイルへ出力されるメッセージをログレベルに応じてフィルタリングします。

• [ wrapper.ping.alert.loglevel ] (3.5.16)

  ping 警告メッセージをログ化するログレベルを設定します。

• [ wrapper.properties.dump.loglevel ] (3.5.30)

  コンフィギュレーションプロパティーをログ化するログレベルを設定します。

• [ wrapper.property_warning.loglevel ] (3.5.21)

  無効なプロパティ値に関する警告メッセージをログ化するログレベルを設定します。

• [ wrapper.syslog.loglevel ] (2.2.5)

  「syslog」（または Windows のイベントログ）へ送信されるメッセージをログレベルに応じてフィルタリングします。

• [ wrapper.event.default.email.maillog.loglevel ] (3.4.0) ( プロフェッショナル版 )

  メールに含まれるメッセージをログレベルに応じてフィルタリングします。

• [ wrapper.event.<event_name>.loglevel ] (3.3.6)

  指定されたイベントが発生する度にログ化するメッセージのログレベルを設定します。

• [ wrapper.event.<event_name>.message ] (3.3.6) ( プロフェッショナル版 )

  指定されたイベントが発生する度にログ化するメッセージを設定します。

• [ wrapper.event.<event_name>.command.loglevel ] (3.3.0) ( プロフェッショナル版 )

  実行されているイベントコマンドに関するメッセージのログレベルを設定します。