Attributes for BGPProtocolEndpoint lists some key attributes for BGPProtocolEndpoint. Network Protocol Manager for BGP uses these and other attributes to diagnose BGP protocol endpoint problems and to detect BGP protocol endpoint events.

The IsFlapping and trap-type attributes for BGPProtocolEndpoint pertain to flapping analysis, which is explained in Chapter 5, “BGP Session Flapping Detection”.

Table 1. Attributes for BGPProtocolEndpoint

Attribute

Description

Allowed values

ActualRemoteAS

Actual identifier, or number, of the autonomous system of which the BGP peer (remote BGP service) for this endpoint is a member.

Integer

AS

Identifier, or number, of the autonomous system of which the BGP service for this endpoint is a member.

Integer

Established

True if the BGP session for this endpoint is established.

Boolean: true or false

FlappingClearWindow

Length of time, in seconds, that a Flapping event, triggered by flapping on this endpoint and generated for the associated BGP session, is active before the event is cleared.

Length of time is determined by the value of the FLAP_Clear_Window parameter in the BGP Session Flapping threshold setting. A value of 0 disables the clearing of Flapping events.

Integer

FlappingDetectedTime

Timestamp, as shown in the Global Console, when flapping condition is detected on this endpoint.

String

FlappingStableMaxTimeWindow

Maximum length of time, in seconds, that can elapse before this flapping endpoint is declared stable. The maximum length of time is fixed at 3600 seconds (60 minutes).

Integer

IsEBGP

True if the BGP session for this endpoint is an External BGP (EBGP) session.

Boolean: true or false

IsFlapping

True if a flapping condition is occurring at this endpoint.

Boolean: true or false

IsMultiHop

True if the BGP session for this endpoint is configured as Multihop.

Boolean: true or false

IsRouteReflector

True if the device for this endpoint is an RR.

Note:

BGP MIB objects cannot identify an RR, this attribute can only be set to true by using an ASL hook script. “BGPSessionGroup” on page 48 provides details.

Boolean: true or false

LocalAddress

Local IP address of the BGP session for this endpoint.

Note:

This attribute is not displayed during IPv6 BGP discovery.

String: IpAddress, an application-wide type that represents a 32-bit value

LocalPort

Local TCP port of the BGP session for this endpoint.

Note:

This attribute is not displayed during IPv6 BGP discovery.

Integer

DiscoveredLocalAddress

The local IP address of the BGP session for this endpoint that is discovered.

Note:

This attribute is not displayed during IPv6 BGP discovery.

String

PeerAdminStatus

Administrative status of the remote device for this endpoint.

String:

  • UNKNOWN

  • STOP

  • START

PeerNegotiatedVersion

Negotiated version of BGP that is running on the BGP session for this endpoint; negotiated between local BGP service and remote BGP service.

Integer

0 indicates that a BGP session is not established.

PeerState

Current state of the BGP session for this endpoint.

  • UNKNOWN is the default PeerState value before Network Protocol Manager for BGP sends SNMP polls to the device that is hosting this endpoint.

  • IDLE indicates that the BGP service for this endpoint refuses all incoming BGP connections. No resources are allocated to the peer.

  • CONNECT indicates that the BGP service for this endpoint is waiting for the transport protocol connection to be completed.

  • ACTIVE indicates that the BGP service for this endpoint is trying to acquire a peer by initiating a transport protocol connection.

  • OPENSENT indicates that the BGP service for this endpoint is waiting for an OPEN message from its peer. When an OPEN message is received, the BGP service checks all fields for correctness.

  • OPENCONFIRM indicates that the BGP service for this endpoint is waiting for a KEEPALIVE or NOTIFICATION message. If the host device receives a KEEPALIVE message, the BGP service changes the state to Established.

  • ESTABLISHED indicates that the BGP service for this endpoint can exchange UPDATE, NOTIFICATION, and KEEPALIVE messages with its peer.

String:

  • UNKNOWN

  • IDLE

  • CONNECT

  • ACTIVE

  • OPENSENT

  • OPENCONFIRM

  • ESTABLISHED

RemoteAddress

Remote IP address of the BGP session for this endpoint.

String: IpAddress, an application-wide type that represents a 32-bit value

RemoteAS

Identifier, or number, of the autonomous system of which the BGP peer for this endpoint is a member, as determined by the configuration on the local device.

Integer

RemotePort

Remote TCP port of the BGP session for this endpoint.

Integer

TrapCount

Number of traps received for this endpoint since flapping condition on this endpoint started.

Integer

TrapCountThreshold

Minimum number of state transitions that must occur during a TrapTimeWindow interval to trigger a flapping condition on this endpoint.

Length of time is determined by the value of the Trap_Count_Threshold parameter in the BGP Session Flapping threshold setting. A value of 0 disables flapping analysis.

Integer

TrapFirstReceivedTime

Timestamp, as shown in the Global Console, when first bgpEstablished trap is received for current flapping condition on this endpoint.

String

TrapLastReceivedTime

Timestamp, as shown in the Global Console, when last bgpEstablished trap is received for current flapping condition on this endpoint.

String

TrapTimeWindow

Time interval, in seconds, during which the TrapCountThreshold value must be reached in order to declare a flapping condition on this endpoint.

Time interval is determined by the value of the Trap_Time_Window parameter in the BGP Session Flapping threshold setting. A value of 0 disables flapping analysis.

Integer