Логи сервера

Логи сервера — расположение и описание логов компонентов сервера RuDesktop на файловой системе. Раздел полезен при диагностике сбоев и обращении в техническую поддержку

Расположение логов

Все файлы логов находятся в каталоге:

/var/log/rudesktop/

Важно

Каталог имеет права доступа 700 и принадлежит пользователю rudesktop — для просмотра содержимого требуются права sudo

Состав логов

Файл

Назначение

rudesktop.log

Логи Django-части сервера: веб-интерфейс, API, фоновые задачи, синхронизация с LDAP/AD

execution.log

Логи модуля выполнения политик и задач (executor)

server.log

Логи нативных компонентов relay / rz (Rust): подключения клиентов, маршрутизация трафика

updater.log

Логи службы обновления сервера

redis.log

Логи встроенного Redis

superset.log

Логи модуля аналитики (Apache Superset). Присутствует только при установленном модуле аналитики

domains/job_<domain_id>.log

Подробные логи последней синхронизации с конкретным доменом LDAP/AD

hosts/<имя_файла>.log

Архивные логи Ansible-задач, выполнявшихся в старой архитектуре (на устройство)

client_logs/<server_id>/...

Логи клиента RuDesktop, загруженные с устройства через веб-интерфейс

archive_<timestamp>/*.gz

Сжатые архивы старых файлов rudesktop.log.* и server.log.*

Примечание

В текущей архитектуре логи отдельных запусков политик (job logs) сохраняются не в файлы, а в базу данных (модель LogEvent). Каталог hosts/ остаётся для совместимости со старыми задачами

Ротация и очистка

Серверные логи ротируются автоматически:

  • rudesktop.log и execution.log ротируются Python-обработчиком ConcurrentRotatingFileHandler — при достижении размера 5 МБ файл переименовывается в *.log.1, *.log.2 и т.д., хранится 5 копий

  • Команда maintain (запускается по расписанию) сжимает в gzip файлы rudesktop.log.* и server.log.* старше 1 дня в подкаталог archive_<timestamp>/ и удаляет файлы и архивы старше 30 дней

  • superset.log ротируется самим модулем аналитики (по времени) и командой maintain не обрабатывается

Подсказка

Параметр срока хранения можно переопределить флагом --log-delete-after-days:

rude maintain --log-delete-after-days 60

Связанные команды

  • clean_audit_logs — удаление старых записей аудита из базы данных

  • clean_job_logs — удаление старых логов задач из базы данных

  • diag — сбор всех логов и конфигов в один архив для передачи в техническую поддержку