|Administrator Handbook||Table of contents|
IntroductionThe 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.
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.
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.
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
|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.|
cisco Call History Index
|Index variable to access the CallHistoryEntry objects of the ciscoCallHistoryTable.|
|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
|The number this call is connected to. This variable is instantiated if this is an outgoing call.|
cisco Call History Interface Number
|This is the ifIndex value of the highest number of interface through which the call was made.|
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.|
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.|
cisco Call History Call Disconnect Cause
|The reason for the call termination.|
cisco Call History Call Connection Time
|The value of sysUpTime when the call was connected.|
cisco Call History Call DisconnectTime
|The value of sysUpTime when the call got disconnected last.|
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.
cisco Call History Connect Time Of Day
|The time of day at the time of call connect.|
cisco Call History Disconnect Time Of Day
|The time of day when the call disconnected.|
cisco Call History Transmit Packets
|Number of packets transmitted when this call was up.|
cisco Call History Transmit Bytes
|Number of Bytes transmitted when this call was up.|
cisco Call History Receive Packets
|Number of packets received when this call was up.|
cisco Call History Receive Bytes
|Number of Bytes received when this call was up.|
cisco Call History Recorded Units
|Advice of Charge recorded units when this call was up.|
cisco Call History Currency
|Advice of Charge currency type.|
cisco Call History Currency Amount
|Advice of Charge currency amount when this call was up.|
cisco Call History Multiplier
|Advice of Charge multiplier for currency amount|