Project

sensu-plugins-cpu-usage

0.0
No commit activity in last 3 years
No release in over 3 years
sensu-plugins-cpu-usagem4ce/sensu-plugins-cpu-usageHomepageDocumentationSource CodeBug TrackerWiki
This plugin provides facilities for monitoring the system cpu usage
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
86,435
Stars
2
Forks
0
Watchers
2
 Releases
Current version
0.0.6
Total releases
6
First release
2016-01-05
Latest release
2016-01-14
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2016-01-08
Reverse Dependencies
0

 Dependencies

Runtime

sensu-plugin
= 1.2.0
 Project Readme

Sensu plugin for monitoring the system CPU usage

A sensu plugin to monitor the system's CPU usage with the option to generate events on specific metrics (e.g. user time, system time)

The plugin generates multiple OK/WARN/CRIT/UNKNOWN events via the sensu client socket (https://sensuapp.org/docs/latest/clients#client-socket-input) so that you do not miss state changes when monitoring multiple metrics.

Usage

The plugin accepts the following command line options:

Usage: check-cpu-usage.rb (options)
    -c, --critical <USAGE>           Critical if USAGE exceeds the overall system cpu usage (default: 90)
        --crit-guest <USAGE>         Critical if USAGE exceeds the current system guest usage
        --crit-guest_nice <USAGE>    Critical if USAGE exceeds the current system guest_nice usage
        --crit-idle <USAGE>          Critical if USAGE exceeds the current system idle usage
        --crit-iowait <USAGE>        Critical if USAGE exceeds the current system iowait usage
        --crit-irq <USAGE>           Critical if USAGE exceeds the current system irq usage
        --crit-nice <USAGE>          Critical if USAGE exceeds the current system nice usage
        --crit-softirq <USAGE>       Critical if USAGE exceeds the current system softirq usage
        --crit-steal <USAGE>         Critical if USAGE exceeds the current system steal usage
        --crit-system <USAGE>        Critical if USAGE exceeds the current system system usage
        --crit-user <USAGE>          Critical if USAGE exceeds the current system user usage
        --dryrun                     Do not send events to sensu client socket
        --handlers <HANDLERS>        Comma separated list of handlers
    -i <user,nice,system,idle,iowait,irq,softirq,steal,guest,guest_nice>,
        --ignore-metric              Comma separated list of metrics to ignore
    -m <user,nice,system,idle,iowait,irq,softirq,steal,guest,guest_nice>,
        --metric                     Comma separated list of metrics to monitor (default: ALL)
    -s, --sleep <SECONDS>            Sleep N seconds when sampling metrics
    -w, --warn <USAGE>               Warn if USAGE exceeds the overall system cpu usage (default: 80)
        --warn-guest <USAGE>         Warn if USAGE exceeds the current system guest usage
        --warn-guest_nice <USAGE>    Warn if USAGE exceeds the current system guest_nice usage
        --warn-idle <USAGE>          Warn if USAGE exceeds the current system idle usage
        --warn-iowait <USAGE>        Warn if USAGE exceeds the current system iowait usage
        --warn-irq <USAGE>           Warn if USAGE exceeds the current system irq usage
        --warn-nice <USAGE>          Warn if USAGE exceeds the current system nice usage
        --warn-softirq <USAGE>       Warn if USAGE exceeds the current system softirq usage
        --warn-steal <USAGE>         Warn if USAGE exceeds the current system steal usage
        --warn-system <USAGE>        Warn if USAGE exceeds the current system system usage
        --warn-user <USAGE>          Warn if USAGE exceeds the current system user usage

By default, all metrics are taken into consideration when calculating the overall cpu usage.

Use the --handlers command line option to specify which handlers you want to use for the generated events.

Author

Matteo Cerutti - matteo.cerutti@hotmail.co.uk