Call logs allow users to see the history of the calls placed and received by Wazo.
The oldest call logs are periodically removed. See xivo-purge-db for more details.
Call logs can be accessed using the menupage.
Specifying no start date returns all available call logs. Specifying a start date and no end date returns all call logs from start date until now.
Call logs are presented in a CSV format. Here’s an example:
Call Date,Caller,Called,Period,user Field 2015-01-02T00:00:00,Alice (1001),1002,2,userfield
The CSV format has the following specifications:
- field names are listed on the first line
- fields are separated by commas:
- if there is a comma in a field value, the value is surrounded by double quotes:
- the UTF-8 character encoding is used
Call logs can also be generated manually. To do so, log on to the target Wazo server and run:
To avoid running for too long in one time, the call logs generation is limited to the N last
unprocessed CEL entries (default 20,000). This means that successive calls to
will process N more CELs, making about N/10 more calls available in call logs, going further back in
history, while processing new calls as well.
You can specify the number of CEL entries to consider. For example, to generate calls using the 100,000 last unprocessed CEL entries:
xivo-call-logs -c 100000
Regeneration of call logs¶
Since call logs are based on CEL, they can be deleted and generated without problems. To regenerate the last month of call logs:
xivo-call-logs delete -d 30 xivo-call-logs generate -d 30 // the default behavior of xivo-call-logs command is `generate`
Call logs are pre-generated from CEL entries. The generation is done automatically by xivo-call-logd. xivo-call-logs is also run nightly to generate call logs from CEL that were missed by xivo-call-logd.