Документация Clouden
Документация
/
Документация Clouden
/
Настройки Clouden
/
Настройки
/
Логирование в Clouden
Добавить в избранное
Режим фокусировки
Документация
/
Документация Clouden
/
Настройки Clouden
/
Настройки
/
Логирование в Clouden

Логирование в Clouden

Clouden сохраняет информацию о своей работе в лог-файлы. Данные из лог-файлов могут быть использованы для диагностики работы платформы.

Настройка логирования

Уровень логирования определяет детализацию информации в логах. Чем выше значение, тем более подробная информация записывается в лог.

Уровни логирования:

  • 1 — замечания;
  • 2 — критические ошибки;
  • 3 — ошибки;
  • 4 — предупреждения;
  • 5 — информация о запросах;
  • 6 — расширенная информация;
  • 7 — сообщения удалённых сервисов (remote service notifications);
  • 8 — трассировка кода;
  • 9 — отладочная информация.
Детализированные логи занимают больше места на диске. После завершения диагностики рекомендуем вернуть уровень логирования к значению по умолчанию.

Через веб-интерфейс

Чтобы изменить уровень логирования, в главном меню перейдите в раздел Настройки → Настройка логирования → выберите модули → нажмите кнопку:

  • Изменить, чтобы настроить уровень логирования для выбранных модулей;
  • По умолчанию, чтобы удалить из конфигурационного файла настройку логирования для выбранных модулей. Будет использовано значение уровня логирования * Все модули;
  • Максимальный, чтобы установить для выбранных модулей максимальный уровень логирования.

Изменение уровня логирования для * Все модули изменит уровень для всех модулей со статусом "Настройка логирования по умолчанию" (обозначены в списке значком  ).

Если нужная служба не отображается в списке, вы можете настроить уровень её логирования через конфигурационный файл /usr/local/mgr5/etc/debug.conf. Подробнее см. статью в документации COREmanager Настройка логирования (debug.conf).

Через конфигурационный файл

Чтобы изменить уровень логирования:

  1. Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места

  2. Добавьте в файл /usr/local/mgr5/etc/debug.conf строку с названием модуля и необходимым уровнем логирования. Например, запись для лог-файла модуля pmvmmgr6.log:

    pmvmmgr6.* 9

Чтобы вернуть уровень логирования к значению по умолчанию, удалите добавленные строки из файла /usr/local/mgr5/etc/debug.conf.

При изменении уровня логирования для основного лога платформы billmgr.log может потребоваться перезапуск платформы. Перезапустить платформу можно командой:

/usr/local/mgr5/sbin/mgrctl -m billmgr -R

При изменении уровня логирования для ihttpd.log потребуется перезапуск веб-сервера ihttpd:

systemctl restart ihttpd

Перечень лог-файлов

Лог-файлы хранятся в директории /usr/local/mgr5/var/

Архивные лог-файлы хранятся в директории /usr/local/mgr5/var/logs/

Основные лог-файлы

Имя файлаСодержимое
billmgr.log

Содержит операции Clouden.

billmaintain.logЛог-файл утилиты sbin/billmaintain , выполняющей операции по расписанию.
billmgr.auth.logЖурнал авторизаций в Clouden.
billmgr.long.logЖурнал долгих запросов к панели Clouden. По умолчанию в журнал записываются операции, время выполнения которых превысило пять минут.
billfix.logЛоги операций, которые исправляют ошибки данных в Clouden.
globalindex.logЛоги утилиты sbin/globalindex, которая выполняет индексацию записей БД для работы Глобального поиска.
ihttpd.logЛоги работы веб-сервера ihttpd.
licctl.logПроверка и активация лицензии на ПО.
longtask.logОбработка фоновых задач.
mgrctl.logЛог-файл работы утилиты mgrctl, обеспечивающей взаимодействие с ПО Clouden.
mysql.logЛоги работы утилиты sbin/mysql-billmgr, обеспечивающей подключение к БД Clouden в интерактивном режиме.
mysqlstat.logСтатистика по работе СУБД.
ntemail.logОтправка email-сообщений.
ntinternal.logОтправка сообщений в модуль У ведомления Clouden.
ntmessenger.logОтправка сообщений в мессенджеры.
ntsms.logОтправка СМС-сообщений.
pkgcheck.logЛоги работы утилиты etc/scripts/pkgcheck.sh, отвечающей за исправление проблем с пакетами ПО.
pkg.logРабота с пакетами ПО Clouden в системе средствами пакетного менеджера ОС.
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.logSMS-центр (звонок).
fgtelesign.logTeleSign.
fgsmsgate.log

Остальные СМС-шлюзы.

Обработка услуг

Связанные статьи:

