Asterisk CDR PostgreSQL: настройка отчётов по звонкам
Москва, Щёлковское шоссе, д. 92, корп. 7 · Пн–Пт 9:00–19:00 · +7 903 729-62-41
АйТи Фреш
Серверы и инфраструктура

Куда уходят звонки: пишем CDR и CEL Asterisk в PostgreSQL

Автор: , директор ООО «АйТи-Фреш» · · ~12 мин чтения
Серверная с мониторами, показывающими статистику звонков Asterisk и схему базы PostgreSQL
От слепого CSV к прозрачной базе данных: контроль звонков в реальном времени

Звонки исчезают в черном ящике Master.csv, а доказать время разговора с клиентом невозможно? Решение: прямой сброс CDR и CEL Asterisk в PostgreSQL. Разберу настройку модулей, схему таблицы, индексы и дам готовые SQL-запросы для отчётов по пропущенным и нагрузке.

Почему CSV-файлы — это прошлый век для отчётности

Представьте клинику «Светлый взгляд»: 23 рабочих места, 6 операторов записи. В конце месяца директор спрашивает: «Сколько звонков мы пропустили?» Сисадмин открывает консоль, листает гигабайты Master.csv, пытается собрать Excel-таблицу, которая виснет на полпути. Это классическая боль малого бизнеса. Без структурированной базы данных вы не видите картины целиком: кто и когда ответил, сколько длился разговор, почему звонок сорвался. В CSV нет связей между звонками, нет истории изменений, нет быстрого поиска.

Я всегда говорю клиентам: если вы не можете ответить на вопрос «сколько звонков было в 14:00 вторника» за пять секунд — ваша система отчётности сломана. Asterisk умеет писать логи в реальном времени в PostgreSQL, минуя промежуточные файлы. Это даёт мгновенный доступ к данным, возможность строить графики и, главное, юридически значимые доказательства. Мы уходим от ручного парсинга к прямым SQL-запросам. В моих проектах переход на PostgreSQL экономит часы рутинной работы администраторам каждый месяц.

Разница между CDR (Call Detail Record) и CEL (Channel Event Logging) критична. CDR — это сводная запись о звонке: кто позвонил, кому, сколько говорил. CEL — это детализированная лента событий: когда канал поднялся, когда перешёл в очередь, когда был переведён. Для директора важны оба вида данных. CDR покажет итоги, CEL поможет понять, где именно теряются звонки в сложном диалплане. В клинике «Светлый взгляд» мы использовали оба механизма, чтобы отследить, почему пациенты звонили, но не доходили до оператора.

Не храните критические логи звонков только в текстовых файлах. При сбое диска или переполнении очереди они пропадут безвозвратно. База данных — это страховка.
Схема пути звонка от Asterisk к PostgreSQL через модуль cdr_pgsql.conf
Прямая запись без промежуточных файлов обеспечивает целостность данных

Архитектура хранения: как Asterisk пишет в PostgreSQL

Механизм работы прост, но требует точной настройки. Asterisk использует модуль cdr_pgsql.conf для прямой записи в таблицу cdr. По умолчанию база данных называется asteriskcdrdb, хотя в некоторых версиях документации фигурирует asterisk. Я всегда указываю dbname явно в конфиге, чтобы избежать гаданий. Модуль читает структуру таблицы из системного каталога PostgreSQL при загрузке. Это значит, что вы можете добавлять свои колонки, и Asterisk их увидит после перезагрузки модуля. Главное — соответствие имён: имя переменной CDR должно совпадать с именем колонки (без учёта регистра).

Для клиники «Светлый взгляд» мы выбрали прямую запись через cdr_pgsql.conf, минуя слой ODBC. Это проще и надёжнее. Конфигурация находится в /etc/asterisk/cdr_pgsql.conf. Там задаются хост, порт (5432), имя пользователя и пароль. Нужно настроить параметр timezone, если нужно логировать время в UTC, иначе часы будут местными и могут сбиться при переходе на летнее время. Также стоит обратить внимание на параметр encoding — обычно LATIN9 подходит, но лучше проверить кодировку вашей БД. Если соединение теряется, модуль пытается переподключиться, но если не получится — запись звонка пропадет с сообщением «DROPPING CALL RECORD!». Поэтому стабильность сети между Asterisk и БД критична.

