Cisco Active Network Abstraction User Guide, 3.6.7
Alarm Source OIDs

Table Of Contents

Alarm Source OIDs

BGP Neighbor Entry OID (IBgpNeighborEntryOid)

EFP OID (IEFPOID)

IP Interface OID (IPInterfaceOid)

L2TP Peer OID (IL2tpPeerOid)

Logical Port OID (ILogicalPortOid)

LSE OID (ILseOid)

Alarm Differentiators

LSE Entry OID (IMplsEntryOid)

Managed Element OID (IManagedElementOid)

Module OID (IModuleOid)

MPBGP OID (IMpBgpOid)

MPLS TE Tunnel OID (IMplsTETunnelOid)

Physical Layer OID (IPhysicalLayerOid)

Shelf OID (IShelfOid)

Topological Link OID (ITopologicalLinkOid)

Supported Alarms with Topological Link OID Source

Link Down Endpoint OID Structure

GRE Tunnel Endpoint OID Structure

Layer 2 MPLS Tunnel Endpoint OID Structure

BGP Link Down Endpoint OID Structure

VLAN Tagged Interface OID (IVlanTaggedInterfaceOID)

VSI OID (IVSIOID)


Alarm Source OIDs


These topics describe the possible source object identifiers (OIDs) of alarms generated by Cisco ANA. A description of each source OID and OID structure is given, with examples of OIDs and service alarms that use those OIDs as their source.


Note The source OID must be unique in the alarm type context. For example, it is not possible to generate multiple different alarms with the same type from the same component using the component OID as the source. An additional differentiator should be added to the base component OID. See LSE OID (ILseOid), for an example.


The following source OIDs are described:

BGP Neighbor Entry OID (IBgpNeighborEntryOid)

EFP OID (IEFPOID)

IP Interface OID (IPInterfaceOid)

L2TP Peer OID (IL2tpPeerOid)

Logical Port OID (ILogicalPortOid)

LSE OID (ILseOid)

LSE Entry OID (IMplsEntryOid)

Managed Element OID (IManagedElementOid)

Module OID (IModuleOid)

MPBGP OID (IMpBgpOid)

MPLS TE Tunnel OID (IMplsTETunnelOid)

Physical Layer OID (IPhysicalLayerOid)

Shelf OID (IShelfOid)

Topological Link OID (ITopologicalLinkOid)

VLAN Tagged Interface OID (IVlanTaggedInterfaceOID)

VSI OID (IVSIOID)

BGP Neighbor Entry OID (IBgpNeighborEntryOid)

The BGP Neighbor Entry OID is the source OID for any alarms related to BGP neighbors.

The alarm supported by Cisco ANA with BGP Neighbor Entry source OID is:

BGP Neighbor Loss

The structure of the BGP Neighbor Entry OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=7)][MpBgp][BgpNeighbourEntry(PeerIdentifier=peerIP)(VrfName=vrfName)]}

The VrfName identifier in the BGP entry part exists if the entry is under VRF.

Example
{[ManagedElement(Key=PE3-NY-7300)][LogicalRoot][FWComponentContainer(Type=7)][MpBgp][BgpNe
ighbourEntry(PeerIdentifier=10.0.7.4)(VrfName=Red)]}

EFP OID (IEFPOID)

The structure of the EFP OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=7)][MpBgp][BgpNeighbourEntry(PeerIdentifier=peerIP)(VrfName=vrfName)]}

Example
{[ManagedElement(Key=PE3-NY-7300)][LogicalRoot][FWComponentContainer(Type=7)][MpBgp][BgpNe
ighbourEntry(PeerIdentifier=10.0.7.4)(VrfName=Red)]}

IP Interface OID (IPInterfaceOid)

The IP Interface OID is the source OID for any alarms related to the IP interface.

Alarms supported by Cisco ANA with IP Interface source OID are:

Interface Status

HSRP Group Status Changed

The structure of the IP Interface OID can be one of the following:

IP interface under the global routing (RoutingEntity):

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=1)][RoutingEntity][IpInterface(IpInterfaceName=ifName)]}

IP interface under a VRF:

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=3)][Vrf(VrfName=vrfName)][IpInterface(IpInterfaceName=ifName)]}

Examples

IP Interface OID under the RoutingEntity:

{[ManagedElement(Key=PE2-TX-GSR)][LogicalRoot][FWComponentContainer(Type=1)][RoutingEntity
][IpInterface(IpInterfaceName=POS0/0)]}

