This patch is the initial push to update Asterisk's CDR engine for the new bridging framework. This patch guts the existing CDR engine and builds the new on top of messages coming across Stasis. As changes in channel state and bridge state are detected, CDRs are built and dispatched accordingly. This fundamentally changes CDRs in a few ways. (1) CDRs are now *very* reflective of the actual state of channels and bridges. This means CDRs track well with what an actual channel is doing - which is useful in transfer scenarios (which were previously difficult to pin down). It does, however, mean that CDRs cannot be 'fooled'. Previous behavior in Asterisk allowed for CDR applications, channels, and other properties to be spoofed in parts of the code - this no longer works. (2) CDRs have defined behavior in multi-party scenarios. This behavior will not be what everyone wants, but it is a defined behavior and as such, it is predictable. (3) The CDR manipulation functions and applications have been overhauled. Major changes have been made to ResetCDR and ForkCDR in particular. Many of the options for these two applications no longer made any sense with the new framework and the (slightly) more immutable nature of CDRs. There are a plethora of other changes. For a full description of CDR behavior, see the CDR specification on the Asterisk wiki. (closes issue ASTERISK-21196) Review: https://reviewboard.asterisk.org/r/2486/ git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@391947 65c4cc65-6c06-0410-ace0-fbb531ad65f3
358 lines
8.9 KiB
C
358 lines
8.9 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 1999 - 2005, Digium, Inc.
|
|
*
|
|
* Mark Spencer <markster@digium.com>
|
|
*
|
|
* Includes code and algorithms from the Zapata library.
|
|
*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
* at the top of the source tree.
|
|
*/
|
|
|
|
/*!
|
|
* \file
|
|
* \brief Comma Separated Value CDR records.
|
|
*
|
|
* \author Mark Spencer <markster@digium.com>
|
|
*
|
|
* \arg See also \ref AstCDR
|
|
* \ingroup cdr_drivers
|
|
*/
|
|
|
|
/*! \li \ref cdr_csv.c uses the configuration file \ref cdr.conf
|
|
* \addtogroup configuration_file Configuration Files
|
|
*/
|
|
|
|
/*** MODULEINFO
|
|
<support_level>extended</support_level>
|
|
***/
|
|
|
|
#include "asterisk.h"
|
|
|
|
ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
|
|
|
|
#include "asterisk/paths.h" /* use ast_config_AST_LOG_DIR */
|
|
#include "asterisk/config.h"
|
|
#include "asterisk/channel.h"
|
|
#include "asterisk/cdr.h"
|
|
#include "asterisk/module.h"
|
|
#include "asterisk/utils.h"
|
|
#include "asterisk/lock.h"
|
|
|
|
#define CSV_LOG_DIR "/cdr-csv"
|
|
#define CSV_MASTER "/Master.csv"
|
|
|
|
#define DATE_FORMAT "%Y-%m-%d %T"
|
|
|
|
static int usegmtime = 0;
|
|
static int accountlogs = 1;
|
|
static int loguniqueid = 0;
|
|
static int loguserfield = 0;
|
|
static int loaded = 0;
|
|
static const char config[] = "cdr.conf";
|
|
|
|
/* #define CSV_LOGUNIQUEID 1 */
|
|
/* #define CSV_LOGUSERFIELD 1 */
|
|
|
|
/*----------------------------------------------------
|
|
The values are as follows:
|
|
|
|
|
|
"accountcode", accountcode is the account name of detail records, Master.csv contains all records *
|
|
Detail records are configured on a channel basis, IAX and SIP are determined by user *
|
|
DAHDI is determined by channel in dahdi.conf
|
|
"source",
|
|
"destination",
|
|
"destination context",
|
|
"callerid",
|
|
"channel",
|
|
"destination channel", (if applicable)
|
|
"last application", Last application run on the channel
|
|
"last app argument", argument to the last channel
|
|
"start time",
|
|
"answer time",
|
|
"end time",
|
|
duration, Duration is the whole length that the entire call lasted. ie. call rx'd to hangup
|
|
"end time" minus "start time"
|
|
billable seconds, the duration that a call was up after other end answered which will be <= to duration
|
|
"end time" minus "answer time"
|
|
"disposition", ANSWERED, NO ANSWER, BUSY
|
|
"amaflags", DOCUMENTATION, BILL, IGNORE etc, specified on a per channel basis like accountcode.
|
|
"uniqueid", unique call identifier
|
|
"userfield" user field set via SetCDRUserField
|
|
----------------------------------------------------------*/
|
|
|
|
static char *name = "csv";
|
|
|
|
AST_MUTEX_DEFINE_STATIC(mf_lock);
|
|
AST_MUTEX_DEFINE_STATIC(acf_lock);
|
|
|
|
static int load_config(int reload)
|
|
{
|
|
struct ast_config *cfg;
|
|
struct ast_variable *v;
|
|
struct ast_flags config_flags = { reload ? CONFIG_FLAG_FILEUNCHANGED : 0 };
|
|
|
|
if (!(cfg = ast_config_load(config, config_flags)) || cfg == CONFIG_STATUS_FILEINVALID) {
|
|
ast_log(LOG_WARNING, "unable to load config: %s\n", config);
|
|
return 0;
|
|
} else if (cfg == CONFIG_STATUS_FILEUNCHANGED) {
|
|
return 1;
|
|
}
|
|
|
|
accountlogs = 1;
|
|
usegmtime = 0;
|
|
loguniqueid = 0;
|
|
loguserfield = 0;
|
|
|
|
if (!(v = ast_variable_browse(cfg, "csv"))) {
|
|
ast_config_destroy(cfg);
|
|
return 0;
|
|
}
|
|
|
|
for (; v; v = v->next) {
|
|
if (!strcasecmp(v->name, "usegmtime")) {
|
|
usegmtime = ast_true(v->value);
|
|
} else if (!strcasecmp(v->name, "accountlogs")) {
|
|
/* Turn on/off separate files per accountcode. Default is on (as before) */
|
|
accountlogs = ast_true(v->value);
|
|
} else if (!strcasecmp(v->name, "loguniqueid")) {
|
|
loguniqueid = ast_true(v->value);
|
|
} else if (!strcasecmp(v->name, "loguserfield")) {
|
|
loguserfield = ast_true(v->value);
|
|
}
|
|
}
|
|
ast_config_destroy(cfg);
|
|
return 1;
|
|
}
|
|
|
|
static int append_string(char *buf, const char *s, size_t bufsize)
|
|
{
|
|
int pos = strlen(buf), spos = 0, error = -1;
|
|
|
|
if (pos >= bufsize - 4)
|
|
return -1;
|
|
|
|
buf[pos++] = '\"';
|
|
|
|
while(pos < bufsize - 3) {
|
|
if (!s[spos]) {
|
|
error = 0;
|
|
break;
|
|
}
|
|
if (s[spos] == '\"')
|
|
buf[pos++] = '\"';
|
|
buf[pos++] = s[spos];
|
|
spos++;
|
|
}
|
|
|
|
buf[pos++] = '\"';
|
|
buf[pos++] = ',';
|
|
buf[pos++] = '\0';
|
|
|
|
return error;
|
|
}
|
|
|
|
static int append_int(char *buf, int s, size_t bufsize)
|
|
{
|
|
char tmp[32];
|
|
int pos = strlen(buf);
|
|
|
|
snprintf(tmp, sizeof(tmp), "%d", s);
|
|
|
|
if (pos + strlen(tmp) > bufsize - 3)
|
|
return -1;
|
|
|
|
strncat(buf, tmp, bufsize - strlen(buf) - 1);
|
|
pos = strlen(buf);
|
|
buf[pos++] = ',';
|
|
buf[pos++] = '\0';
|
|
|
|
return 0;
|
|
}
|
|
|
|
static int append_date(char *buf, struct timeval when, size_t bufsize)
|
|
{
|
|
char tmp[80] = "";
|
|
struct ast_tm tm;
|
|
|
|
if (strlen(buf) > bufsize - 3)
|
|
return -1;
|
|
|
|
if (ast_tvzero(when)) {
|
|
strncat(buf, ",", bufsize - strlen(buf) - 1);
|
|
return 0;
|
|
}
|
|
|
|
ast_localtime(&when, &tm, usegmtime ? "GMT" : NULL);
|
|
ast_strftime(tmp, sizeof(tmp), DATE_FORMAT, &tm);
|
|
|
|
return append_string(buf, tmp, bufsize);
|
|
}
|
|
|
|
static int build_csv_record(char *buf, size_t bufsize, struct ast_cdr *cdr)
|
|
{
|
|
|
|
buf[0] = '\0';
|
|
/* Account code */
|
|
append_string(buf, cdr->accountcode, bufsize);
|
|
/* Source */
|
|
append_string(buf, cdr->src, bufsize);
|
|
/* Destination */
|
|
append_string(buf, cdr->dst, bufsize);
|
|
/* Destination context */
|
|
append_string(buf, cdr->dcontext, bufsize);
|
|
/* Caller*ID */
|
|
append_string(buf, cdr->clid, bufsize);
|
|
/* Channel */
|
|
append_string(buf, cdr->channel, bufsize);
|
|
/* Destination Channel */
|
|
append_string(buf, cdr->dstchannel, bufsize);
|
|
/* Last Application */
|
|
append_string(buf, cdr->lastapp, bufsize);
|
|
/* Last Data */
|
|
append_string(buf, cdr->lastdata, bufsize);
|
|
/* Start Time */
|
|
append_date(buf, cdr->start, bufsize);
|
|
/* Answer Time */
|
|
append_date(buf, cdr->answer, bufsize);
|
|
/* End Time */
|
|
append_date(buf, cdr->end, bufsize);
|
|
/* Duration */
|
|
append_int(buf, cdr->duration, bufsize);
|
|
/* Billable seconds */
|
|
append_int(buf, cdr->billsec, bufsize);
|
|
/* Disposition */
|
|
append_string(buf, ast_cdr_disp2str(cdr->disposition), bufsize);
|
|
/* AMA Flags */
|
|
append_string(buf, ast_channel_amaflags2string(cdr->amaflags), bufsize);
|
|
/* Unique ID */
|
|
if (loguniqueid)
|
|
append_string(buf, cdr->uniqueid, bufsize);
|
|
/* append the user field */
|
|
if(loguserfield)
|
|
append_string(buf, cdr->userfield,bufsize);
|
|
/* If we hit the end of our buffer, log an error */
|
|
if (strlen(buf) < bufsize - 5) {
|
|
/* Trim off trailing comma */
|
|
buf[strlen(buf) - 1] = '\0';
|
|
strncat(buf, "\n", bufsize - strlen(buf) - 1);
|
|
return 0;
|
|
}
|
|
return -1;
|
|
}
|
|
|
|
static int writefile(char *s, char *acc)
|
|
{
|
|
char tmp[PATH_MAX];
|
|
FILE *f;
|
|
|
|
if (strchr(acc, '/') || (acc[0] == '.')) {
|
|
ast_log(LOG_WARNING, "Account code '%s' insecure for writing file\n", acc);
|
|
return -1;
|
|
}
|
|
|
|
snprintf(tmp, sizeof(tmp), "%s/%s/%s.csv", ast_config_AST_LOG_DIR,CSV_LOG_DIR, acc);
|
|
|
|
ast_mutex_lock(&acf_lock);
|
|
if (!(f = fopen(tmp, "a"))) {
|
|
ast_mutex_unlock(&acf_lock);
|
|
ast_log(LOG_ERROR, "Unable to open file %s : %s\n", tmp, strerror(errno));
|
|
return -1;
|
|
}
|
|
fputs(s, f);
|
|
fflush(f);
|
|
fclose(f);
|
|
ast_mutex_unlock(&acf_lock);
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
static int csv_log(struct ast_cdr *cdr)
|
|
{
|
|
FILE *mf = NULL;
|
|
/* Make sure we have a big enough buf */
|
|
char buf[1024];
|
|
char csvmaster[PATH_MAX];
|
|
snprintf(csvmaster, sizeof(csvmaster),"%s/%s/%s", ast_config_AST_LOG_DIR, CSV_LOG_DIR, CSV_MASTER);
|
|
if (build_csv_record(buf, sizeof(buf), cdr)) {
|
|
ast_log(LOG_WARNING, "Unable to create CSV record in %d bytes. CDR not recorded!\n", (int)sizeof(buf));
|
|
return 0;
|
|
}
|
|
|
|
/* because of the absolutely unconditional need for the
|
|
highest reliability possible in writing billing records,
|
|
we open write and close the log file each time */
|
|
ast_mutex_lock(&mf_lock);
|
|
if ((mf = fopen(csvmaster, "a"))) {
|
|
fputs(buf, mf);
|
|
fflush(mf); /* be particularly anal here */
|
|
fclose(mf);
|
|
mf = NULL;
|
|
ast_mutex_unlock(&mf_lock);
|
|
} else {
|
|
ast_mutex_unlock(&mf_lock);
|
|
ast_log(LOG_ERROR, "Unable to re-open master file %s : %s\n", csvmaster, strerror(errno));
|
|
}
|
|
|
|
if (accountlogs && !ast_strlen_zero(cdr->accountcode)) {
|
|
if (writefile(buf, cdr->accountcode))
|
|
ast_log(LOG_WARNING, "Unable to write CSV record to account file '%s' : %s\n", cdr->accountcode, strerror(errno));
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
static int unload_module(void)
|
|
{
|
|
ast_cdr_unregister(name);
|
|
loaded = 0;
|
|
return 0;
|
|
}
|
|
|
|
static int load_module(void)
|
|
{
|
|
int res;
|
|
|
|
if (!load_config(0)) {
|
|
return AST_MODULE_LOAD_DECLINE;
|
|
}
|
|
|
|
if ((res = ast_cdr_register(name, ast_module_info->description, csv_log))) {
|
|
ast_log(LOG_ERROR, "Unable to register CSV CDR handling\n");
|
|
} else {
|
|
loaded = 1;
|
|
}
|
|
return res;
|
|
}
|
|
|
|
static int reload(void)
|
|
{
|
|
if (load_config(1)) {
|
|
loaded = 1;
|
|
} else {
|
|
loaded = 0;
|
|
ast_log(LOG_WARNING, "No [csv] section in cdr.conf. Unregistering backend.\n");
|
|
ast_cdr_unregister(name);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Comma Separated Values CDR Backend",
|
|
.load = load_module,
|
|
.unload = unload_module,
|
|
.reload = reload,
|
|
.load_pri = AST_MODPRI_CDR_DRIVER,
|
|
);
|