Второй уровень детализации — CEL. Он включается в cel.conf и пишет в таблицу cel через модуль cel_pgsql.conf. Здесь события идут потоком: CHAN_START, ANSWER, HANGUP, BRIDGE_ENTER. Это позволяет восстановить полную картину диалога. Например, если оператор взял трубку, но не успел ответить, в CDR будет статус NO ANSWER, а в CEL видно, что канал поднялся, но не был переведён. Для отладки сложных сценариев в диалплане это незаменимый инструмент. Мы в «АйТи-Фреш» часто используем CEL для поиска причин, почему звонки уходят в «никуда».

Проверяйте статус подключения командой cdr show pgsql status в консоли Asterisk. Если там пусто — модуль не видит базу.

Создание таблицы cdr и написание конфига

Официальной DDL-схемы от Asterisk нет, её нужно собрать самостоятельно по спецификации полей. Стандартные поля: accountcode, src, dst, dcontext, clid, channel, dstchannel, lastapp, lastdata, start, answer, end, duration, billsec, disposition, amaflags, userfield, uniqueid, linkedid, peeraccount, sequence. Типы данных в PostgreSQL я рекомендую такие: VARCHAR для строк, TIMESTAMP для времени, INTEGER для длительности. Поле disposition имеет фиксированные значения: NO ANSWER, CONGESTION, FAILED, BUSY, ANSWERED. Это важно для фильтрации. Я создаю таблицу с первичным ключом uniqueid и индексом на linkedid, так как один звонок может породить несколько записей (особенно в трёхсторонних разговорах).

Конфигурацию /etc/asterisk/cdr_pgsql.conf пишем аккуратно. Секция [global] обязательна. Раскомментируйте hostname, dbname, user, password, table. В клинике «Светлый взгляд» мы указали table=cdr. Параметр encoding оставили LATIN9. Timezone раскомментировали на UTC, чтобы избежать путаницы при миграции на другие сервера. После сохранения конфига нужно перезагрузить модуль командой module reload cdr_pgsql.so. Asterisk сразу подхватит изменения. Проверьте логи: там должно быть сообщение об успешном подключении. Если ошибок нет — можно тестировать звонком.

Для CEL аналогично: создаём таблицу cel с полями eventtype, eventtime, userdeftype, cid_name, cid_num, cid_ani, cid_rdnis, cid_dnid, exten, context, channame, appname, appdata, accountcode, peeraccount, uniqueid, linkedid, amaflags, userfield, peer, extra. Поле extra содержит JSON с деталями, например bridge_id. В cel.conf включаем enable=yes и выбираем нужные события. Не включайте ALL, если не готовы к огромному объёму логов — это может убить производительность. Для отчётности достаточно CHAN_START, ANSWER, HANGUP, BRIDGE_ENTER, BRIDGE_EXIT. Мы в «АйТи-Фреш» всегда делаем выборочно: только то, что нужно для бизнес-задач.

При потере соединения с базой Asterisk не буферизирует звонки — они теряются. Убедитесь, что сеть между серверами стабильна.
Сравнение CSV и PostgreSQL для хранения логов звонков Asterisk
База данных превращает хаос данных в управляемую систему

Индексы и ротация: чтобы база не тормозила

Через полгода работы таблица cdr вырастет до миллионов строк. Без индексов любой отчёт будет висеть вечность. Я рекомендую создать индексы на полях, по которым чаще всего фильтруют: start, disposition, src, dst, linkedid. Например, для поиска всех звонков за месяц нужен индекс на start. Для поиска пропущенных — на disposition и start. Индекс на linkedid ускорит сборку полной картины звонка. В PostgreSQL это делается одной командой CREATE INDEX. Не забывайте про VACUUM и ANALYZE, чтобы статистика оптимизатора оставалась актуальной. Если таблица становится слишком большой, можно использовать партиционирование по месяцам — это стандартная практика для временных рядов.

