Логирование в BILLmanager
BILLmanager сохраняет информацию о работе платформы в лог-файлы. Данные из лог-файлов могут быть использованы для диагностики работы платформы.
Настройка логирования
Уровень логирования определяет насколько детально будет отображена информация в логах. Чем выше значение, тем более подробная информация записывается в лог.
Уровни логирования:
- 1 — замечания;
- 2 — критические ошибки;
- 3 — ошибки;
- 4 — предупреждения;
- 5 — информация о запросах;
- 6 — расширенная информация;
- 7 — сообщения удалённых сервисов;
- 8 — трассировка кода;
- 9 — отладочная информация.
Обратите внимание!
Детализированные логи занимают больше места на диске. После завершения диагностики рекомендуем вернуть уровень логирования к значению по умолчанию.
Перейдите в раздел Настройки → Настройка логирования → выберите модули → нажмите кнопку:
- Изменить, чтобы настроить уровень логирования для выбранных модулей;
- По умолчанию, чтобы удалить из конфигурационного файла настройку логирования для выбранных модулей. Будет использовано значение уровня логирования модуля * Все модули;
- Максимальный, чтобы установить для выбранных модулей максимальный уровень логирования.
Обратите внимание
Изменение уровня логирования для * Все модули приведёт к изменению уровня для всех модулей со статусом "Настройка логирования по умолчанию" 
.
Изменение уровня логирования через конфигурационный файл
Изменение уровня логирования через веб-интерфейс доступно не для всех лог-файлов, так как они могут отсутствовать в разделе Настройка логирования. Вы можете изменить уровень логирования через добавление записи в файл /usr/local/mgr5/etc/debug.conf. Подробнее см. статью в документации COREmanager Настройка логирования (debug.conf).
Чтобы изменить уровень логирования:
- Подключитесь к серверу с BILLmanager по SSH.
Добавьте в файл /usr/local/mgr5/etc/debug.conf строку с названием модуля и необходимым уровнем логирования. Например, запись для лог-файла модуля pmvmmgr6.log:
pmvmmgr6.* 9CODE
При изменении уровня логирования для основного лога платформы billmgr.log потребуется перезапуск платформы:
killall coreПри изменении уровня логирования для ihttpd.log потребуется перезапуск веб-сервера ihttpd:
systemctl restart ihttpdЧтобы вернуть уровень логирования к значению по умолчанию, удалите добавленные строки из файла /usr/local/mgr5/etc/debug.conf.
Перечень лог-файлов
Лог-файлы хранятся в директории /usr/local/mgr5/var/.
Архивные лог-файлы хранятся в директории /usr/local/mgr5/var/logs/.
Основные лог-файлы
| Имя файла | Содержимое |
|---|---|
| billmgr.log | содержит операции BILLmanager |
| billmaintain.log | лог-файл утилиты sbin/billmaintain, выполняющей операции по расписанию |
| billmgr.auth.log | журнал авторизаций в BILLmanager |
| billmgr.long.log | журнал долгих запросов к панели BILLmanager. По умолчанию в журнал записываются операции, время выполнения которых превысило пять минут |
| billfix.log | логи операций, которые исправляют ошибки данных в BILLmanager |
| globalindex.log | логи утилиты sbin/globalindex, которая выполняет индексацию записей БД для работы Глобального поиска |
| ihttpd.log | логи работы веб-сервера ihttpd |
| licctl.log | проверка и активация лицензии на ПО |
| longtask.log | обработка фоновых задач |
| mgrctl.log | лог-файл работы утилиты mgrctl, обеспечивающей взаимодействие с ПО BILLmanager |
| mysql.log | логи работы утилиты sbin/mysql-billmgr, обеспечивающей подключение к БД BILLmanager в интерактивном режиме |
| mysqlstat.log | статистика по работе СУБД |
| ntemail.log | отправка email-сообщений |
| ntinternal.log | отправка сообщений в модуль Уведомления BILLmanager |
| ntmessenger.log | отправка сообщений в мессенджеры |
| ntsms.log | отправка СМС-сообщений |
| pkgcheck.log | логи работы утилиты etc/scripts/pkgcheck.sh, отвечающей за исправление проблем с пакетами ПО |
| pkg.log | работа с пакетами ПО BILLmanager в системе средствами пакетного менеджера ОС |
| qrcode.log | логи работы утилиты cgi/qrcode для генерации QR-кода при настройке Двухэтапной аутентификации |
| remotetaskctl.log | логи модуля Проксирование задач |
| usagestat.log | логи сбора статистики |
| xmlinstall.log | кэширование xml-файлов для ускорения работы платформы |
Шлюзы сообщений
Связанные статьи:
| Имя файла | Модуль |
|---|---|
| gwclickatell.log | СМС-шлюз Clickatell |
| gwdevinotele.log | СМС-шлюз Devino Telecom |
| gwgreensms.log | СМС-шлюз GREENSMS |
| gwmobilmoney.log | СМС-шлюз MobilMoney |
| gwqtelecom.log | СМС-шлюз QuickTelecom |
| gwsmsc.log | СМС-шлюз SMS-центр |
| gwsmscustom.log | СМС-шлюз http-SMS |
| gwsmstraffic.log | СМС-шлюз SMS Traffic |
| gwturbosms.log | СМС-шлюз TurboSMS |
| gwlocalmail.log | СМС-шлюз Clickatell |
| gwremotemail.log | работы со сторонними сервисами почты (gmail, yandex, mail и т.д.) через POP3, IMAP, SMTP |
| gwtelegram.log | шлюз Telegram |
| telegram_webhook.log | логи обработчика обратных запросов от Telegram |
Проверка номера телефона
Связанные статьи:
| Имя файла | Модуль |
|---|---|
| fgsmsc.log | SMS-центр (звонок) |
| fgtelesign.log | TeleSign |
| fgsmsgate.log | остальные СМС-шлюзы |
Обработка услуг
Связанные статьи:
| Имя файла | Название обработчика услуг |
|---|---|
| pmauto.log | "Без обработки" |
| pmazure.log | Microsoft Windows Azure Pack |
| pmbillmgr.log | Перепродажа через BILLmanager |
| pmcpanel.log | cPanel |
| pmdcimgr6.log | DCImanager 6 |
| pmdcimgr.log | DCImanager 5 |
| pmdirecti.log | ResellerClub |
| pmdnsmgr.log | DNSmanager |
| pmdrs.log | DRS |
| pmenom.log | Enom |
| pmenomssl.log | Enom SSL |
| pmepp.log | EPP-сервер |
| pmevonames.log | EvoNames |
| pmglobalsign.log | GlobalSign |
| pmgogetssl.log | GoGetSSL |
| pmhostmaster.log | HostMaster |
| pmipmgr.log | IPmanager |
| pmispmgr4.log | ISPmanager 4 |
| pmispmgr5.log | ISPmanager 5 |
| pmispmgr6.log | ISPmanager 6 |
| pmleadertelecom.log | LeaderTelecom |
| pmmanual.log | Ручная обработка |
| pmmastername.log | .mastername |
| pmnamecheapdomain.log | Namecheap (домены) |
| pmnamecheapssl.log | Namecheap (SSL) |
| pmnaunet.log | NauNet |
| pmnic.log | RU-Center |
| pmnorid.log | Norid |
| pmonlinenic.log | OnlineNIC |
| pmopenprovider.log | OpenProvider |
| pmopenstack.log | OpenStack |
| pmopenstackvds.log | OpenStack (VPS) |
| pmplesk.log | Plesk |
| pmr01.log | R01 |
| pmregru.log | REG.RU |
| pmresellerclub.log | ResellerClub |
| pmshellscripts.log | ShellScripts |
| pmthesslstore.log | The SSL Store |
| pmtucows.log | Tucows |
| pmukrnames.log | Ukrnames |
| pmvdsmgr.log | VDSmanager |
| pmveeam.log | Veeam |
| pmvmmgr6-iaas.log | VMmanager 6 IaaS |
| pmvmmgr6.log | VMmanager 6 |
| pmvmmgr.log | VMmanager |
| pmvmware.log | VMware vCloud Director |
| pmvmwarevds.log | VMware vCloud Director (VPS) |
| pmwebnames.log | WebNames |
Методы оплаты
Лог-файлы взаимодействия биллинговой платформы с модулями оплаты описаны в статьях раздела Подключение методов оплаты.
Онлайн-кассы
Связанные статьи:
| Имя файла | Модуль онлайн-кассы |
|---|---|
| cratol.log | АТОЛ Онлайн (старая версия) |
| cratolv4.log | АТОЛ Онлайн v4 |
Модули для работы с запросами
Связанные статьи:
| Имя файла | Содержимое |
|---|---|
| pmtelegram.log | логи модуля по работе с запросами через Telegram |
| telegram_support_webhook.log | логи обработчика сообщений пользователя, отправленных через Telegram |
| pmomnidesk.log | логи модуля Omnidesk для работы с запросами |
| omnidesk_webhook.log | логи CGI-модуля для обработки уведомлений от Omnidesk |
Работа с логами
Модули могут записывать свои события в разные лог-файлы, поэтому название модуля в настройках логирования может отличаться от имени лог-файла.
Пример строки в лог-файле billmgr.log:
Mar 21 08:45:12 [2962:1] <название_модуля> <уровень_логирования> Query: 'SELECT nc.* FROM notifytemplate nt JOIN notifycontent nc ON nc.notifytemplate = nt.id WHERE nt.notice = 'sitebui lderopen' AND nt.project IS NULL'- Mar 21 08:45:12 — дата события в системном времени сервера;
- [2962:1] — поток лога. Уникальный идентификатор, где
- первое значение — номер процесса в ОС Linux. После перезапуска платформы BILLmanager значение изменится;
- второе — уникальный номер запроса к платформе BILLmanager. Каждый запрос имеет свой номер, так его можно отследить в логе.
- <уровень_логирования> — имеет следующие уровни:
- NOTE — замечания;
- FATAL — критические ошибки;
- ERROR — ошибки;
- WARNING — предупреждения;
- INFO — информация о запросах;
- EXTINFO — расширенная информация;
- EXT — сообщения удалённых сервисов;
- TRACE — трассировка кода;
- DEBUG — отладочная информация.
Диагностика
В этом разделе приведен пример диагностики с главным логом платформы billmgr.log. Для диагностики также могут потребоваться другие логи. Например, при проблемах с оплатой информация запишется в логи платёжного модуля, а в случае неполадок при перепродаже услуг — в лог взаимодействия продающего биллинга с перепродающим. Список всех журналов расположен по пути /usr/local/mgr5/var/. Названия логов см. в соответствующем разделе документации BILLmanager 6. Например, логи для диагностики проблем с оплатой Paymaster перечислены в статье PayMaster.
В главный лог платформы billmgr.log записываются все основные события и ошибки. Чтобы проверить наличие ошибок в основном логе, выполните команду:
grep 'ERROR' /usr/local/mgr5/var/billmgr.logЧтобы проверить логи в настоящий момент времени, выполните команду:
tail -f /usr/local/mgr5/var/billmgr.logС помощью команды для отображения логов в настоящий момент можно провести диагностику любой проблемы. Для этого:
- Откройте раздел в интерфейсе BILLmanager, где происходит некорректное поведение.
- Подключитесь к серверу с платформой по SSH.
Откройте лог в реальном времени командой:
tail -f /usr/local/mgr5/var/billmgr.logCODE- Воспроизведите некорректное поведение в интерфейсе.
В результате этих действий в логе отобразится ошибка и запрос, который следует перед ней. Это поможет выявить причину некорректного поведения.
Для детальной диагностики инструкция выше может быть использована с любым другим логом, например, логом обработчика услуг.
