Interstage Application Server/Interstage Web Server Express トラブルシューティング集

A.3 スレッドダンプツール

■スレッドダンプツールとは

  スレッドダンプツールは、Java VMのスレッドダンプ（コマンドプロンプトから[Ctrl]キーを押しながら[Break]キーを押し採取したスレッドダンプ）と同じく、各スレッドの状態を出力し、プログラム全体や、各スレッドの実行状況を解析する助けとなるスレッドダンプを出力する機能です。

  スレッドダンプツールは、Java VMのスレッドダンプ出力に以下の機能を追加しています。

• ファイル出力
  オプション(-f)で指定したファイルに、スレッドダンプを出力できます。
  

• ヘッダー、フッター出力
  標準出力や標準エラー出力にスレッドダンプを出力した場合、アプリケーションのログファイル(ServletやEJBの標準出力、あるいはJava VMの出力を格納するファイルなど)に、そのスレッドダンプが含まれることになります。ヘッダーやフッターは、そのログファイルを参照する場合に、目印となる情報です。(-fオプションを指定した場合も出力します。)
  ヘッダーには、スレッドダンプの採取日時、コマンドラインおよび、メモリの使用状況の情報が含まれます。

  なお、Java VMのスレッドダンプ出力の操作方法は、“チューニングガイド”の[JDK/JREのチューニング] > [チューニング/デバッグ技法] > [スレッドダンプ]を参照してください。

■動作環境

サポート対象のJDK/JRE

  製品添付のJDK/JRE

■2種類のコマンド

スレッドダンプツールには、以下の2種類のコマンドがあります。

• 通常のアプリケーション(ユーザが起動するプログラム)として動作するthdumpコマンド

• Windowsサービス(システム内に常駐して動作するプログラム)として動作するthdumpSVCコマンド

これら2種類のコマンドは、以下にしたがって使い分けてください。

• Javaプログラムが、通常のアプリケーションとして動作している場合は、thdumpコマンドを使用してください。

• Javaプログラムが、Windowsサービスとして動作している場合は、thdumpSVCコマンドを使用してください。

例えば、以下はWindowsサービスとして動作するので、スレッドダンプを採取するためにはthdumpSVCコマンドを使用します。

• Java EE実行環境

  • IJServerクラスタ

  • Interstage Java EE DASサービス

  • Interstage Java EE Node Agentサービス

  • Interstage JMX サービス

• J2EE実行環境

  • IJServerワークユニット

なお、各コマンドには、機能的な相違点はありません。

■格納先

  格納先は次のとおりです（製品を“C:\Interstage”にインストールした場合）。

• thdumpコマンド:

  • C:\Interstage\jdk6\tools\thdump (JDK 6)

  • C:\Interstage\jre6\tools\thdump (JRE 6)

  • C:\Interstage\jdk7\tools\thdump (JDK 7)

  • C:\Interstage\jre7\tools\thdump (JRE 7)

• thdumpSVCコマンド:

  • C:\Interstage\jdk6\tools\thdump\thdumpSVC (JDK 6)

  • C:\Interstage\jre6\tools\thdump\thdumpSVC (JRE 6)

  • C:\Interstage\jdk7\tools\thdump\thdumpSVC (JDK 7)

  • C:\Interstage\jre7\tools\thdump\thdumpSVC (JRE 7)