IP Interface OID under a VRF:

{[ManagedElement(Key=PE-South)][LogicalRoot][FWComponentContainer(Type=3)][Vrf(VrfName=vrf
A)][IpInterface(IpInterfaceName=Serial2/0.400)]}

L2TP Peer OID (IL2tpPeerOid)

Layer 2 Tunneling Protocol (L2TP) modeling in Cisco ANA is available only for Redback SMS devices. L2TP Peer is a component that is used to model administrative aspect of L2TP tunnels. It is basically an entity responsible for creating L2TP tunnels based on its configuration.

The L2TP Peer OID is the source OID for any alarms related to L2TP Peer components.

Alarms supported by Cisco ANA with L2TP Peer source OID are:

L2TP Peer Not Established

L2TP Session Threshold

The structure of the L2TP Peer OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][Context(ContextName=contextName)][FWComponentContainer(Type=6)][L2tpPeer(PeerName=peerName)]}

Example
{[ManagedElement(Key=redback)][LogicalRoot][Context(ContextName=l2tpCtx)][FWComponentConta
iner(Type=6)][L2TPPeer(PeerName=peer5)]}

Logical Port OID (ILogicalPortOid)

A logical port represents a logical ATM/FrameRelay interface which is configured on top of a physical port. One physical port might have multiple logical ports. In ATM, logical ports are differentiated by VP muxing, that is, each logical port is configured with a range of VPIs. This type of configuration exists in Lucent GX/CBX, which are supported by Cisco ANA.

The Logical Port OID is the source OID for any alarms related to logical ports.

The alarm supported by Cisco ANA with the Logical Port source OID is:

Logical Port Down

The structure of the Logical Port OID can be one of the following:

Logical port on a module's physical port:

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Slot(SlotNum=slotNum)][Module][Port(PortNumber=portNum)][PhysicalLayer][VpMux][LogicalPort(LogicalPortNumber=logicalPortNum)]}

Logical port on a submodule's physical port:

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Slot(SlotNum=slotNum)][Module][Slot(SlotNum=subSlotNum)][Module][Port(PortNumber=portNum)][PhysicalLayer][VpMux][LogicalPort(LogicalPortNumber=logicalPortNum)]}

Logical port of a subport:

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Slot(SlotNum=slotNum)][Module][Port(PortNumber=portNum)][PhysicalLayer][SubPort(SubPortNumber=subPortNumber)][VpMux][LogicalPort(LogicalPortNumber=logicalPortNum)]}

LSE OID (ILseOid)

The Label Switching Entity (LSE) OID is used as the source for various alarms related to MPLS.

Alarms supported by Cisco ANA with LSE OID are:

MPLS Black Hole Found

MPLS Interface Removed

LDP Neighbor Loss

The structure of the LSE OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=4)][Lse]}

Alarm Differentiators

Multiple alarms of the same type cannot have the same source. When this occurs, then the LSE OID is used as a base OID and is augmented with a differentiator. A specific alarm differentiator is used for each type of alarm.

The following examples show how specific alarm differentiators are used in the different types of alarms:

Example 1

MPLS Black Hole Found—[ServiceEvent(DiffObject=ifName nextHop)]

Source OIDs of MPLS Black Hole Found:

{[ManagedElement(Key=RR1-IOU)][LogicalRoot][FWComponentContainer(Type=4)][Lse][ServiceEven
t(DiffObject=Ethernet0/0 192.168.1.210)]}

{[ManagedElement(Key=RR1-IOU)][LogicalRoot][FWComponentContainer(Type=4)][Lse][ServiceEven
t(DiffObject=Ethernet0/0 192.168.1.310)]}
Example 2

MPLS Interface Removed—[ServiceEvent(DiffObject=mplsIfDescr)]

Source OIDs of MPLS Interface Removed:

{[ManagedElement(Key=PE4-NY-7200)][LogicalRoot][FWComponentContainer(Type=4)][Lse][Service
Event(DiffObject=MPLS on interface FastEthernet0/1)]}

{[ManagedElement(Key=PE4-NY-7200)][LogicalRoot][FWComponentContainer(Type=4)][Lse][Service
Event(DiffObject=MPLS on interface FastEthernet0/2)]}

Example 3

LDP Neighbor Loss—[ServiceEvent(DiffObject=peerLdpId)]

