Conditional Debug on Cisco IOS Router

Conditional debug is very useful to filter out some of the debug information that you see on a (busy) router. It allows us to only show debug information that matches a certain interface, MAC address, username and some other items.

It’s best to demonstrate this with an example, so let me show you the following router that is running RIP on two interfaces:

single Cisco router Two FE Interfaces

Let’s enable RIP debugging on this router:

R1#debug ip rip 
RIP protocol debugging is on

We will see RIP debug information from both interfaces:

RIP: sending v2 update to via FastEthernet0/0 (
RIP: build update entries via, metric 1, tag 0
RIP: sending v2 update to via FastEthernet0/1 (
RIP: build update entries via, metric 1, tag 0

If I only want to see the debug information from one interface then I can use a debug condition:

R1#debug condition ?
  application  Application
  called       called number
  calling      calling
  card         card
  glbp         interface group
  interface    interface
  ip           IP address
  mac-address  MAC address
  match-list   apply the match-list
  standby      interface group
  username     username
  vcid         VC ID
  vlan         vlan
  voice-port   voice-port number
  xconnect     Xconnect conditional debugging on segment pair

This is quite a list with different items to choose from. I’ll use the interface as a condition:

R1#debug condition interface fastEthernet 0/0
Condition 1 set

Using this debug condition we will only see RIP debug information from the FastEthernet 0/0 interface:

RIP: sending v2 update to via FastEthernet0/0 (
RIP: build update entries via, metric 1, tag 0

When you want to get rid of the debug condition then you can use the following command:

We're Sorry, Full Content Access is for Members Only...

If you like to keep on reading, Become a Member Now! Here is why:

  • Learn any CCNA, CCNP and CCIE R&S Topic. Explained As Simple As Possible.
  • Try for Just $1. The Best Dollar You’ve Ever Spent on Your Cisco Career!
  • Full Access to our 736 Lessons. More Lessons Added Every Week!
  • Content created by Rene Molenaar (CCIE #41726)

514 Sign Ups in the last 30 days

100% Satisfaction Guaranteed!
You may cancel your monthly membership at any time.
No Questions Asked!

Forum Replies

  1. Rene,

    Hi. With the debug condition there are multiple options that can be used such as interface (as you highlighted) ip address, mac address, etc… When you have multiple debug conditions configured is it a logical “and” or “or”? In other words do they all have to match for it to work with multiple conditions? When using the “ip” condition could that be any IP going through the router? Could it also include traffic to the router itself? Many thanks.


  2. Rene,

    I have been able to get conditional debug to work with interface. However, I have yet to perform a successful conditional debug with ip. Here’s an example:

    R5#debug ip ospf hello
    OSPF hello debugging is on
    OSPF-1 HELLO Gi1.45: Send hello to area 0 from
    OSPF-1 HELLO Tu0: Send hello to area 0 from
    OSPF-1 HELLO Gi1.5: Send hello to area 0 from
    OSPF-1 HELLO Gi1.58: Send hello to area 0 from
    OSPF-1 HELLO Gi1.45: Rcv hello from area 0
    ... Continue reading in our forum

  3. Hi Ronald,

    I just tried this on some IOS 15 routers but I’m having the same issue as you. Whatever IP address I try in “debug condition ip”…nothing shows up :slight_smile: I’m guessing that this command doesn’t work for most debug commands…


  4. I tried a couple of different combinations and maybe in GNS3 this command doesn’t work at all.
    I set conditions for completely different IP and only enable debug ip icmp, ping from another router and I still get output.
    enable condition for interface that isn’t used and I still get debug output when pinging.
    Seems this command isn’t working at all in GNS3.

    I’d fire up my rack of gear but it’s 110 here …

    R5#debug ip icmp
    ICMP packet debugging is on
    R5#debug condition ip
    Condition 1 set
    *Jun 23 05:13:31.239: ICMP: echo reply sent, src 10.1.3
    ... Continue reading in our forum

  5. Hi Daniel,

    Same issue here, conditional debugging works for interfaces but I was unable to get any wanted results with debug ip condition. Tried it in VIRL and on real hardware.


2 more replies! Ask a question or join the discussion by visiting our Community Forum