Call Logs

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.

Note

The oldest call logs are periodically removed. See Purge Logs for more details.

Search Dashboard

Call logs can be accessed using the menu Services ‣ IPBX ‣ Call management ‣ Call Logs page.

../../_images/search_dashboard.png

Calls Records Dashboard

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

REST API

Call logs are also available from xivo-confd REST API.

Manual generation

Call logs can also be generated manually. To do so, log on to the target XiVO server and run:

xivo-call-logs

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 xivo-call-logs 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