Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
PHP nagios plugin utility
PHP
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
src/Dubture/Nagios
tests
vendor
.gitignore
.travis.yml
LICENSE
README.md
check_load
compile
composer.json
nagios.phar
phpunit.xml.dist

README.md

nagios-php

Build Status Scrutinizer Code Quality

Simple utility to help writing nagios plugins in PHP inspired by the Silex microframework.

Usage:

Example - check_hello :

<?php 

require_once __DIR__ . '/nagios.phar';

use Dubture\Nagios\Plugin;

$plugin = new Plugin();
$plugin->run(function($name, $foo = 'bar') use ($plugin) {

    return array(Plugin::OK, array('hello' => $name, $foo));

});

Running the above plugin using check_hello pulse00 will result in an nagios service state OK and the multiline output:

hello | pulse00
bar

The Dubture\Nagios\Plugin::run() method expects a Closure whose method signature determines the nagios plugin arguments. A parameter without a default value represents a mandatory argument, a parameter with a default value represents an optional argument.

The plugin in the above example has one mandatory argument name and an optional argument foo with the default value bar.

The Closure should return an array with the status code as the first element and the output as the second argument, which will be formatted after the following rules:

  • If the second array element is a string, the output is a single-line message
  • If the second array element is an array, the output is a multi-line message.
  • Every element of the multiline message can either be a simple message (literal value), or a message / performance output if the array paramater is a key/value pair.

Installation

Download and include the nagios.phar file. That's all.

Something went wrong with that request. Please try again.