Using BGP Debugging Commands

Use global and peer debug commands to display specific debug messages for the global and peer Border Gateway Protocol (BGP) configuration, including the BGP neighbors.

You can use these commands to troubleshoot the BGP configuration.

Procedure

Enter BGP Router Configuration mode:

enable

configure terminal

router bgp
Show specific debug messages for the global BGP configuration:

global-debug mask WORD<1-100>
Display specific debug messages for the global BGP neighbors:

neighbor-debug-all mask WORD<1-100>
Display specific debug messages for BGP peers or peer groups:

neighbor <nbr_ipaddr|peer-group-name> neighbor-debug-mask WORD<1-100>
Display debug messages on the console:

debug-screen <on|off>

Example

Switch:1> enable

Switch:1# configure terminal

Switch:1(config)# router bgp

Display the global debug messages for error and packet:

Switch:1(router-bgp)#global-debug mask error,packet

End (disable) the display of global debug messages:

Switch:1(router-bgp)#global-debug mask none

Display specific debug messages for the global BGP neighbors:

Switch:1(router-bgp)#neighbor-debug-all mask packet,event

Display specific debug messages for BGP peers or peer groups:

Switch:1(router-bgp)#neighbor 192.0.2.10 neighbor-debug-mask event,trace

Display debug messages on the console:

Switch:1(router-bgp)#debug-screen on

Variable Definitions

The following table defines parameters for the global-debug mask and neighbor-debug-all mask commands.


Variable	Value
`WORD<1-100>`	Specifies one or more mask choices that you enter, separated by commas with no space between choices. For example: [<mask>,<mask>,<mask>...]. Options include: none, all, error, packet, event, trace, warning, state, init, filter, update.

The following table defines parameters for the neighbor command.


Variable	Value
<nbr_ipaddr\|peer-group-name>	Specifies the IP address or the group name of the peer.
`WORD<1-100>`	Specifies one or more mask choices that you enter, separated by commas with no space between choices. For example: [<mask>,<mask>,<mask>...]. Options include: none, all, error, packet, event, trace, warning, state, init, filter, update.

Job Aid

Use debug command values to control debug messages for global BGP message types, and for message types associated with a specified BGP peer or peer group. The following table identifies mask categories and messages.

Table 1. Mask categories and messages
Mask category	Message
none	None disables the display of all debug messages.
all	All configures the device to show all categories of debug messages.
error	Error configures the device to show error debug messages.
packet	Packet configures the device to show packet debug messages.
event	Event configures the device to show event debug messages.
warning	Warning configures the device to show warning debug messages.
init	Init configures the device to show initialization debug messages.
filter	Filter configures the device to show filter-related debug messages.
update	Update configures the device to show update-related debug messages.