Table Of Contents
Source OIDs of Alarms Generated by Cisco ANA
Managed Element OID (IManagedElementOid)
Topological Link OID (ITopologicalLinkOid)
Supported Alarms with Topological Link OID Source
Link Down Endpoint OID Structure
GRE Tunnel Endpoint OID Structure
Layer2 MPLS Tunnel Endpoint OID Structure
BGP Link Down Endpoint OID Structure
Physical Layer OID (IPhysicalLayerOid)
Module OID (IModuleOid)
Shelf OID (IShelfOid)
IP Interface OID (IPInterfaceOid)
MPBgp OID (IMpBgpOid)
BGP Neighbor Entry OID (IBgpNeighborEntryOid)
LSE OID (ILseOid)
Alarm Differentiators
LSE Entry OID (IMplsEntryOid)
MPLS TE Tunnel OID (IMplsTETunnelOid)
Logical Port OID (ILogicalPortOid)
L2TP Peer OID (IL2tpPeerOid)
Source OIDs of Alarms Generated by Cisco ANA
This appendix describes 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 the LSE OID (ILseOid)) for an example.
This appendix includes the following source OIDs:
•
Managed Element OID (IManagedElementOid)
•
Topological Link OID (ITopologicalLinkOid)
•
Physical Layer OID (IPhysicalLayerOid)
•
Module OID (IModuleOid)
•
Shelf OID (IShelfOid)
•
IP Interface OID (IPInterfaceOid)
•
MPBgp OID (IMpBgpOid)
•
BGP Neighbor Entry OID (IBgpNeighborEntryOid)
•
LSE OID (ILseOid)
•
LSE Entry OID (IMplsEntryOid)
•
MPLS TE Tunnel OID (IMplsTETunnelOid)
•
Logical Port OID (ILogicalPortOid)
•
L2TP Peer OID (IL2tpPeerOid)
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 over utilized
•
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)]}
Topological Link OID (ITopologicalLinkOid)
The Topological Link OID is the source OID for any link down alarm. It will have the following structure:
{[TopologicalLink(AEndPoint=AEndOid)(TunnelID=tunnelId)(ZEndPoint=ZEndOid)]}
•
AEndOid, ZEndOid—The OIDs of the link endpoint components.
•
TunnelId—Where multiple links can exists between two components, the tunnelItd value is used to distinguish between the links.
Supported Alarms with Topological Link OID Source
Currently 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 subtypes of link down (for example link down due to admin down, 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 initialized. See Layer2 MPLS Tunnel Endpoint OID Structure.
•
BGP link down—The endpoint OIDs are the MpBGP. In this case the TunnelID is not used, nor initialized. See BGP Link Down Endpoint OID Structure.
Link Down Endpoint OID Structure
The structure of the Physical Layer OID for the Link Down Endpoint is:
{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Shelf(ShelfNum=shelfNum)][Slot(SlotNum=slotNum)][Module][Slot(SlotNum=subSlotNum)][Module][Port(PortNumber=portNum)][PhysicalLayer]}
Optional parts in the Physical Layer OID are:
•
Shelf
•
Second level slot
•
Module representing a submodule
PortNum can also be the port name (see Examples below).
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 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 OID for the GRE Tunnel Endpoint 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 Layer2 MPLS tunnel endpoints. In this case the TunnelID is not used and is not initialized.
Layer2 MPLS Tunnel Endpoint OID Structure
The structure of the source OID for the Layer2 MPLS Tunnel Endpoint 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 OID for the MpBGP 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]})]}
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 in the OIDs are:
•
Shelf
•
Second level slot
•
Module representing submodule
PortNum can also be the port name (see Examples below).
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]}
Module OID (IModuleOid)
The Module OID is the source OID for any alarms related to a card/module.
Alarms which have Module OID as their source are:
•
Card out
•
Card down
Possible structures of the Module OIDs are:
1.
Module under chassis:
{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Shelf(ShelfNum=shelfNum)][Slot(SlotNum=slotNum)][Module]}
2.
Module under other module (submodule):
{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Shelf(ShelfNum=shelfNum)][Slot(SlotNum=slotNum)][Module][Slot(SlotNum=subSlotNum)][Module]}
The Shelf is an optional part in the OIDs.
Example
{[ManagedElement(Key=CRS-1)][PhysicalRoot][Chassis][Shelf(ShelfNum=0)][Slot(SlotNum=4
-Back)][Module][Slot(SlotNum=10)][Module]}
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)]}
IP Interface OID (IPInterfaceOid)
The IP Interface OID is the source OID for any alarms related to 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)]}
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]}
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)]}
LSE OID (ILseOid)
LSE (Label Switching Entity) OID is used as the source for various alarms related to MPLS.
Currently 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 different alarms of the same type cannot have the same source. When this occurs, for example with the alarms listed above, 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.
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 will be different when the IP interface is under a VRF (See IP Interface OID (IPInterfaceOid)).
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 may 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 physical port on a module.
{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Slot(SlotNum=slotNum)][Module][Port(PortNumber=portNum)][PhysicalLayer][VpMux][LogicalPort(LogicalPortNumber=logicalPortNum)]}
•
Logical port on a physical port on a submodule.
{[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:
Example
{[ManagedElement(Key=deviceName)][PhysicalRoot][Chassis][Slot(SlotNum=slotNum)][Module][Po
rt(PortNumber=portNum)][PhysicalLayer][SubPort(SubPortNumber=subPortNumber)][VpMux][Logica
lPort(LogicalPortNumber=logicalPortNum)]}
L2TP Peer OID (IL2tpPeerOid)
L2TP modeling in Cisco ANA is currently 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)]}