Default event maps

Edit online

Network Manager provides a default set of event maps. Use this information to understand which default event maps are available and what each event map does, and to understand how legacy event maps delegate to current event maps.

Default event maps

The following table describes the default event maps.
Table 1. Default event maps
Event map Stitcher called by event map Event map description
ChassisFailure LookupMainNode

Handles events where the LocalNodeAlias sufficiently specifies the chassis (main node) entity.

Expected input fields:

  • LocalNodeAlias, where this field contains one of the following:
    • IP address
    • Entity name
    • DNS name
    • sysName
    • entityId
EMSNonPollingEvent LookupEMSEntity Handles polling events from element management systems (EMSs).
Expected input fields:
  • LocalNodeAlias.
  • LocalPriObj.
  • RemoteNodeAlias, where this field contains the IP address or DNS name of polling station.
EMSPollingEvent LookupEMSEntity Handles non-polling events from element management systems (EMSs).
Expected input fields:
  • LocalNodeAlias.
  • LocalPriObj.
  • RemoteNodeAlias.
EntityFailure LookupIp Handles events where the LocalNodeAlias is sufficient to specify the entity, or if no further data is available.
Expected input field: LocalNodeAlias, where this field contains one of the following:
  • IP address
  • Entity name
  • DNS name
  • sysName
  • entityId
EntityMibTrap LookupEntPhysEntry Handles traps from the ENTITY MIB.
Expected input fields:
  • LocalNodeAlias , where this field contains one of the following:
    • IP address
    • Entity name
    • DNS name
    • sysName
    • entityId
  • LocalPriObj , where this field contains an index from the entPhysicalTable; for example, 'entPhysicalEntry.2'.
EntityStateChange LookupEntityId Handles events raised by the Topology manager, ncp_model. No plug-ins currently register interest in this event map. Nevertheless the map allows for population of standard fields. The events raised by ncp_model are the following:
  • ItnmEntityCreation
  • ItnmEntityDeletion
  • ItnmMaintenanceState

Expected input field: NmosEntityId.
genericip-event LookupMainNode Processes events that do not match any other event map.
Note: This event map is intended as a catch-all. Plug-ins should not register interest in this eventMap. Instead, events of interest should be passed to the EntityFailure event map.
Expected input field: LocalNodeAlias, where this field contains one of the following:
  • IP address
  • Entity name
  • DNS name
  • sysName
  • entityId
ItncmResourceEvent LookupMainNode Used to handle events raised by Netcool Configuration Manager. This event map maps the entity identifier (entityId) in Network Manager to its corresponding Netcool Configuration Manager credentials.
Expected input fields: NmosEntityId. If this field is not available, then uses as input: LocalNodeAlias, where this field contains one of the following:
  • IP address
  • Entity name
  • DNS name
  • sysName
  • entityId
ItnmHealthChk No related stitcher Used by the Failover plug-in, to process Network Manager health check events.

Expected input field: Node, where this field contains the name of the domain the health check is for.

ItnmLinkDownIfIndex LookupIfEntry Expects an interface event to be identified by the ifIndex if the interface NmosEntityId is not set.
Expected input fields:
  • LocalNodeAlias , where this field contains one of the following:
    • IP address
    • Entity name
    • DNS name
    • sysName
    • entityId
  • LocalPriObj , where this field contains an ifIndex value from the ifTable table, in the format ifEntry.ifIndex, where ifIndex is the value of ifIndex; for example, ifEntry.1.
ItnmMonitorEventNoRca LookupEntityId Used to handle events raised by the Network Manager Polling engine, ncp_poller, for which root-cause analysis should not be performed.

Expected input fields: NmosEntityId , where this field contains the NCIM entityId for the entity.
ItnmStatus No related stitcher Catch-all event map for Network Manager status information events that are not explicitly handled by any other event map, for example, ItnmHealthCheck. No action is taken for these events.
LinkDownIfDescr LookupIfEntry Expects an interface event to be identified by the ifDescr value.
Expected input fields:
  • LocalNodeAlias , where this field contains one of the following:
    • IP address
    • Entity name
    • DNS name
    • sysName
    • entityId
  • LocalPriObj , where this field contains an ifDescr value from the ifTable table, in the format ifEntry.ifDescr, where ifDescr is the value of ifDescr; for example, ifEntry.FastEthernet0/1.
LinkDownIfIndex LookupIfEntry Expects an interface event to be identified by the ifIndex value.
Expected input fields:
  • LocalNodeAlias , where this field contains one of the following:
    • IP address
    • Entity name
    • DNS name
    • sysName
    • entityId
  • LocalPriObj , where this field contains an ifIndex value from the ifTable table, in the format ifEntry.ifIndex, where ifIndex is the value of ifIndex; for example, ifEntry.1.
