Расширенное логгирование звонков: CEL — Channel Event Logging

Для подробного логирования вызовов была разработана система Channel Event Logging, которая записывает последовательность событий, происходящих на канале.

Типы CEL-событий

Таблица 1. Типы CEL-событий

Поля CEL-события

Таблица 2. Поля CEL-событий

Некоторые поля CEL-события определяются пользователем. Например полю userfield можно присвоить значение с помощью функции диалплана CHANNEL ():

exten => 102,1,Set (CHANNEL (userfield)=my userfield)

Приложения диалплана

Система CEL включает в себя одно приложение диалплана в модуле app_celgenuserevent.so. Это приложение используется для генерации пользовательских событий типа EV_USER_EVENT. Например можно логировать выбор звонящего в голосовом меню:

 exten => 7,1,CELGenUserEvent (MENU_CHOICE,Caller chose option 7)

Настройка

Настройки системы CEL хранятся в файле /etc/asterisk/cel.conf. Настройки должны указываться в разделе [general]. Список настроек:

Таблица 3. Настройки CEL

Пример настройки:
[general]
enable=yes
apps=dial,queue
events=ALL

Бэкэнды

Бэкэнды позволяют получать логи CEL-событий в различном виде. Как и в случае с системой CDR, есть несколько модулей бэкэндов для хранения логов. Здесь будут описаны несколько наиболее полезных.

cel_odbc

Модуль cel_odbc.so позволяет логировать CEL-события в базу данных с помощью ODBC. Файл настроек модуля /etc/asterisk/cel_odbc.conf. Может быть настроено несколько таблиц для хранения логов, каждая таблица — в отдельном разделе файла (Раздел начинается строчкой [имя_раздела]). Имя раздела не используется модулем и может быть любым. Список настроек, которые могут быть указаны в файле /etc/asterisk/cel_odbc.conf указан в таблице ниже.

Таблица 4. Настройки cel_odbc

В дополнение к этим значениям можно указывать еще псевдонимы, фильтры и статические данные для столбцов. Псевдоним позволяет записывать CEL-поле в столбец с другим именем, указывается опцией alias в формате:

alias имя_CEL_поля => псевдоним

Пример:
alias exten => extension

Фильтр позволяет записывать только события с определенными значениями полей. Формат:

filter имя_CEL_поля ≥ значение

Пример:
filter appname => Dial

Статические данные позволяют присваивать определенным столбцам одно и то же значение (удобно для различия событий, добавленных разными разделами файла настроек). Формат:

static «значение» ≥ имя_столбца

Пример:
static «mytable» => section

Пример настройки бэкэнда:
[mytable]
connection = asterisk
table = asterisk_cel
alias eventtime => time

 Поля CEL-события автоматически записываются в столбцы с соответствующими заголовками или с заголовками, указанными в файле /etc/asterisk/cel_odbc.conf опцией alias. Если каких-либо полей в таблице нет, то соответствующие им поля CEL-события логироваться не будут, при этом никаких сообщений об ошибке записано не будет.

Поле eventtype записывается в базу данных в виде целого числа. Ниже приведена таблица типов событий и соответствующих им чисел.

Таблица 5. Числовые значения eventtype

cel_manager

Этот модуль позволяет выводить CEL-сообщения через AMI. Его настройки хранятся в основном файле настроек CEL /etc/asterisk/cel.conf в разделе [manager]. Единственный параметр в этом разделе — enable для включения модуля, по умолчанию «no».

cel_custom

Этот модуль позволяет записывать CEL-события в файл (ы) в настраиваемом формате (обычно CSV). Настройки модуля хранятся в файле /etc/asterisk/cel_custom.conf. В файле должен быть один раздел — [mappings], в котором описываются лог-файлы и шаблоны записи событий в них. Лог-файлы будут созданы в директории /var/log/asterisk/cel-custom. В шаблонах можно использовать специальные переменные CEL и функции диалплана (в примере ниже используются функции CHANNEL (), CALLERID () и CSV_QUOTE ()).

Таблица 6. переменные CEL, которые можно использовать в [mappings]

