nagios-parser-docker

nagios-parser-docker-api

In order to read the status of our nagios servers, we use the following service, which runs within docker. It exposes the status of nagios through HTTP in a sensible way

Endpoints

Endpoint	Filters	Description
/	No	Returns the entire overview of Nagios
/info	No	Returns the information about Nagios
/program	No	Returns the informatino about running Nagios program and settings
/hosts/:host/services/:service	Yes	Returns service information about the specified service on the specified host
/hosts/:host/services	Yes	Returns service information about services on the specified host
/hosts/:host	No	Returns host information on the specified host
/hosts	Yes	Returns host information on all hosts
/services/:service	Yes	Returns service information about services with the specified service name
/services	Yes	Returns service information on all services
/contacts	No	Returns all contact information

Websockets

You can also enable --with-ws as a command line flag. The service will start with a websockets endpoint at /. This will send you either update-hosts or update-services if their state changed significantly.

Notifications will be sent for the following changes:

• New services or hosts added,
• Services or hosts were removed,
• A host or services state changed,
• A host or service state changed (HARD/SOFT),
• Notifications will be surpressed for flapping hosts and services.

CORS

For easier integration (as you should only expose this data on your internal network), you can accept all Origins for CORS. Pass the flag --allow-all-cors for this to the script.

Filters

Filter	Values	Description
state	OK, WARNING, CRITICAL, UNKNOWN	Only show services or hosts which match the speficied state. Prepend with ! for a negation. So !OK will return all non-OK services or hosts
flapping	true, false, 1, 0	Only show services or hosts which are currently flapping (or not)

Running it

You can start it as follows docker run -v /var/cache/nagios3/:/opt/nagios -p 8080:8080 magnetme/nagios-parser-docker-api:latest. In this case you can just execute http://localhost:8080 to see all of nagios' data in JSON format.