IMG 1010 - Call Tracing

Description:

The Call Tracing feature has evolved over time. The Call Tracing Feature logs events from the IMG into a file with a maximum log time of 7200 seconds (2 hours). After the two hour period, the logging would stop. In software version 10.5.2 some enhancements were made to the Call Tracing Feature so that troubleshooting and file management was made easier. The information below explain both the older version and the newer version updated in Software version 10.5.2. Use this pane to initiate Call Tracing. A log will be generated showing events that occur on a per-call basis.

Accessing this Pane

Dialogic IMG EMS -> Logical IMG -> Physical IMG -> Call Tracing

Open

Maximum Objects:

1 per Physical IMG

Related Topics:

IMG 1010 - Call Trace - Setup and Configuration

IMG 1010 - Call Trace - Log File Overview

ClientView Pane: (Software 10.5.2+)

Open

Field Descriptions:

Call Tracing Period:

The Call Tracing Period is the total amount of time the Call Tracing session will be logging for. The range is from 1-4320 minutes (72 hours). To change the value, click in the Call Tracing Field and enter the new value 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

Roll-over Interval: (0=disabled: Default)

The Call Trace logging files can now be Rolled Over at 1 minute intervals. To ease the management of the Call Tracing log files the GCEMS can create a new Call Trace log file at the interval entered in the Roll-Over Interval. The range of values is from 0-120 minutes (0 = disabled). The default value is 0 which indicates the Roll-Over feature is disabled. 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. Below is screen capture of the Call Trace log files that have a Roll-Over interval of 2 minutes.

The format is syslog_<img serial #>_<YYMMDD>_<HHMMSS>.log. (The time parameter is displayed in UTC format)

For the parameters of the filenames above to be correct, the ntp server must be enabled. If ntp server has not been configured a default date of Jan 1970 will be displayed. See IMG 1010 - Configure GCEMS and Start Linux Services for more information on configuring/starting the ntp service.

Call Tracing Directory:

The default directory is located at /opt/dialogic/common/calltracing. All Call Tracing log files will be created and stored here. 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 call tracing directory. This is done to keep logging directory from filling up and using too much memory. 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.

Monitoring Fields:

Call Tracing Status:

Disabled (Default) - Call Tracing Gel is not running.

Enabled- 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 changed.

Timer Expired- The Call Tracing Session has completed. This field will have a value of 0 displayed.

Call Tracing Time Remaining:

The number of minutes left in this Call Trace session. In order to display the latest value, the 'Update Status' button must be pressed.

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:

Stops the Call Tracing session.

Update Status:

In order to display the latest values in the yellow shaded monitoring fields hit the Update Status button. Fields will not automatically update without selecting this button.

ClientView Pane: (Software 10.3.x - 10.5.1)

Field Descriptions:

Call Tracing Period:

The amount of time in seconds the trace will be logged. Range: 1-7200  (Default = 3600 seconds)

Call Tracing Directory:

The location of the trace log on the GCEMS host. The default is:

Monitoring Fields:

Call Tracing Status:

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

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

Stop Call Tracing:

Stop the Call Tracing session

Update Status:

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