Журналы и хранилище

Читайте журнал

1. Откройте Settings > Logs (настройки > журналы). Журнал (лог) видят владелец и администраторы.
2. Выберите Level (уровень): Every line (все строки), Warnings and errors (предупреждения и ошибки) или Errors only (только ошибки).
3. Введите слова в поле Text (текст), чтобы остались строки с ними. Регистр не важен.
4. Задайте From (с) и To (по), чтобы ограничить дни; день в To входит в диапазон. Нажмите Apply (применить).
5. Листайте кнопками Newer (новее) и Older (старее), по 100 строк, сначала новые. Вы увидите только подходящие строки.

Поделитесь журналом

1. В Settings > Logs нажмите Download (скачать). Вы получите самые новые строки, до 2 MB, в текстовом файле.
2. Приложите его там, где просите о помощи. См. Как получить поддержку.

Ключи, токены и пароли уже скрыты под [hidden]. Всё равно прочитайте файл один раз перед отправкой: названия тайтлов, папок и адрес вашего сервера остаются на виду.

Где хранятся файлы

Settings > This app > Storage (настройки > это приложение > хранилище) перечисляет каждый путь так, как его видит HolyArrs, и свободное место на его диске. В Docker это пути внутри контейнера.

Путь	Что там
Папка конфигурации	Все данные HolyArrs
holyarrs.db	Основная база данных
holyarrs-events.db	База данных Истории
Папки резервных копий, обложек и журналов	Внутри папки конфигурации
Папки Медиатеки, папка сохранения загрузчика	Ваши медиафайлы и загрузки

«free space unknown» (свободное место неизвестно) значит, что система его не сообщила.

Файл журнала — logs/holyarrs.log в папке конфигурации. На 5 MB он переезжает в logs/holyarrs.log.1, так что журналы занимают около 10 MB. docker logs holyarrs показывает тот же вывод.

Если не работает

Признак проблемы: страницы Logs нет. Причина: её видят только владелец и администраторы. Решение: попросите кого-то из них.

Признак проблемы: путь выглядит неправильно. Причина: в Docker раздел Storage показывает пути внутри контейнера. Решение: сравните со своими пробросами томов. См. Папки.

Для опытных

Как определяется уровень

Уровень берётся из слов в строке. «failed», «crashed» и «error» означают ошибку. «could not», «refused» и «timed out» означают предупреждение.

Что скрывается

Каждая строка маскируется при записи и ещё раз при чтении или скачивании:

• Каждый сохранённый ключ, токен, пароль и ссылка вебхука, в том числе в виде, экранированном для ссылок, и в base64.
• Старые значения. Когда секрет меняется или удаляется, оба файла журнала переписываются со скрытым значением, и только потом старое значение забывается.
• Имена и пароли в ссылках: http://user:pass@host превращается в http://[hidden]@host.
• Параметры ссылок, такие как apikey=, token=, passkey=, password=.
• Пары с названием секрета: API key, token, password, secret, cookie, authorization, setup code. Значения в кавычках скрываются до закрывающей кавычки.
• Токены Bearer и Basic, ключи API HolyArrs (hak_...), код настройки первого запуска и длинные строки, похожие на токены.

Переносы строк и коды цветов терминала внутри значений показываются экранированными, так что значение не может подделать новую строку. Сохранённые значения из 4 или 5 символов скрываются только как целое слово и никогда, если это обычное слово вроде admin или test.

API

Маршрут	Кто	Что
GET /api/v1/app/storage	Change settings (менять настройки)	Пути и свободное место
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Владелец, администраторы	Строки и общее число
GET /api/v1/logs/download	Владелец, администраторы	Самые новые 2 MB обычным текстом

Ключам API для всех трёх нужна область admin.

См. также

• Как получить поддержку
• Проверки исправности
• Резервные копии