sensu-plugins / Sensu Plugins Process Checks

Sensu-Plugins-process-checks

Sensu Asset

The Sensu assets packaged from this repository are built against the Sensu ruby runtime environment. When using these assets as part of a Sensu Go resource (check, mutator or handler), make sure you include the corresponding Sensu ruby runtime asset in the list of assets needed by the resource. The current ruby-runtime assets can be found here in the Bonsai Asset Index.

Functionality

check-processs and check-process-restart will check processes on a system and alert if specific conditions exist based upon a set of filters that each has implemented.

check-cmd will run a specific user designated command and parse the output with a regex or check for a specific status code. If either of these conditions is not what is expected it will alert.

Files

• bin/check-cmd.rb
• bin/check-process-restart.rb
• bin/check-process.rb
• bin/check-threads-count.rb
• bin/metrics-per-process.py
• bin/metrics-per-process.rb
• bin/metrics-process-status.rb
• bin/metrics-process-uptime.rb
• bin/metrics-process-uptime.sh
• bin/metrics-processes-threads-count.rb

Usage

Check if an arbitrary process seems to be running or not. Our arbitrary process in this example is called gutrot. Usage of check-process.rb would look something similar to the following:

$ /opt/sensu/embedded/bin/ruby /opt/sensu/embedded/bin/check-process.rb -p gutrot
CheckProcess OK: Found 3 matching processes; cmd /gutrot/

The -p argument is for a pattern to match against the list of running processes reported by ps.

Example configuration at /etc/sensu/conf.d/check_gutrot_running.json:

{
  "checks": {
    "check_gutrot_running": {
      "command": "check-process.rb -p gutrot",
      "standalone": true,
      "interval": 60,
      "handlers": ["default"]
    }
  }
}

The check is named check_gutrot_running and it runs check-process.rb -p gutrot every 60 seconds (interval) then lets the default handler handle the result.

Installation

Installation and Setup

Quick install after following the steps above:

$ sensu-install process-checks

The checks will be installed at:

/opt/sensu/embedded/bin/

Notes