Versions Compared

Old Version 1

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version Current

changes.mady.by.user Ribbon Communications

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Add_workflow_for_techpubs
AUTH2UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cd5909df, userName='null'}
AUTH1UserResourceIdentifier{userKey=8a00a0c86e9b2550016ec54396b5000a, userName='null'}
JIRAIDAUTHSBX-88869118198
REV5UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb8305e9, userName='null'}
REV6REV3REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb8305e9, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb1f0553, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb1f0553, userName='null'}


Panel
Panel

In this section:

Table of Contents
maxLevel2


Use the Configure Trace and Media Packet Capture window to both configure Call Trace Filters and to initiate call traces to use in debugging policy and call routing issues. 
 

On the SBC main screen, go to Troubleshooting → > Call Trace/Logs/Monitors > → Call Trace and Packet Capture > → Call Trace. The Configure Trace and Media Packet Capture window opens. anchor

Configure Trace and Media Packet Capture Configure Trace and Media Packet Capture

Caption
0Figure
1Configure Trace and Media Packet Capture Window

Window:

Image Added
Image Modified

 

There are two panels in this window: the the Call Trace Status and Setting panel  panel and the Call Trace Filters panel panel. The Call Trace Filters panel lists any existing Call Trace Filters.

Call Trace Filters define conditions that determine which call events trigger logging PES call trace messages to the system trace data event log. When a call meets the criteria, the trace information is written to a tracing file (.TRC). The following default information is collected during a call trace: 

  • Service group configuration
  • DSP T.38 event information, if applicable
  • DSP channel statistics
  • DEBUG/SYS log information  
Warning
titleWarning

Do not configure a Call Trace Filter to trace all calls. Use of the Call Trace feature can have significant impact on the network performance of the 

Spacevars
0product
system. 
Spacevars
0company
strongly recommends configuring Call Filters which result in a small number of calls being traced to avoid heavy loads. Also, be sure to delete Call Trace Filters once you have obtained the necessary information.

Enter values for the Call Trace

Filters
Info
titleNote:

Only Administrators, Field Service, Guests and Operators have the ability to access the Call Trace configuration screen.

You must create Call Trace Filters before you can start a call trace.

The maximum number of call trace filters allowed is 100. 

 The Call Trace Filter object allows you to create and configure Call Trace Filters that specify criteria that the SBC uses to determine which call events to trace.

AnchorTo Create Call FilterTo Create Call FilterTo Create a Call Trace Filter

To create a new Call Trace Filter, click New Call Filter on the Call Trace Filters panel. The Create New Call Trace Filter window opens.

Caption
0Figure
1Create New Call Trace Filter Window
Image Removed 

Enter values for the Call Trace Filter object using the following table and click Save.

Caption
0Table
1Call Trace Filter parameters

Parameter

Description

NameSpecifies the name of the Call Trace Filter of up to 23 characters.State

Specifies the state of this filter. The options are:

  • Disabled (default): If disabled, it is not used for a Call Trace.
  • Enabled: If enabled, this filter can be used for a Call Trace.
SIPRec Legs Capture

Enable this flag to trace and capture packets for SIPREC legs.

  • Disabled (default)
  • Enabled

For more information on this flag, refer to Call Trace to Capture SIPRec Legs.

Capture type

Specifies the type of logs to capture while running a Call Trace. The options are:

  • Capture trace information (.trc logs) only
  • Capture trace information (.trc logs) and media information (.pkt logs).
Detail level to log

Specifies the level of details that need to be capture in the log file when the trace is complete. The options are:

  • Level 1 - Everything
  • Level 2 - Everything but raw hex dump
  • Level 3 - Only external message information and errors
  • Level 4 - Only SIP PDU events 

