Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Tool to facilitate the development of nagios notification methods using many different protocols and delivery systems
Branch: master
Failed to load latest commit information.
angelia fix opsgenie class name
mcollective-agent/angelianotify whitespace fix
Rakefile add nagios templates for opsgenie
angelia-nagios-send.rb whitespace fix
angelia-send.rb whitespace fix
angelia-spoold.rb whitespace fix
angelia.cfg Remove more twitter stuff
angelia.init First stab at renaming to Angelia
angelia.rb whitespace fix
angelia.spec First stab at renaming to Angelia


This is a tool to facilitate the development of nagios notification methods using many different protocols and delivery systems while using a single simple script that can deliver all messages.

Messages have recipients in the form:


and each protocol gets handled by a different plugin.

At present there are just two plugins that serve as a introduction to the plugin system, see Angelia::Plugin::Xmpp and Angelia::Plugin::Clickatell.

When called from inside nagios a script - angelia-nagios-send - should be used it will assist in building up the message bodies by means of templates and the state provided by nagios, each protocol can have its own templates for host and service notifies, these are in files:


See the provided templates for samples

And you can use any of the NAGIOS\*_ variables that Nagios sets in the environment.

The nagios commands to send notifications via this tools are:

    define command{
            command_name host-notify-by-angelia
            command_line /usr/sbin/angelia-nagios-send -c /etc/angelia/angelia.cfg --host-notify -r $CONTACTEMAIL$

    define command{
            command_name notify-by-angelia
            command_line /usr/sbin/angelia-nagios-send -c /etc/angelia/angelia.cfg --service-notify -r $CONTACTEMAIL$

This will set all the nagios environment variables and the angelia notifier will use these with the templates mentioned earlier.

Normal messages can be send using angelia-send fro the command line or other monitoring systems, in this case you need to provide your own message body.

Sample calls to put messages on the spool are:

    $ angelia-nagios-send -c /etc/angelia/angelia.cfg --service-notify -r xmpp://
    $ angelia-send -c /etc/angelia/angelia.cfg -r xmpp:// -m 'my message'

Included in the source are init scripts, daemon to run and poll the spool and also a RPM spec file to build it.

This code is released under the terms of the Apache version 2 license.

Contact R.I.Pienaar / / @ripienaar

Something went wrong with that request. Please try again.