Viewing Call History

Contents

  1. 1  Displaying the Call History Page
    1. 1.1 To display the Call History Page
      1. 1.1.1 Finding a Device
      2. 1.1.2 Filtering Calls by Offset, Reseller, and/or Domain
    2. 1.2 Showing or Hiding Information
    3. 1.3 Downloading a Call Detail Record
    4. 1.4 Viewing Events
  2. 2 Reading Call History

 Displaying the Call History Page

The Call History page contains information about each call attempt that was made in the system. Each line contains the Call Detail Record (CDR) for one call, which includes information such as:

  • Originating and answering telephone numbers for each call
  • Date and time of each call attempt
  • Call duration

There is one CDR for each call attempt.

The most recent calls appear at the top of the page. If the number of calls shown exceeds what the page can display, a next link appears at the lower right area of the page. Click this link to display the next page of calls.

To display the Call History Page

Click the Call History menu. A Call History page similar to the one below appears.


Column

Description

From Device

Device that originated the call.

To Device

Device to which the call was directed.

Dialed #

Telephone number that was dialed.

Call Time

Date and time when the call was placed.

Ringing Time

Date and time when the call started ringing the other phone.

Answer Time

Date and time when the call was answered.

Hangup Time

Date and time when the call was released (ended).

Duration (Sec)

Elapsed time of the call, in seconds.

Release Reason

Reason why the call was released.

Initially, the Call History page shows the entire call history. To locate a call for a particular device, you can use the Find Device field at the top right side of the Call History page to find a device that meets certain search criteria, or the Offset field and the Reseller or Domain drop-down list at the bottom-left side of the Call History page to filter calls by reseller and or domain.

The Call History page also has a Refresh button. After you filter or edit a voice mail, click this button to update the contents on this page.

Finding a Device

To find a device on the Call History page:

  • In the Find Device field, enter the first few characters of the device you want to find. For example, to find the device “sip:1234,” you can type sip:12.
  • Click the Refresh button. Only the device that matches the characters you typed appear in the Call History page.

Filtering Calls by Offset, Reseller, and/or Domain

Initially, the Offset field is empty and the Reseller and Domain fields contain an asterisk. This character means the Call History page shows calls for all resellers and domains. To filter the calls by a particular offset, reseller, and/or domain:

  • To filter calls by an offset, enter a value in the Offset field.
  • To filter calls by a particular reseller, select a reseller in the Reseller drop-down list.
  • To filter calls by a particular domain, select a domain in the Domain drop-down list.


The Reseller and Domain drop-down lists can be used together to narrow your view by filtering calls by reseller and domain
  • Click the Refresh button. Only the calls that correspond to the reseller and/or domain you selected are displayed in the Call History page.

Showing or Hiding Information

At the bottom of the Call History page are the following toggle buttons you can click to show or hide call-related information:

  • Show/Hide From User allows the call history page to include or exclude the From User field.
  • Show/Hide From Device allows the call history to include or exclude the From Device field
  • Show/Hide To User allows the call history to include or exclude the To User field.
  • Show/Hide To Device allows the call history to include or exclude the To Device field.
  • Show/Hide Media allows the call history to include or exclude information about the media, such as byte counts for each direction and the IP addresses of the devices involved in the call.
  • Show/Hide Disposition allows the call history to include or exclude the disposition information. Dispositions are used in call center environments, where an agent enters a disposition code about the call at the end of the call.

Downloading a Call Detail Record

A CDR is generated when a telephone call is placed. Using the Download CDR button at the bottom-right area of the Call History page, you can download a CDR for a particular date and time range. The CDR is contained in a comma-separated value (CSV)-formatted file. This allows you to import the CSV into applications that handle CSV-formatted files.

  • Click the Download CDR button. The controls shown below appear


  • Using the From controls, select the starting date and time.
  • Using the To controls, select the ending date and time.
  • By default, the CDRs for all domains will be downloaded. To download CDRs for a specific domain, select the domain from the Domain drop-down list.
  • Click the Start Download button. The message below prompts you to specify a location where the CDR file should be downloaded.

  • Click the Save button, specify a location where the CDR file is to be downloaded, and click the Save button.

Viewing Events

The Call History page allows you to view events associated with a record. To view events:

  • From the Call History page, under the Call Time column, click a record whose events you want to view. The Events page appears
  • At the top-right side of the page, the Filter field shows the filter to be applied to the events. By default, the filter is set to the call that was selected in the previous page. Changing this filter information requires in-depth knowledge of the filter syntax.
  • By default, SIP Call ID information is omitted from the events. To include it, check Call-ID to the right of the filter.
  • Below the filter are checkboxes for checking the events you want to view. There is a checkbox for each event. To view an event for the record you selected, check that event’s checkbox. To view multiple events, check each checkbox that corresponds to the events you want to view for the selected record.

The most commonly used events are:

- Responder s shows step-by-step progress of the call in the SNAP platform.

- Info = shows the actual SIP trace of the call.

- Media = shows media-related information, such as voice prompts played.

- All = shows all events combined for a call.


To select all events, click the All checkbox at the far right side.
 
  • Offset is used to jump ahead by the selected number of events. This offset includes all system events, not necessarily the ones that are displayed (unless you are displaying “all” events). Enter the appropriate value in the Offset field
  • The Time From and Time To fields show the start and end times for the events to be displayed. To see events that occurred at a different start and end time, change the Time From value to reflect the desired start time and the Time To value to reflect the desired end time.
  • The Time Margin field shows events for the specified amount of seconds before and after the call.
  • After you select one or more event categories, click the Refresh button. The event trace appears, with the newest event at the top of the page. An index number and a time stamp for each event appear on the right side.


Reading Call History





To help decipher the various SIP release codes that may be shown in the Release Reason column go here