events.pod

Network Management Information System

=head1 NAME

Event Policy

=head1 DESCRIPTION

You can add, edit and delete entries to the NMIS Event Policy table.
This controls how events are processed by NMIS, what event level each node type and role type will generate and whether or not it will send alerts.

The event Level and notification action is set by matching on the Event, device Role and device Type. Note that a record of type event=default, role=default, type=default may be used to set a default policy for any event that is not specifically matched. 

=head2 Event

A list of pre-configured event types.

Select one of "Generic Down", "Generic Up", "Interface Down", "Interface Up",
									"Node Down", "Node Reset", "Node Failover", "Node Up",
									"Proactive Response Time Threshold",
									"Proactive Reachability Threshold",
									"Proactive CPU Threshold",
									"Proactive Memory Threshold",
									"Proactive Interface Availability Threshold",
									"Proactive Interface Input Utilisation",
									"Proactive Interface Output Utilisation",
									"Proactive Availability Threshold Interface",
									"Proactive Interface Input NonUnicast",
									"Proactive Interface Output NonUnicast",
									"RPS Fail",
									"SNMP Down", "SNMP Up"

=head2 Role

A list of pre-configured Device Roles. See L<Nodes Table|nodes.pod>.

Select one of "core", "distribution", "access"

=head2 Type

A list of pre-configured Device Types. See L<Nodes Table|nodes.pod>.

Select one of "router", "switch", "server", "generic"

=head2 Level

A list of pre-configured Event levels, based on syslog event levels.

	NMIS colorised eventlevels map as follows to RFC syslog
	
	0 fatal 	->	RFC emergencies		0
	1 critical	->	RFC alerts		1
	2 major		->	RFC critical		2
	3 minor		->	RFC errors		3
	4 warnings	->	RFC warnings		4
	5 error		->	RFC notifications	5
	6 normal	->	RFC informational	6
	7 unknown	->	RFC debugging		7

Select one of "Normal", "Warning", "Major", "Critical", "Fatal"

=head2 Log

Select 'true|false'. If true, logs all events in the L<Event Log|menu.pod/Logs>

Recommended: 'true'

=head2 Mail

Select 'true|false'. If true, send an immediate once only notification email to the list of email addresses in the L<Contacts Table|contacts.pod/Contact>
 referenced by the name found in the device 'sysContact' entry. 

Checks the L<Current Events Table|menu.pod/Current Events> for an existing event, so that duplicate events are not notified again. Assumes that notify=true.

This field is recommended to be set to 'false' , and set L<Escalation Policy|escalation.pod> to notify events using timed escalation levels.

=head2 Notify

Select 'true|false'. If true, writes a current event record to the L<Current Events Table|menu.pod/Current Events>, that could then be escalated using L<Escalation Policy|escalation.pod>.

Recommended: 'true'

=head2 Pager

Select 'true|false'. If true, send a notification pager to the pager number in the L<Contacts Table|contacts.pod/Contact> referenced by the name found in the device 'sysContact' entry.

Checks the L<Current Events Table|menu.pod/Current Events> for an existing event, so that duplicate events are not notified again. Assumes that notify=true.

This field is recommended to be set to 'false' , and set L<Escalation Policy|escalation.pod> to notify events using timed escalation levels.