- すべてのスーパー・インタフェース:
PlatformManagedObject
public interface HotSpotDiagnosticMXBean extends PlatformManagedObject
HotSpot仮想マシン用の診断管理インタフェースです。
診断MBeanは、ほかのプラットフォームMBeanと同様にプラットフォームMBeanServerに登録されます。
MBeanServer内の診断MXBeanを一意に識別するためのObjectName
は、次のとおりです:
com.sun.management:type=HotSpotDiagnostic
これを取得するには、PlatformManagedObject.getObjectName()
メソッドを呼び出します。 入力引数がnull
の場合は、特に記述がないかぎり、すべてのメソッドがNullPointerException
をスローします。 - 関連項目:
-
ネストされたクラスのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明void
ヒープをhprofヒープ・ダンプと同じ形式でoutputFile
ファイルにダンプします。default void
dumpThreads
(String outputFile, HotSpotDiagnosticMXBean.ThreadDumpFormatPREVIEW format) Preview.指定されたファイルに指定された形式でスレッド・ダンプを生成します。すべての診断オプションについて、VMOption
オブジェクトのリストを返します。getVMOption
(String name) 指定された名前のVMオプションに対するVMOption
オブジェクトを返します。void
setVMOption
(String name, String value) 指定された名前のVMオプションを指定された値に設定します。インタフェース java.lang.management.PlatformManagedObjectで宣言されたメソッド
getObjectName
-
メソッドの詳細
-
dumpHeap
void dumpHeap(String outputFile, boolean live) throws IOException ヒープをhprofヒープ・ダンプと同じ形式でoutputFile
ファイルにダンプします。このメソッドを別のプロセスからリモートで呼び出した場合、ヒープ・ダンプ出力は、ターゲットVMが実行されているマシン上の
outputFile
という名前のファイルに書き込まれます。 outputFileが相対パスの場合は、ターゲットVMが起動した作業ディレクトリの相対パスです。- パラメータ:
outputFile
- システムに依存するファイル名live
-true
がliveオブジェクトのみ(他のオブジェクトからアクセス可能なオブジェクト)をダンプした場合- 例外:
IOException
-outputFile
がすでに存在する場合は、作成、オープン、または書き込むことはできません。UnsupportedOperationException
- この操作がサポートされていない場合。IllegalArgumentException
-outputFile
が".hprof"サフィクスで終わらない場合。NullPointerException
-outputFile
がnull
の場合。SecurityException
- セキュリティ・マネージャが存在し、そのSecurityManager.checkWrite(java.lang.String)
メソッドが指定されたファイルへの書込みアクセスを拒否するか、または呼出し元がManagmentPermission("control")を持っていない場合。
-
getDiagnosticOptions
すべての診断オプションについて、VMOption
オブジェクトのリストを返します。 診断オプションは書込み可能な
VMオプションであり、これは主にトラブルシューティングと診断のために動的に設定できます。- 戻り値:
- すべての診断オプションに対する
VMOption
オブジェクトのリスト。
-
getVMOption
指定された名前のVMオプションに対するVMOption
オブジェクトを返します。- 戻り値:
- 指定された名前のVMオプションの
VMOption
オブジェクト。 - 例外:
NullPointerException
- nameがnull
の場合。IllegalArgumentException
- 指定された名前のVMオプションが存在しない場合。
-
setVMOption
指定された名前のVMオプションを指定された値に設定します。 新しい値は、getVMOption(java.lang.String)
メソッドまたはgetDiagnosticOptions()
メソッドによって返される新しいVMOption
オブジェクトに反映されます。 このメソッドは、このVMOption
オブジェクトの値を変更しません。- パラメータ:
name
- VMオプションの名前value
- 設定されるVMオプションの新しい値- 例外:
IllegalArgumentException
- 指定された名前のVMオプションが存在しない場合。IllegalArgumentException
- 新しい値が無効な場合。IllegalArgumentException
- VMオプションが書き込み可能でない場合。NullPointerException
- 名前または値がnull
の場合。SecurityException
- セキュリティ・マネージャが存在する場合で、呼出し元がManagementPermission("control")を持たない場合。
-
dumpThreads
default void dumpThreads(String outputFile, HotSpotDiagnosticMXBean.ThreadDumpFormatPREVIEW format) throws IOException dumpThreads
は、Javaプラットフォームのリフレクティブ・プレビューAPIです。プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。指定されたファイルに指定された形式でスレッド・ダンプを生成します。outputFile
パラメータは、存在しないファイルへの絶対パスである必要があります。スレッド・ダンプには、すべてのプラットフォーム・スレッドの出力が含まれます。 一部またはすべての仮想スレッドの出力が含まれる場合があります。
- APIのノート:
- 現在の作業ディレクトリが異なるツールまたはプログラムからMXBeanにリモートでアクセスできるため、出力ファイルは絶対パスである必要があります。
- 実装要件:
- デフォルト実装は
UnsupportedOperationException
をスローします。 - パラメータ:
outputFile
- 作成するファイルへのパスformat
- 使用する形式- 例外:
IllegalArgumentException
- ファイル・パスが絶対パスでない場合IOException
- ファイルがすでに存在するか、ファイルに書き込むI/O例外がスローされた場合NullPointerException
- いずれかのパラメータがnull
の場合SecurityException
- セキュリティ・マネージャが設定されていて、そのSecurityManager.checkWrite(java.lang.String)
メソッドがファイルへの書込みアクセスを拒否するか、ManagementPermission("control")
が拒否された場合UnsupportedOperationException
- この操作がサポートされていない場合- 導入されたバージョン:
- 19
-