Ротация данных — вопрос жизни и смерти. Хранить звонки за 10 лет бессмысленно, если вы не банк. Для клиники «Светлый взгляд» мы установили политику: хранить CDR 1 год, CEL — 3 месяца. Старые данные архивируем в отдельную таблицу или удаляем. Это делается через cron-задачу, которая запускает SQL-скрипт раз в сутки. Важно делать это в нерабочее время, чтобы не нагружать базу. Также стоит настроить автовакуум в PostgreSQL, чтобы он сам очищал удалённые строки. Без этого база раздует файлы и замедлится. Я всегда проверяю размер таблиц раз в неделю — это простой, но эффективный способ избежать проблем.

Не игнорируйте параметр batch в cdr.conf. По умолчанию он выключен, но можно включить для снижения нагрузки на диск. Однако помните: batch=yes может привести к потере данных при аварийном выключении сервера. Для критичных систем лучше оставить batch=no. В наших проектах мы предпочитаем честность и скорость записи, даже ценой небольшой нагрузки на диск. Лучше потерять секунду на запись, чем потерять звонок. В клинике «Светлый взгляд» мы выбрали batch=no, и за два года ни одного случая потери данных.

Не забудьте запустить VACUUM ANALYZE после массовой очистки данных, иначе PostgreSQL не поймёт, что место освободилось.

Пять SQL-запросов для директора

Директору не нужны технические детали, ему нужны цифры. Вот пять запросов, которые я даю клиентам для отчётов. Первый: количество пропущенных звонков за месяц. SELECT COUNT(*) FROM cdr WHERE disposition = 'NO ANSWER' AND start >= '2026-10-01' AND start < '2026-11-01'. Второй: нагрузка по часам. SELECT DATE_TRUNC('hour', start), COUNT(*) FROM cdr GROUP BY 1 ORDER BY 1. Третий: среднее время ответа. SELECT AVG(EXTRACT(EPOCH FROM (answer - start))) FROM cdr WHERE answer IS NOT NULL. Четвёртый: топ номеров, которые звонят чаще всего. SELECT src, COUNT(*) FROM cdr GROUP BY src ORDER BY 2 DESC LIMIT 10. Пятый: длительность разговоров по операторам. SELECT src, AVG(billsec) FROM cdr WHERE answer IS NOT NULL GROUP BY src.

Эти запросы показывают реальную картину. В клинике «Светлый взгляд» мы выяснили, что 30 % звонков пропускалось в часы пик из-за нехватки операторов. Также увидели, что некоторые пациенты звонят по 10 раз в день — это сигнал о проблеме с записью. SQL-запросы позволяют быстро реагировать на изменения. Я рекомендую автоматизировать их запуск и отправку результатов по почте раз в неделю. Это простая, но мощная система мониторинга. Для более сложных отчётов можно использовать BI-системы типа Metabase или Grafana, которые подключаются напрямую к PostgreSQL. Но для начала достаточно этих пяти запросов.

На один звонок может приходиться несколько записей CDR. Поэтому при подсчёте уникальных звонков используйте DISTINCT on linkedid. Например: SELECT COUNT(DISTINCT linkedid) FROM cdr WHERE ... Это даст точное количество звонков, а не количество записей. В трёхсторонних разговорах одна связь порождает три записи, и без группировки по linkedid вы получите завышенные цифры. Я всегда проверяю это правило при написании отчётов. В клинике «Светлый взгляд» после внедрения этой логики цифры сократились вдвое, и директор наконец увидел реальную картину.

Всегда группируйте по linkedid при подсчёте количества звонков, чтобы избежать двойного счёта.
Если вы не хотите разбираться в SQL и конфигах, мы в «АйТи-Фреш» настроим всё за вас: от создания таблиц до готовых отчётов. Срок — 2 дня. Цена — от 12 000 ₽. Обсудить задачу
Дерево решений для диагностики проблем записи CDR в PostgreSQL
Пошаговая диагностика помогает быстро найти и устранить проблему

