display bgp peer statistics

Function

The display bgp peer statistics command displays statistics about routes learned from a specified peer.

Format

display bgp [ multicast ] peer ipv4-address statistics

display bgp ipv6 peer { ipv4-address | ipv6-address } statistics

display bgp vpnv4 { all | vpn-instance vpn-instance-name } peer ipv4-address statistics

display bgp vpnv4 all peer ipv6-address statistics

display bgp vpnv6 { all peer ipv4-address statistics | vpn-instance vpn-instance-name peer ipv6-address statistics }

display bgp labeled peer ipv4-address statistics

display bgp rpd peer ipv4-address statistics

display bgp labeled vpn-instance vpn-instance-name peer ipv4-address statistics

display bgp peer ipv6-address statistics

display bgp vpnv6 all peer ipv6-address statistics

Parameters

Parameter	Description	Value
multicast	IPv4 multicast address-family.	-
ipv4-address	Specify an IPv4 peer address.	The value is in dotted decimal notation.
ipv6	Specify IPv6 unicast address-family.	-
ipv6-address	Specify an IPv6 peer address.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
vpnv4	VPNv4 address-family.	-
all	Display all information on VPNv6 and IPv6 VPN instance.	-
vpn-instance vpn-instance-name	Specify a VPN-Instance (VRF) name.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.
vpnv6	VPNv6 address-family.	-
labeled	Specify labeled-unicast sub-address family.	-
rpd	Specify RPD address family.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
bgp	read

Usage Guidelines

Usage Scenario

On a network with a monitoring server, routers send packets to the monitoring server to report BGP running statistics for monitoring. You can run the display bgp peer statistics command to check the statistics about routes learned from a specified peer.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics about routes learned from a specified peer.

<HUAWEI> display bgp peer 1.1.1.2 statistics
Peer 1.1.1.2, IPv4 Unicast
   Number of prefixes rejected by inbound policy         : 0
   Number of (known) duplicate prefix advertisements     : 6
   Number of (known) duplicate withdraws                 : 6
   Number of updates invalidated due to CLUSTER_LIST loop: 0
   Number of updates invalidated due to AS_PATH loop     : 0
   Number of updates invalidated due to ORIGINATOR_ID    : 0
   Number of updates invalidated due to AS_CONFED loop   : 0
   Number of routes in Adj-RIBs-In (pre-policy)          : 0
   Number of routes in Adj-RIBs-In (post-policy)         : 2
   Number of best routes in Loc-RIB                      : 1

**Table 1** Description of the **display bgp peer statistics** command output
Item	Description
Number of prefixes rejected by inbound policy	Number of routes that are filtered out by the import policy.
Number of (known) duplicate prefix advertisements	Number of times that a route is re-advertised.
Number of (known) duplicate withdraws	Number of times that a route is re-deleted.
Number of updates invalidated due to CLUSTER_LIST loop	Number of routes that are invalid because their Cluster_Lists contain the local cluster ID.
Number of updates invalidated due to AS_PATH loop	Number of routes that are invalid because their AS_Paths contain the local AS number.
Number of updates invalidated due to ORIGINATOR_ID	Number of routes that are invalid because their Originator_IDs are the same as the local router ID.
Number of updates invalidated due to AS_CONFED loop	Number of routes that are invalid because their AS_Paths contain the AS number of the local confederation.
Number of routes in Adj-RIBs-In (pre-policy)	Number of all received routes.
Number of routes in Adj-RIBs-In (post-policy)	Number of accepted routes.
Number of best routes in Loc-RIB	Number of optimal routes in the routing table.