Interstage Application Server/Interstage Web Server トラブルシューティング集
目次 索引 前ページ次ページ

付録A Javaツール機能> A.3 Qualyzer

A.3.3 メモリ(ヒープ)ダンプ機能の使用方法

■実行形式

 メモリ(ヒープ)ダンプは、次の3つのステップで行います。

1. ヒープ情報収集

JDK/JRE 5.0(シリアルGC)の場合:

java -XX:-UseParallelGC -Xrunholmes[:t=depth][,f=0|1][,d=folder][,b=0|1|2|3|4] クラス名

JDK/JRE 1.4の場合:

java -Xrunholmes[:t=depth][,f=0|1][,d=folder][,b=0|1|2|3|4] クラス名

2. HTML/CSVファイル生成

java -jar holmes.jar [-i input-folder] [-o output-folder] [-heap[,frame]|-csv]

3. ヒープ情報表示

java -jar holmes.jar -h html-folder [-i input-folder] -view[,frame]

情報収集したデータが大きい場合、HTML/CSVファイル生成において、OutOfMemoryErrorが発生することがあります。必要に応じて-Xmxオプションで最大使用可能量を調節してください。

情報収集しているJava VMのプロセスに対して、SIGQUITを発行し、それまで収集した情報を一旦ファイルに出力できます。

kill -QUIT process-id

■オプション

 “実行形式”で示した各ステップのオプションを説明します。

◆ヒープ情報収集オプション

t=depth

call stack情報を精査する深さを、depthに指定します。
省略値は、t=5です。

f=0|1

ヒープ情報を収集する直前に、GCを起動するかどうか指定します。

 無効です。ヒープ情報を収集する直前に、GCを起動しません。

  • f=0:ヒープ情報を収集する直前に、GCを起動しません。
  • f=1:ヒープ情報を収集する直前に、GCを起動します。省略値です。

d=folder

ヒープ情報格納先ディレクトリを、folderに指定します。ディレクトリは存在している必要があります。
省略値は、Java VMの作業ディレクトリです。
このオプションで指定されたディレクトリの下に、qua.${PID}というディレクトリが作成されます。${PID}はヒープ情報収集が実行されているJava VMのプロセスIDです。各データファイルは、このディレクトリの下に作成されます。

b=0|1|2|3|4

ssbを利用したヒープ情報収集の一時停止・再開・出力を行えるようにします。ssbの使用方法は“情報収集制御の方法”を参照してください。

  • b=0     :ssbを利用しない場合に指定します。省略値です。
  • b=1またはb=3:Java VMが単独で動作している環境で、ssbを利用する場合に指定します。
  • b=2またはb=4:Java VMが複数で動作している環境で、ssbを利用する場合に指定します。

注) b=1(b=2)とb=3(b=4)のどちらを指定するかは動作環境に依存します。そのため、b=1(b=2)で正しく動作しなかった場合、b=3(b=4)を指定してください。

◆HTML/CSVファイル生成オプション

-i input-folder

ヒープ情報格納先ディレクトリを、input-folderに指定します。
省略値は、Java VMの作業ディレクトリです。

-o output-folder

HTML/CSVファイル格納先ディレクトリを、output-folderに指定します。ディレクトリは存在している必要があります。
省略値は、Java VMの作業ディレクトリです。

-heap

ヒープ情報が、フレームなしHTMLファイルに構成されます。

frame

heapオプションのサブオプションです。
ヒープ情報が、フレームありHTMLファイルに構成されます。

-csv

ヒープ情報が、CSV形式のファイルに構成されます。

◆ヒープ情報表示オプション

-h html-folder

HTMLファイル格納先ディレクトリを、html-folderに指定します。

-i input-folder

ヒープ情報格納先ディレクトリを、input-folderに指定します。
省略値は、Java VMの作業ディレクトリです。

-view

HTMLファイルが表示されます。

frame

viewオプションのサブオプションです。
フレームありHTMLファイルが表示されます。


目次 索引 前ページ次ページ

Copyright 2008 FUJITSU LIMITED