Имя файлаНазвание обработчика услуг
pmauto.log"Без обработки"
pmbillmgr.logПерепродажа через Clouden
pmcpanel.logcPanel
pmdcimgr6.logDCImanager 6
pmdcimgr.logDCImanager 5
pmdirecti.logResellerClub
pmdnsmgr.log DNSmanager
pmdrs.logDRS
pmenom.logEnom
pmenomssl.logEnom SSL
pmepp.logEPP-сервер
pmevonames.logEvoNames
pmglobalsign.logGlobalSign
pmgogetssl.log GoGetSSL
pmhostmaster.logHostMaster
pmipmgr.logIPmanager
pmispmgr4.logISPmanager 4
pmispmgr5.logISPmanager 5
pmispmgr6.logISPmanager 6
pmleadertelecom.logLeaderTelecom
pmmanual.log Ручная обработка
pmmastername.logmastername
pmnamecheapdomain.logNamecheap (домены)
pmnamecheapssl.logNamecheap (SSL)
pmnaunet.logNauNet RU
pmnic.logRU-Center
pmnorid.logNorid
pmonlinenic.logOnlineNIC
pmopenprovider.logOpenProvider
pmopenstack.logOpenStack
pmopenstackvds.logOpenStack (VPS)
pmplesk.logPlesk
pmr01.logR01
pmregru.logREG.RU
pmresellerclub.logResellerClub
pmshellscripts.logShellScripts
pmthesslstore.logThe SSL Store
pmtucows.logTucows
pmukrnames.logUkrnames
pmvdsmgr.logVDSmanager
pmveeam.logVeeam
pmvmmgr6-iaas.logVMmanager 6 IaaS
pmvmmgr6.logVMmanager 6
pmvmmgr.logVMmanager
pmvmware.log VMware vCloud Director
pmvmwarevds.logVMware vCloud Director (VPS)
pmwebnames.logWebNames

Методы оплаты

Лог-файлы взаимодействия биллинговой платформы с модулями оплаты описаны в статьях раздела Подключение методов оплаты.

Онлайн-кассы

Связанные статьи:

Имя файлаМодуль онлайн-кассы
cratol.logАТОЛ Онлайн (неподдерживаемая версия)
cratolv4.logАТОЛ Онлайн v4
cratolv5.logАТОЛ Онлайн v5

Модули для работы с запросами

Связанные статьи:

Имя файлаСодержимое
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. После перезапуска платформы Clouden значение изменится;
    • второе — уникальный номер запроса к платформе Clouden. Каждый запрос имеет свой номер, так его можно отследить в логе.
  • <уровень_логирования> —  может принимать следующие значения:
    • NOTE — замечания;
    • FATAL — критические ошибки;
    • ERROR — ошибки;
    • WARNING — предупреждения;
    • INFO — информация о запросах;
    • EXTINFO — расширенная информация;
    • EXT — сообщения удалённых сервисов (remote service notifications);
    • TRACE — трассировка кода;
    • DEBUG — отладочная информация.

Диагностика

В этом разделе приведён пример диагностики с главным логом платформы billmgr.log. Для диагностики также могут потребоваться другие логи. Например, при проблемах с оплатой информация запишется в логи платёжного модуля, а в случае неполадок при перепродаже услуг — в лог взаимодействия продающего биллинга с перепродающим. Список всех лог-файлов расположен по пути /usr/local/mgr5/var/. Имена логов конкретного сервиса указаны в статье об интеграции с этим сервисом. Например, логи для диагностики проблем с оплатой PayMaster перечислены в статье PayMaster.

В главный лог платформы billmgr.log записываются все основные события и ошибки. Чтобы проверить наличие ошибок в основном логе, выполните команду:

grep 'ERROR' /usr/local/mgr5/var/billmgr.log

Чтобы проверить логи в настоящий момент времени, выполните команду:

tail -f /usr/local/mgr5/var/billmgr.log

С помощью команды для отображения логов можно провести диагностику большинства проблем. Для этого:

  1. Откройте раздел в интерфейсе Clouden, где происходит некорректное поведение.
  2. Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.

  3. Откройте лог в реальном времени командой:

    tail -f /usr/local/mgr5/var/billmgr.log
  4. Воспроизведите некорректное поведение в интерфейсе.

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

Аналогичным образом вы можете провести диагностику с любым лог-файлом. Например, логом обработчика услуг.

Ротация логов

Ротация логов — автоматический процесс архивации и очистки файлов журналирования при достижении установленного размера. В Clouden размер каждого лог-файла по умолчанию ограничен 100 МБ. Все логи записываются в каталог /usr/local/mgr5/var/. Когда файл достигает максимального размера, система:

  1. Перемещает содержимое лога в каталог /usr/local/mgr5/var/logs/ и сжимает в архив.
  2. Добавляет к имени архивированного файла суффикс, содержащий:
    • дату и время создания в формате ГГГГ_ММ_ДД_ЧЧ_ММ_СС;
    • порядковый номер. Обеспечивает уникальность имени, если за одну секунду ротируются несколько файлов.
  3. Удаляет содержимое оригинального файла. Первой строкой записывает в него полное имя созданного архива.
Пример имени архивированного файла после ротации:
billmgr.log.2026_02_03_15_3022_01.0.gz

Настройка параметров ротации

Вы можете управлять ротацией логов с помощью глобальных параметров в файле /usr/local/mgr5/etc/debug.conf:

  • max_log_size — максимальный размер лог-файла в байтах, при превышении которого запускается ротация; значение по умолчанию — 104857600 (100 МБ);
  • color — использование цветного форматирования в логах. Допустимые значения:
    • on — включено, значение по умолчанию;
    • off — выключено.
  • storage — способ вывода логов. Допустимые значения:
    • file — запись в файл, значение по умолчанию.
    • console — вывод в stdout.

Ротация логов Python-плагинов

Для плагинов, написанных на языке Python и использующих модуль billmgr.logging из Clouden SDK (Software Development Kit — набор разработчика), реализована автоматическая ротация логов при достижении размера 100 МБ. Изменение размера файла не поддерживается. Имя созданного архива при ротации не записывается.

Может быть полезно

Статьи из базы знаний: