[asterisk-dev] [Code Review] Rework CDR API Internals to Prevent Loss of CDR Records

[Russell Bryant]

-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviewboard.asterisk.org/r/531/
-----------------------------------------------------------

(Updated 2010-02-26 02:49:20.048173)


Review request for Asterisk Developers.


Changes
-------

One more minor update for the night ... this just reduces the diff size a little bit more


Summary
-------

This code comes from the team/russell/cdr-q branch.  It is something I did on a couple of flights this week.

The current CDR implementation in Asterisk does nothing to ensure that every CDR record is successfully logged to configured logging destinations.  A single attempt is made to log a record.  If for some reason it fails, such as connectivity to a database being temporarily disrupted, then the records are lost.  Obviously, this is very bad in many cases where these records are used for things like billing.

The primary purpose behind these changes is to ensure that every record is successfully logged to every destination that has been configured.  If posting a CDR fails, it will be queued up for a retry later.

A new method has been added for backends to register callbacks for receiving CDR records.  For CDR modules that allow posting CDRs to multiple destinations, such as multiple DB tables or multiple text files, they now make a registration into the core for every destination.  That way, the success or failure of the attempt to each destination can be tracked.  All backends that need it have been updated to operate this way.

main/cdr.c has also been updated to use more modern Asterisk APIs.  It has also been updated with various other bits of code cleanup.

One side effect of these changes is that the code that previously implemented the batch mode has been completely removed, as that code is now deprecated.  The biggest benefit from batch mode was handling CDR posting asynchronously from channel threads.  In this code, that is the only behavior that exists.


Diffs (updated)
-----

  /trunk/UPGRADE.txt 249057 
  /trunk/cdr/cdr_adaptive_odbc.c 249058 
  /trunk/cdr/cdr_custom.c 249058 
  /trunk/cdr/cdr_odbc.c 249058 
  /trunk/cdr/cdr_radius.c 249058 
  /trunk/cdr/cdr_syslog.c 249058 
  /trunk/configs/cdr.conf.sample 249057 
  /trunk/include/asterisk/cdr.h 249057 
  /trunk/main/asterisk.c 249057 
  /trunk/main/cdr.c 249057 
  /trunk/main/features.c 249057 
  /trunk/main/manager.c 249057 

Diff: https://reviewboard.asterisk.org/r/531/diff


Testing
-------

I have done some manual testing.  However, before I consider this done, I would like to implement some automated tests, as well as touch on more backends than what I have tested so far.

I configured cdr_custom to log CDRs to multiple files.  I made calls and verified that records were logged successfully.  I made some modifications on disk such that attempts to log to one file would fail, while the other would continue to succeed.  I made more calls and verified that the CDR queue grew for the specific file that had failures.  I fixed the problem and continued making calls.  I verified that all previously failed CDRs were posted and that both files were in sync with the number of CDRs that they had.


Thanks,

Russell