Поиск и устранение проблем Asterisk и связанного с ним оборудования: Log-файлы

Log-файлы. Для чего они нужны, где их искать и как использовать?

Log-файлы это друзья инженера и если проблема «плавающая», то не редко только логи могут прояснить ситуацию. Как известно, любая программа пишет свой лог файл, куда заносит информацию о том, что произошло, что вызвало ошибку или, к примеру, чего не хватает для нормальной работы и.т.д.

В конфигурационном каталоге asterisk (по умолчанию /etc/asterisk) находится несколько файлов, отвечающих за логи:
1.Файл asterisk.conf содержит переменную astlogdir, которая указывает местоположение логов asterisk (по умолчанию — /var/log/asterisk)

2.Файл конфигурации логов — logger.conf. В нем можно прописывать различные опции для ведения логов, а также указать, какие виды информации в эти логи должны будут сохранять. Так же для каждого вида информации можно предусмотреть свой файл логов.

Полный список и расположение лог файлов следующий:

•  /var/log/asterisk/fail2ban — Лог-файл событий модуля fail2ban
•  /var/log/asterisk/freepbx.log — Лог-файл событий событий модулей FreePBX
•  /var/log/asterisk/freepbx_security.log — Лог-файл событий событий безопасности
•  /var/log/asterisk/full — Лог-файл событий Asterisk всех уровней. Этот файл чаще всего используется для поиска старых звонков.
•  /var/log/dmesg — Лог-файл событий событий уровня ядра
•  /var/log/httpd/access_log — Лог-файл событий доступа к Apache
•  /var/log/httpd/error_log — Лог-файл где можно посмотреть ошибки web сервера Apache
•  /var/log/messages — Системный журнал событий Linux
•  /var/log/yum.log — Лог-файл где записаны действия выполненных через yum

Обратите внимание, что в зависимости от используемого дистрибутива Linux место расположение log-файлов может отличаться.Тем не менее, настраивать какие-то дополнительные условия для логирования мы не будем. Как было написано выше – стандартный путь логов следующий: /var/log/asterisk. Перейдем туда

Как можете видеть – здесь содержится огромное количество логов очередей, фаервола и много чего еще, но в данном случае нас интересует полный лог станции с одноименным названием full. Есть два способа прочесть содержимое:

1 С помощью текстового редактора (vi/vim/nano)
2 С помощью утилиты grep

И мы даже не будем рассматривать просмотр лога с помощью текстового редактора. Вне зависимости от того, какой текстовый редактор вы будите использовать открывать весь лог-файл не оптимальное решение и удобнее использовать для этого утилиту grep. Grep это утилита командной строки которая используется для фильтрации текста по заданному шаблону. Пример: предположим, что интересующий момент произошел сегодня ночью (20 августа) в 04:42:58.

Используем следующую команду # grep ’04:42:58′ full

Как можете видеть утилита вывела все события которые произошли в указанное время, однако нам нужен полный лог связанный с этим событием и есть возможность его вывести игнорируя все остальные события. Для этого обратите внимание на значение [C-00004aec]

Это UID звонка и для каждого он уникален и позволяет по нему просмотреть все события связанные с этим звонком.

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

Некоторые дополнительные ключи команды grep:

•   -v : Выводи реверсивные результаты. Вместо того чтобы вывести строки где искомое было найдено — выводи те строки где искомой подстроки нет.
•   -c : Отключает стандартный способ вывода результата и вместо этого отображает только число обозначающее количество найденых строк.
•   -i : Делает поиск регистронезависимым
•   -w : Ведет поиск по цельным словам. Например, при обычном поиске строки ‘200’ grep может найти слово ‘81002002020. А если используется данный ключ то будут найдены только строки где есть слово ‘200’.
•   -l : Выводит только имена файлов, где была найдена строка.
•   -r : Производит поиск рекурсивно по всем поддиректориям.

Этого будет более чем достаточно для просмотра логов. Подробнее по мониторингу системы вы можете узнать по следующей ссылке

Просмотр логов через Web-интерфейс

По каким-то причинам у вас не может оказаться доступа на АТС по ssh и в таком случае вы можете просмотреть логи на web-интерфейсе FreePBX с помощью модуля Asterisk Log Files. Этот модуль расположен по следующему пути: Reports — Asterisk Log Files

После попадаем мы на следующую страничку

Как можете видеть, уже без каких либо манипуляций модуль подгрузил последние логи со станции без каких либо фильтров

Есть возможность просматривать все логи не только за сегодняшнее число, но и за прошлые, а так же конкретно какой-то log-файл просмотреть.

Давайте для примера посмотрим подробную статистику по одному из звонков.

Как можете видеть поле Filtre выполняет ту же роль что и утилита grep

Тем не менее, советуем при возможности просматривать логи подключившись к серверу напрямую используя терминальный клиент PuTTy который, к примеру, поддерживает операцию копировать/вставить, что упрощает работу при анализе лога.

Модуль Support FreePBX

Обратите внимание, что данный модуль был включен в дистрибутив начиная с 13 версиии FreePBX.

Это очень полезная секция, которая позволяет получить доступ к логам. Благодаря ей можно скачать zip-файл, который будет содержать отчет с необходимой информацией, а так же логами для дальнейшего их исследования. Чтоб попасть на страничку модуля нужно пройти по следующему пути: Admin — System Admin

И мы попадаем в System Admin.

Здесь множество полезных утилит для администратора, но в данной статье нас интересует модуль Support.  вниз и выбираем раздел

Выбираем раздел «Support»

На этой странице и можно скачать zip-архив с отчетом. Путем выбора ответа Yes/No можно сформировать свой отчет. Пункты выбора следующие:

• FreePBX Versions — Список всех установленных модулей и их версии
• System Information — Информация об операционной системе
• Asterisk Logs — Журналы событий Asterisk за последние 24 часа
• Firewall Setting — Вывод текущих настроек ip-tables
• ASTDB Dump — Полный дамп ASTBD (Не путать с MySQL)
• License Information — Информация о лицензировании и статусе сервера
• Dialplan — Полный дайл-план, созданный FreePBX (включая кастомные файлы _custom)
• SIP Settings — Настройки SIP (Может содержать секретную информацию)
• PJSIP Settings — Настройки PJSIP (Может содержать секретную информацию)
• IAX Settings — Настройки IAX (Может содержать секретную информацию)

После того, как мы включили интересующие нас пункты чтоб сформировать отчет и скачать достаточно нажать download и загрузить архив к себе компьютер. Для теста, давайте, соберем наиболее полный отчет выставив на всех пунктах Yes.

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

Так же вам могут быть интересны следующие темы по логированию:

Сбор логов на одном сервере с нескольких других, посредством SysLog

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

Сбор статистики звонков по региональным направлениям