Notifications

Whenever something changes state, Argus can notify someone about it.

Argus realizes that in the real world, sometimes people forget, they go out of range of their paging service, their batteries die, etc. So, by default, when Argus wants to be sure someone knows about something it will require that the message be acknowledged and will resend and/or escalate until someone does.

Configuring

To specify where to send notifications:

	notify:		mail:support@example.com  qpage:joe

you can specify more than one. Currently notifying by mail and qpage are supported.

By default, Services generate notifications and Groups do not. This can be changed:

	Group "Foo" {
		sendnotify:	yes
		Service Ping {
			sendnotify:	no
		}
	}

You can change the message that gets sent:

	Service UDP/SNMP {
		# cisco inlet temperature
		oid:		.1.3.6.1.4.1.9.9.13.1.3.1.3.1
		maxvalue:	27
		messagedn:	server room is too hot
		messageup:	server room has cooled back down
	}

If you only want one message sent, and never resent or escalated:

	autoack:	yes

By default, notifications are resent every 5 minutes, to change this, specify a value in seconds:

	renotify:	120

Escalating

After attempting to notify someone of a problem repeatedly, you may want to try notifying someone else:

	escalate:    10 qpage:manager; 30 qpage:cio; 60 qpage:ceo

which means:

In previous versions of Argus, the number in the escalate parameter, above, was "number of pages sent", and another version in seconds. If you are running an older version of code, you may wish to check.

Acknowledging

On the webpage, click "Un-Acked Notifies". Ack them one-by-one by clicking "Ack", or ack several by checking their checkboxes and clicking "Ack Checked", or ack all of them by clicking "Ack All".

The ability to ack is controlled by the "acl_ntfyack" access control list. The ability to "Ack All" is controlled by the "acl_ntfyackall" access control list.

In order to remain sane, the author highly recommends verifying that anyone who may be sent notifications is also permitted to acknowledge them.

Adding Other Notification Methods

Support for user defined notification methods was added in version 3.2

Argus comes with mail and qpage built in, to add other methods, pick a name for the method and add to the top of the config file:

	Method "annoy" {
		command:	winpopup %R
		send:		%M
	}

	notify:		annoy:bob

This will cause notifications to be sent to 'bob' using the 'winpopup' program. Various % sequences can be used:

and in the message text (message{up,dn}) some additional sequences can be used: