Call Recording

From Taridium

Revision as of 16:34, 9 December 2008 (view source) Webmaster (Talk | contribs) (→View) ← Older edit		Latest revision as of 17:01, 17 October 2018 (view source) Webmaster (Talk | contribs)
(36 intermediate revisions not shown)
Line 1:		Line 1:
-	ipbx call recording allows you to record all or select calls passing through your PBX system.	+	ipbx call recording allows you to record all or select calls passing through your PBX system. You can set individual call recording for Users (inbound/outbound) and their associated phones, Groups, Queues and Conferencing. This form of call recording is independent from [[User_Call_Recording|User Call Recording]] sometimes also referred to as ad-hoc call recording.
-	== View ==	+	Check your jurisdiction's laws regarding call recording. Generally, it is legal to record any conversation where all the parties to it, have given their consent (one-party consent if all the parties are in a state with a corresponding law). For example, U.S. federal law requires only one-party consent to the recording of a telephone conversation, but does not explicitly protect such a recording if it is made for criminal or tortuous purposes. Many states and countries make similar exceptions.
		+
		+
		+	== Storage & Limits ==
		+
		+	Call recording is storage intensive and should be carefully planned. Standard ipbx configurations use the local database and disk for call recordings. It is advisable to use a separate disk, or storage array for more than occasional recording.
		+	One hour of call recording takes up about 6MB of disk space in GSM format or about 60MB in WAV format. A 500GB drive will thus be able to store in excess of 70,000 hours. See also [[Call_Recording#Storage_Backend|Storage Backend Settings]].
		+
		+	In order for ipbx to properly handle and play back recordings that are bigger than 16MB, you will need to adjust your php.ini configuration (on standard ipbx distributions this file can be found under /etc/php.ini). The relevant limit is:
		+
		+	memory_limit = 128M
		+
		+	Make sure to restart the ipbx tasker service and HTTP server by entering:
		+
		+	[root@ipbx ~]# service ipbx restart
		+	[root@ipbx ~]# service httpd restart
		+
		+	Later versions of ipbx have a preset limit of 128MB and usually don't require any changes.
		+
		+	Further limits on database storage are imposed by the MySQL backend and might need be adjusted as well.
		+
		+	[mysqld]
		+	max_allowed_packet = 128M
		+	query_cache_size = 128M
		+
		+	remember to restart the MySQL backend by typing:
		+
		+	[root@ipbx ~]# service mysqld restart
		+
		+	Unprocessed recordings which haven't shown up in the recordings table, will still be in the /tmp/ directory of the ipbx system. A restart of the tasker will automatically cause these to be stored in the database. Do not restart your ipbx system before moving the files out of the /tmp/ directory unless they have been already stored in your recordings table.
		+
		+	== Browsing recordings ==
	This interaction displays all your recorded calls. Calls are stored in a local relational database.		This interaction displays all your recorded calls. Calls are stored in a local relational database.
Line 31:		Line 62:
	=== Length ===		=== Length ===
-	Length of recording	+	Length of recording in seconds. This applies to the recorded file and not necessarily to the total duration of the call.
		+
		+	=== Size ===
		+
		+	The size of the recording as stored on the disk. The letter '''F''' indicates that the file has been stored as a separate file on the disk. See also file based storage option.
	=== CDR ===		=== CDR ===
-	Link to associated CDR record	+	Link to associated [[wikipedia:Call_detail_record|CDR]] record - see also [[CDR|Call Detail Records]]. You can also search and access your call recordings via the CDR browser, by expanding the call record.
	=== Audio ===		=== Audio ===
Line 41:		Line 76:
	Click on the speaker button to playback or save the recording locally.		Click on the speaker button to playback or save the recording locally.
-	== Settings ==	+	== Settings & What to Record ==
-	Configure your call recording settings.	+	Call Recording Settings can be found under '''Diagnostics''' → '''Call Recording''' → '''Settings'''. Configure your call recording settings. ipbx is capable of recording selectively as well as globally. The following applications allow selective call recording: '''Groups''', '''Queues''' and '''Conferencing'''. In order to record on a per user basis see [[Feature_Settings|User Feature Settings]].
	=== Record all Incoming Calls ===		=== Record all Incoming Calls ===
Line 60:		Line 95:
	Set an automated deletion schedule for your recorded calls.		Set an automated deletion schedule for your recorded calls.
		+
		+	===Storage Backend===
		+
		+	The default storage backend is a relational MySQL database named '''monitor'''. Use the file based backend for large scale recording and durations beyond 1 hour. Your files will be stored in /var/spool/asterisk/monitor.
	== Clear Recording ==		== Clear Recording ==
	Remove all recordings from your database		Remove all recordings from your database

---

Latest revision as of 17:01, 17 October 2018

ipbx call recording allows you to record all or select calls passing through your PBX system. You can set individual call recording for Users (inbound/outbound) and their associated phones, Groups, Queues and Conferencing. This form of call recording is independent from User Call Recording sometimes also referred to as ad-hoc call recording.

Check your jurisdiction's laws regarding call recording. Generally, it is legal to record any conversation where all the parties to it, have given their consent (one-party consent if all the parties are in a state with a corresponding law). For example, U.S. federal law requires only one-party consent to the recording of a telephone conversation, but does not explicitly protect such a recording if it is made for criminal or tortuous purposes. Many states and countries make similar exceptions.

Contents 1 Storage & Limits 2 Browsing recordings 2.1 Edit 2.2 ID 2.3 Date & Time 2.4 Source 2.5 Destination 2.6 Accountcode 2.7 Length 2.8 Size 2.9 CDR 2.10 Audio 3 Settings & What to Record 3.1 Record all Incoming Calls 3.2 Record all Outgoing Calls 3.3 Record all Internal Calls 3.4 Recordings Maintenance 3.5 Storage Backend 4 Clear Recording

Storage & Limits

Call recording is storage intensive and should be carefully planned. Standard ipbx configurations use the local database and disk for call recordings. It is advisable to use a separate disk, or storage array for more than occasional recording. One hour of call recording takes up about 6MB of disk space in GSM format or about 60MB in WAV format. A 500GB drive will thus be able to store in excess of 70,000 hours. See also Storage Backend Settings.

In order for ipbx to properly handle and play back recordings that are bigger than 16MB, you will need to adjust your php.ini configuration (on standard ipbx distributions this file can be found under /etc/php.ini). The relevant limit is:

 memory_limit = 128M

Make sure to restart the ipbx tasker service and HTTP server by entering:

 [root@ipbx ~]# service ipbx restart
 [root@ipbx ~]# service httpd restart

Later versions of ipbx have a preset limit of 128MB and usually don't require any changes.

Further limits on database storage are imposed by the MySQL backend and might need be adjusted as well.

 [mysqld]
 max_allowed_packet = 128M
 query_cache_size = 128M

remember to restart the MySQL backend by typing:

 [root@ipbx ~]# service mysqld restart

Unprocessed recordings which haven't shown up in the recordings table, will still be in the /tmp/ directory of the ipbx system. A restart of the tasker will automatically cause these to be stored in the database. Do not restart your ipbx system before moving the files out of the /tmp/ directory unless they have been already stored in your recordings table.

Browsing recordings

This interaction displays all your recorded calls. Calls are stored in a local relational database.

Edit

Remove the call recording

ID

Unique recording ID / also used to associate with corresponding CDR record.

Date & Time

Date and Time when the recording took place (completion time)

Source

Call recording source

Destination

Call recording destination

Accountcode

Account code as set by CDR

Length

Length of recording in seconds. This applies to the recorded file and not necessarily to the total duration of the call.

Size

The size of the recording as stored on the disk. The letter F indicates that the file has been stored as a separate file on the disk. See also file based storage option.

CDR

Link to associated CDR record - see also Call Detail Records. You can also search and access your call recordings via the CDR browser, by expanding the call record.

Audio

Click on the speaker button to playback or save the recording locally.

Settings & What to Record

Call Recording Settings can be found under Diagnostics → Call Recording → Settings. Configure your call recording settings. ipbx is capable of recording selectively as well as globally. The following applications allow selective call recording: Groups, Queues and Conferencing. In order to record on a per user basis see User Feature Settings.

Record all Incoming Calls

Record all calls that are received from other systems or the PSTN.

Record all Outgoing Calls

Record all calls that are placed to other systems or the PSTN.

Record all Internal Calls

Record all calls that have been placed internally, e.g. from extension to extension etc.

Recordings Maintenance

Set an automated deletion schedule for your recorded calls.

Storage Backend

The default storage backend is a relational MySQL database named monitor. Use the file based backend for large scale recording and durations beyond 1 hour. Your files will be stored in /var/spool/asterisk/monitor.

Clear Recording

Remove all recordings from your database