Skip to content
Snippets Groups Projects
  • Matt Jordan's avatar
    9cdf3ec1
    res_pjsip_history: Add a module that provides PJSIP history for debugging · 9cdf3ec1
    Matt Jordan authored
    This patch adds a new module, res_pjsip_history, that provides a slightly
    better way of debugging SIP message traffic on a busy Asterisk system. The
    existing mechanisms all rely on passively dumping a SIP message to the CLI.
    While this is perfectly fine for logging purposes and well controlled
    environments, on many installations, the amount of SIP messages Asterisk
    receives will quickly swamp the CLI. This makes it difficult to view/capture
    those messages that you want to diagnose in real time.
    
    This patch provides another way of handling this. When enabled, the module
    will store SIP message traffic in memory. This traffic can then be queried
    at leisure.
    
    In order to make the querying useful, a CLI command has been implemented,
    'pjsip show history', that supports a basic expression syntax similar to
    SQL or other query languages. A small number of useful fields have been
    added in this initial patch; additional fields can easily be added in
    later improvements. Those fields are:
     - number: The entry index in the history
     - timestamp: The time the message was recieved
     - addr: The source/destination address of the message
     - sip.msg.request.method: The request method
     - sip.msg.call-id: The Call-ID header
    
    Note - this is a resurrection of the module initially proposed on Review Board
    here: https://reviewboard.asterisk.org/r/4053/
    
    Change-Id: I39bd74ce998e99ad5ebc0aab3e84df3a150f8e36
    9cdf3ec1
    History
    res_pjsip_history: Add a module that provides PJSIP history for debugging
    Matt Jordan authored
    This patch adds a new module, res_pjsip_history, that provides a slightly
    better way of debugging SIP message traffic on a busy Asterisk system. The
    existing mechanisms all rely on passively dumping a SIP message to the CLI.
    While this is perfectly fine for logging purposes and well controlled
    environments, on many installations, the amount of SIP messages Asterisk
    receives will quickly swamp the CLI. This makes it difficult to view/capture
    those messages that you want to diagnose in real time.
    
    This patch provides another way of handling this. When enabled, the module
    will store SIP message traffic in memory. This traffic can then be queried
    at leisure.
    
    In order to make the querying useful, a CLI command has been implemented,
    'pjsip show history', that supports a basic expression syntax similar to
    SQL or other query languages. A small number of useful fields have been
    added in this initial patch; additional fields can easily be added in
    later improvements. Those fields are:
     - number: The entry index in the history
     - timestamp: The time the message was recieved
     - addr: The source/destination address of the message
     - sip.msg.request.method: The request method
     - sip.msg.call-id: The Call-ID header
    
    Note - this is a resurrection of the module initially proposed on Review Board
    here: https://reviewboard.asterisk.org/r/4053/
    
    Change-Id: I39bd74ce998e99ad5ebc0aab3e84df3a150f8e36