Note: The Level 4 log is implemented to capture SIP Ladder diagrams for the interpretation of calls. Level 4 Call Trace Filter conditions/behavior:

  • Level 4 traces all the SIP PDU events (without logging other trace messages) at line-rate without dropping any PDUs. These traces are used by SIP Ladder feature for further analysis.
  • The Level 4 filters are based only on Peer IP address and this must be specified to trace calls. This call trace method does not trace/filter based on trunk group, called number, calling number, and so on.
  • Configure a Level 4 filter with a wildcard Peer IP address  of 255.255.255.255 to match ALL packets to/from any IP address.
  • Level 4 filters identify GCID when possible. However, some messages do not contain GCIDs and may have 0xfffffffff as the GCID (registration, notify, options ping, and so on).
  •  Other filters may run simultaneously as trace level 4, but ensure configuring the parameter maxTriggerCount to a non-zero value by executing the following command:  
    set global callTrace maxTriggerCount <1-64>  
    where the allowed range for maxTriggerCount is 0-64. For more information, refer to Call Trace - CLI.  

For more information on the effect of different levels with respect to the flag SIPRec Legs Capture, refer to Call Trace to Capture SIPRec Legs.

Capture calls that match these filters

Specifies the criteria to use determine which calls to capture in the logs in a Call Trace (these are optional). The options are:

  • Called number: Specifies the called party number to trace. Field length is up to 30 characters.
  • Calling number: Specifies the calling party number to trace. Field length is up to 30 characters.
  • Contractor number: Specifies the contractor number to trace. Field length is up to 30 characters.
  • Redirecting number: Specifies the redirecting number to trace. Field length is up to 30 characters.
  • CDDN number: Specifies the Called Directory Number to trace. Field length is up to 30 characters. 
    Note: For the preceding options, the following characters are accepted by the SBC when specifying Call Trace Filter criteria: 

    • Digits 0-9

    • Plus (+) symbol

    • Wildcard matching is also supported. Use "X" or "x" wildcard character to match any single digit, and "%" symbol to match any digits from that point forward.
      For example, using "978xxx1212" returns all calls between 9780001212 and 9789991212, and using "978%" returns all calls with a 978 prefix. 

  • Transfer capability: Specifies the transfer capability of the call trace filter. Options are: 
  • Audio31Khz - 3.1 kHz Audio - ITC 3.1 kHz audio calls are traced. The default setting is disabled.
  • Speech - ITC Speech based calls are traced. The default setting is disabled.
  • Unrestricted - Calls with ITC Unrestricted are traced. The default setting is disabled.
  • Unrestricted With Tones - Unrestricted Digital Information With Tones Announcements - Calls with ITC Unrestricted Digital Information With Tones Announcements are traced. The default setting is disabled.
  • Video - Calls with ITC Video are traced. The default setting is disabled.
  • Trunk Group: The name of a trunk group to filter the calls to trace. This string must match the trunk group name exactly. You cannot use wildcard characters for this argument. Field length is up to 23 characters.
  • Peer IP address: Specifies the peer IPv4 or IPv6 address for call tracing.
Stop Match

