CheckCPU

CheckCPU is part of the wiki:CheckSystem module.

This check calculates an average of CPU usage for a specified period of time. The data is always collected in the background and the size and interval is configured from the CPUBufferSize and CheckResolution? options. A request has one or more options described in the table below.

Option	Values	Description
warn	load in %	Load to go above to generate a warning.
crit	load in %	Load to go above to generate a critical state.
Time	time with optional prefix	The time to calculate average over. Multiple time= entries can be given - generating multiple CPU usage summaries and multiple warn/crits.
nsclient		Flag to make the plug in run in NSClient compatibility mode
ShowAll	none, long	Add this option to show info even if no errors are detected. Set it to long to show detailed information.

Time can use any of the following postfixes. w=week, d=day, h=hour, m=minute and s=second.

Examples

Check that the CPU load for various times is below 80%:

 checkCPU warn=80 crit=90 time=20m time=10s time=4
 CPU Load ok.|'20m average'=11%;80;90; '10s average'=7%;80;90; '4 average'=10%;80;90;

Showing multiple time entry usage and returned data

 CheckCPU warn=2 crit=80 time=5m time=1m time=10s
 WARNING: 5m: average load 8% > warning, 1m: average load 2% > warning, 10s: average load 4% > warning|'5m'=8;2;80; '1m'=2;2;80; '10s'=4;2;80;

Check CPU load with intervals like known from Linux/Unix (with example thresholds):

 checkCPU warn=100 crit=100 time=1 warn=95 crit=99 time=5 warn=90 crit=95 time=15

FAQ

• Question: How does it handle multi CPU machines?
• Answer: The returned value is the average value of the CPU load of all the processors.

---