Process Checks

This plugin provides native process instrumentation for monitoring and metrics collection, including: process status, uptime, thread count, and others.

Sensu-Plugins-process-checks

Build Status Gem Version Code Climate Test Coverage Dependency Status

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

Get Plugin

Stats

16 stars on GitHub
12 open issues on GitHub
46 open forks on GitHub

Sensu Plugins

Sensu plugins and extensions are available for dozens of modern applications and services.