Specifies the condition to stop matching filters. The options are:

  • When a match occurs in this filter, stop trying to match the other filters
    • Continue to try to match up to two other filters after a match is found in this filter(default)
    Info
    titleNote

    As a general rule, set the Call Trace Filter for the ingress side except for the Called number. 

    To Edit a Call Trace Filter

    1. Select an existing Call Trace Filter object by clicking the radio button adjacent to it in the Call Trace Filters window. The Edit Call Trace Filter window is displayed.

    2. Make changes and click Save.

    To Copy a Call Trace Filter

    1. Select an existing Call Trace Filter object by clicking the radio button adjacent to it in the Call Trace Filters window.
    2. Click Copy Call Filter. The Copy Call Trace Filter window is displayed.
    3. Make changes and click Save. 

    To Delete a Call Trace Filter

    1. Select an existing Call Trace Filter object by clicking the radio button adjacent to it in the Call Trace Filters window.
    2. Click the X on the right end of the selected row.

    3. Confirm the deletion when prompted.

    AnchorCall Trace Status and SettingsCall Trace Status and SettingsCall Trace Status and Settings

    Once you have one or more Call Trace Filters created, call traces can be started and stopped from the top panel of the Configure Trace and Media Packet Capture window. See the earlier figure of the Configure Trace and Media Packet Capture window. There you can start, save and stop traces using the enabled filters. The trace continues running until a specified duration elapses or the specified number of call filter matches is reached.

    Info
    titleNote:

    When you start a trace, by default, the first three enabled filters in the table are used for the trace.

    To Run a Call Trace

     In the Call Trace Status and Settings panel, choose the required conditions for the trace using the following table.

    Caption
    0Table
    1Call Trace Status and Settings parameters
    3Call Trace Error Types

    Parameter

    Description

    Call Trace Duration

    Specifies the duration for the Call Trace to run. The options are:

    • Run trace until stopped (by clicking the Stop Trace button): If selected, the trace will keep running till it is stopped manually (by clicking the Stop Trace button).
    • Stop trace after __ minutes: If selected, add the number of minutes for the Call Trace to run. The value ranges from 1 to 360 minutes and the default value is 180 minutes.

    If you configure a specific value for Call Trace Duration and the SBC experiences a failover or restart, the call trace starts again automatically and runs for the specified duration.

    Number of Matches (optional)Specifies the maximum number of calls to match before stopping the trace. The value ranges from 1 to 64 times.Trace Calls with errors of the type

    Check this object to enable specifying  a system-wide call trace error filter trigger criteria. By default the option is unchecked which means there is no SIP PDU logging for this error filter. After checking the option the following options are available:  

    • Any—Log all SIP PDUs that meet the requirement of the Parse Error, Out of Dialog, and Early Attempt options below.
    • Parse Error—Log received SIP PDUs that fail parsing. If an error is detected by SIP signaling, the accompanying PDUs will not be associated with any dialog, including an existing dialog. Hence all in dialog and out of dialog PDUs are assigned to this category. If an error is detected at the front end pre-parser, the PDU is logged by this software and not forwarded to SIP signaling. This prevents an offending PDU from being logged by both the pre-parser and SIP signaling.
    • Out of Dialog—Log incoming syntactically correct SIP PDUs (except INVITE) that do not belong to an existing dialog.
    • Early Attempt—Logs incoming SIP PDUs that result in early termination of the call (by either the pre-parser or SIP signaling).
    Include PageCall_Trace_ErrorFilter_NoteCall_Trace_ErrorFilter_Note

    For further details on error logs, see the section Call Trace Log Messages.

    Call Trace Status

    Displays the current status of the Call Trace.

    • When there is no trace running, the status is Call trace stopped with a red dot.
    • when a trace is running, the status is Call trace running with a green dot.

    Status and Settings using the following table.

    ParameterDescription
    Call Trace Duration

    Duration in minutes that call trace is enabled.

    (default = 180)

    Sage Tracing

    Use this flag to allow a sampling of the call flows in the network using the L4 call trace.

    When the Sage Tracing feature is enabled, the SBC captures a small set of level 4 SIP PDU trace logs automatically in order to help debug field issues. This logging utilizes a small amount of CPU, for example, 1%. This functionality is not utilized if Level 4 SIP PDU tracing is already enabled to capture allMessages for all IPs, or the trace files are disabled in the eventLog configuration.

    • Disable
    • Enable (default)

    Note: You might need to disable the Sage Tracing to reduce the TRC output and the speed of log rotation if you are trying to collect a specific call trace filter.

    Call Trace Filters

    Info
    titleNote:

    Only Administrators, Field Service, Guests and Operators have the ability to access the Call Trace configuration screen.

    You must create Call Trace Filters before you can start a call trace.

    The maximum number of call trace filters allowed is 100. 

     The Call Trace Filter object allows you to create and configure Call Trace Filters that specify criteria that the SBC uses to determine which call events to trace.

    Anchor
    To Create Call Filter
    To Create Call Filter
    To Create a Call Trace Filter

    To create a new Call Trace Filter, click New Call Filter on the Call Trace Filters panel. The Create New Call Trace Filter window opens.

    Create New Call Trace Filter Window
    Image Added

    Enter values for the Call Trace Filter object using the following table and click Save.

    Call Trace Filter parameters:

    Parameter

    Description

    Capture calls that match these filters

    Specifies the criteria to use determine which calls to capture in the logs in a Call Trace (these are optional). The options are:

    • Called number: Specifies the called party number to trace. Field length is up to 30 characters.
    • Calling number: Specifies the calling party number to trace. Field length is up to 30 characters.
    • Contractor number: Specifies the contractor number to trace. Field length is up to 30 characters.
    • Redirecting number: Specifies the redirecting number to trace. Field length is up to 30 characters.
    • CDDN number: Specifies the Called Directory Number to trace. Field length is up to 30 characters. 
      Note: For the preceding options, the following characters are accepted by the SBC when specifying Call Trace Filter criteria: 

      • Digits 0-9

      • Plus (+) symbol

      • Wildcard matching is also supported. Use "X" or "x" wildcard character to match any single digit, and "%" symbol to match any digits from that point forward.
        For example, using "978xxx1212" returns all calls between 9780001212 and 9789991212, and using "978%" returns all calls with a 978 prefix. 

    • Transfer capability: Specifies the transfer capability of the call trace filter. Options are: 
    • Audio31Khz - 3.1 kHz Audio - ITC 3.1 kHz audio calls are traced. The default setting is disabled.
    • Speech - ITC Speech based calls are traced. The default setting is disabled.
    • Unrestricted - Calls with ITC Unrestricted are traced. The default setting is disabled.
    • Unrestricted With Tones - Unrestricted Digital Information With Tones Announcements - Calls with ITC Unrestricted Digital Information With Tones Announcements are traced. The default setting is disabled.
    • Video - Calls with ITC Video are traced. The default setting is disabled.
    • Trunk Group: The name of a trunk group to filter the calls to trace. This string must match the trunk group name exactly. You cannot use wildcard characters for this argument. Field length is up to 23 characters.
    • Peer IP address: Specifies the peer IPv4 or IPv6 address for call tracing.
    Capture type

    Specifies the type of logs to capture while running a Call Trace. The options are:

    • Capture trace information (.trc logs) only
    • Capture trace information (.trc logs) and media information (.pkt logs).
    Detail level to log

    Specifies the level of details that need to be capture in the log file when the trace is complete. The options are:

    • Level 1 - Everything
    • Level 2 - Everything but raw hex dump
    • Level 3 - Only external message information and errors
    • Level 4 - Only SIP PDU events, and GW-GW PDUs in Level 4 trace when enabled. 

    Note: The Level 4 log is implemented to capture SIP Ladder diagrams for the interpretation of calls. Level 4 Call Trace Filter conditions/behavior:

    • Level 4 traces all the SIP PDU events (without logging other trace messages) at line-rate without dropping any PDUs. These traces are used by SIP Ladder feature for further analysis.
    • The Level 4 filters are based only on Peer IP address and this must be specified to trace calls. This call trace method does not trace/filter based on trunk group, called number, calling number, and so on.
    • Configure a Level 4 filter with a wildcard Peer IP address  of 255.255.255.255 to match ALL packets to/from any IP address.
    • Level 4 filters identify GCID when possible. However, some messages do not contain GCIDs and may have 0xfffffffff as the GCID (registration, notify, options ping, and so on).
    •  Other filters may run simultaneously as trace level 4, but ensure configuring the parameter maxTriggerCount to a non-zero value by executing the following command:  
      set global callTrace maxTriggerCount <1-64>  
      where the allowed range for maxTriggerCount is 0-64. For more information, refer to Call Trace - CLI.  

    For more information on the effect of different levels with respect to the flag SIPRec Legs Capture, refer to Call Trace to Capture SIPRec Legs.

    NameSpecifies the name of the Call Trace Filter of up to 23 characters.
    SIPRec Legs Capture

    Enable this flag to trace and capture packets for SIPREC legs.

    • Disabled (default)
    • Enabled

    For more information on this flag, refer to Call Trace to Capture SIPRec Legs.

    State

    Specifies the state of this filter. The options are:

    • Disabled (default): If disabled, it is not used for a Call Trace.
    • Enabled: If enabled, this filter can be used for a Call Trace

    Click Save & Start Trace to start the trace. The trace status is displayed in the same panel.  

    Caption
    0Figure
    1Call Trace Logs and Monitors - Call Trace Running
    Image Removed

    The trace stops automatically if a time limit is specified, otherwise you must stop the trace manually by clicking Stop Trace.

    Caption
    0Figure
    1Call Trace Logs and Monitors - Call Trace Stop
    Image Removed

    Once the trace is complete, the logs are generated and stored at Log Management. Look for TRC and PKT log files (.trc and .pkt log files). For more details on log messages, see the section Call Trace Log Messages.

    AnchorLog Message FactsLog Message FactsCall Trace Log Messages Include PageNotes_and_Examples_on_Call_Trace_Log_MessageNotes_and_Examples_on_Call_Trace_Log_Message

    Offline Call Trace Analysis Using LX Utility

    Multiexcerpt include
    MultiExcerptNameLX
    PageWithExcerptMedia Capture and Call Trace

    Pagebreak

    Add_workflow_for_techpubsAUTH1JIRAIDAUTHSBX-88869REV5REV6REV3REV1
    Panel

    In this section:

    Table of Contents
    maxLevel2

    Use the Configure Trace and Media Packet Capture window to both configure Call Trace Filters and to initiate call traces to use in debugging policy and call routing issues. 
     

    On the SBC main screen, go to Troubleshooting > Call Trace/Logs/Monitors > Call Trace and Packet Capture > Call Trace. The Configure Trace and Media Packet Capture window opens. 

    AnchorConfigure Trace and Media Packet CaptureConfigure Trace and Media Packet Capture
    Caption
    0Figure
    1Configure Trace and Media Packet Capture Window
    Image Removed
     

    There are two panels in this window: the Call Trace Status and Setting panel and the Call Trace Filters panel. The Call Trace Filters panel lists any existing Call Trace Filters.

    Call Trace Filters define conditions that determine which call events trigger logging PES call trace messages to the system trace data event log. When a call meets the criteria, the trace information is written to a tracing file (.TRC). The following default information is collected during a call trace: 

    • Service group configuration
    • DSP T.38 event information, if applicable
    • DSP channel statistics
    • DEBUG/SYS log information  
    Warning
    titleWarning

    Do not configure a Call Trace Filter to trace all calls. Use of the Call Trace feature can have significant impact on the network performance of the 

    Spacevars
    0product
    system. 
    Spacevars
    0company
    strongly recommends configuring Call Filters which result in a small number of calls being traced to avoid heavy loads. Also, be sure to delete Call Trace Filters once you have obtained the necessary information.

    Call Trace Filters

    Info
    titleNote:

    Only Administrators, Field Service, Guests and Operators have the ability to access the Call Trace configuration screen.

    You must create Call Trace Filters before you can start a call trace.

     The Call Trace Filter object allows you to create and configure Call Trace Filters that specify criteria that the SBC uses to determine which call events to trace.

    AnchorTo Create Call FilterTo Create Call FilterTo Create a Call Trace Filter

    To create a new Call Trace Filter, click New Call Filter on the Call Trace Filters panel. The Create New Call Trace Filter window opens.

    Caption
    0Figure
    1Create New Call Trace Filter Window
    Image Removed 

    Enter values for the Call Trace Filter object using the following table and click Save.

    Caption
    0Table
    1Call Trace Filter parameters

    Parameter

    Description

    NameSpecifies the name of the Call Trace Filter of up to 23 characters.State

    Specifies the state of this filter. The options are:

    • Disabled (default): If disabled, it is not used for a Call Trace.
    • Enabled: If enabled, this filter can be used for a Call Trace.
    SIPRec Legs Capture

    Enable this flag to trace and capture packets for SIPREC legs.

    • Disabled (default)
    • Enabled

    For more information on this flag, refer to Call Trace to Capture SIPRec Legs.

    Capture type

    Specifies the type of logs to capture while running a Call Trace. The options are:

    • Capture trace information (.trc logs) only
    • Capture trace information (.trc logs) and media information (.pkt logs).
    Detail level to log

    Specifies the level of details that need to be capture in the log file when the trace is complete. The options are:

    • Level 1 - Everything
    • Level 2 - Everything but raw hex dump
    • Level 3 - Only external message information and errors
    • Level 4 - Only SIP PDU events 

    Note: The Level 4 log is implemented to capture SIP Ladder diagrams for the interpretation of calls. Level 4 Call Trace Filter conditions/behavior:

    • Level 4 traces all the SIP PDU events (without logging other trace messages) at line-rate without dropping any PDUs. These traces are used by SIP Ladder feature for further analysis.
    • The Level 4 filters are based only on Peer IP address and this must be specified to trace calls. This call trace method does not trace/filter based on trunk group, called number, calling number, and so on.
    • Configure a Level 4 filter with a wildcard Peer IP address  of 255.255.255.255 to match ALL packets to/from any IP address.
    • Level 4 filters identify GCID when possible. However, some messages do not contain GCIDs and may have 0xfffffffff as the GCID (registration, notify, options ping, and so on).
    •  Other filters may run simultaneously as trace level 4, but ensure configuring the parameter maxTriggerCount to a non-zero value by executing the following command:  
      set global callTrace maxTriggerCount <1-64>  
      where the allowed range for maxTriggerCount is 0-64. For more information, refer to Call Trace - CLI.  

    For more information on the effect of different levels with respect to the flag SIPRec Legs Capture, refer to Call Trace to Capture SIPRec Legs.

    Capture calls that match these filters

    Specifies the criteria to use determine which calls to capture in the logs in a Call Trace (these are optional). The options are:

  • Called number: Specifies the called party number to trace. Field length is up to 30 characters.
  • Calling number: Specifies the calling party number to trace. Field length is up to 30 characters.
  • Contractor number: Specifies the contractor number to trace. Field length is up to 30 characters.
  • Redirecting number: Specifies the redirecting number to trace. Field length is up to 30 characters.
  • CDDN number: Specifies the Called Directory Number to trace. Field length is up to 30 characters. 
    Note: For the preceding options, the following characters are accepted by the SBC when specifying Call Trace Filter criteria: 

    • Digits 0-9

    • Plus (+) symbol

    • Wildcard matching is also supported. Use "X" or "x" wildcard character to match any single digit, and "%" symbol to match any digits from that point forward.
      For example, using "978xxx1212" returns all calls between 9780001212 and 9789991212, and using "978%" returns all calls with a 978 prefix. 

  • Transfer capability: Specifies the transfer capability of the call trace filter. Options are: 
  • Audio31Khz - 3.1 kHz Audio - ITC 3.1 kHz audio calls are traced. The default setting is disabled.
  • Speech - ITC Speech based calls are traced. The default setting is disabled.
  • Unrestricted - Calls with ITC Unrestricted are traced. The default setting is disabled.
  • Unrestricted With Tones - Unrestricted Digital Information With Tones Announcements - Calls with ITC Unrestricted Digital Information With Tones Announcements are traced. The default setting is disabled.
  • Video - Calls with ITC Video are traced. The default setting is disabled.
  • Trunk Group: The name of a trunk group to filter the calls to trace. This string must match the trunk group name exactly. You cannot use wildcard characters for this argument. Field length is up to 23 characters.
    • Peer IP address: Specifies the peer IPv4 or IPv6 address for call tracing
    • .
    Stop Match

    Specifies the condition to stop matching filters. The options are:

    • When a match occurs in this filter, stop trying to match the other filters
    • Continue to try to match up to two other filters after a match is found in this filter(default)


    Info
    titleNote

    As a general rule, set the Call Trace Filter for the ingress side except for the Called number. 

    To Edit a Call Trace Filter

    1. Select an existing Call Trace Filter object by clicking the radio button adjacent to it in the Call Trace Filters window. The Edit Call Trace Filter window is displayed.

    2. Make changes and click Save.

    To Copy a Call Trace Filter

    1. Select an existing Call Trace Filter object by clicking the radio button adjacent to it in the Call Trace Filters window.
    2. Click Copy Call Filter. The Copy Call Trace Filter window is displayed.
    3. Make changes and click Save. 

    To Delete a Call Trace Filter

    1. Select an existing Call Trace Filter object by clicking the radio button adjacent to it in the Call Trace Filters window.
    2. Click the X on the right end of the selected row.

    3. Confirm the deletion when prompted.

    Anchor
    Call Trace Status and Settings
    Call Trace Status and Settings
    Call Trace Status and Settings

    Once you have one or more Call Trace Filters created, call traces can be started and stopped from the top panel of the Configure Trace and Media Packet Capture window. See the earlier figure of the Configure Trace and Media Packet Capture window. There you can start, save and stop traces using the enabled filters. The trace continues running until a specified duration elapses or the specified number of call filter matches is reached.

    Info
    titleNote:

    When you start a trace, by default, the first three enabled filters in the table are used for the trace.

    To Run a Call Trace

     In the Call Trace Status and Settings panel, choose the required conditions for the trace using the following table.

    Caption0

    Table1

    Call Trace Status and Settings parameters

    3Call Trace Error Types

    :

    Parameter

    Description

    Call Trace Duration

    Specifies the duration for the Call Trace to run. The options are:

    • Run trace until stopped (by clicking the Stop Trace button): If selected, the trace will keep running till it is stopped manually (by clicking the Stop Trace button).
    • Stop trace after __ minutes: If selected, add the number of minutes for the Call Trace to run. The value ranges from 1 to 360 minutes and the default value is 180 minutes.

    If you configure a specific value for Call Trace Duration and the SBC experiences a failover or restart, the call trace starts again automatically and runs for the specified duration.

    Number of Matches (optional)Specifies the maximum number of calls to match before stopping the trace. The value ranges from 1 to 64 times.
    Trace Calls with errors of the type

    Check this object to enable specifying  a system-wide call trace error filter trigger criteria. By default the option is unchecked which means there is no SIP PDU logging for this error filter. After checking the option the following options are available:  

    • Any—Log all SIP PDUs that meet the requirement of the Parse Error, Out of Dialog, and Early Attempt options below.
    • Parse Error—Log received SIP PDUs that fail parsing. If an error is detected by SIP signaling, the accompanying PDUs will not be associated with any dialog, including an existing dialog. Hence all in dialog and out of dialog PDUs are assigned to this category. If an error is detected at the front end pre-parser, the PDU is logged by this software and not forwarded to SIP signaling. This prevents an offending PDU from being logged by both the pre-parser and SIP signaling.
    • Out of Dialog—Log incoming syntactically correct SIP PDUs (except INVITE) that do not belong to an existing dialog.
    • Early Attempt—Logs incoming SIP PDUs that result in early termination of the call (by either the pre-parser or SIP signaling).

    Include Page
    Call_Trace_ErrorFilter_Note
    Call_Trace_ErrorFilter_Note

    For further details on error logs, see the section Call Trace Log Messages.

    Call Trace Status

    Displays the current status of the Call Trace.

    • When there is no trace running, the status is Call trace stopped with a red dot.
    • when a trace is running, the status is Call trace running with a green dot.

    Click Save & Start Trace to start the trace. The trace status is displayed in the same panel.  

    Caption
    0Figure
    1Call Trace Logs and Monitors - Call Trace Running

    The trace stops automatically if a time limit is specified, otherwise you must stop the trace manually by clicking Stop Trace.

    Caption
    0Figure
    1Call Trace Logs and Monitors - Call Trace Stop

    Once the trace is complete, the logs are generated and stored at Log Management. Look for TRC and PKT log files (.trc and .pkt log files). For more details on log messages, see the section Call Trace Log Messages.

    Anchor
    Log Message Facts
    Log Message Facts
    Call Trace Log Messages

    Include Page
    Notes_and_Examples_on_Call_Trace_Log_Message
    Notes_and_Examples_on_Call_Trace_Log_Message

    Offline Call Trace Analysis Using LX Utility

    pagebreak
    Multiexcerpt include
    MultiExcerptNameLX
    PageWithExcerptMedia Capture and Call Trace