Versions Compared

Old Version 5

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version 6

changes.mady.by.user Ribbon Communications

Saved on

Key

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

...

Panel

In this section:

Table of Contents
maxLevel2

Call Trace

...

The SBC supports logging PES call trace messages in the tracing files (.TRC). Trace information is used for debugging policy and routing of a call. Processing information such as pre-processing, applying services, routing, and post processing is logged. For identifying traces of a call, the call identifier is also logged in the .TRC file.

The default information collected during a call trace includes the following:

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

The Call Trace Filter screen

 

Note

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

This object allows you to create and configure Call Trace Filters that specify criteria that the SBC uses using criteria to determine call events that are added to the system trace data event log (which uses the ".TRC" file extension).

Note

Limitation: Call Trace should be set to ingress mode and not egress unless, egress mode is called for.

Warning

Caution
 Do not turn on the Filter to trace all calls. Doing so may cause poor system performance. Use this mechanism to trace specific calls.

The first three Call Trace filters are logged unless the Stop Match flag  is enabled (whereby the number of filters logged may be less than three). The Stop Match flag  stops filter profile matching once a match is found.

When a call trace filter is created, call trace is started, and a call fulfills the filter criteria, the trace information is written to a tracing file (.TRC). Call trace can be started and stopped from the Call Trace > Configure Trace and Media Packet Capture screen. The trace continues running until the specified duration or number of call filter matches is reachedThe Call Trace feature 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. A new log level (level 4) is added to available Call Trace levels which is required by the SIP Ladder feature.

The Call Trace feature helps you supports to:

  • Configure Call Trace, Call Filter, Match, and Error Filter options from a single screen.
  • View the status of a Call Trace.
  • Stop a Call Trace with a single command.
  • Run the Call Trace for unlimited duration.
  • Restart the Call Trace with a single click when a call trace gets stopped once the call filters reaches the threshold limit.
  • Delete any Call Filter.
  • Create and Edit Call Filter and Filter Match Criteria from a Single Tool.

Call Trace Filters

Note

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

The Call Trace Filter object allows you to create and configure Call Trace Filters that specify criteria that the SBC uses to determine call events added to the system trace data event log (which uses the .TRC file extension).

Note

Limitation: Call Trace should be set to ingress mode and not egress unless, egress mode is called for.

Navigation Path:

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

...

Info

You need to create Filters first or use the created Filters to start a Call Trace on it.

To View Call Filter

On the SBC main screen, go navigate to Troubleshooting > Call Trace/Logs/Monitors > Call Trace and Packet Capture > Call Trace. The Configure Trace and Media Packet Capture window appears.The second panel reflects the Filter entries in it.

...

Parameter

Description

NameSpecifies the name of the Call Trace filter that you are about to create.
State

Specifies the state of this filter. The options are:

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

Specifies the type of logs that need to be captured while running the Call Trace. The options are:

  • TRC logs: Capture trace information (.trc logs) only.
  • TRC and PKT logs: Capture trace information (.trc logs) and media information (.pkt logs).
Note

You can even save the CLI call details and statistics by selecting this additional option, Also save CLI call details and statistics for traced calls (Call Detail Status, Call Media Status, Call Resource Detail StatusStatus). These files are saved as .out files.

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

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.
  • Level 4 filters based ONLY on Peer IP Address. This call trace method does not trace/filter based on trunk group, called number, calling number, etc.
  • 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, etc.).and so on).
  • No other trace filters can be running at the same time as the level 4 trace (that is, do not run a level 1, 2, or 3 trace at the same time as the level 4 trace.)


Note

The Level 4 log is implemented to capture SIP Ladder diagrams (which is currently not supported) for the interpretation of calls.


Capture calls that match these filters

Specifies the criteria that need to be captured in the logs in a Call Trace (these are optional). The options are:

  • Called Number: Specifies the called party number to trace. An X or x means accept anything in that digit position. For example, 617xxx1212 would filter for all numbers 6170001212 through 6179991212. The % symbol acts as a wildcard for all remaining digits. For example, use 978% to trace all calls with a 978 prefix. Field Length is upto 30 characters.
  • Calling Number: Specifies the calling party number to trace. An X or x means accept anything in that digit position. For example, 617xxx1212 would filter for all numbers 6170001212 through 6179991212. The % symbol acts as a wildcard for all remaining digits. For example, use 978% to trace all calls with a 978 prefix. Field Length is upto 30 characters.

  • Contractor Number: Specifies the contractor number to trace. An X or x means accept anything in that digit position. For example, 617xxx1212 would filter for all numbers 6170001212 through 6179991212. The % symbol acts as a wildcard for all remaining digits. For example, use 978% to trace all calls with a 978 prefix. Field Length is upto 30 characters.

    Note

    For the above parameters, use "X" or "x" wildcard characters to match any single digit and "%" symbol to match any digits from that point forward.

  • Redirecting Number:  Specifies the redirecting number to trace. An X or x means accept anything in that digit position. For example, 617xxx1212 would filter for all numbers 6170001212 through 6179991212. The % symbol acts as a wildcard for all remaining digits. For example, use 978% to trace all calls with a 978 prefix. Field Length is upto 30 characters.
  • CDDN number: Specifies the Called Directory Number to trace. Field Length is upto 30 characters.

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 trace. This string must match the trunk group name exactly. You cannot use wildcard characters for this argument. Field Length is upto 23 characters.
  • Peer IP Address: Specifies the peer IpV4 or IpV6 Address for call tracing.
stop match

Specifies the criteria to stop the Call Trace. 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)

...

Excerpt Include
Media Capture and Call Trace
Media Capture and Call Trace
nopaneltrue

 

The Call Trace Filter