インタフェースOperatingSystemMXBean

すべてのスーパー・インタフェース:
OperatingSystemMXBean, PlatformManagedObject
既知のすべてのサブインタフェース:
UnixOperatingSystemMXBean
public interface OperatingSystemMXBean extends OperatingSystemMXBean
Java仮想マシンが実行されているオペレーティング・システムのプラットフォーム固有の管理インタフェースです。

このインタフェースは、Java仮想マシンが実行されている操作環境についての情報を提供します。 ネイティブ・オペレーティング・システム、仮想化オペレーティング・システム環境またはコンテナ管理環境が該当します。

ManagementFactory.getOperatingSystemMXBean()によって返されるOperatingSystemMXBeanオブジェクトは、基礎となるオペレーティング・システムに応じて、このインタフェースまたはUnixOperatingSystemMXBeanインタフェースの実装クラスのインスタンスです。

導入されたバージョン:
1.5

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    long
    getCommittedVirtualMemorySize()
    実行中のプロセスで使用可能であることが保証されている仮想メモリーの量をバイト単位で返します。この操作がサポートされていない場合は、-1を返します。
    double
    getCpuLoad()
    オペレーティング環境の"最近のCPU使用率"を返します。
    long
    getFreeMemorySize()
    空きメモリーの容量をバイト単位で返します。
    default long
    getFreePhysicalMemorySize()
    非推奨。
    この履歴名前付きメソッドではなくgetFreeMemorySize()を使用してください。
    long
    getFreeSwapSpaceSize()
    空きスワップ空間の容量をバイト単位で返します。
    double
    getProcessCpuLoad()
    Java Virtual Machineプロセスの"最近のCPU使用率"を返します。
    long
    getProcessCpuTime()
    Java仮想マシンが実行されているプロセスで使用されるCPU時間をナノ秒単位で返します。
    default double
    getSystemCpuLoad()
    非推奨。
    この履歴名前付きメソッドではなくgetCpuLoad()を使用してください。
    long
    getTotalMemorySize()
    メモリーの合計量をバイト単位で返します。
    default long
    getTotalPhysicalMemorySize()
    非推奨。
    この履歴名前付きメソッドではなくgetTotalMemorySize()を使用してください。
    long
    getTotalSwapSpaceSize()
    スワップ空間の合計容量をバイト単位で返します。

    インタフェースで宣言されたメソッド OperatingSystemMXBean

    getArch, getAvailableProcessors, getName, getSystemLoadAverage, getVersion
    修飾子と型
    メソッド
    説明
    String
    getArch()
    オペレーティング・システムのアーキテクチャを返します。
    int
    getAvailableProcessors()
    Java仮想マシンが使用できるプロセッサの数を返します。
    String
    getName()
    オペレーティング・システム名を返します。
    double
    getSystemLoadAverage()
    最後の1分のシステム負荷平均を返します。
    String
    getVersion()
    オペレーティング・システムのバージョンを返します。

    インタフェースで宣言されたメソッド PlatformManagedObject

    getObjectName
    修飾子と型
    メソッド
    説明
    ObjectName
    getObjectName()
    このプラットフォーム管理対象オブジェクトのオブジェクト名を表すObjectNameインスタンスを返します。

  • メソッドの詳細

    • getCommittedVirtualMemorySize

      long getCommittedVirtualMemorySize()
      実行中のプロセスで使用可能であることが保証されている仮想メモリーの量をバイト単位で返します。この操作がサポートされていない場合は、-1を返します。
      戻り値:
      実行中のプロセスが使用できることが保証される仮想メモリーの量(バイト単位)、またはこの操作がサポートされていない場合は-1。

    • getTotalSwapSpaceSize

      long getTotalSwapSpaceSize()
      スワップ空間の合計容量をバイト単位で返します。
      戻り値:
      スワップ空間の合計容量(バイト単位)。

    • getFreeSwapSpaceSize

      long getFreeSwapSpaceSize()
      空きスワップ空間の容量をバイト単位で返します。
      戻り値:
      空きスワップ空間の容量(バイト単位)。

    • getProcessCpuTime

      long getProcessCpuTime()
      Java仮想マシンが実行されているプロセスで使用されるCPU時間をナノ秒単位で返します。 戻り値はナノ秒単位の精度ですが、必ずしもナノ秒の正確度ではありません。 このメソッドは、プラットフォームがこの操作をサポートしていない場合、-1を返します。
      戻り値:
      プロセスで使用されるCPU時間(ナノ秒単位)。この操作がサポートされていない場合は-1。

    • getFreePhysicalMemorySize

      @Deprecated(since="14") default long getFreePhysicalMemorySize()
      非推奨。
      この履歴名前付きメソッドではなくgetFreeMemorySize()を使用してください。
      空き物理メモリーの容量をバイト単位で返します。
      実装要件:
      この実装は、getFreeMemorySize()と同じ値を戻す必要があります。
      戻り値:
      空き物理メモリーの容量(バイト単位)。

    • getFreeMemorySize

      long getFreeMemorySize()
      空きメモリーの容量をバイト単位で返します。
      戻り値:
      空きメモリーの容量(バイト単位)。
      導入されたバージョン:
      14

    • getTotalPhysicalMemorySize

      @Deprecated(since="14") default long getTotalPhysicalMemorySize()
      非推奨。
      この履歴名前付きメソッドではなくgetTotalMemorySize()を使用してください。
      物理メモリーの合計容量をバイト単位で返します。
      実装要件:
      この実装は、getTotalMemorySize()と同じ値を戻す必要があります。
      戻り値:
      物理メモリーの合計容量(バイト単位)。

    • getTotalMemorySize

      long getTotalMemorySize()
      メモリーの合計量をバイト単位で返します。
      戻り値:
      メモリーの合計量(バイト)。
      導入されたバージョン:
      14

    • getSystemCpuLoad

      @Deprecated(since="14") default double getSystemCpuLoad()
      非推奨。
      この履歴名前付きメソッドではなくgetCpuLoad()を使用してください。
      システム全体の"最近のCPU使用率"を返します。 これは、[0.0,1.0]間隔のdouble値です。 0.0という値は最近の監視期間中にすべてのCPUがアイドル状態だったことを意味し、1.0という値は最近の監視期間中にすべてのCPUが常時アクティブに動作していたことを意味します。 最近の観察期間は実装固有であり、通常は、このメソッドに対する最後のコール以降の期間(getCpuLoad())に関連しています。 最初の呼出しでは、最近の観測期間は未定義です。 0.0から1.0までのすべての値は、進行中のアクティビティに応じて指定できます。 最近のCPU使用率が使用できない場合、メソッドは負の値を返します。
      APIのノート:
      発信者は、他の発信者が観測期間と結果に影響を及ぼす可能性を認識する必要があります。
      実装要件:
      この実装は、getCpuLoad()と同じ値を戻す必要があります。
      戻り値:
      システム全体の「最新のCPU使用率」。取得できない場合は負の値。
      導入されたバージョン:
      1.7

    • getCpuLoad

      double getCpuLoad()
      オペレーティング環境の"最近のCPU使用率"を返します。 これは、[0.0,1.0]間隔のdouble値です。 0.0という値は最近の監視期間中にすべてのCPUがアイドル状態だったことを意味し、1.0という値は最近の監視期間中にすべてのCPUが常時アクティブに動作していたことを意味します。 最近の観察期間は実装固有であり、通常は、このメソッドに対する最後のコール以降の期間(getSystemCpuLoad())に関連しています。 最初の呼出しでは、最近の観測期間は未定義です。 0.0から1.0までのすべての値は、進行中のアクティビティに応じて指定できます。 最近のCPU使用率が使用できない場合、メソッドは負の値を返します。
      APIのノート:
      発信者は、他の発信者が観測期間と結果に影響を及ぼす可能性を認識する必要があります。
      戻り値:
      オペレーティング環境全体のための"最近のcpu使用状況"。使用できない場合は、負の値になります。
      導入されたバージョン:
      14

    • getProcessCpuLoad

      double getProcessCpuLoad()
      Java Virtual Machineプロセスの"最近のCPU使用率"を返します。 これは、[0.0,1.0]間隔のdouble値です。 0.0という値は最近の監視期間中にどのCPUもJVMプロセスのスレッドを実行していなかったことを意味し、1.0という値は最近の監視期間中にすべてのCPUが常時アクティブにJVMのスレッドを実行していたことを意味します。 JVMのスレッドには、JVMの内部スレッドだけでなく、アプリケーションのスレッドも含まれます。 最近の観察期間は実装固有であり、通常は、このメソッドに対して最後にコールされてからの期間に関連します。 最初の呼出しでは、最近の観測期間は未定義です。 0.0から1.0までのすべての値は、JVMプロセスおよびシステム全体で実行されるアクティビティによって異なる可能性があります。 Java仮想マシンの最新のCPU使用率を取得できない場合、このメソッドは負の値を返します。
      APIのノート:
      発信者は、他の発信者が観測期間と結果に影響を及ぼす可能性を認識する必要があります。
      戻り値:
      Java仮想マシン・プロセスの「最新のCPU使用率」。取得できない場合は負の値。
      導入されたバージョン:
      1.7