The /proc/stat file holds various pieces of information about the kernel activity and is available on every Linux system. This document will explain what you can read from this file.
Example output from /proc/stat
> cat /proc/stat
cpu 1279636934 73759586 192327563 12184330186 543227057 56603 68503253 0 0
cpu0 297522664 8968710 49227610 418508635 72446546 56602 24904144 0 0
cpu1 227756034 9239849 30760881 424439349 196694821 0 7517172 0 0
cpu2 86902920 6411506 12412331 769921453 17877927 0 4809331 0 0
intr 47965531372 1240248033 2 0 0 0 0 0 0 1 0 0 0 4 0 0 0 0 128 0 0 0 360 38 0 0 0 ...
swap 72080475 70517875 ctxt 113062355059 btime 1423804268 realbtime 1423804268
softirq 103392583578 0 3105824580 7624540 1792771145 2125464967 0 290942924 2131429539 52132004 3692080663
First of all, the numbers reported are counters / aggregates since when then system booted. This brings us directly to the first interesting value "btime" which gives the UNIX epoch time the system was booted. Depending on the kernel version and the available CPUs on your system, the information shown on /proc/stat may differ slightly.
the "cpu" lines
The first "cpu" line is an aggregate of all following "cpuN" lines. The number of "cpuN" lines is equal to the number of CPUs reported on /proc/cpuinfo. The numbers behind the "cpu" lines identify the amount of time the CPU has spent performing different kind of work:
||Time spent with normal processing in user mode.
||Time spent with niced processes in user mode.
||Time spent running in kernel mode.
||Time spent in vacations twiddling thumbs.
||Time spent waiting for I/O to completed. This is considered idle time too.
||Time spent serving hardware interrupts. See the description of the intr line for more details.
||Time spent serving software interrupts.
||Time stolen by other operating systems running in a virtual environment.
||Time spent for running a virtual CPU or guest OS under the control of the kernel.
The time is measured in USER_HZ (also called Jiffies) which are typically 1/100ths of a second. USER_HZ is a compile time constant which can be queried using:
|> getconf CLK_TCK 100
const double ticks = (double)sysconf( _SC_CLK_TCK );
ticks = os.sysconf(os.sysconf_names['SC_CLK_TCK'])
use POSIX qw(sysconf _SC_CLK_TCK);
my $ticks = sysconf(_SC_CLK_TCK);
the "intr" line
The first column of the "intr" line is the total of all interrupts served on the system since boot time. The following counters are the count for each possible system interrupt. If you are interested in these values, take a look on /proc/interrupts which does not only show the counters but also the CPU mapping too.
Fine but where is the CPU usage?
The CPU usage can be measured over an interval of time only. This means we have to read the values from /proc/stat on a fixed interval and calculate the delta from these readings.
We can simply sum of all difference between two consecutive reads to get the time elapsed between these reads. The result is equal to multiplying USER_HZ with the number of CPUs on your system and the seconds between the reads. The difference of column 4 (idle) gives us the time spent idle. The sum minus the idle time gives us the total CPU utilization. Divided by the sum we get the percentage of CPU utilization.
while :; do
# Get the first line with aggregate of all CPUs
cpu_now=($(head -n1 /proc/stat))
# Get all columns but skip the first (which is the "cpu" string)
# Replace the column seperator (space) with +
# Get the delta between two reads
cpu_delta=$((cpu_sum - cpu_last_sum))
# Get the idle time Delta
# Calc time spent working
cpu_used=$((cpu_delta - cpu_idle))
# Calc percentage
cpu_usage=$((100 * cpu_used / cpu_delta))
# Keep this as last for our next read
echo "CPU usage at $cpu_usage%"
# Wait a second before the next read