Source OIDs of LDP Neighbor Loss:

{[ManagedElement(Key=CORE2-NY-GSR)][LogicalRoot][FWComponentContainer(Type=4)][Lse][Servic
eEvent(DiffObject=172.255.0.1:0)]}

{[ManagedElement(Key=CORE2-NY-GSR)][LogicalRoot][FWComponentContainer(Type=4)][Lse][Servic
eEvent(DiffObject=172.255.0.1:5)]}

LSE Entry OID (IMplsEntryOid)

The LSE Entry OID is used as the source OID for any alarms related to LSE entries.

The alarm supported by Cisco ANA with the LSE Entry source OID is:

Broken LSP Discovered

The structure of the LSE Entry OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=4)][Lse][LSEEntries(InLabel=inLabel)][MplsEntry(OutInterface=outIfOid)]}

The OutInterface is the IP interface OID of the outgoing interface.

Example
{[ManagedElement(Key=PE1-NY-GSR)][LogicalRoot][FWComponentContainer(Type=4)][Lse][LSEEntri
es(InLabel=74)][MplsEntry(OutInterface={[ManagedElement(Key=PE1-NY-GSR)][LogicalRoot][FWCo
mponentContainer(Type=1)][RoutingEntity][IpInterface(IpInterfaceName=POS0/0)]})]}

Note The structure of the OutInterface is a separate OID.


Managed Element OID (IManagedElementOid)

Managed Element represents the root component of the VNE. Any alarm related to the top-level component of the VNE will have the Managed Element OID as the source.

Alarms which have Managed Element OID as their source are:

Device Unreachable

Device Unsupported

CPU Overutilized

Module Unsupported (Investigation State)

Adaptive Polling

Cloud Problem (for cloud VNEs)

The structure of the Managed Element OID is:

{[ManagedElement(Key=deviceName)]}

Example
{[ManagedElement(Key=PE4-NY-7200)]}

Module OID (IModuleOid)

The Module OID is the source OID for any alarms related to a card or module.

Alarms which have Module OID as their source are:

Card Out

Card Down

Possible structures of the Module OIDs are:

Module under chassis:

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Shelf(ShelfNum=shelfNum)][Slot(SlotNum=slotNum)][Module]}

Module under other module (submodule):

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Shelf(ShelfNum=shelfNum)][Slot(SlotNum=slotNum)][Module][Slot(SlotNum=subSlotNum)][Module]}

Shelf is an optional part of the OID.

Example
{[ManagedElement(Key=CRS-1)][PhysicalRoot][Chassis][Shelf(ShelfNum=0)][Slot(SlotNum=4 
-Back)][Module][Slot(SlotNum=10)][Module]}

MPBGP OID (IMpBgpOid)

The MPBGP OID will be the source OID for any alarms related to BGP service.

The alarm supported by Cisco ANA with MPBGP source OID is:

BGP Process Down

The structure of the MPBGP OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=7)][MpBgp]}

Example
{[ManagedElement(Key=Juniper M5)][LogicalRoot][FWComponentContainer(Type=7)][MpBgp]}

MPLS TE Tunnel OID (IMplsTETunnelOid)

The MPLS TE Tunnel OID is the source OID for any alarms related to MPLS TE tunnels.

The alarm supported by Cisco ANA with MPLS TE Tunnel source OID is:

MPLS TE Tunnel Down

The structure of the MPLS TE Tunnel OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=1)][RoutingEntity][IpInterface(IpInterfaceName=ifName)][MplsTETunnel]}

Example
{[ManagedElement(Key=CRS1-PE)][LogicalRoot][FWComponentContainer(Type=1)][RoutingEntity][I
pInterface(IpInterfaceName=tunnel-te0)][MplsTETunnel]}

Note The structure of the OID is different when the IP interface is under a VRF (see IP Interface OID (IPInterfaceOid)).


Physical Layer OID (IPhysicalLayerOid)

The Physical Layer OID is the source OID for any alarm related to the physical layer of a port.

Alarms which have Physical Layer OID as their source are:

Port Down

Tx/Rx Utilization (no adjacent)

Tx/Rx Dormant

Dropped/Discarded Packets

All IP Interfaces Down

The structure of the Physical Layer OID is:

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Shelf(ShelfNum=shelfNum)][Slot(SlotNum=slotNum)][Module][Slot(SlotNum=subSlotNum)][Module][Port(PortNumber=portNum)][PhysicalLayer]}

