Supported Platforms
show bgp group
List of Syntax
SyntaxSyntax (EX Series Switch and QFX Series)
Syntax
Syntax (EX Series Switch and QFX Series)
Release Information
Command introduced before Junos OS Release 7.4.
Command introduced in Junos OS Release 9.0 for EX Series switches.
Command introduced in Junos OS Release 11.3 for the QFX Series.
exact-instance option introduced in Junos OS Release 11.4.
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 master 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
List of Sample Output
show bgp groupshow bgp group brief
show bgp group detail
show bgp group rtf detail
show bgp group summary
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 |
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 |
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 |
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.
| summary |
ip-addresses | List of peers who are members of the group. The address is followed by the peer’s port number. | All levels |
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:
| none |
Table inet.number | Information about the routing table.
| 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
user@host> show bgp group Groups: 2 Peers: 2 External: 0 Internal: 2 Down peers: 1 Flaps: 0
Table Tot Paths Act Paths Suppressed History Damp State Pending
inet.0
0 0 0 0 0 0
bgp.l3vpn.0
0 0 0 0 0 0
bgp.rtarget.0
2 0 0 0 0 0
show bgp group brief
user@host> show bgp group brief Groups: 2 Peers: 2 External: 0 Internal: 2 Down peers: 1 Flaps: 0
Table Tot Paths Act Paths Suppressed History Damp State Pending
inet.0
0 0 0 0 0 0
bgp.l3vpn.0
0 0 0 0 0 0
bgp.rtarget.0
2 0 0 0 0 0
show bgp group detail
user@host> show bgp group detailGroup Type: Internal AS: 1 Local AS: 1
Name: ibgp Index: 0 Flags: <Export Eval>
Holdtime: 0
Total peers: 3 Established: 0
22.0.0.2
22.0.0.8
22.0.0.5
Groups: 1 Peers: 3 External: 0 Internal: 3 Down peers: 3 Flaps: 3
Table bgp.l3vpn.0
Received prefixes: 0
Accepted prefixes: 0
Active prefixes: 0
Suppressed due to damping: 0
Received external prefixes: 0
Active external prefixes: 0
Externals suppressed: 0
Received internal prefixes: 0
Active internal prefixes: 0
Internals suppressed: 0
RIB State: BGP restart is complete
RIB State: VPN restart is complete
Table bgp.mdt.0
Received prefixes: 0
Accepted prefixes: 0
Active prefixes: 0
Suppressed due to damping: 0
Received external prefixes: 0
Active external prefixes: 0
Externals suppressed: 0
Received internal prefixes: 0
Active internal prefixes: 0
Internals suppressed: 0
RIB State: BGP restart is complete
RIB State: VPN restart is complete
Table VPN-A.inet.0
Received prefixes: 0
Accepted prefixes: 0
Active prefixes: 0
Suppressed due to damping: 0
Received external prefixes: 0
Active external prefixes: 0
Externals suppressed: 0
Received internal prefixes: 0
Active internal prefixes: 0
Internals suppressed: 0
RIB State: BGP restart is complete
RIB State: VPN restart is complete
Table VPN-A.mdt.0
Received prefixes: 0
Accepted prefixes: 0
Active prefixes: 0
Suppressed due to damping: 0
Received external prefixes: 0
Active external prefixes: 0
Externals suppressed: 0
Received internal prefixes: 0
Active internal prefixes: 0
Internals suppressed: 0
RIB State: BGP restart is complete
RIB State: VPN restart is completeshow bgp group rtf detail
user@host> show bgp group rtf detail Group: internal (group-index: 0)
Receive mask: 00000002
Table: bgp.rtarget.0 Entries: 2
Target Mask
100:100/64 00000002
200:201/64 (Group)
Group: internal (group-index: 1)
Table: bgp.rtarget.0 Entries: 1
Target Mask
200:201/64 (Group)show bgp group summary
user@host> show bgp group summaryGroup Type Peers Established Active/Received/Accepted/Damped ibgp Internal 3 0 Groups: 1 Peers: 3 External: 0 Internal: 3 Down peers: 3 Flaps: 3 bgp.l3vpn.0 : 0/0/0/0 External: 0/0/0/0 Internal: 0/0/0/0 bgp.mdt.0 : 0/0/0/0 External: 0/0/0/0 Internal: 0/0/0/0 VPN-A.inet.0 : 0/0/0/0 External: 0/0/0/0 Internal: 0/0/0/0 VPN-A.mdt.0 : 0/0/0/0 External: 0/0/0/0 Internal: 0/0/0/0
