Skip to content
This plugin provides native process instrumentation for monitoring and metrics collection, including: process status, uptime, thread count, and others.
Ruby Python Shell
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
bin fix check always returning critical May 7, 2019
lib prep for 4.0.1 release May 7, 2019
test
.bonsai.yml add bonsai config Apr 17, 2019
.gitignore initial commit Jan 30, 2015
.rubocop.yml Added ipcs May 2, 2018
.travis.yml add new travis auto,ation Apr 17, 2019
CHANGELOG.md prep for 4.0.1 release May 7, 2019
CONTRIBUTING.md updated documentation links Jul 13, 2015
Gemfile
LICENSE deploy May 1, 2015
README.md add new travis auto,ation Apr 17, 2019
Rakefile Added ipcs May 2, 2018
sensu-plugins-process-checks.gemspec add new travis auto,ation Apr 17, 2019

README.md

Sensu-Plugins-process-checks

Build Status Gem Version Code Climate Test Coverage Dependency Status Sensu Bonsai Asset

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

You can’t perform that action at this time.