ClubIS ведёт текстовые логи работы модулей и фоновых служб. Все они складываются в каталог clubis-logs: для каждой программы или службы внутри создаётся своя подпапка.
¶ Где находится каталог clubis-logs
¶ Программы на рабочих местах (Windows)
В домашней папке пользователя, под которым запущен модуль:
- откройте проводник и введите в адресной строке
%USERPROFILE%; - перейдите в подпапку
clubis-logs.
¶ Программы на рабочих местах (Linux)
В домашнем каталоге пользователя:
~/clubis-logs
¶ Службы ClubIS (Windows)
Фоновые службы Windows пишут логи в каталог установки ClubIS, в подпапку clubis-logs рядом с исполняемыми файлами служб (а не в профиль системной учётной записи).
При стандартной установке это обычно:
C:\Program Files (x86)\ClubIS\Fitness 3\clubis-logs
Если ClubIS установлен в другую папку, ищите clubis-logs рядом с файлами служб (например, web-service.exe).
¶ Службы ClubIS (Linux)
На сервере площадки службы обычно запускаются от root. Их логи находятся в:
/root/clubis-logs
¶ Фоновые службы: папки логов
В clubis-logs для каждой службы используется отдельная подпапка:
| Служба | Папка в clubis-logs |
|---|---|
| Web API и интеграции | web-service |
| СКУД / проход | access-service |
| Учёт времени | time-service |
| Медиаплеер | media-service |
| События и рассылки | event-service |
| SMS | sms-service |
| Фискальные регистраторы (служба ФР) | fiscal-service |
email-service |
На сервере Linux службы запускаются автоматически при старте системы. Перезапуск выполняет администратор площадки.
¶ Программы на рабочих местах: папки логов
Имя подпапки совпадает с именем модуля в лаунчере, например:
manager— Менеджер;reception— Рецепция;admin— Администратор;fitness— Фитнес;reports— Отчёты;archiver— Архиватор.
Полный список папок виден непосредственно в каталоге clubis-logs на компьютере, где запускался модуль.
¶ Имена файлов и ротация
Файлы логов называются так:
clubis-<модуль>--<дд-мм-гггг>--<номер>.log
Пример: clubis-manager--16-12-2020--0.log — модуль Менеджер, дата лога, порядковый номер файла за этот день.
Правила ротации:
- каждый день создаётся новый лог;
- если файл превышает 200 МБ, начинается новый файл с увеличенным номером;
- при запуске любого модуля старые логи (кроме сегодняшних) автоматически упаковываются в ZIP-архив;
- при смене календарного дня во время работы программа создаёт лог за новый день и архивирует вчерашние файлы.
¶ Уровень детализации логов
¶ Программы на рабочих местах
В лаунчере ClubIS откройте Настройка → Логирование.
Уровни (от подробного к краткому):
- Отладка — максимально подробный лог; включайте при разборе ошибки по запросу поддержки;
- Информация;
- Предупреждения — уровень по умолчанию;
- Критические ошибки;
- Фатальные ошибки.
После смены уровня перезапустите модуль, логи которого нужно собрать.
¶ Службы
Уровень логирования служб настраивается в модуле Настройка служб в лаунчере: вкладка нужной службы → поле Логирование → Сохранить. Затем перезапустите службу.
¶ Отчёты о критических сбоях (дампы)
При аварийном завершении модуль может сохранить минидамп в каталог ClubIsDumps в домашней папке пользователя (на Windows — %USERPROFILE%\ClubIsDumps, на Linux — ~/ClubIsDumps). Внутри — подпапки по версии программы. Эти файлы обычно запрашивает служба поддержки.