Optional parts of the OID are:

Shelf

Second-level slot

Module representing submodule

PortNum can also be the port name (see the following examples).

Examples

Source of port down where the port is on a submodule:

{[ManagedElement(Key=CRS-1)][PhysicalRoot][Chassis][Shelf(ShelfNum=0)][Slot(SlotNum=4 
-Back)][Module][Slot(SlotNum=4)][Module][Port(PortNumber=GigabitEthernet0/4/4/1)][Physical
Layer]}

Shelf OID (IShelfOid)

The Shelf OID is the source OID for any alarms related to shelf.

The alarm which has Shelf OID as its source is:

Shelf Out

The structure of the Shelf OID is:

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Shelf(ShelfNum=shelfNum)]}

Example
{[ManagedElement(Key=CRS-1)][PhysicalRoot][Chassis][Shelf(ShelfNum=0)]}

Topological Link OID (ITopologicalLinkOid)

The Topological Link OID is the source OID for any Link Down alarm. It has the following structure:

{[TopologicalLink(AEndPoint=AEndOid)(TunnelID=tunnelId)(ZEndPoint=ZEndOid)]}

AEndOid, ZEndOid—The OIDs of the link endpoint components.

TunnelID—Where multiple links can exist between two components, the TunnelID value is used to distinguish between the links.

Supported Alarms with Topological Link OID Source

The alarms supported in Cisco ANA which have Topological Link OID source are:

Link Down—Link down between physical ports, the endpoint OIDs of the physical layer. In this case, the TunnelId is not used and is set to -1. See Link Down Endpoint OID Structure.


Note There are various alarm subtypes of link down (for example, Link Down to Admin Down, and Link Down on Unreachable). They all have the same source OID.


Link Utilization—The source OID is the same as for link down.

Tx/Rx Utilization—The source OID is the same as for link down where the physical layer component is adjacent.

GRE Tunnel Down—The endpoint OIDs are the GRE tunnel endpoints. In this case, the TunnelID is not used and is set to -1. See GRE Tunnel Endpoint OID Structure.

Layer  2 Tunnel Down—The endpoint OIDs are the Layer 2 MPLS tunnel endpoints. In this case, the TunnelID is not used, nor is it initialized. See Layer 2 MPLS Tunnel Endpoint OID Structure.

BGP Link Down—The endpoint OIDs are the MpBGP. In this case, the TunnelID is not used, nor is it initialized. See BGP Link Down Endpoint OID Structure.

Link Down Endpoint OID Structure

The structure of the Link Down Endpoint OID is:

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Shelf(ShelfNum=shelfNum)][Slot(SlotNum=slotNum)][Module][Slot(SlotNum=subSlotNum)][Module][Port(PortNumber=portNum)][PhysicalLayer]}

Optional parts of the Link Down Endpoint OID are:

Shelf

Second-level slot

Module representing a submodule

PortNum can also be the port name (see the following examples).

Examples

Source of link down where the physical ports are on a module:

{[TopologicalLink(AEndPoint={[ManagedElement(Key=PE3-NY-7300)][PhysicalRoot][Chassis][Slot
(SlotNum=1)][Module][Port(PortNumber=FastEthernet1/1)][PhysicalLayer]})(TunnelID=-1)(ZEndP
oint={[ManagedElement(Key=PE1-NY-GSR)][PhysicalRoot][Chassis][Slot(SlotNum=1)][Module][Slo
t(SlotNum=1)][Module][Port(PortNumber=GigabitEthernet1/1/2)][PhysicalLayer]})]}

Source of link down where the physical port of AendPoint is on a submodule:

{[TopologicalLink(AEndPoint={[ManagedElement(Key=PE1-NY-GSR)][PhysicalRoot][Chassis][Slot(
SlotNum=1)][Module][Slot(SlotNum=1)][Module][Port(PortNumber=GigabitEthernet1/1/1)][Physic
alLayer]})(TunnelID=-1)(ZEndPoint={[ManagedElement(Key=NPE1-NY-7600)][PhysicalRoot][Chassi
s][Slot(SlotNum=4)][Module][Port(PortNumber=FastEthernet4/48)][PhysicalLayer]})]}

GRE Tunnel Endpoint OID Structure

