Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show bgp group

Syntax

Syntax (EX Series Switch and QFX Series)

Description

Display information about the configured BGP groups.

Options

none

Display group information about all BGP groups.

brief | detail | summary

(Optional) Display the specified level of output.

group-name

(Optional) Display group information for the specified group.

exact-instance instance-name

(Optional) Display information for the specified instance only.

instance instance-name

(Optional) Display information about BGP groups for all routing instances whose name begins with this string (for example, cust1, cust11, and cust111 are all displayed when you run the show bgp group instance cust1 command). The instance name can be primary for the main instance, or any valid configured instance name or its prefix.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

rtf

(Optional) Display BGP group route targeting information.

Required Privilege Level

view

Output Fields

Table 1 describes the output fields for the show bgp group command. Output fields are listed in the approximate order in which they appear.

Table 1: show bgp group Output Fields

Field Name

Field Description

Level of Output

Group Type or Group

Type of BGP group: Internal or External.

All levels

group-index

Index number for the BGP peer group. The index number differentiates between groups when a single BGP group is split because of different configuration options at the group and peer levels.

rtf detail

AS

AS number of the peer. For internal BGP (IBGP), this number is the same as Local AS.

brief detail none

Local AS

AS number of the local routing device.

brief detail none

Name

Name of a specific BGP group.

brief detail none

Options

The Network Layer Reachability Information (NLRI) format used for BGP VPN multicast.

none none

Index

Unique index number of a BGP group.

brief detail none

Flags

Flags associated with the BGP group. This field is used by Juniper Networks customer support.

brief detail none

BGP-Static Advertisement Policy

Policies configured for the BGP group with the advertise-bgp-static policy statement.

brief none

Remove-private options

Options associated with the remove-private statement.

brief detail none

Holdtime

Maximum number of seconds allowed to elapse between successive keepalive or update messages that BGP receives from a peer in the BGP group, after which the connection to the peer is closed and routing devices through that peer become unavailable.

brief detail none

Export

Export policies configured for the BGP group with the export statement.

brief detail none

Optimal Route Reflection

Client nodes (primary and backup) configured in the BGP group.

brief detail none

MED tracks IGP metric update delay

Time, in seconds, that updates to multiple exit discriminator (MED) are delayed. Also displays the time remaining before the interval is set to expire

All levels

Traffic Statistics Interval

Time between sample periods for labeled-unicast traffic statistics, in seconds.

brief detail none

Total peers

Total number of peers in the group.

brief detail none

Established

Number of peers in the group that are in the established state.

All levels

Active/Received/Accepted/Damped

Multipurpose field that displays information about BGP peer sessions. The field’s contents depend upon whether a session is established and whether it was established in the main routing device or in a routing instance.

  • If a peer is not established, the field shows the state of the peer session: Active, Connect, or Idle.

  • If a BGP session is established in the main routing device, the field shows the number of active, received, accepted, and damped routes that are received from a neighbor and appear in the inet.0 (main) and inet.2 (multicast) routing tables. For example, 8/10/10/2 and 2/4/4/0 indicate the following:

    • 8 active routes, 10 received routes, 10 accepted routes, and 2 damped routes from a BGP peer appear in the inet.0 routing table.

    • 2 active routes, 4 received routes, 4 accepted routes, and no damped routes from a BGP peer appear in the inet.2 routing table.

summary

ip-addresses

List of peers who are members of the group. The address is followed by the peer’s port number.

All levels

Allowed Unconfigured Peer Addresses

Configured peer-limit and the current peer-limit for a dynamic neighbor.

detail

Route Queue Timer

Number of seconds until queued routes are sent. If this time has already elapsed, this field displays the number of seconds by which the updates are delayed.

detail

Route Queue

Number of prefixes that are queued up for sending to the peers in the group.

detail

inet.number

Number of active, received, accepted, and damped routes in the routing table. For example, inet.0: 7/10/9/0 indicates the following:

  • 7 active routes, 10 received routes, 9 accepted routes, and no damped routes from a BGP peer appear in the inet.0 routing table.

none

Table inet.number

Information about the routing table.

  • Received prefixes—Total number of prefixes from the peer, both active and inactive, that are in the routing table.

  • Active prefixes—Number of prefixes received from the peer that are active in the routing table.

  • Suppressed due to damping—Number of routes currently inactive because of damping or other reasons. These routes do not appear in the forwarding table and are not exported by routing protocols.

  • Advertised prefixes—Number of prefixes advertised to a peer.

  • Received external prefixes—Total number of prefixes from the external BGP (EBGP) peers, both active and inactive, that are in the routing table.

  • Active external prefixes—Number of prefixes received from the EBGP peers that are active in the routing table.

  • Externals suppressed—Number of routes received from EBGP peers currently inactive because of damping or other reasons.

  • Received internal prefixes—Total number of prefixes from the IBGP peers, both active and inactive, that are in the routing table.

  • Active internal prefixes—Number of prefixes received from the IBGP peers that are active in the routing table.

  • Internals suppressed—Number of routes received from IBGP peers currently inactive because of damping or other reasons.

  • RIB State—Status of the graceful restart process for this routing table: BGP restart is complete, BGP restart in progress, VPN restart in progress, or VPN restart is complete.

detail

Groups

Total number of groups.

All levels

Peers

Total number of peers.

All levels

External

Total number of external peers.

All levels

Internal

Total number of internal peers.

All levels

Down peers

Total number of unavailable peers.

All levels

Flaps

Total number of flaps that occurred.

All levels

Table

Name of a routing table.

brief, none

Tot Paths

Total number of routes.

brief, none

Act Paths

Number of active routes.

brief, none

Suppressed

Number of routes currently inactive because of damping or other reasons. These routes do not appear in the forwarding table and are not exported by routing protocols.

brief, none

History

Number of withdrawn routes stored locally to keep track of damping history.

brief, none

Damp State

Number of active routes with a figure of merit greater than zero, but lower than the threshold at which suppression occurs.

brief, none

Pending

Routes being processed by the BGP import policy.

brief, none

Group

Group the peer belongs to in the BGP configuration.

detail

Receive mask

Mask of the received target included in the advertised route.

detail

Entries

Number of route entries received.

detail

Target

Route target that is to be passed by route-target filtering. If a route advertised from the provider edge (PE) routing device matches an entry in the route-target filter, the route is passed to the peer.

detail

Mask

Mask which specifies that the peer receive routes with the given route target.

detail

Sample Output

show bgp group

show bgp group

show bgp group brief

show bgp group detail

show bgp group rtf detail

show bgp group summary

show bgp group

Release Information

Command introduced before Junos OS Release 7.4.

exact-instance option introduced in Junos OS Release 11.4.

From Junos OS release 18.4 onwards, show bgp group group-name does an exact match and displays groups with names matching exactly with that of the specified group-name. For all Junos OS releases preceding 18.4, the implementation was performed using the prefix matches (example: if there are two groups grp1, grp2 and the CLI command show bgp group grp was issued, then both grp1, grp2 were displayed).