Event- and alert type hierarchy

NAV events and alerts are organized into a type hierarchy. While NAV’s backend monitoring processes usually generate events, the Event Engine is responsible for deciding what to do with those events. In most cases, events are translated into a corresponding alert by the Event Engine.

Most alerts are stateful, i.e. they can be viewed as an incident that has a start time and an end time. If the end time is set to an infinite value, the alert is considered unresolved (also known as open).

Some alert types indicate the beginning of a new alert state, while some alert types indicate the closure of an existing alert state. E.g. for boxState alerts, a boxDown alert indicates that a new stateful incident has occured: A device is no longer responsive. On the other hand, a boxUp alert will cause an existing boxState-type alert to be resolved.

All legal event- and alert-types are registered in the NAV database (and can thus be extended, even by the user, if need be). The following are the event- and alert types that come pre-defined with NAV:

boxState events

Tells us whether a network-unit is down or up.

Alerts associated with boxState events
Alert type name	Description
`boxDownWarning`	Warning sent before declaring the box down.
`boxShadowWarning`	Warning sent before declaring the box in shadow.
`boxDown`	Box declared down.
`boxUp`	Box declared up.
`boxShadow`	Box declared down, but is in shadow.
`boxSunny`	Box declared up from a previous shadow state.

serviceState events

Tells us whether a service on a server is up or down.

Alerts associated with serviceState events
Alert type name	Description
`httpDown`	http service not responding.
`httpUp`	http service responding.

moduleState events

Tells us whether a module in a device is working or not.

Alerts associated with moduleState events
Alert type name	Description
`moduleDownWarning`	Warning sent before declaring the module down.
`moduleDown`	Module declared down.
`moduleUp`	Module declared up.

thresholdState events

Tells us whether the load has passed a certain threshold.

Alerts associated with thresholdState events
Alert type name	Description
`exceededThreshold`	Threshold exceeded.
`belowThreshold`	Value below threshold.

linkState events

Tells us whether a link is up or down.

Alerts associated with linkState events
Alert type name	Description
`linkUp`	Link active
`linkDown`	Link inactive

boxRestart events

Tells us that a network-unit has done a restart

Alerts associated with boxRestart events
Alert type name	Description
`coldStart`	The IP device has coldstarted
`warmStart`	The IP device has warmstarted

info events

Basic information

Alerts associated with info events
Alert type name	Description
`dnsMismatch`	Mismatch between sysname and dnsname.
`serialChanged`	Serial number for the device has changed.
`macWarning`	Mac appeared on port

notification events

Notification event, typically between NAV systems

deviceActive events

Lifetime event for a device

deviceState events

Registers the state of a device

Alerts associated with deviceState events
Alert type name	Description
`deviceInIPOperation`	The device is now in operation with an active IP address
`deviceInStack`	The device is now in operation as a chassis module
`deviceRMA`	RMA event for device.
`deviceNewModule`	The device has been found as a module.
`deviceNewChassis`	The device has been found as a chassis.
`deviceNewPsu`	The device has been found as a power supply.
`deviceNewFan`	The device has been found as a fan.

deviceNotice events

Registers a notice on a device

Alerts associated with deviceNotice events
Alert type name	Description
`deviceError`	Error situation on device.
`deviceSwUpgrade`	Software upgrade on device.
`deviceHwUpgrade`	Hardware upgrade on device.
`deviceFwUpgrade`	Firmware upgrade on device.

maintenanceState events

Tells us if something is set on maintenance

Alerts associated with maintenanceState events
Alert type name	Description
`onMaintenance`	Box put on maintenance.
`offMaintenance`	Box taken off maintenance.

apState events

Tells us whether an access point has disassociated or associated from the controller

Alerts associated with apState events
Alert type name	Description
`apUp`	AP associated with controller
`apDown`	AP disassociated from controller

snmpAgentState events

Tells us whether the SNMP agent on a device is down or up.

Alerts associated with snmpAgentState events
Alert type name	Description
`snmpAgentDown`	SNMP agent is down or unreachable due to misconfiguration.
`snmpAgentUp`	SNMP agent is up.

chassisState events

The state of this chassis has changed

Alerts associated with chassisState events
Alert type name	Description
`chassisDown`	This chassis is no longer visible in the stack
`chassisUp`	This chassis is visible in the stack again

aggregateLinkState events

The state of this aggregated link changed

Alerts associated with aggregateLinkState events
Alert type name	Description
`linkDegraded`	This aggregate link has been degraded
`linkRestored`	This aggregate link has been restored