The structure of the GRE Tunnel Endpoint OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][Context(ContextName=contextName)][TunnelContainer(TunnelType=4)][TunnelGre(TunnelName=tunnelName)]}

Examples

Source of GRE Tunnel Down alarm:

{[TopologicalLink(AEndPoint={[ManagedElement(Key=PE-East-IOU-158)][LogicalRoot][Context(Co
ntextName=Default 
context)][TunnelContainer(TunnelType=4)][TunnelGre(TunnelName=Tunnel1)]})(TunnelID=-1)(ZEn
dPoint={[ManagedElement(Key=PE-South-IOU-158)][LogicalRoot][Context(ContextName=Default 
context)][TunnelContainer(TunnelType=4)][TunnelGre(TunnelName=Tunnel1)]})]} 

Layer 2 Tunnel Down—The endpoint OIDs are the Layer 2 MPLS tunnel endpoints. In this case, the TunnelID is not used and is not initialized.

Layer 2 MPLS Tunnel Endpoint OID Structure

The structure of the Layer 2 MPLS Tunnel Endpoint OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][Context(ContextName=contextName)][TunnelContainer(TunnelType=1)][PTPLayer2MplsTunnel(PeerRouterIp=peerRouterIP)(TunnelId=tunnelId)]}

Example

Source of Layer 2 Tunnel Down:

{[TopologicalLink(AEndPoint={[ManagedElement(Key=NPE1-NY-7600)][LogicalRoot][Context(Conte
xtName=Default 
context)][TunnelContainer(TunnelType=1)][PTPLayer2MplsTunnel(PeerRouterIp=172.255.1.5)(Tun
nelId=100)]})(TunnelID=)(ZEndPoint={[ManagedElement(Key=PE4-NY-7200)][LogicalRoot][Context
(ContextName=Default 
context)][TunnelContainer(TunnelType=1)][PTPLayer2MplsTunnel(PeerRouterIp=172.255.1.3)(Tun
nelId=100)]})]}

BGP Link Down Endpoint OID Structure

The structure of the MpBGP Link Down Endpoint OID is:

{[ManagedElement(Key=deviceName)][LogicalRoot][FWComponentContainer(Type=7)] [TunnelId=tunnelId)]}

Example

Source of BGP Link Down:

{[TopologicalLink(AEndPoint={[ManagedElement(Key=PE-East-IOU-159)][LogicalRoot][FWComponen
tContainer(Type=7)][MpBgp]})(TunnelID=-1)(ZEndPoint={[ManagedElement(Key=RR2-IOU-159)][Log
icalRoot][FWComponentContainer(Type=7)][MpBgp]})]}

VLAN Tagged Interface OID (IVlanTaggedInterfaceOID)

The VLAN Tagged Interface OID is used as the source OID for alarms related to Q-in-Q or stacked VLANs, such as Subinterface Down.

A subinterface is a logical division of traffic on an interface, such as multiple subnets across one physical interface. A subinterface name is represented as an extension to an interface name using dot notation, such as Interface Gigabit Ethernet 0/1/2/3.10. In this example, the main interface name is Gigabit Ethernet 0/1/2/3 and the subinterface is 10.

The structure of the VLAN Tagged Interface OID is:

{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Slot(SlotNum=slotNum)][Module][Slot(SlotNum=subSlotNum)][Module][Port(PortNumber=portNum)][PhysicalLayer][DataLinkLayer][VlanEncapMux][VLANTaggedInterface(InterfaceName=subInterfaceName)]}

Example

{[ManagedElement(Key=10.56.101.133)][PhysicalRoot][Chassis][Slot(SlotNum=4)][Module][Slot(
SlotNum=0)][Module][Port(PortNumber=GigabitEthernet4/0/2)][PhysicalLayer][DataLinkLayer][V
lanEncapMux][VLANTaggedInterface(InterfaceName=Gi4/0/2.1)]}

VSI OID (IVSIOID)

The VSI OID is used as a source for VSI IMOs and VSI alarms including VSI Admin Down, VSI Down, and VSI Up.

The VSI OID is structured so that the VPLS name and VPN ID are identifiers for the VSI entity concatenated to the logical context OID.

Example

[ManagedElement(Key=7606S-PE1)][LogicalRoot][Context(ContextName=Default 
context)][FWComponentContainer(Type=10)] [VSI(VplsInstanceName=eli_VFI)(VpnId=101)]}