This command reports the status of outbound update groups and their members. If a VRF instance is specified, the status of the update groups for the communities within the VRF instance are displayed.
| Format | show ip bgp [vrf vrf-name] update-group [group-index | peer-address ] |
| Mode | Privileged EXEC |
| Parameter | Description |
|---|---|
| group-index | (Optional) If specified, this option restricts the output to a single update group. |
| peer-address | (Optional) If specified, this option restricts the output to the update group containing the peer with the given address. |
The command displays the following information.
| Parameter | Description |
|---|---|
| Update Group ID | Unique identifier for outbound update group |
| Peer Type | Whether peers in this update group are internal or external |
| Minimum Advertisement Interval | The minimum time, in seconds, between sets of UPDATE messages sent to the group |
| Send Community | If BGP communities are included in route advertisements to members of the group. |
| Remove Private ASNs | If BGP removes private ASNs from paths advertised to members of this update group.
|
| Route Reflector Client | If peers in this update group are route reflector clients. |
| Neighbor AS Path Access List Out | The AS path access list used to filter UPDATE messages sent to peers in the update group |
| Neighbor Prefix List Out | Name of the prefix list used to filter prefixes advertised to the peers in the update group |
| Members Added | The number of peers added to the group since the group was formed |
| Members Removed | The number of peers removed from the group |
| Update Version | The number of times phase 3 of the BGP decision process has run for this group to determine which routes should be advertised to the group |
| Number of UPDATEs Sent | The number of UPDATE messages that have been sent to this group. Incremented once for each UPDATE regardless of the number of group members |
| Time Since Last UPDATE | Time since an UPDATE message was last sent to the group. If no UPDATE has been sent to the group, the status is "Never." |
| Current Prefixes | The number of prefixes currently advertised to the group |
| Current Paths | The number of paths currently advertised to the group |
| Prefixes Advertised | The total number of prefixes advertised to the group since the group was formed |
| Prefixes Withdrawn | The total number of prefixes included in the Withdrawn Routes field of UPDATE messages sent to the group since the group was formed |
| UPDATE Send Failures | The number of UPDATE messages that failed to be delivered to all members of the group |
| Current Members | The IPv4 address of all current members of the group |
The update send history table show statistics on as many as the ten most recent executions of the update send process for the update group. Items in the history table are as follows:
| Parameter | Description |
|---|---|
| Version | The update version |
| Delta T | The amount of time elapsed since the update send process executed. hours::minutes::seconds. |
| Duration | How long the update send process took, in milliseconds. |
| UPD Built | The number of UPDATE messages built |
| UPD Sent | The number of UPDATE messages successfully transmitted to group members. Normally a copy of each UPDATE message built is sent to each group member. |
| Paths Sent | The number of paths advertised. |
| Pfxs Adv | The number of prefixes advertised |
| Pfxs Wd | The number of prefixes withdrawn |
Example: The following shows an example of the command displaying information for all update groups.
(R1) # show ip bgp update-group
Update Group ID............................ 0
Peer Type.................................. External
Minimum Advertisement Interval............. 30 seconds
Send Community............................. Yes
Remove Private ASNs........................ No
Route Reflector Client..................... No
Neighbor AS Path Access List Out........... 1
Neighbor Prefix List Out................... pfxList1
Members Added.............................. 48
Members Removed............................ 0
Update Version............................. 19
Number of UPDATEs Sent..................... 512
Time Since Last Update..................... 5 hrs 3 min 2 sec
Current Prefixes........................... 5500
Current Paths.............................. 22
Prefixes Advertised........................ 191250
Prefixes Withdrawn......................... 186000
UPDATE Send Failures....................... 0
Current Members: 172.20.1.100, 172.20.2.100
Version Delta T Duration UPD Built UPD Sent Paths Sent Pfxs Adv Pfxs Wd
10 00:33:49 100 6 288 5 1250 750
11 00:33:49 0 4 192 3 750 250
12 00:33:49 0 2 96 1 250 1000
13 00:33:49 0 2 96 1 250 1018
14 00:33:49 0 1 48 0 0 482
15 00:33:49 100 8 384 7 1750 750
16 00:33:49 0 3 144 2 500 250
17 00:31:49 0 4 192 3 750 750
18 00:23:49 100 4 192 3 750 1000
19 00:03:49 100 6 288 5 1250 500
Update Group ID............................ 1
Peer Type.................................. Internal
Minimum Advertisement Interval............. 5 seconds
Remove Private ASNs........................ No
Route Reflector Client..................... No
Send Community............................. Yes
Neighbor AS Path Access List Out........... none
Neighbor Prefix List Out................... none
Members Added.............................. 3
Members Removed............................ 0
Update Version............................. 4
Number of UPDATEs Sent..................... 8
Time Since Last UPDATE..................... 3 hrs 13 min 22 sec
Current Prefixes........................... 84
Current Paths.............................. 2
Prefixes Advertised........................ 100
Prefixes Withdrawn......................... 16
UPDATE Send Failures....................... 0
Current Members: 172.24.3.1, 172.25.8.56, 172.28.9.1
Version Delta T Duration UPD Built UPD Sent Paths Sent Pfxs Adv Pfxs Wd
10 00:00:49 100 6 288 5 1250 750
