Best Practice - Configure Logging based on Call Trace Criteria

Overview

In a high call volume deployment, the SBC Edge Portfolio has a new mechanism to turn on logging for a call based on the call criteria you configure; call related messages will appear in the log when enabled by the call trace criteria configured. This new feature provides an alternative to filter based logging on subsystems individually. The following call criteria can be configured for logging:

• Ingress SG
• Remote IP
• Calling Party
• Called Party

The Call Criteria Table, available in the WebUI is used to store the call criteria configuration. 

View the Call Criteria Table

The Call Criteria Table stores the call criteria data configuration; you add call criteria entries in which the SBC SWe Edge provides call trace messages in the log.

View the Call Criteria table as follows: 

1. In the WebUI, click the Settings tab.

2. In the left navigation pane, go to Logging Configuration > Diagnostic Logging > By Call Criteria. 

   Call Criteria Table

   

Create an Entry in the Call Criteria Table 

Create an entry in the Call Criteria table as follows:

1. In the WebUI, click the Settings tab.

2. In the left navigation pane, go to Logging Configuration > Diagnostic Logging > By Call Criteria. 

3. Click the Create ( ) icon. The Create Call Trace Criteria window is displayed.  

   Call Criteria Table Field Definitions

   Field	Definition
   Description	Description of the Call Trace Criteria.
   Enabled	The stats of the felter: Valid entries: Enabled (enabled the filter Disabled (disables the filter)
   Rule Type	Determines which rule in which the call trace logging is based. Valid entries: Ingress SG. Filters logs based on the Ingress Signaling Group. Remote IP. Filters logs based on the Remote IP.  Calling Party. Filters logs based on the Calling Party Number. Called Party. Filters logs based on the Called Party.
   Signaling Groups	Determines which signaling group in which to obtain the call trace.

4. Configure the fields. See below for field definitions. 

Modify an Entry in a Call Criteria Table

1. Click the expand () Icon next to the entry you wish to modify.
2. Edit the entry properties as required, see field definitions above.

Enable all Entries in a Call Criteria Table

1. Select the check box next to the entry you wish to enable.
2. Click the Enable () icon at the top of the table. 

Disable an Entry in a Call Criteria Table

1. Select the check box next to the entry you wish to disable.
2. Click the Disable () icon at the top of the table. 

Delete an Entry in a Call Criteria Table

1. Select the check box next to the entry you wish to disable.
2. Click the Delete (X) icon at the top of the table. 

Perform Call Trace Logging - Configuration Example

Follow the configuration example below for logging based on calls details being traced on the Ingress Signaling group (Ingress SG).

1. In the WebUI, click the Settings tab.

2. In the left navigation pane, go to Logging Configuration > Diagnostic Logging > By Call Criteria. 

3. Add an entry to the Call Criteria Table and set the Rule Type to Ingress SG.
4. Run multiple calls. Calls should be dispersed between the different Signaling Groups. For details on Signaling Groups, refer to Managing Signaling Groups.
5. Access the webui.log ( Diagnostics > Logs > Local System Logs tab). The log displays the log lines associated with the calls using the Ingress SG. For details on the log display, refer to Managing Local Logs.