Debug/syslog configuration commands

Event notification logging

Automatically sends switch-level event messages to the switch's Event Log. Debug and syslog do not affect this operation, but add the capability of directing Event Log messaging to an external device.

Command

syslog-ip-addr

Enables syslog messaging to be sent to the specified IP address. IPv4 and IPv6 are supported.

  facility

Optional: The logging facility command specifies the destination (facility) subsystem used on a syslog server for debug reports.

  priority-desc

A text string associated with the values of facility, severity, and system-module.

 

neighbor-adjacency [detail]

Enables or disables OSPFv3 (IPv6) adjacency logging. Must be executed in OSPFv3 context. The detail option displays all the adjacency state transitions and adjacency-related errors.

  severity

Sends Event Log messages of equal or greater severity than the specified value to configured debug destinations. (The default setting is to send Event Log messages from all severity levels.)

  system-module

Sends Event Log messages from the specified system module to configured debug destinations. The severity filter is also applied to the system-module messages you select.

The default setting is to send Event Log messages from all system modules. To restore the default setting, enter the no logging system-module system-module or logging system-module all-pass commands.

debug Command

acl

Sends ACL syslog logging to configured debug destinations. When there is a match with a "deny" statement, directs the resulting message to the configured debug destinations.

  all

Sends debug logging to configured debug destinations for all ACL, Event Log, IP-OSPF, and IP-RIP options.

  cdp

Displays CDP information.

  destination

logging: Disables or re-enables syslog logging on one or more syslog servers configured with the logging syslog-ip-addr command.

session: Assigns or re-assigns destination status to the terminal device that was most recently used to request debug output.

buffer: Enables syslog logging to send the debug message types specified by the debug debug-type command to a buffer in switch memory.

  event

Sends standard Event Log messages to configured debug destinations. (The same messages are also sent to the switch's Event Log, regardless of whether you enable this option.)

  ip

fib: Displays IP Forwarding Information Base messages and events.

forwarding: Sends IPv4 forwarding messages to the debug destinations.

ospf: Sends OSPF event logging to the debug destinations.

ospfv3: Enables debug messages for OSPFv3.

packet: Sends IPv4 packet messages to the debug destinations.

pim [packet [filter source ip-addr | vlan vid ]]

: Enables or disables tracing of PIM messages.

Note: When PIM debugging is enabled, the following message displays:

PIM Debugging can be extremely CPU intensive when run
on a device with an existing high CPU load or on a switch
with more than 10 PIM-enabled VLANs. In high load
situations, the switch may suffer from protocol
starvation, high latency, or even reload. When debugging
a switch with more than 10 PIM-enabled VLANs, the 

“vlan”
option in 

“debug ip pim packet” should be utilized.
Debugging should only be used temporarily while
troubleshooting problems. Customers are advised to
exercise caution when running this command in a highstress
production network.
 

pbr: Logs a message when a PBR policy is applied, when the action in a class goes active or when it goes inactive.

rip: Sends RIP event logging to the debug destinations.

  ipv6

dhcpv6-client: Sends DHCPv6 client debug messages to the configured debug destination.

dhcpv6-relay: Sends DHCPv6 relay debug messages to the configured debug destination.

forwarding: Sends IPv6 forwarding messages to the debug destination(s)

nd: Sends IPv6 debug messages for IPv6 neighbor discovery to the configured debug destinations.

   

ospf3 [ adj | event | flood | lsa-generation | packet | retransmission | spf ]

: Sends OSPFv3 events to the debug destinations. Must be executed in OSPFv3 context. Selecting an option filters the debug messages by that option. packet: Sends IPv6 packet messages to the debug destinations.

  lldp

Sends LLDP debug messages to the debug destinations.

  lacp

event: Sends messages related to change events.

packet: Sends messages when BPDUs are exchanged.

  security

Sends security messages to the debug destination.

  services

Displays debug messages on the services module.

  snmp

Sends snmp messages to the debug destination.

  vrrp

Turns on tracing of the incoming and outgoing VRRP packets and sends debug logging to the debug destination.

  wireless-services

Sends wireless service module debug messages to the debug destination.

Using the Debug/Syslog feature, you can perform the following operations:

  • Configure the switch to send Event Log messages to one or more Syslog servers. In addition, you can configure the messages to be sent to the User log facility (default) or to another log facility on configured Syslog servers.

  • Configure the switch to send Event Log messages to the current management- access session (serial-connect CLI, Telnet CLI, or SSH.)

  • Disable all Syslog debug logging while retaining the Syslog addresses from the switch configuration. This allows you to configure Syslog messaging and then disable and re-enable it as needed.

  • Display the current debug configuration. If Syslog logging is currently active, the list f configured Syslog servers is displayed.

  • Display the current Syslog server list when Syslog logging is disabled.