Method: LinuxStat::ProcessInfo.cpu_usage

Defined in:

lib/linux_stat/process_info.rb

.cpu_usage(pid: $$, sleep: ticks_to_ms_t5) ⇒ Object

cpu_usage(pid: $$, sleep: 1.0 / LinuxStat::Sysconf.sc_clk_tck * 5)

Where pid is the process ID and sleep time is the interval between measurements.

By default it is the id of the current process ($$), and sleep is 1.0 / LinuxStat::Sysconf.sc_clk_tck * 5

The smallest amount of available sleep time is LinuxStat::Sysconf.sc_clk_tck.

It retuns the CPU usage as Float.

For example:

LinuxStat::ProcessInfo.cpu_usage

=> 10.0

10.0 means it’s using 10% of the total processing power of the system.

The value is divided with the configured number of CPU and not online CPU.

A value of 100.0 indicates it is using 100% processing power available to the system.

But if the info isn’t available, it will return nil.

This method is more efficient than running LinuxStat::ProcessInfo.cpu_stat()

# File 'lib/linux_stat/process_info.rb', line 340

def cpu_usage(pid: $$, sleep: ticks_to_ms_t5)
	u = cpu_usage_thread(pid, sleep)
	return nil unless u

	u /= LinuxStat::CPU.count
	u > 100 ? 100.0 : u.round(2)
end