psuState events

Reports state changes in power supply units

Alerts associated with psuState events
Alert type name	Description
`psuNotOK`	A PSU has entered a non-OK state
`psuOK`	A PSU has returned to an OK state

fanState events

Reports state changes in fan units

Alerts associated with fanState events
Alert type name	Description
`fanNotOK`	A fan unit has entered a non-OK state
`fanOK`	A fan unit has returned to an OK state

bgpState events

The state of this BGP peering session changed

Alerts associated with bgpState events
Alert type name	Description
`bgpDown`	This BGP peering session is down
`bgpEstablished`	This BGP peering session has been established
`bgpAdmDown`	This BGP peering session is administratively down

juniperYellowAlarmState events

Tells us if a Juniper device has any open yellow alarms.

Alerts associated with juniperYellowAlarmState events
Alert type name	Description
`juniperYellowAlarmOn`	The Juniper device has some yellow alarms.
`juniperYellowAlarmOff`	The Juniper device has no yellow alarms.

juniperRedAlarmState events

Tells us if a Juniper device has any open red alarms.

Alerts associated with juniperRedAlarmState events
Alert type name	Description
`juniperRedAlarmOn`	The Juniper device has some red alarms.
`juniperRedAlarmOff`	The Juniper device has no red alarms.

weathergoose_temperature events

Alerts associated with weathergoose_temperature events
Alert type name	Description
`cmClimateTempCTRAP`	Climate Temperature Sensor Trap
`cmClimateTempCCLEAR`	Climate Temperature Sensor Clear Trap
`cmClimateTempCNOTIFY`	Climate Temperature Sensor Trap
`cmTempSensorTempCNOTIFY`	Remote Temp Sensor - Temperature Trap
`cmTempSensorTempCCLEAR`	Remote Temp Sensor - Temperature Clear Trap
`gstClimateTempCNOTIFY`	Climate Temperature Sensor Trap
`gstTempSensorTempCNOTIFY`	Remote Temp Sensor - Temperature Trap
`gstClimateTempCCLEAR`	Climate Temperature Sensor Clear Trap
`gstTempSensorTempCCLEAR`	Remote Temp Sensor - Temperature Clear Trap

weathergoose_humidity events

Alerts associated with weathergoose_humidity events
Alert type name	Description
`cmClimateHumidityTRAP`	Climate Humidity Sensor Trap
`cmClimateHumidityCLEAR`	Climate Humidity Sensor Clear Trap
`cmClimateHumidityNOTIFY`	Climate Humidity Sensor Trap
`gstClimateHumidityNOTIFY`	Climate Humidity Sensor Trap
`gstClimateHumidityCLEAR`	Climate Humidity Sensor Clear Trap

weathergoose_airflow events

Alerts associated with weathergoose_airflow events
Alert type name	Description
`cmClimateAirflowTRAP`	Climate Air Flow Sensor Trap
`cmClimateAirflowCLEAR`	Climate Air Flow Sensor Clear Trap
`cmClimateAirflowNOTIFY`	Climate Air Flow Sensor Trap
`gstClimateAirflowNOTIFY`	Climate Air Flow Sensor Trap
`gstClimateAirflowCLEAR`	Climate Air Flow Sensor Clear Trap

weathergoose_light events

Alerts associated with weathergoose_light events
Alert type name	Description
`cmClimateLightTRAP`	Climate Light Sensor Trap
`cmClimateLightCLEAR`	Climate Light Sensor Clear Trap
`cmClimateLightNOTIFY`	Climate Light Sensor Trap
`gstClimateLightNOTIFY`	Climate Light Sensor Trap
`gstClimateLightCLEAR`	Climate Light Sensor Clear Trap

weathergoose_sound events

Alerts associated with weathergoose_sound events
Alert type name	Description
`cmClimateSoundTRAP`	Climate Sound Sensor Trap
`cmClimateSoundCLEAR`	Climate Sound Sensor Clear Trap
`cmClimateSoundNOTIFY`	Climate Sound Sensor Trap
`gstClimateSoundNOTIFY`	Climate Sound Sensor Trap
`gstClimateSoundCLEAR`	Climate Sound Sensor Clear Trap

upsPowerState events

UPS running on battery or utility power

Alerts associated with upsPowerState events
Alert type name	Description
`upsOnBatteryPower`	Ups running on battery power
`upsOnUtilityPower`	Ups running on utility power