Showing results for 
Search instead for 
Did you mean: 



    This document covers the overview of SIP debugging commands which are helpful while examining the status of SIP components and troubleshooting.


    SIP debugging overview

    debug ccsip: This has various options,

    • debug ccsip all:  This command enables all ccsip type debugging. This debug command is very active, you should use it sparingly in a live network
    • debug ccsip calls: This command displays all SIP call details as they are updated in the SIP call control block. You can use this debug command to monitor call records for suspicious clearing causes.
    • debug ccsip errors: This command traces all errors that are encountered by the SIP subsystem.
    • debug ccsip events: this command traces event, such as call setups, connections and disconnections. An events version of a debug command is often the best place to start because detailed debugs provide much useful information.
    • debug ccsip info: This command enables tracing of general SIP security parameter index (SPI) information, including verification that call redirection is disabled.
    • debug ccsip media: This command enables tracing of SIP media streams
    • debug ccsip messages: This command shows the headers of SIP messages that are exchanged between a client and a server.
    • debug ccsip preauth: This command enables diagnostic reporting of authentication, authorization, accounting (AAA) for SIP calls.
    • debug ccsip states: This command displays the SIP states and state changes for sessions within the SIP subsytem.
    • debug ccsip transport: This command enables tracing the SIP transport handler and the TCP or UDP process

    debug voip ccapi inout: This command shows every interaction with the call control application programming interface (API) on both the telephone interface and on the VOIP side. By monitoring the output, you can follow the progress of a call from the inbound interface or VOIP peer to the outbound side of the call. This debug command is very active. you should use it sparingly in a live network.

    debug voip ccpai protoheaders: This command displays messages that are sent between the originating and terminating gateways. If no headers are being received by the terminating gateway, verify that the header-passing command is enabled on the originating gateway.

    Feature Design of SIP Debug Output Filtering Support

    Prior to the SIP Debug Output Filtering Support feature, debugging and troubleshooting on the VoIP gateway was made more challenging by the extensive amounts of raw data generated by debug output. 

    This feature allows the debug output for a SIP call to be filtered according to a variety of criteria. The SIP Debug Output Filtering Support feature provides a generic call filtering mechanism that does the following:

    •Allows you to define a set of matching conditions for filtering calls.

    •Identifies the desired calls based on the configured matching conditions inside VoIP gateways.

    •Coordinates the filtering effort on traced calls between multiple modules inside VoIP gateways.

    •Displays the debugging trace for calls that match the specified conditions.

    SIP Debug Commands that Support Output Filtering

    •debug ccsip all

    •debug ccsip calls

    •debug ccsip events

    •debug ccsip messages

    •debug ccsip preauth

    •debug ccsip states

    Configuring Call Filters

    This task configures the conditions for filtering SIP calls.


    1. enable

    2. configure terminal

    3. call filter match-list number voice

    4. incoming calling-number string

    5. incoming called-number string

    6. incoming signaling {local | remote} ipv4 ip-address

    7. incoming media {local | remote} ipv4 ip-address

    8. incoming dialpeer tag

    9. outgoing calling-number string

    10. outgoing called-number string

    11. outgoing signaling {local | remote} ipv4 ip-address

    12. outgoing media {local | remote} ipv4 ip-address

    13. outgoing dialpeer tag

    14. end


    call filter match-list 1 voice
     incoming called-number 4085559876
     voice-port 0:D
     voice-port 1:D
     voice-port 2:D
     voice-port 3:D

    Enabling SIP Debug Output Filtering: Example

    Router# debug condition match-list 1 exact-match
     Router# debug ccsip all

     Router# show debug

     CCSIP SPI:SIP Call Statistics tracing is enabled       (filter is ON)
     CCSIP SPI:SIP Call Message tracing is enabled  (filter is ON)
     CCSIP SPI:SIP Call State Machine tracing is enabled    (filter is ON)
     CCSIP SPI:SIP Call Events tracing is enabled   (filter is ON)
     CCSIP SPI:SIP error debug tracing is enabled   (filter is ON)
     CCSIP SPI:SIP info debug tracing is enabled    (filter is ON)
     CCSIP SPI:SIP media debug tracing is enabled   (filter is ON)
     CCSIP SPI:SIP Call preauth tracing is enabled  (filter is ON)

     Router# Debug filtering is now on
     Building configuration...
     call filter match-list 1 voice
     incoming called-number 4085551221


    Related Information




    Another gem from the great  Muthurani. Thank you. Much appreciated!

    Cisco Employee
    Cisco Employee

    Thank you so much, a very useful information.

    Getting Started

    Find answers to your questions by entering keywords or phrases in the Search bar above. New here? Use these resources to familiarize yourself with the community: