Update CDR README

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@2051 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Mark Spencer 2004-01-19 02:30:02 +00:00
parent dd96991005
commit 616e31f795
1 changed files with 55 additions and 6 deletions

View File

@ -1,9 +1,55 @@
Asterisk now generates Call Detail Records. See include/asterisk/cdr.h for Asterisk billing support - Call Detail Records
all the fields which are recorded. By default, records in comma-separated ----------------------------------------------
values will be created in /var/log/asterisk/cdr-csv. You can specify Asterisk generates Call Detail Records in a database or in a comma
account codes and AMA (Automated Machine Accounting) flags on a per-channel separated text file.
(Zaptel et al) or per-user (IAX) basis to help with accounting. Look * cdr_csv supports comma separated text file storage, this is the
at the top of cdr/cdr_csv.c to see the format for the records. default driver
* cdr_odbc supports UnixODBC databases, see http://www.unixodbc.org
for an updated list of supported databases, from MySQL to MsSQL
and text files.
Applications
------------
* Asterisk cmd setaccount: Set accound code for billing
* Asterisk cmd NoCDR: Make sure no CDR is saved for a specific call
* Asterisk cmd resetCDR: Reset CDR
* Asterisk cmd authenticate - Authenticates and sets the account code
* Asterisk cmd SetCDRUserField - Set CDR user field
* Asterisk cmd AppendCDRUserField - Append data to CDR User field
For more information, use the "show application" command.
Fields of the CDR in Asterisk
-----------------------------
1. accountcode: What account number to use, (string, 20 characters)
2. src: Caller*ID number (string, 80 characters)
3. dst: Destination extension (string, 80 characters)
4. dcontext: Destination context (string, 80 characters)
5. clid: Caller*ID with text (80 characters)
6. channel: Channel used (80 characters)
7. dstchannel: Destination channel if appropriate (80 characters)
8. lastapp: Last application if appropriate (80 characters)
9. lastdata: Last application data (arguments) (80 characters)
10. start: Start of call (date/time)
11. answer: Anwer of call (date/time)
12. end: End of call (date/time)
13. duration: Total time in system, in seconds (integer), from dial to hangup
14. billsec: Total time call is up, in seconds (integer), from answer to hangup
15. disposition: What happened to the call: ANSWERED, NO ANSWER, BUSY
16. amaflags: What flags to use: DOCUMENTATION, BILL, IGNORE etc,
specified on a per channel basis like accountcode.
17. user field: A user-defined field, maximum 255 characters
In some cases, uniqueid is appended:
* uniqueid: Unique Channel Identifier (32 characters)
This needs to be enabled in the source code at compile time
ONE IMPORTANT NOTE: If you are trying to collect records on IAX to IAX calls ONE IMPORTANT NOTE: If you are trying to collect records on IAX to IAX calls
you need to be aware that by default, IAX will attempt to transfer calls you need to be aware that by default, IAX will attempt to transfer calls
@ -12,3 +58,6 @@ the call is dumped from the middle machine and thus the call detail records
will report a short call time. If you want detailed records you must will report a short call time. If you want detailed records you must
turn off IAX transfer, but unless your servers are very close together, you turn off IAX transfer, but unless your servers are very close together, you
will definitely get a latency hit from doing so. will definitely get a latency hit from doing so.
----------------
2004-01-17/v0.7.1