diff options
| author | Dinesh G Dutt <5016467+ddutt@users.noreply.github.com> | 2019-08-31 18:24:49 +0200 |
|---|---|---|
| committer | Dinesh G Dutt <5016467+ddutt@users.noreply.github.com> | 2019-09-02 16:21:44 +0200 |
| commit | 3577f1c54f94d296a266d0660436ef0d0cfaffb0 (patch) | |
| tree | 4592392f903c37c2714ad998bfc86851f84d64d2 /doc/user | |
| parent | Merge pull request #4852 from ashish12pant/fix_log (diff) | |
| download | frr-3577f1c54f94d296a266d0660436ef0d0cfaffb0.tar.xz frr-3577f1c54f94d296a266d0660436ef0d0cfaffb0.zip | |
bgpd: Add a new command to only show failed peerings
In a data center, having 32-128 peers is not uncommon. In such a situation, to find a
peer that has failed and why is several commands. This hinders both the automatability of
failure detection and the ease/speed with which the reason can be found. To simplify this
process of catching a failure and its cause quicker, this patch does the following:
1. Created a new function, bgp_show_failed_summary to display the
failed summary output for JSON and vty
2. Created a new function to display the reset code/subcode. This is now used in the
failed summary code and in the show neighbors code
3. Added a new variable failedPeers in all the JSON outputs, including the vanilla
"show bgp summary" family. This lists the failed session count.
4. Display peer, dropped count, estd count, uptime and the reason for failure as the
output of "show bgp summary failed" family of commands
5. Added three resset codes for the case where we're waiting for NHT, waiting for peer
IPv6 addr, waiting for VRF to init.
This also counts the case where only one peer has advertised an AFI/SAFI.
The new command has the optional keyword "failed" added to the classical summary command.
The changes affect only one existing output, that of "show [ip] bgp neighbors <nbr>". As
we track the lack of NHT resolution for a peer or the lack of knowing a peer IPv6 addr,
the output of that command will show a "waiting for NHT" etc. as the last reset reason.
This patch includes update to the documentation too.
Signed-off-by: Dinesh G Dutt <5016467+ddutt@users.noreply.github.com>
Diffstat (limited to 'doc/user')
| -rw-r--r-- | doc/user/bgp.rst | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/user/bgp.rst b/doc/user/bgp.rst index 92d4126ce..da339b440 100644 --- a/doc/user/bgp.rst +++ b/doc/user/bgp.rst @@ -2251,6 +2251,12 @@ structure is extended with :clicmd:`show bgp [afi] [safi]`. Show a bgp peer summary for the specified address family, and subsequent address-family. +.. index:: show bgp [afi] [safi] summary failed [json] +.. clicmd:: show bgp [afi] [safi] summary failed [json] + + Show a bgp peer summary for peers that are not succesfully exchanging routes + for the specified address family, and subsequent address-family. + .. index:: show bgp [afi] [safi] neighbor [PEER] .. clicmd:: show bgp [afi] [safi] neighbor [PEER] |