Call Tracing

For troubleshooting purposes, the 2020 IMG supports logging calls over a specified period of time. The 2020 IMG can be configured to log all call events from the 2020 IMG  into a file for viewing. The Call Trace logging feature can be configured to log all calls on a per-call basis for minimum of 1 minute to a maximum of 4320 minutes (72 Hours). After the pre-determined amount of time has elapsed, the 2020 IMG will stop logging any more call events. A nice attribute of the Call Tracing feature is the ability to create multiple smaller call trace files broken down into smaller manageable files. This attribute is labeled Roll-over interval. See information below

  

ClientView Pane

IMG EMS > Logical Node > IMG Name > Call Tracing

SC_Call_Tracing.png

 

Maximum Objects

One Call Trace object can be created per 2020 IMG.

 

Related Topics and Dependencies

Within a Call Trace a Timestamp is generated displaying the exact time of each call event. For the timestamp to be accurate, an (Network Time Protocol) NTP server must be configured to send the time to the 2020 IMG. If the NTP Service is not configured, the time will default to Jan 1970. See Configure SNTP for more information on configuring/starting the ntp service. The Call Trace object does not automatically update its Real Time status. To view the latest status information, press the Update Status button.

Call Trace - Setup and Configuration

Call Trace - Log File Overview

 

Field Descriptions

Call Tracing Period (Default 60 Minutes)

The Call Tracing Period field determines how long an occurrence of a call trace event will log for. The range of time is from 1 - 4320 minutes (72 hours). To enter a time, click in the 'Call Tracing Period' field and enter a new time in minutes. If a value is entered that falls outside of the Call Tracing Period range a Call Tracing Enable: Range Field Invalid error will be displayed. At the end of the call trace period, the logging will stop.

 

Roll-over Interval (Default = 0 Minutes = Disabled)

Call Trace log files can get very large and difficult to handle. To ease the management of the Call Tracing log files a Roll-over provision was added to enable a user to configure how long the log file will capture data before creating a new log file. The default value is 0 which indicates the Roll-Over feature is disabled. The Roll-over field is configured in one minute intervals and has a range from 0-120 minutes. If a value is entered that falls outside of the Roll-over interval range a Call Tracing Enable: Range Field Invalid error will be displayed. The default directory that the Roll-Over files are all logged in is the /opt/dialogic/common/calltracing directory. The time parameter is displayed in UTC format and the naming convention of the log files is:

syslog_<img serial #>_<YYMMDD>_<HHMMSS>.log

Note: If Roll-Over Interval is enabled (set to something other than 0) and Roll-over Interval value is changed, the Roll-over timer is restarted. This allows a user to disable or extend the timer as needed.

 

Call Tracing Directory

The Call Trace Directory field displays the path to the directory where the log files are stored. The default location is opt/dialogic/common/calltracing.  To change the default directory, delete the Call Tracing object and re-add a new Call Tracing Object. Once the new pane has been created, double click in the Call Tracing Directory and the field will become white. At this point the directory/path can be changed. Each day at approximately 1:30 AM the Call Tracing Log Files are archived into the /opt/dialogic/common/backup directory and a new set of log files are generated in the calltracing directory. This is implemented to keep the logging directory from filling up and using too much memory.

 

Monitoring Fields

Call Tracing Status

The Call Tracing Status field indicates whether Call Tracing is enabled or disabled, as well as any error conditions. To view the current status, click the Update Status button.

Disabled (Default) - Logging of Call Traces is not being performed. Call Tracing Gel is not running.

Enabled - Logging of Call Trace has been started and is in progress. Call Tracing Gel is running and is being logged to file in Call Tracing Directory field.

Error Writing to System Log File - Cannot write to log file. Possible NFS problem or a file has been modified.

Timer Expired - The Call Tracing Period Timer has expired. Logging of Call Traces is no longer being performed.

 

Call Tracing Time Remaining

The amount of time remaining in the current trace period.  To view the current value, click the Update Status button.

 

Buttons

Start/Reset Call Tracing

Starts and Resets the Call Tracing session. To get the latest information after a call trace has been initialized, the Update Status button must be pressed.

Stop Call Tracing

Stop the Call Tracing session.

Update Status

Update the Call Tracing Status and Call Tracing Time Remaining fields.