Дневници и място за файловете

Прочети дневника

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“ отбелязват предупреждения.

Какво се скрива

Всеки ред се скрива при записване и пак при четене или изтегляне:

• Всеки запазен ключ, токен, парола и 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 обхват и за трите.

Свързано

• Получи помощ
• Проверки на здравето
• Резервни копия