LinkDownIfName LookupIfEntry Expects an interface event to be identified by the ifName value.
Expected input fields:
  • LocalNodeAlias , where this field contains one of the following:
    • IP address
    • Entity name
    • DNS name
    • sysName
    • entityId
  • LocalPriObj , where this field contains an ifName value from the ifTable table, in the format ifEntry.ifName, where ifName is the value of ifName; for example, ifEntry.Fa0/1.
NbrFail LookupNbrFailure Handles OSPF, LDP and BGP adjacency change events. In addition to performing the requisite lookup, the LookupNbrFailure stitcher also adds a RemoteNodeEntityId value, used by the RCA plug-in.
Expected input fields:
  • LocalNodeAlias , where this field contains one of the following:
    • IP address
    • Entity name
    • DNS name
    • sysName
    • entityId
  • RemoteNodeAlias , where this field contains the neighboring node IP address or DNS name.
  • LocalPriObj , where this field contains an ifDescr value in the format ifEntry.ifDescr, where ifDescr is the value of ifDescr; for example, ifEntry.ifFastEthernet0/1.
OspfIfState LookupOspfIfEntry Handles OSPF interface events.
Expected input fields:
  • LocalNodeAlias , where this field contains the node IP address (used only for addresless interfaces).
  • LocalPriObj , where this field contains an index from the ospfIfTable; for example:
    • ospfIfEntry.0.0.0.0.66 for addressless (IP unnumbered) interfaces
    • ospfIfEntry.84.82.109.12.0 for serial or Ethernet interfaces
PollFailure LookupIp Covers events raised for a specific IP address, such as Tivoli Netcool/OMNIbus ping probe events.

Expected input fields: NmosEntityId, where this field contains the NCIM entityId for the entity.
PrecisionMonitorEvent LookupEntityId Used to handle events raised by the ITNM poller, for which root-cause analysis must be performed.

Expected input fields: NmosEntityId, where this field contains the NCIM entityId for the entity.
Reconfiguration LookupMainNode

Events assigned to this event map are used by the Disco plug-in to rediscover the device associated with them. By default, reboot events (events with event ID of NmosSnmpReboot) are assigned to this event map, based on the assumption that following reconfiguration of a device (for example, addition of a new card), the device will be rebooted, and then needs to be immediately discovered, so that the changes in configuration can be rapidly stored in the topology model.

Expected input field: LocalNodeAlias, where this field contains one of the following:
  • IP address
  • Entity name
  • DNS name
  • sysName
  • entityId
rttMonNotifications LookupProbeSourceEntity

V4.2 Fix Pack 4: Adds the main node and probe ID to incoming RTTMON traps.

Expected input fields:

  • LocalNodeAlias, where this field contains the IP address, DNS name, sysName or entityName of the node.
  • X733SpecificProb, where this field identifies the trap type, for example rttMonNotification.
  • LocalPriObj, where this field identifies the trap index.

  • ExtendedAttr, where this field stores various RTT-related fields.

Legacy event maps

The following table lists the legacy event maps and, for each legacy event map, specifies which 3.9 event map is delegated to.
Table 2. Legacy event maps
Legacy event map Handled by the following 3.9 event map
EntityIfDescr LinkDownIfDescr
NbrFailIfDescr NbrFail
NcpHealthChk ItnmHealthChk
OSPFIfStateChange OspfIfState
OSPFIfStateChangeIP OspfIfState

How legacy event maps delegate to 3.9 event maps

This example explains how the NbrFailIfDescr legacy event map delegates to the NbrFail 3.9 event map.
  1. An event is received that has an eventId listed in the config.precedence table, mapping to the NbrFailIfDescr eventMap.
  2. The NbrFailIfDescr eventMap delegates to the NbrFail eventMap, using the HandledBy field.
  3. The event is treated exactly as if it had been mapped to the NbrFail eventMap in the first place, that is it will be handled as follows:
    • The LookupNbrFailure stitcher is called. This stitcher is referenced in the Stitcher field relevant to the NbrFail event map entry in the config.eventMaps table.
    • The fields of the NbrFail eventMap (not the NbrFailIfDescr to which the event was originally mapped) are appended to the event before passing it to plug-ins.
    • Plugins that have registered interest in the NbrFail eventMap (not the NbrFailIfDescr to which the event was originally mapped) receive the event.
In this example, the flexibility of the stitcher language allows both types of event to be handled in the same way. If the ifDescr, expected by the legacy NbrFailIfDescr eventMap, is available, it is extracted and used within the LookupNbrFailure stitcher.