show bgp group
Syntax
show bgp group <brief | detail | summary> <group-name> <exact-instance instance-name> <instance instance-name> <logical-system (all | logical-system-name)> <rtf>
Syntax (EX Series Switch and QFX Series)
show bgp group <brief | detail | summary> <group-name> <exact-instance instance-name> <instance instance-name>
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 |
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.
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 |
|
Policies configured for the BGP group with the |
|
|
Options associated with the |
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 |
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.
|
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 |
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:
|
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
- show bgp group
- show bgp group brief
- show bgp group detail
- show bgp group rtf detail
- show bgp group summary
- show bgp group
show bgp group
user@host> show bgp group Group Type: Internal AS: 65200 Local AS: 65200 Name: ibgp Index: 0 Flags: <> Options: Preference LocalAddress Cluster AddressFamily Refresh
show bgp group
user@host> show bgp group Group Type: Internal AS: 65101 Local AS: 65101 Name: ibgp Index: 2 Flags: Export Eval Total assigned update threads: 5 bgp-updio-4: 50 bgp-updio-5: 50 bgp-updio-6: 50 bgp-updio-3: 50 bgp-updio-1: 50 Holdtime: 0 Optimal Route Reflection: igp-primary 10.1.1.1, igp-backup 10.1.2.1 Total peers: 1 Established: 1 10.1.1.2+179 Trace options: all Trace file: /var/log/bgp-log size 10485760 files 10 bgp.l3vpn.2: 0/0/0/0 vpn-1.inet.2: 0/0/0/0 Group Type: Internal AS: 65101 Local AS: 65101 Name: ibgp Index: 3 Flags: Export Eval Options: RFC6514CompliantSafi129 Holdtime: 0 Optimal Route Reflection: igp-primary 10.1.1.1, igp-backup 10.1.2.1 Total peers: 1 Established: 1 10.1.1.5+61698 Trace options: all Trace file: /var/log/bgp-log size 10485760 files 10 bgp.l3vpn.2: 2/2/2/0 vpn-1.inet.2: 2/2/2/0 Groups: 2 Peers: 2 External: 0 Internal: 2 Down peers: 0 Flaps: 0 Table Tot Paths Act Paths Suppressed History Damp State Pending bgp.l3vpn.2 2 2 0 0 0 0 vpn-1.inet.0 0 0 0 0 0 0 vpn-1.inet.2 2 2 0 0 0 0 vpn-1.inet6.0 0 0 0 0 0 0 vpn-1.mdt.0 0 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 detail Group Type: Internal AS: 65100 Local AS: 65100 Name: ibgp Index: 0 Flags: <Export Eval> Holdtime: 0 Optimal Route Reflection: igp-primary 10.1.1.1, igp-backup 10.1.2.1 Total peers: 3 Established: 0 10.22.0.2 10.22.0.8 10.22.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 complete
show 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 10:100/64 00000002 10: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 summary Group 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
show bgp group
user@host> show bgp group Group Type: Internal AS: 2 Local AS: 2 Name: toR1 Index: 0 Flags: <Export Eval> Options: <Cluster> Holdtime: 0 + Optimal Route Reflection: export orr-policy Total peers: 1 Established: 1 1.1.1.1+179 inet.0: 0/0/0/0
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).