Пример настройки cel_custom:
[mappings]
Master.csv => ${CSV_QUOTE (${eventtype})},${CSV_QUOTE (${eventtime})},
${CSV_QUOTE (${CALLERID (name)})},${CSV_QUOTE (${CALLERID (num)})},
${CSV_QUOTE (${CALLERID (ANI)})},${CSV_QUOTE (${CALLERID (RDNIS)})},
${CSV_QUOTE (${CALLERID (DNID)})},${CSV_QUOTE (${CHANNEL (exten)})},
${CSV_QUOTE (${CHANNEL (context)})},${CSV_QUOTE (${CHANNEL (channame)})},
${CSV_QUOTE (${CHANNEL (appname)})},${CSV_QUOTE (${CHANNEL (appdata)})},
${CSV_QUOTE (${CHANNEL (amaflags)})},${CSV_QUOTE (${CHANNEL (accountcode)})},
${CSV_QUOTE (${CHANNEL (uniqueid)})},${CSV_QUOTE (${CHANNEL (linkedid)})},
${CSV_QUOTE (${CHANNEL (peer)})},${CSV_QUOTE (${CHANNEL (userfield)})},
${CSV_QUOTE (${eventextra})}

В файле /etc/asterisk/cel_custom.conf весь шаблон необходимо указывать на одной строчке.

Пример лога — вызов с номера 101 на номер 103:
«2012-12-04 18:05:05»,»CHAN_START»,»device»,»101»,»»,»»,»»,»103»,»from-internal»,
«SIP/101-0000000a»,»»,»»,»3»,»»,»1354629905.13»,»1354629905.13»,»»,»»,»»
«2012-12-04 18:05:05»,»APP_START»,»test101»,»101»,»101»,»»,»103»,»s»,»macro-dial-one»,
«SIP/101-0000000a»,»Dial»,»SIP/103,trI»,»3»,»»,»1354629905.13»,
«1354629905.13»,»»,»»,»»
«2012-12-04 18:05:05»,»CHAN_START»,»device»,»103»,»»,»»,»»,»s»,»from-internal»,
«SIP/103-0000000b»,»»,»»,»3»,»»,»1354629905.14»,»1354629905.13»,»»,»»,»»
«2012-12-04 18:05:07»,»ANSWER»,»device»,»103»,»103»,»»,»»,»103»,»from-internal»,
«SIP/103-0000000b»,»AppDial»,» (Outgoing Line)»,»3»,»»,»1354629905.14»,
«1354629905.13»,»»,»»,»»
«2012-12-04 18:05:07»,»ANSWER»,»test101»,»101»,»101»,»»,»103»,»s»,»macro-dial-one»,
«SIP/101-0000000a»,»Dial»,»SIP/103,trI»,»3»,»»,»1354629905.13»,
«1354629905.13»,»»,»»,»»
«2012-12-04 18:05:07»,»BRIDGE_START»,»test101»,»101»,»101»,»»,»103»,»s»,»macro-dial-one»,»SIP/101-0000000a»,»Dial»,»SIP/103,trI»,»3»,»»,»1354629905.13»,»1354629905.13»,»»,»»,»»
«2012-12-04 18:05:09»,»BRIDGE_END»,»test101»,»101»,»101»,»»,»103»,»s»,
«macro-dial-one»,»SIP/101-0000000a»,»Dial»,»SIP/103,trI»,»3»,»»,»1354629905.13»,
«1354629905.13»,»»,»»,»»
«2012-12-04 18:05:09»,»HANGUP»,»device»,»103»,»103»,»»,»»,»»,»macro-dial-one»,
«SIP/103-0000000b»,»AppDial»,» (Outgoing Line)»,»3»,»»,»1354629905.14»,
«1354629905.13»,»»,»»,»16,»
«2012-12-04 18:05:09»,»CHAN_END»,»device»,»103»,»103»,»»,»»,»»,»macro-dial-one»,
«SIP/103-0000000b»,»AppDial»,» (Outgoing Line)»,»3»,»»,»1354629905.14»,
«1354629905.13»,»»,»»,»»
«2012-12-04 18:05:09»,»APP_END»,»test101»,»101»,»101»,»»,»103»,»s»,»macro-dial-one»,
«SIP/101-0000000a»,»Dial»,»SIP/103,trI»,»3»,»»,»1354629905.13»,
«1354629905.13»,»»,»»,»
«2012-12-04 18:05:09»,»HANGUP»,»test101»,»101»,»101»,»»,»103»,»103»,»from-internal»,
«SIP/101-0000000a»,»»,»»,»3»,»»,»1354629905.13»,»1354629905.13»,
»»,»»,»16,SIP/101-0000000a,ANSWER»
«2012-12-04 18:05:09»,»CHAN_END»,»test101»,»101»,»101»,»»,»103»,»103»,»from-internal»,
«SIP/101-0000000a»,»»,»»,»3»,»»,»1354629905.13»,»1354629905.13»,»»,»»,»»
«2012-12-04 18:05:09»,»LINKEDID_END»,»test101»,»101»,»101»,»»,»103»,»103»,»from-internal»,
«SIP/101-0000000a»,»»,»»,»3»,»»,»1354629905.13»,»1354629905.13»,»»,»»,» «