Events overview

An event is an occurrence of something significant happening in the cluster. Notification of events is an important tool because it allows the administrator to be informed about and to monitor the health of the cluster.

Events have three levels: LOG_ERR, LOG_WARNING, and LOG_INFO.
  • LOG_ERR: Error events only

  • LOG_WARNING: Warning and error events

  • LOG_INFO: All events

Each event has the following fields:
  • Component: String that identifies that component triggered the event

  • Code: An event number used for identification

  • Name: The name of the event

  • Level: The event level this event belongs to (for example, LOG_WARNING)

  • Args: Arguments to the event

Note:

Together, component and code provide unique event identification.

By default, the event feature is not enabled.

Default SNMP

EGO includes an SNMP plug-in: eventplugin_snmp. This plug-in is integrated with SNMP, which uses SNMP traps as the notification mechanism. The file is located under $EGO_LIBDIR in the file eventplugin_snmp.dll. On a Linux system, the file has the extension .so.

The default configuration of this plug-in is in ego.conf under the section EGO event configuration. It is set as follows:

EGO_EVENT_MASK=LOG_INFO
EGO_EVENT_PLUGIN=eventplugin_snmp[SINK=host,MIBDIRS=EGO_CONFDIR/mibs]

(where host is the host that the SNMP trap is sent to.)

Note:

The MIBDIRS directory may also equal %EGO_CONFDIR%/kernel/conf/mibs.

In a Windows environment, use quotation marks around the event plug-in definition. For example:

EGO_EVENT_PLUGIN="eventplugin_snmp[SINK=host,MIBDIRS=$EGO_CONFDIR\kernel\conf\mibs]"

By default, all SNMP traps are sent to port 162. To change the destination port, an optional string "TRAPPORT=port_number" may be added to the EGO_EVENT_PLUGIN configuration string above.

The definition of the SNMP trap sent by this plug-in is defined in the file EGO-SNMP-MIB.txt found under EGO_CONFDIR/mibs.

You can replace the default SNMP with another SNMP. We recommend SNMP Trap Watcher by BTT Software.