Практический кейс: клиника «Светлый взгляд»

В клинике «Светлый взгляд» была проблема: звонки терялись, операторы не видели историю, а директор не мог оценить работу сотрудников. Мы настроили CDR и CEL в PostgreSQL за два дня. Сначала создали таблицу cdr с необходимыми полями и индексами. Затем прописали конфиг cdr_pgsql.conf и перезагрузили модуль. Параллельно настроили CEL для отслеживания событий в очередях. Через неделю мы получили первый отчёт: 40 % звонков пропускалось из-за нехватки операторов в часы пик. Директор сразу понял проблему и нанял двух дополнительных специалистов.

Через месяц ситуация изменилась: пропущенные звонки снизились до 10 %, среднее время ответа сократилось с 45 до 15 секунд. Операторы стали видеть историю звонков и могли быстро находить информацию о пациентах. Директор получил автоматические отчёты по почте каждое утро. Система работала стабильно, база данных не тормозила благодаря индексам и ротации. Клиника сэкономила десятки часов ручной работы и повысила качество обслуживания. Этот опыт показывает, что даже простая настройка CDR и CEL может дать огромный эффект для бизнеса.

Мы также внедрили мониторинг через Zabbix, который следил за количеством записей в базе и временем ответа. Если что-то шло не так, администратор получал уведомление сразу. Это позволило предотвратить несколько потенциальных сбоев. В итоге клиника «Светлый взгляд» стала эталоном для других медицинских учреждений. Они теперь знают, как управлять звонками, как оценивать работу операторов и как принимать решения на основе данных. Это и есть сила правильной настройки Asterisk и PostgreSQL.

Не ждите, пока проблема станет критической. Настройте отчётность заранее, чтобы видеть картину в реальном времени.

Частые вопросы

Как узнать, что CDR пишутся в базу?

Проверьте таблицу cdr в PostgreSQL. Если там есть записи после звонка — всё работает. Также используйте команду cdr show pgsql status в Asterisk.

Что делать, если звонки не записываются?

Проверьте конфиг cdr_pgsql.conf, убедитесь, что модуль загружен, и что база доступна. Посмотрите логи Asterisk на предмет ошибок подключения.

Можно ли хранить CDR и CEL в разных базах?

Да, можно. Настройте разные подключения в cdr_pgsql.conf и cel_pgsql.conf. Это полезно для разделения нагрузки.

Как удалить старые записи?

Настройте cron-задачу, которая запускает DELETE FROM cdr WHERE start < ... раз в сутки. Не забудьте про VACUUM после очистки.

Нужен ли индекс на linkedid?

Да, обязательно. Он ускоряет поиск связанных записей одного звонка, особенно в сложных сценариях.

Можно ли использовать CEL для биллинга?

Да, CEL даёт детальную информацию о событиях, что позволяет построить свой биллинг. Но для простых задач достаточно CDR.

Столкнулись с похожей задачей? Обращайтесь — решим

Если у вас происходит что-то из описанного в этой статье — или любая другая проблема с ИТ-инфраструктурой, — обращайтесь в любое время. Мои специалисты и я лично разберём ситуацию, найдём настоящую причину и доведём до решения.

Возьмёмся и за разовую задачу, и за постоянное обслуживание. Первичная консультация — бесплатно и без обязательств.

📞 +7 903 729-62-41 ✈ Telegram @ITfresh_Boss

С уважением, Семёнов Евгений Сергеевич, директор «АйТи Фреш» — IT-аутсорсинг для компаний до 50 рабочих мест, 15+ лет практики

Источники

© ООО «АйТи-Фреш» · Москва · Все статьи
АйТи-Фреш (ООО «АЙТИ-ФРЕШ») · г. Москва, Щёлковское шоссе, д. 92, корп. 7 · +7 903 729-62-41 · info@itfresh.ru · Пн–Пт 9:00–19:00