Журналювання

Для перегляду журналів сервісів можна використовувати скрипт bin/logs.

Приклади базового використання:

# View the web service logs
bin/logs web

# Show help
bin/logs --help

# View logs for multiple services at once
bin/logs filestore docstore web clsi

# Follow log output (like tail -f)
bin/logs -f filestore docstore web clsi

# Limit the number of lines printed (default 50)
bin/logs -n 50 web

# Show all log lines
bin/logs -n all web

# Redirect output to a file
bin/logs -n all web > web.log

Скрипт bin/logs дає змогу переглядати журнали таких сервісів: clsi, contacts, docstore, document-updater, filestore, git-bridge, mongo, notifications, real-time, redis, spelling, tags, track-changes, web, web-api, history-v1, project-history.

​

Копіювання журналів

Дивіться оригінальну документацію: https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/logging#copying-logs

Скопіюйте файли журналів з основного контейнера sharelatex на свій локальний комп’ютер:

docker cp sharelatex:/var/log/overleaf/{service-name}.log {service-name}.log

​

Збереження журналів

Контейнери Docker є ефемерними: файли й каталоги, створені всередині контейнера під час роботи (зокрема файли журналів), буде втрачено, якщо контейнер буде перестворено (наприклад, під час виконання bin/up). Щоб зберігати файли журналів між перестворенням контейнерів:

• Задайте змінну середовища OVERLEAF_LOG_PATH у файлі config/overleaf.rc, який використовує Toolkit. Це має бути каталог на хості, який буде змонтовано (bind-mount) у каталог журналів усередині контейнера sharelatex.
• Після цієї зміни та виконання bin/up -d файли журналів зберігатимуться на хості й будуть доступні безпосередньо.

Ви маєте призначити власником каталогу журналів на хості, що використовується для bind-mount, користувача www-data (uid=33) і переконатися, що права доступу — drwxr-xr-x (755).

Приклад:

chown 33:33 data/overleaf/logs
chmod 755 data/overleaf/logs