No release in over 3 years
Low commit activity in last 3 years
There's a lot of open issues
This plugin provides native process instrumentation for monitoring and metrics collection, including: process status, uptime, thread count, and others
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.1
~> 0.10
~> 13.0
~> 3.2
~> 3.7
~> 0.51.0
~> 0.9.11

Runtime

 Project Readme

Sensu-Plugins-process-checks

Build Status Gem Version 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