Push Nagios incidents to Cachet status page

Mathieu — Mon, 10 Aug 2015 21:45:00 +0200

Cachet is an opensource status page. It displays incidents, manually or automaticaly created to inform users of what is going on the monitored service.

Note that Cachet does not do any monitoring, that’s why Nagios will be used to send incidents events through its API.

The code can be downloaded at : https://github.com/mpellegrin/nagios-eventhandler-cachet

Prerequisites

Have a working Cachet installation
Have created some Cachet components to play with
Have a Nagios instance with PHP CLI and php-curl installed

Installation

Get a Cachet API key: Create a new user in Cachet dashboard, login with this user, and get the API key in his profile.
Copy cachet_notify to /usr/share/nagios3/plugins/eventhandlers (depending on your configuration)
Change URL and API key in cachet_notification source code
Try it: ./cachet_notify ‘My Cachet component’ ‘My nagios service’ CRITICAL HARD ‘The service is Critical’

Configuration

Make a Nagios command:

  define command {
      command_name    cachet_notify
      command_line    /usr/share/nagios3/plugins/eventhandlers/cachet_notify '$ARG1$' '$SERVICEDESC$' '$SERVICESTATE$' '$SERVICESTATETYPE$' '$SERVICEOUTPUT$'
  }

Add an event handler on your services:

  define service {
      service_description             My nagios service
      ...
      event_handler                   cachet_notify!My Cachet component
  }

Restart nagios

Addendum

Feel free to ask questions or open issues for this code on Github.

# uname -a - Mot-clé - status

Push Nagios incidents to Cachet status page

Prerequisites

Installation

Configuration

Addendum