NETSCREEN-BGP4-MIB

All MIBs › NETSCREEN-BGP4-MIB

Organization: Juniper Networks, Inc.

Last Updated: 2005-06-03

Category: BGP

Description: Monitors BGP4 peer session state, prefix counts, and routing table data on Juniper NetScreen ScreenOS firewalls.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is NETSCREEN-BGP4-MIB?

NETSCREEN-BGP4-MIB is a vendor MIB from Juniper's NetScreen line (ScreenOS-based security appliances) that extends BGP4 routing visibility beyond the standard BGP4-MIB. It exposes BGP peer session data, prefix counts, and routing table information specific to the NS-BGP-4 implementation. Its core monitoring purpose is protocol/software status rather than physical hardware: tracking peer session establishment state, route counts, and BGP-related error conditions lets an operator detect a flapping or down BGP neighbor, a route-count anomaly, or a misconfigured peering session on the firewall's routing engine. Because it augments rather than replaces the IETF standard BGP4-MIB (RFC 1657/4273), it depends heavily on that base MIB's object model and conventions. It is deployed on Juniper NetScreen ScreenOS firewalls and security appliances that participate in BGP-based dynamic routing at network edges or between security zones. Engineers can download the NETSCREEN-BGP4-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in NETSCREEN-BGP4-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Juniper NetScreen ScreenOS firewall
security appliance with BGP routing

Monitoring Examples

No sample objects were supplied for this module, so specific object names cannot be grounded here; in general use, an operator would poll BGP peer state and prefix-count objects analogous to the standard bgpPeerTable to detect a peer transitioning out of the Established state or a sudden drop in received route counts, indicating a routing adjacency failure.

Imported Objects

From NETSCREEN-SMI

netscreenVR

OBJECT-IDENTITY

From NETSCREEN-TRAP-MIB

netscreenTrapDesc	OBJECT-TYPE
netscreenTrapType	OBJECT-TYPE

From SNMPv2-SMI

Counter32
Gauge32
Integer32
IpAddress
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

OIDs

