jhat

Section: トラブルシューティング・ツール (1)
Updated: 2013年11月21日
Page Index
 

名前

jhat - Javaヒープを分析します。このコマンドは試験的なもので、サポートされていません。  

概要

jhat [ options ] heap-dump-file 

options

コマンド行オプション。オプションを参照してください。

heap-dump-file

ブラウズ対象となるJavaバイナリ・ヒープ・ダンプ・ファイル。複数のヒープ・ダンプを含むダンプ・ファイルの場合、myfile.hprof#3のようにファイル名の後に#<number>を付加することで、ファイル内の特定のダンプを指定できます。
 

説明

jhatコマンドはJavaヒープ・ダンプ・ファイルを解析し、Webサーバーを開始します。jhatコマンドを使用して、お気に入りのブラウザでヒープ・ダンプを参照できます。jhatコマンドは、既知のクラスMyClassのすべてのインスタンスを表示するなどの事前設計済の問合せやObject Query Language (OQL)をサポートします。ヒープ・ダンプの問合せを除き、OQLはSQLに似ています。OQLのヘルプには、jhatコマンドによって表示されるOQLヘルプ・ページからアクセスできます。デフォルト・ポートを使用する場合、OQLのヘルプはhttp://localhost:7000/oqlhelp/で利用可能です。

Javaのヒープ・ダンプを生成するには、次のいくつかの方法があります。

jmap -dumpオプションを使用して実行時にヒープ・ダンプを取得します。jmap(1)を参照してください。

jconsoleオプションを使用してHotSpotDiagnosticMXBean経由で実行時にヒープ・ダンプを取得します。jconsole(1)およびHotSpotDiagnosticMXBeanのインタフェースの説明( http://docs.oracle.com/javase/8/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html)を参照してください。

• ヒープ・ダンプは、-XX:+HeapDumpOnOutOfMemoryError Java Virtual Machine (JVM)オプションを指定することで、OutOfMemoryErrorがスローされたときに生成されます。

hprofコマンドを使用します。HPROF: Heap/CPUプロファイリング・ツール (http://docs.oracle.com/javase/8/docs/technotes/samples/hprof.html)を参照してください
 

オプション

-stack false|true

オブジェクト割当呼出しスタックの追跡を無効にします。ヒープ・ダンプ内で割当サイト情報が使用できない場合、このフラグをfalseに設定する必要があります。デフォルトはtrueです。

-refs false|true

オブジェクトへの参照の追跡を無効にします。デフォルトはtrueです。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ(指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる)が計算されます。

-port port-number

jhatのHTTPサーバーのポートを設定します。デフォルトは7000です。

-exclude exclude-file

到達可能なオブジェクトの問合せから除外する必要があるデータ・メンバーの一覧を含むファイルを指定します。たとえば、このファイルにjava.lang.String.valueが含まれていた場合、特定のオブジェクトoから到達可能なオブジェクトのリストを計算する際に、java.lang.String.valueフィールドに関連する参照パスが考慮されなくなります。

-baseline exclude-file

ベースラインとなるヒープ・ダンプを指定します。両方のヒープ・ダンプ内で同じオブジェクトIDを持つオブジェクトは新規ではないとしてマークされます。他のオブジェクトは新規としてマークされます。これは、異なる2つのヒープ・ダンプを比較する際に役立ちます。

-debug int

このツールのデバッグ・レベルを設定します。レベル0はデバッグ出力がないことを意味します。より大きな値を設定すると、より冗長なモードになります。

-version

リリース番号をレポートして終了します

-h

ヘルプ・メッセージを表示して終了します。

-help

ヘルプ・メッセージを表示して終了します。

-Jflag

jhatコマンドを実行しているJava Virtual Machineにflagを渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、-J-Xmx512mとします。
 

関連項目

jmap(1)

jconsole(1)

• HPROF: Heap/CPUプロファイリング・ツール (http://docs.oracle.com/javase/8/docs/technotes/samples/hprof.html)


 

Index

名前
概要
説明
オプション
関連項目