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 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
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).