OID symbolic	OID numeric	Type	Access	Description
nsBgp	1.3.6.1.4.1.3224.18.3			The MIB module for NS-BGP-4.
nsBgpInfoTable	1.3.6.1.4.1.3224.18.3.1		not-accessible	BGP info table. This table contains, one entry per VR, information about the BGP's Version, LocalAs and Identifier.
nsBgpInfoEntry	1.3.6.1.4.1.3224.18.3.1.1		not-accessible	Entry containing information about the BGP's Version, LocalAs and Identifier
OCT nsBgpInfoVersion	1.3.6.1.4.1.3224.18.3.1.1.1	OCTET STRING	read-only	Vector of supported BGP protocol version numbers. Each peer negotiates the version from this vector. Versions are identified via the string of bits contained within this object. The first octet contains bits 0 to 7, the second octet contains bits 8 to 15, and so on, with the most significant bit referring to the lowest bit number in the octet (e.g., the MSB of the first octet refers to bit 0). If a bit, i, is present and set, then the version (i+1) of the BGP is supported.
INT nsBgpInfoLocalAs	1.3.6.1.4.1.3224.18.3.1.1.2	INTEGER	read-only	The local autonomous system number.
IP nsBgpInfoIdentifier	1.3.6.1.4.1.3224.18.3.1.1.3	IpAddress	read-only	The BGP Identifier of local system.
INT nsBgpInfoVRID	1.3.6.1.4.1.3224.18.3.1.1.4	INTEGER	read-only	Virtual Router ID
nsBgpPeerTable	1.3.6.1.4.1.3224.18.3.3		not-accessible	BGP peer table. This table contains, one entry per BGP peer, information about the connections with BGP peers.
nsBgpPeerEntry	1.3.6.1.4.1.3224.18.3.3.1		not-accessible	Entry containing information about the connection with a BGP peer.
IP nsBgpPeerIdentifier	1.3.6.1.4.1.3224.18.3.3.1.1	IpAddress	read-only	The BGP Identifier of this entry's BGP peer.
INT nsBgpPeerState	1.3.6.1.4.1.3224.18.3.3.1.2	INTEGER	read-only	The BGP peer connection state.
INT nsBgpPeerAdminStatus	1.3.6.1.4.1.3224.18.3.3.1.3	INTEGER	read-only	The desired state of the BGP connection. A transition from 'stop' to 'start' will cause the BGP Start Event to be generated. A transition from 'start' to 'stop' will cause the BGP Stop Event to be generated. This parameter can be used to restart BGP peer connections. Care should be used in providing write access to this object without adequate authentication.
I32 nsBgpPeerNegotiatedVersion	1.3.6.1.4.1.3224.18.3.3.1.4	Integer32	read-only	The negotiated version of BGP running between the two peers.
IP nsBgpPeerLocalAddr	1.3.6.1.4.1.3224.18.3.3.1.5	IpAddress	read-only	The local IP address of this entry's BGP connection.
INT nsBgpPeerLocalPort	1.3.6.1.4.1.3224.18.3.3.1.6	INTEGER	read-only	The local port for the TCP connection between the BGP peers.
IP nsBgpPeerRemoteAddr	1.3.6.1.4.1.3224.18.3.3.1.7	IpAddress	read-only	The remote IP address of this entry's BGP peer.
INT nsBgpPeerRemotePort	1.3.6.1.4.1.3224.18.3.3.1.8	INTEGER	read-only	The remote port for the TCP connection between the BGP peers. Note that the objects nsBgpPeerLocalAddr, nsBgpPeerLocalPort, nsBgpPeerRemoteAddr and nsBgpPeerRemotePort provide the appropriate reference to the standard MIB TCP connection table.
INT nsBgpPeerRemoteAs	1.3.6.1.4.1.3224.18.3.3.1.9	INTEGER	read-only	The remote autonomous system number.
C32 nsBgpPeerInUpdates	1.3.6.1.4.1.3224.18.3.3.1.10	Counter32	read-only	The number of BGP UPDATE messages received on this connection. This object should be initialized to zero (0) when the connection is established.
C32 nsBgpPeerOutUpdates	1.3.6.1.4.1.3224.18.3.3.1.11	Counter32	read-only	The number of BGP UPDATE messages transmitted on this connection. This object should be initialized to zero (0) when the connection is established.
C32 nsBgpPeerInTotalMessages	1.3.6.1.4.1.3224.18.3.3.1.12	Counter32	read-only	The total number of messages received from the remote peer on this connection. This object should be initialized to zero when the connection is established.
C32 nsBgpPeerOutTotalMessages	1.3.6.1.4.1.3224.18.3.3.1.13	Counter32	read-only	The total number of messages transmitted to the remote peer on this connection. This object should be initialized to zero when the connection is established.
OCT nsBgpPeerLastError	1.3.6.1.4.1.3224.18.3.3.1.14	OCTET STRING	read-only	The last error code and subcode seen by this peer on this connection. If no error has occurred, this field is zero. Otherwise, the first byte of this two byte OCTET STRING contains the error code, and the second byte contains the subcode.
C32 nsBgpPeerFsmEstablishedTransitions	1.3.6.1.4.1.3224.18.3.3.1.15	Counter32	read-only	The total number of times the BGP FSM transitioned into the established state.
G32 nsBgpPeerFsmEstablishedTime	1.3.6.1.4.1.3224.18.3.3.1.16	Gauge32	read-only	This timer indicates how long (in seconds) this peer has been in the Established state or how long since this peer was last in the Established state. It is set to zero when a new peer is configured or the router is booted.
INT nsBgpPeerConnectRetryInterval	1.3.6.1.4.1.3224.18.3.3.1.17	INTEGER	read-only	Time interval in seconds for the ConnectRetry timer. The suggested value for this timer is 120 seconds.
INT nsBgpPeerHoldTime	1.3.6.1.4.1.3224.18.3.3.1.18	INTEGER	read-only	Time interval in seconds for the Hold Timer established with the peer. The value of this object is calculated by this BGP speaker by using the smaller of the value in nsBgpPeerHoldTimeConfigured and the Hold Time received in the OPEN message. This value must be at lease three seconds if it is not zero (0) in which case the Hold Timer has not been established with the peer, or, the value of nsBgpPeerHoldTimeConfigured is zero (0).
INT nsBgpPeerKeepAlive	1.3.6.1.4.1.3224.18.3.3.1.19	INTEGER	read-only	Time interval in seconds for the KeepAlive timer established with the peer. The value of this object is calculated by this BGP speaker such that, when compared with nsBgpPeerHoldTime, it has the same proportion as what nsBgpPeerKeepAliveConfigured has when compared with nsBgpPeerHoldTimeConfigured. If the value of this object is zero (0), it indicates that the KeepAlive timer has not been established with the peer, or, the value of nsBgpPeerKeepAliveConfigured is zero (0).
INT nsBgpPeerHoldTimeConfigured	1.3.6.1.4.1.3224.18.3.3.1.20	INTEGER	read-only	Time interval in seconds for the Hold Time configured for this BGP speaker with this peer. This value is placed in an OPEN message sent to this peer by this BGP speaker, and is compared with the Hold Time field in an OPEN message received from the peer when determining the Hold Time (nsBgpPeerHoldTime) with the peer. This value must not be less than three seconds if it is not zero (0) in which case the Hold Time is NOT to be established with the peer. The suggested value for this timer is 90 seconds.
INT nsBgpPeerKeepAliveConfigured	1.3.6.1.4.1.3224.18.3.3.1.21	INTEGER	read-only	Time interval in seconds for the KeepAlive timer configured for this BGP speaker with this peer. The value of this object will only determine the KEEPALIVE messages' frequency relative to the value specified in nsBgpPeerHoldTimeConfigured; the actual time interval for the KEEPALIVE messages is indicated by nsBgpPeerKeepAlive. A reasonable maximum value for this timer would be configured to be one third of that of nsBgpPeerHoldTimeConfigured. If the value of this object is zero (0), no periodical KEEPALIVE messages are sent to the peer after the BGP connection has been established. The suggested value for this timer is 30 seconds.
INT nsBgpPeerMinASOriginationInterval	1.3.6.1.4.1.3224.18.3.3.1.22	INTEGER	read-only	Time interval in seconds for the MinASOriginationInterval timer. The suggested value for this timer is 15 seconds.
INT nsBgpPeerMinRouteAdvertisementInterval	1.3.6.1.4.1.3224.18.3.3.1.23	INTEGER	read-only	Time interval in seconds for the MinRouteAdvertisementInterval timer. The suggested value for this timer is 30 seconds.
G32 nsBgpPeerInUpdateElapsedTime	1.3.6.1.4.1.3224.18.3.3.1.24	Gauge32	read-only	Elapsed time in seconds since the last BGP UPDATE message was received from the peer. Each time nsBgpPeerInUpdates is incremented, the value of this object is set to zero (0).
INT nsBgpPeerVRID	1.3.6.1.4.1.3224.18.3.3.1.25	INTEGER	read-only	Virtual Router ID
nsBgp4PathAttrTable	1.3.6.1.4.1.3224.18.3.6		not-accessible	The BGP-4 Received Path Attribute Table contains information about paths to destination networks received from all BGP4 peers.
nsBgp4PathAttrEntry	1.3.6.1.4.1.3224.18.3.6.1		not-accessible	Information about a path to a network.
IP nsBgp4PathAttrPeer	1.3.6.1.4.1.3224.18.3.6.1.1	IpAddress	read-only	The IP address of the peer where the path information was learned.
INT nsBgp4PathAttrIpAddrPrefixLen	1.3.6.1.4.1.3224.18.3.6.1.2	INTEGER	read-only	Length in bits of the IP address prefix in the Network Layer Reachability Information field.
IP nsBgp4PathAttrIpAddrPrefix	1.3.6.1.4.1.3224.18.3.6.1.3	IpAddress	read-only	An IP address prefix in the Network Layer Reachability Information field. This object is an IP address containing the prefix with length specified by nsBgp4PathAttrIpAddrPrefixLen. Any bits beyond the length specified by nsBgp4PathAttrIpAddrPrefixLen are zeroed.
INT nsBgp4PathAttrOrigin	1.3.6.1.4.1.3224.18.3.6.1.4	INTEGER	read-only	The ultimate origin of the path information.
OCT nsBgp4PathAttrASPathSegment	1.3.6.1.4.1.3224.18.3.6.1.5	OCTET STRING	read-only	The sequence of AS path segments. Each AS path segment is represented by a triple . The type is a 1-octet field which has two possible values: 1 AS_SET: unordered set of ASs a route in the UPDATE message has traversed 2 AS_SEQUENCE: ordered set of ASs a route in the UPDATE message has traversed. The length is a 1-octet field containing the number of ASs in the value field. The value field contains one or more AS numbers, each AS is represented in the octet string as a pair of octets according to the following algorithm: first-byte-of-pair = ASNumber / 256; second-byte-of-pair = ASNumber & 255;
IP nsBgp4PathAttrNextHop	1.3.6.1.4.1.3224.18.3.6.1.6	IpAddress	read-only	The address of the border router that should be used for the destination network.
INT nsBgp4PathAttrMultiExitDisc	1.3.6.1.4.1.3224.18.3.6.1.7	INTEGER	read-only	This metric is used to discriminate between multiple exit points to an adjacent autonomous system. A value of -1 indicates the absence of this attribute.
INT nsBgp4PathAttrLocalPref	1.3.6.1.4.1.3224.18.3.6.1.8	INTEGER	read-only	The originating BGP4 speaker's degree of preference for an advertised route. A value of -1 indicates the absence of this attribute.
INT nsBgp4PathAttrAtomicAggregate	1.3.6.1.4.1.3224.18.3.6.1.9	INTEGER	read-only	Whether or not the local system has selected a less specific route without selecting a more specific route.
INT nsBgp4PathAttrAggregatorAS	1.3.6.1.4.1.3224.18.3.6.1.10	INTEGER	read-only	The AS number of the last BGP4 speaker that performed route aggregation. A value of zero (0) indicates the absence of this attribute.
IP nsBgp4PathAttrAggregatorAddr	1.3.6.1.4.1.3224.18.3.6.1.11	IpAddress	read-only	The IP address of the last BGP4 speaker that performed route aggregation. A value of 0.0.0.0 indicates the absence of this attribute.
INT nsBgp4PathAttrCalcLocalPref	1.3.6.1.4.1.3224.18.3.6.1.12	INTEGER	read-only	The degree of preference calculated by the receiving BGP4 speaker for an advertised route. A value of -1 indicates the absence of this attribute.
INT nsBgp4PathAttrBest	1.3.6.1.4.1.3224.18.3.6.1.13	INTEGER	read-only	An indication of whether or not this route was chosen as the best BGP4 route.
OCT nsBgp4PathAttrUnknown	1.3.6.1.4.1.3224.18.3.6.1.14	OCTET STRING	read-only	One or more path attributes not understood by this BGP4 speaker. Size zero (0) indicates the absence of such attribute(s). Octets beyond the maximum size, if any, are not recorded by this object.
INT nsBgp4PathAttrVRID	1.3.6.1.4.1.3224.18.3.6.1.15	INTEGER	read-only	Virtual Router ID
nsBgpTraps	1.3.6.1.4.1.3224.18.3.7
NTF nsBgpEstablished	1.3.6.1.4.1.3224.18.3.7.1			The BGP Established event is generated when the BGP FSM enters the ESTABLISHED state.

RFC description

BGP-4 routing protocol monitoring for Juniper NetScreen firewalls and virtual routers.

Start monitoring Juniper NetScreen ScreenOS firewall (BGP4 routing) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download NETSCREEN-BGP4-MIB

What Is NETSCREEN-BGP4-MIB?

Supported Devices

Monitoring Examples

This MIB depends on

Related MIBs

RFC description