Sensu Assets: Monitoring Plugins

Overview

An attempt at packaging individual C plugins from the excellent Monitoring Plugins project https://monitoring-plugins.org in the Sensu Go Asset format. The goal of the project is to provide a simple workflow for creating a Sensu Go Asset containing the C plugins.

Goal

The goal of this project is to provide Sensu Go Assets for CentOS/Rocky/RHEL Linux (7, 8, 9), Debian Linux (9, 10, 11), Ubuntu Linux (18.04, 20.04, 22.04), Amazon Linux (2, 2023), and Alpine Linux containing a good subset of the plugins from the Monitoring Plugins project.

Current Status

Currently, This project will attempt to provide support for the following plugins:

• check_disk
• check_dns
• check_http
• check_load
• check_log
• check_ntp
• check_ntp_peer
• check_ntp_time
• check_ping
• check_procs
• check_smtp
• check_snmp
• check_ssh
• check_swap
• check_tcp
• check_time
• check_users

Caveats

Several plugins, though compiled binaries, require that certain commands be available from the OS.

Examples (not exhaustive):

• check_snmp requires snmpget
• check_procs requires ps
• check_dns requires nslookup

Configuration

Sensu Go

Asset registration

Assets are the best way to make use of this plugin. If you're not using an asset, please consider doing so! If you're using sensuctl 5.13 or later, you can use the following command to add the asset:

sensuctl asset add sensu/monitoring-plugins

If you're using an earlier version of sensuctl, you can download the asset definition from this project's Bonsai Asset Index page.

Build

1. Clone this repo:

   $ git clone [email protected]:sensu/monitoring-plugins.git
   $ cd monitoring-plugins
   

2. Build the Docker containers and extract the Sensu assets:

   $ ./build.sh
   

   NOTE: if your local docker installation is configured to require root access you will need to run the build script as root (i.e. sudo ./build.sh).