Administrator Handbook Table of contents version française

Cisco ISDN Call History collector

Introduction

The Cisco ISDN Call History Collector can retreive the history of calls from Cisco routers and provide detail reports on call duration per source and destination.

The Cisco ISDN Call History Collector Plug-in reads call history table in CISCO router each 5 minutes, displays the opened and closed calls and stores the new closed call in files. These Files could be later used by the ISDN Call statistic Plug-in to perform statistics on Call and calculate daily or monthly cost.

About ISDN : Integrated Services Digital Network (ISDN) is comprised of digital telephony and data-transport services offered by regional telephone carriers. ISDN involves the digitization of the telephone network, which permits voice, data, text, graphics, music, video, and other source material to be transmitted over existing telephone wires.

RNIS is the french translation of ISDN and means " Réseau numérique à intégration de services ".

The Call History Collector module is a single window application that provide in real time a view of current active calls and closed calls. The history in the router is updated at regular interval and cannot save more that a short period of time. With the Call History Collector plug-in you can save months and years of histiory.

Requirements

The Cisco ISDN History Call Collector Plug-in works with all Cisco devices that support the proprietary Cisco MIB - CISCO-CALL-HISTORY-MIB - This MIB describes the objects defined and used for storing the call information for all calls.

Mandatory: The no snmp-server sparse-tables command should be set on the Cisco router else the results will not be consistent.

The MIB file is provided by default with LoriotPro and available in the MIb tree under the private -> enterprise -> cisco branch :

The MIB contains a table that stores the past call information. The call information will include the destination number, the call connect time, the call disconnect time and the disconnection cause. These calls could be circuit switched or they could be virtual circuits. History of each and every call will be stored. An entry will be created when a call gets disconnected. At the time of creation, the entry will contain the connect time and the disconnect time and other call information."

Most of the Router and Cisco Access products support this MIB and could be used with this PLUG-IN.

Cisco Router 1000 Series
Cisco Router 1600 Series
Cisco Router 2500 Series
Cisco Router 2600 Series
Cisco Router 3600 Series
Cisco Router 4000 Series
Cisco Router 1000 Series
Cisco Access Server AS5300 Series
Cisco Router 6000 Series
Cisco Router 7000 Series

The History table is characterized by two values, the maximum number (max-size) of entries that could be stored in a period of time (retain-timer).
The max-size value specifies the maximum size of the Call history table. The valid range is from 0-1200, and the default is 320.
The retain-timer value specifies the length of time in minutes that entries will remain in the call history table. The valid range is from 0-2147483647 minutes, and the default is 15. Setting the value to 0 prevents any call history from being retained.

To modify this values use the following command:

call-history-mib retain-timer <number>
call-history-mib max-size <number>

We strongly recommend to not change the retain timer if you use this Plug-in.

Launching the program

From the Directory TAB, open the contextual menu of apropriate Cisco Router host with a right click, select  Insert Task and Cisco Call collector.

launching cisco isdn call collector

The Plug-in is attached to the Host and could be setup

Using the Plug-in

The Cisco ISDN Call History collector is very simple to configure. By default it works and collects call history each 5 minutes. As the wrap interval is 15 minutes in the Router you should not lose any call (except if you have a huge number of calls that saturate the Cisco History table in less than 5 minutes. In that case decrease the polling interval or increase the History table in the router (when possible).

First time you open the Plug-in you get the following screen.

Cisco Call ISDN

Click on the Request button if you want an immediate upadte of your table.

Other options allow you to create a Syslog message each time a call is closed. To get it to work, you have to check the Send Closed Call to Syslog and provide a Syslog Server IP address to which the Syslog messages will be sent.

You could also save the log in Tml or CSV file for further analysis by checking the Generate Html or CSV check box.

If you want to use the Cisco ISDN Call Statistics Plug-in, check the Generate CSV file option. The log files will be stored by default in the /bin/www/log subdirectory.

The column contains the following SNMP objects

SNMP Object Description

ciscoCallHistoryStartTime
cisco Call History Start Time

The value of sysUpTime when this  call history entry was created. This will be useful for an NMS to retrieve all calls after a specific time.
ciscoCallHistoryIndex
cisco Call History Index
Index variable to access the CallHistoryEntry objects of the ciscoCallHistoryTable.

ciscoCallHistoryCallingNumber
cisco Call History Calling Number

The calling number for this  call. If the number is
not available, then it will have a length of zero.
The variable is instantiated if this is an incoming
call.

ciscoCallHistoryCalledNumber
cisco Call History Called Number

The number this  call   is connected to. This variable is instantiated if this is an outgoing call.
ciscoCallHistoryInterfaceNumber
cisco Call History Interface Number
This is the ifIndex value of the highest number of interface through which the call was made.
ciscoCallHistoryDestinationAddress
cisco Call History Destination Address
The address of the host this  call  is connected to, if it is available. Most devices/routers connected to an interface  have an address and this object will store that. The variable is not instantiated if it is not available.
ciscoCallHistoryDestinationHostName
cisco Call History Destination Host Name
The name of the host this  call  is connected to. Most devices/routers connected to an interface  have a name and this object will store that name.
ciscoCallHistoryCallDisconnectCause
cisco Call History Call Disconnect Cause
The reason for the call termination.
ciscoCallHistoryCallConnectionTime
cisco Call History Call Connection Time
The value of sysUpTime when the  call was connected.
ciscoCallHistoryCallDisconnectTime
cisco Call History Call DisconnectTime
The value of sysUpTime when the call got disconnected last.
ciscoCallHistoryDialReason
cisco Call History Dial Reason
The reason for initiating this  call. This may include
the destination address of the interesting packet that forced us to dial. This variable is instantiated for an outgoing call.
ciscoCallHistoryConnectTimeOfDay
cisco Call History Connect Time Of Day
The time of day at the time of call connect.
ciscoCallHistoryDisconnectTimeOfDay
cisco Call History Disconnect Time Of Day
The time of day when the call disconnected.
ciscoCallHistoryTransmitPackets
cisco Call History Transmit Packets
Number of packets transmitted when this call was up.
ciscoCallHistoryTransmitBytes
cisco Call History Transmit Bytes
Number of Bytes transmitted when this call was up.
ciscoCallHistoryReceivePackets
cisco Call History Receive Packets
Number of packets received when this call was up.
ciscoCallHistoryReceiveBytes
cisco Call History Receive Bytes
Number of Bytes received when this call was up.
ciscoCallHistoryRecordedUnits
cisco Call History Recorded Units
Advice of Charge recorded units when this call was up.
ciscoCallHistoryCurrency
cisco Call History Currency
Advice of Charge currency type.
ciscoCallHistoryCurrencyAmount
cisco Call History Currency Amount
Advice of Charge currency amount when this call was up.
ciscoCallHistoryMultiplier
cisco Call History Multiplier
Advice of Charge multiplier for currency amount

www.loriotpro.com