artem
18.12.2012
23218

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

Для логирования звонков в Asterisk обычно используется система CDR, которая хорошо работает при простых звонках, однако, при сложных сценариях с переводами и парковкой, логи CDR трудно толковать. Например, для определения, с кем именно говорил абонент, предется ориентироваться по набранным во время вызова сервисным кодам, которые могут и не иметь отношения к данному вызову.

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

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

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

Тип события

Описание

CHAN_START

Канал был создан

CHAN_END

Канал был уничтожен

LINKEDID_END

Последний канал с указанным linkedid был уничтожен

ANSWER

Канал получил ответ. На канале, созданном для исходящего вызова, это событие происходит, когда удаленный конец отвечает

HANGUP

На канале повесили трубку. Обычно за этим событием следует событие CHAN_END

APP_START

Отслеживаемое приложение начало выполнение на канале. Отслеживаемые приложения настраиваются в главном файле настроек CEL (cel.conf)

APP_END

Отслеживаемое приложение завершило выполнение на канале

PARK_START

Канал был припаркован

PARK_END

Канал покинул парковку

BRIDGE_START

Установлен мост между каналами. Событие наступает, когда каналы соединяются приложением Dial () или Queue ()

BRIDGE_UPDATE

Мост между каналами был обновлен. Событие наступает, когда какая-либо информация, связанная с мостом меняется (Например имя)

BRIDGE_END

Мост между каналами разорван

BLINDTRANSFER

На канале выполнен перевод вслепую

ATTENDEDTRANSFER

На канале выполнен управляемый перевод

USER_DEFINED

На канале произошло пользовательское событие. Такие события можно генерировать с помощью приложения CELGenUserEvent ()

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


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

Имя поля

Пример

Описание

eventtype

CHAN_START

Тип события, произошедшего на канале

eventtime

2011-10-25 15:22:53

Время происхождения события

cidname

TEST

CID-имя, установленное для канала, на котором произошло событие

cidnum

103

CID-номер, установленный для канала, на котором произошло событие

cidani

103

ANI-номер (Automatic Number Identification), установленный для канала, на котором произошло событие

cidrdnis

101

Перенаправляющий номер канала, на котором произошло событие

ciddnid

102

Набранный номер канала, на котором произошло событие

exten

102

Расширение диалплана, выполняемое в момент наступления события

context

from-internal

Контекст расширения, выполняемого в момент наступления события

channame

SIP/103

Имя канала, на котором произошло событие

appname

Dial

Имя приложения диалплана, выполняемого в момент события

appdata

SIP/102

Аргументы, переданные приложению диалплана, выполняемому в момент события

amaflags

DOCUMENTATION

AMA-флаги (Automatic Message Accounting) связанные с вызовом. Может быть OMIT, BILLING, DOCUMENTATION или Unknown

accountcode

1234

ID аккаунта. Это поле определяется пользователем и пусто по умолчанию

uniqueid

1328564546.15

Уникальный идентификатор канала, на котором произошло событие

userfield

my userfield

Любые данные, определенные пользователем

linkedid

1328564546.15

Уникальный идентификатор вызова. Он одинаков

peer

SIP/102-000058f4

Имя канала, соединенного с каналом, имя которого указано в channame


Некоторые поля 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

Опция

Пример

Описание

enable

yes

Включить / выключить CEL. По умолчанию — «no»

apps

dial, queue

Список отслеживаемых приложений. Для отслеживаемых приложений будут генерироваться события EV_APP_START и EV_APP_END. По умолчанию приложения не отслеживаются

events

CHAN_START, CHAN_END, ANSWER, HANGUP

Список событий, которые CEL будет генерировать. По умолчанию CEL не генерирует события. Для включения всех событий, следует указать значение ALL

dateformat

%F %T

Формат, в котором время будет указываться в CEL-событии. Синтаксис можно посмотреть в man-странице к функции strftime. По умолчанию используется количество секунд, прошедших с начала эпохи

Пример настройки:
[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

Опция

Пример

Описание

connection

asterisk-cel-db

Имя соединения с базой данных, настроенного в файле /etc/asterisk/res_odbc.conf (настройка ODBC — тема отдельной статьи). Параметр обязателен

table

asterisk-cel

Имя таблици в базе данных. Параметр обязателен

usegmtime

no

Использовать в CEL-событиях GMT-время вместо местного времени. По умолчанию — «no»

В дополнение к этим значениям можно указывать еще псевдонимы, фильтры и статические данные для столбцов. Псевдоним позволяет записывать 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

Тип события

Значение в столбце eventtype

CHANNEL_START

1

CHANNEL_END

2

HANGUP

3

ANSWER

4

APP_START

5

APP_END

6

BRIDGE_START

7

BRIDGE_END

8

CONF_START

9

CONF_END

10

PARK_START

11

PARK_END

12

BLINDTRANSFER

13

ATTENDEDTRANSFER

14

TRANSFER

15

HOOKFLASH

16

3WAY_START

17

3WAY_END

18

CONF_ENTER

19

CONF_EXIT

20

USER_DEFINED

21

LINKEDID_END

22

BRIDGE_UPDATE

23

PICKUP

24

FORWARD

25

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

Пример

Описание

${eventtype}

CHAN_START

Тип события

${eventtime}

2011-10-25 15:22:53

Время наступления события

${eventextra}

test test

Дополнительные данные, включенные в CEL-событие. Добавляются приложением диалплана CELGenUserEvent ()

 

Пример настройки 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»,»»,»»,» «

 

Кейсы внедрения
Asterisk от VoxLink
Узнайте, какие крупные компании уже используют Asterisk в работе.
Скачать
Подписаться
Уведомить о
guest
1 Комментарий
Старые
Новые Популярные
Межтекстовые Отзывы
Посмотреть все комментарии
Валерий
Валерий
03.08.2021 01:13

Почему никто не пишет о том, что в CEL не отображаются DTMF команды, набранные пользователями, например при донаборе при попадании на наш IVR?
 Вы же пишите, что CEL нужен «для подробного логирования вызовов«, но как это делать не видя какие команды DTMF вводил позвонивший на IVR?

Последний раз редактировалось 2 лет назад Валерий ем

Остались вопросы?

Я - Компаниец Никита, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование


ближайшие курсы

10 доводов в пользу Asterisk

Распространяется бесплатно.

Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.

Безопасен в использовании.

Любое программное обеспечение может стать объектом интереса злоумышленников, в том числе телефонная станция. Однако, сам Asterisk, а также операционная система, на которой он работает, дают множество инструментов защиты от любых атак. При грамотной настройке безопасности у злоумышленников нет никаких шансов попасть на станцию.

Надежен в эксплуатации.

Время работы серверов некоторых наших клиентов исчисляется годами. Это значит, что Asterisk работает несколько лет, ему не требуются никакие перезагрузки или принудительные отключения. А еще это говорит о том, что в районе отличная ситуация с электроэнергией, но это уже не заслуга Asterisk.

Гибкий в настройке.

Зачастую возможности Asterisk ограничивает только фантазия пользователя. Ни один конструктор шаблонов не сравнится с Asterisk по гибкости настройки. Это позволяет решать с помощью Asterisk любые бизнес задачи, даже те, в которых выбор в его пользу не кажется изначально очевидным.

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.

Повышает управляемость бизнеса.

Asterisk дает не просто набор полезных функций, он повышает управляемость организации, качества и комфортности управления, а также увеличивает прозрачность бизнеса для руководства. Достичь этого можно, например, за счет автоматизации отчетов, подключения бота в Telegram, санкционированного доступа к станции из любой точки мира.

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.