Skip to content

Latest commit

 

History

History
66 lines (46 loc) · 2.82 KB

README.md

File metadata and controls

66 lines (46 loc) · 2.82 KB

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