Use 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

  1. Enter BGP Router Configuration mode:

    enable

    configure terminal

    router bgp

  2. Show specific debug messages for the global BGP configuration:

    global-debug mask WORD<1-100>

  3. Display specific debug messages for the global BGP neighbors:

    neighbor-debug-all mask WORD<1-100>

  4. Display specific debug messages for BGP peers or peer groups:

    neighbor <nbr_ipaddr|peer-group-name> neighbor-debug-mask WORD<1-100>

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