モジュール jdk.management
パッケージ com.sun.management

インタフェースHotSpotDiagnosticMXBean

すべてのスーパー・インタフェース:
PlatformManagedObject
public interface HotSpotDiagnosticMXBean extends PlatformManagedObject
HotSpot仮想マシン用の診断管理インタフェースです。

診断MBeanは、ほかのプラットフォームMBeanと同様にプラットフォームMBeanServerに登録されます。

MBeanServer内の診断MXBeanを一意に識別するためのObjectNameは、次のとおりです:

com.sun.management:type=HotSpotDiagnostic
これを取得するには、PlatformManagedObject.getObjectName()メソッドを呼び出します。 入力引数がnullの場合は、特に記述がないかぎり、すべてのメソッドがNullPointerExceptionをスローします。

関連項目:

  • ネストされたクラスのサマリー

    ネストされたクラス
    修飾子と型
    インタフェース
    説明
    static enum 
    HotSpotDiagnosticMXBean.ThreadDumpFormat
    スレッドのダンプ形式。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    dumpHeap(String outputFile, boolean live)
    ヒープをhprofヒープ・ダンプと同じ形式でoutputFileファイルにダンプします。
    default void
    dumpThreads(String outputFile, HotSpotDiagnosticMXBean.ThreadDumpFormat format)
    指定されたファイルに指定された形式でスレッド・ダンプを生成します。
    List<VMOption>
    getDiagnosticOptions()
    すべての診断オプションについて、VMOptionオブジェクトのリストを返します。
    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

      List<VMOption> getDiagnosticOptions()
      すべての診断オプションについて、VMOptionオブジェクトのリストを返します。 診断オプションは書込み可能な VMオプションであり、これは主にトラブルシューティングと診断のために動的に設定できます。
      戻り値:
      すべての診断オプションに対するVMOptionオブジェクトのリスト。

    • getVMOption

      VMOption getVMOption(String name)
      指定された名前のVMオプションに対するVMOptionオブジェクトを返します。
      戻り値:
      指定された名前のVMオプションのVMOptionオブジェクト。
      例外:
      NullPointerException - nameがnullの場合。
      IllegalArgumentException - 指定された名前のVMオプションが存在しない場合。

    • setVMOption

      void setVMOption(String name, String value)
      指定された名前の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.ThreadDumpFormat format) throws IOException
      指定されたファイルに指定された形式でスレッド・ダンプを生成します。 outputFileパラメータは、存在しないファイルへの絶対パスである必要があります。

      スレッド・ダンプには、すべてのプラットフォーム・スレッドの出力が含まれます。 一部またはすべての仮想スレッドの出力が含まれる場合があります。

      APIのノート:
      現在の作業ディレクトリが異なるツールまたはプログラムからMXBeanにリモートでアクセスできるため、出力ファイルは絶対パスである必要があります。
      実装要件:
      デフォルト実装はUnsupportedOperationExceptionをスローします。
      パラメータ:
      outputFile - 作成するファイルへのパス
      format - 使用する形式
      例外:
      IllegalArgumentException - ファイル・パスが絶対パスでない場合
      IOException - ファイルがすでに存在するか、ファイルに書き込むI/O例外がスローされた場合
      NullPointerException - いずれかのパラメータがnullの場合
      SecurityException - セキュリティ・マネージャが設定されていて、そのSecurityManager.checkWrite(java.lang.String)メソッドがファイルへの書込みアクセスを拒否するか、ManagementPermission("control")が拒否された場合
      UnsupportedOperationException - この操作がサポートされていない場合
      導入されたバージョン:
      21