Логи й сховище

Читання логу

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 сховище показує шляхи контейнера. Рішення: порівняй зі своїми зіставленнями volume. Див. Теки.

Для досвідчених

Як вгадується рівень

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

Що маскується

Кожен рядок маскується під час запису, а потім ще раз під час читання чи завантаження:

• Кожен збережений ключ, токен, пароль і посилання webhook, зокрема у вигляді з екрануванням посилання та в 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.

Пов’язане

• Отримати підтримку
• Перевірки справності
• Бекапи