Skip to content

Latest commit

 

History

History
56 lines (41 loc) · 2.1 KB

README.md

File metadata and controls

56 lines (41 loc) · 2.1 KB

Nagios plugin to poll Graphite

What does it do? How does it work? How do I run it?

This is a Nagios plugin. Install it and configure a service check in Nagios and it will run whenever Nagios calls it and will report back on the status of whatever it's monitoring.

It has one required parameter -u which tells it the Graphite URL to monitor, for example:

http://server/render?target=stats.auctionStart&from=-1minutes&rawData=true`

When run, it will query that URL, calculate the average (or another function) of the recieved values, compare the average to the warning/critical thresholds, and return the value to Nagios as performance data.

See Graphite's URL API documentation on how to generate the URL parameter.

Usage

Usage: check_graphite -u URL [-U USERNAME] [-P PASSWORD] [-H HOSTNAME] [-n NONE] [-f FUNCTION] -w WARNING -c CRITICAL

Plugin to retrieve data from graphite

Options:
    -h,          --help               show this help message and exit
    -V,          --version            show program's version number and exit
    -v,          --verbose            Get more verbose status output. Can be specified up to three times
    -u URL,      --url=URL            URL to query for data (required)
    -U USERNAME, --username=USERNAME  User for authentication
    -P PASSWORD, --password=PASSWORD  Password for authentication
    -H HOSTNAME, --hostname=HOSTNAME  Host name to use in the URL
    -n NONE,     --none=NONE          Ignore None values: 'yes' or 'no' (default no)
    -f FUNCTION, --function=FUNCTION  Function to run on retrieved values: avg/min/max/last/sum (default 'avg')
    -w WARNING,  --warning=WARNING    Set the warning notification level (required)
    -c CRITICAL, --critical=CRITICAL  Set the critical notification level (required)

Example

check_graphite -u http://server/render?target=stats.auctionStart&from=-1minutes&rawData=true -w 10,20 -c 20,30

Dependencies

Python 2.6+

You'll need to have NagAconda installed (e.g. easy_install nagaconda or pip install nagaconda)