Skip to end of metadata
Go to start of metadata

In this section:

Call Trace Filtering

The SBC supports logging PES call trace messages in 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 global callTrace signalingPacketCapture command allows you to create and configure Call Trace Filters using criteria to determine call events added to the system trace data event log (which uses the ".TRC" file extension). The first three Call Trace filters are logged unless the stopMatch flag in enabled (whereby the number of filters logged may be less than three). The stopMatch flag will halt filter profile matching once a match is found.

When call trace filter criteria is provisioned and a call meets the criteria, trace information is written to a tracing file. Call trace is enabled using the provisioning interface.A callTraceTimer configuration is provided along with the maxTriggerCount configuration to limit the logging of call/error filter events in the TRC file. The SBC may be configured to stop call tracing if either of following criteria is met:

  • Configured maxTriggerCount is reached or,
  • Configured callTraceTimer expires

To set the callTraceTimer, use CLI syntax:

set global callTrace callTraceTimer <minutes>

To restart the call trace without changing the callTrace configuration, use the CLI command:

request global callTrace action command start

To enable call trace logging using CLI, see Call Trace - CLI.

The SBC generates sonusSbxNodeResourceCallTraceActiveNotification alarm when the callTrace starts. When the callTrace stops, either due to maxTriggerCount reach or callTraceTimer expiry, SBC generates sonusSbxNodeResourceCallTraceDisabledNotification trap and clears the sonusSbxNodeResourceCallTraceActiveNotification alarm.

 

A system reboot, an application restart or a Live Software Upgrade (LSWU) causes the callFilter, mediaPacketCapture, callDetailCapture, and signalingPacketCapture filters to go offline. To overcome this, disable and then re-enable these filters.

Call Trace functionality is supported using either the EMA or CLI.

 

Offline Call Trace Analysis Using Log Exchange (LX) Utility

The TRC files can be analyzed offline using the Sonus LX tool, which generates a SIP ladder diagram from the TRC or DBG files. The LX tool is a Windows PC application available free of charge to all customers and partners with a license agreement, and can be downloaded as part of your software download request. For details, see Log Exchange Documentation.

Figure : LX Main User Interface

 

  • No labels