check_cpu_utilization

Checks the CPU utilization metrics.

Implementation

Windows	Linux	FreeBSD	MacOSX
✅	✅	✅	✅

Argument Defaults

Argument	Default Value
warning	total > 90
critical	total > 95
empty-state	0 (OK)
empty-syntax
top-syntax	%(status) - %(list)
ok-syntax
detail-syntax	user: %(user)% - system: %(system)% - iowait: %(iowait)% - steal: %(steal)% - guest: %(guest) - idle: %(idle)%

Check Specific Arguments

Argument	Description
n\|procs-to-show	Number of processes to show when printing the top consuming processes
range	Sets time range to calculate average (default is 1m)
show-args	Show arguments when listing the top N processes

Attributes

Filter Keywords

these can be used in filters and thresholds (along with the default attributes):

Attribute	Description
total	Sum of user, system, iowait, steal and guest in percent
user	User CPU utilization in percent
system	System CPU utilization in percent
iowait	IOWait CPU utilization in percent
steal	Steal CPU utilization in percent
guest	Guest CPU utilization in percent
idle	Idle CPU utilization in percent

Examples

Default Check

check_cpu_utilization
OK - user: 2% - system: 1% - iowait: 0% - steal: 0% - guest: 0 - idle: 96% |'total'=3.4%;90;95;0; 'user'=2.11%;;;0;...

Example using check_snclient and Naemon

Naemon Config

define command{
    command_name         check_snclient
    command_line         $USER1$/check_snclient -k -p 'your-password' -u 'https://$HOSTADDRESS$:8443' $ARG1$ $ARG2$
}

define service {
    host_name            testhost
    service_description  check_cpu_utilization
    use                  generic-service
    check_command        check_snclient!check_cpu_utilization!'warn=total > 90%' 'crit=total > 95%'
}