Class ProcessorUsage


  • public class ProcessorUsage
    extends Object
    This represents a snapshot of the Operating System level Processor usage statistics. The statistics could be at an individual Processor level or an aggregate across all Processors. The statistics are available on AIX, Linux and Windows.
    • This information is not available on z/OS.
    Since:
    1.7.1
    • Constructor Detail

      • ProcessorUsage

        public ProcessorUsage()
        Creates a new ProcessorUsage instance.
    • Method Detail

      • getUser

        public long getUser()
        The time spent in user mode in microseconds.
        Returns:
        The user times in microseconds or -1 if not available.
      • getSystem

        public long getSystem()
        The time spent in system mode in microseconds.
        Returns:
        The system times in microseconds or -1 if not available.
      • getIdle

        public long getIdle()
        The time spent by the Processor sitting idle in microseconds.
        Returns:
        The idle times in microseconds or -1 if not available.
      • getWait

        public long getWait()
        The time spent by the Processor in Input/Output (IO) wait in microseconds.
        Returns:
        The wait times in microseconds or -1 if not available.
      • getBusy

        public long getBusy()
        The time spent by the Processor executing a non-idle thread in microseconds.
        Returns:
        The busy times in microseconds or -1 if not available.
      • getId

        public int getId()
        A unique identifier assigned to the this Processor. This is -1 if method invoked on the global Processor record.
        Returns:
        An identifier for this Processor or -1 for the global record or if not available.
      • getOnline

        public int getOnline()
        The online/offline status of this Processor. This is -1 if method invoked on the global Processor record or if this info is unavailable.
        • On AIX the online value is not reliable. Once a Processor becomes online, the status of the Processor will always be shown as online from that point onwards, even if it is currently offline. This is a limitation of the OS. Similarly offline on AIX means that the Processor was never online.
        Returns:
        This Processor's online status (0 = offline, 1 = online) or -1 for the global record or if not available.
      • getTimestamp

        public long getTimestamp()
        The timestamp when usage statistics were last sampled in microseconds.
        Returns:
        Timestamp in microseconds.