Logi i miejsce zapisu

Czytaj log

1. Otwórz Settings > Logs (Ustawienia > Logi). Widzi to właściciel i administratorzy.
2. Wybierz Level (poziom): Every line (każda linia), Warnings and errors (ostrzeżenia i błędy) albo Errors only (tylko błędy).
3. Wpisz coś w Text (tekst), żeby zostawić linie z tymi słowami. Wielkość liter nie ma znaczenia.
4. Ustaw From (od) i To (do), żeby ograniczyć dni; To jest wliczone. Kliknij Apply (zastosuj).
5. Przeglądaj przyciskami Newer (nowsze) i Older (starsze), po 100 linii, od najnowszych. Powinny być widoczne tylko pasujące linie.

Udostępnij log

1. W Settings > Logs kliknij Download (pobierz). Dostaniesz najnowsze linie, do 2 MB, jako plik tekstowy.
2. Dołącz go tam, gdzie prosisz o pomoc. Zobacz Uzyskaj pomoc.

Klucze, tokeny i hasła są już zamaskowane jako [hidden]. Mimo to przeczytaj plik raz przed wysłaniem: nazwy tytułów, folderów i adres twojego serwera pozostają widoczne.

Gdzie są pliki

Settings > This app > Storage (Ustawienia > Ta aplikacja > Miejsce zapisu) wylicza każdą ścieżkę tak, jak widzi ją HolyArrs, razem z wolnym miejscem na jej dysku. W Dockerze są to ścieżki wewnątrz kontenera.

Ścieżka	Zawiera
Folder konfiguracji	Wszystkie dane HolyArrs
holyarrs.db	Główna baza danych
holyarrs-events.db	Baza danych historii
Foldery backupów, grafik i logów	Wewnątrz folderu konfiguracji
Foldery biblioteki, folder zapisu downloadera	Twoje multimedia i pobrane pliki

„free space unknown“ (wolne miejsce nieznane) znaczy, że system tego nie podał.

Plik logu to logs/holyarrs.log w folderze konfiguracji. Przy 5 MB trafia do logs/holyarrs.log.1, więc logi zajmują około 10 MB. docker logs holyarrs pokazuje te same dane.

Jeśli to nie działa

Objaw: nie ma strony Logs. Przyczyna: widzi ją tylko właściciel i administratorzy. Rozwiązanie: poproś jednego z nich.

Objaw: jakaś ścieżka wygląda źle. Przyczyna: w Dockerze Storage pokazuje ścieżki kontenera. Rozwiązanie: porównaj je ze swoimi mapowaniami wolumenów. Zobacz Foldery.

Dla zaawansowanych

Jak zgaduje się poziomy

Poziom wynika ze słów w linii. „failed“, „crashed“ i „error“ oznaczają błędy. „could not“, „refused“ i „timed out“ oznaczają ostrzeżenia.

Co jest maskowane

Każda linia jest maskowana przy zapisie i jeszcze raz przy odczycie lub pobraniu:

• Każdy zapisany klucz, token, hasło i link webhooka, także w postaci zakodowanej w linku i w base64.
• Stare wartości. Gdy sekret się zmienia lub jest usuwany, oba pliki logów są przepisywane z jego zamaskowaniem, zanim stara wartość zostanie porzucona.
• Nazwy i hasła w linkach: http://user:pass@host zamienia się w http://[hidden]@host.
• Parametry linków, takie jak apikey=, token=, passkey=, password=.
• Pary z nazwą sekretu: API key, token, password, secret, cookie, authorization, setup code. Wartości w cudzysłowie są maskowane do zamykającego cudzysłowu.
• Tokeny bearer i basic, klucze API HolyArrs (hak_...), kod konfiguracji pierwszego uruchomienia i długie ciągi podobne do tokenów.

Podziały linii i kody kolorów terminala wewnątrz wartości są pokazywane jako ciągi znaków ucieczki (escape), więc wartość nie może podrobić nowej linii. Zapisane wartości o długości 4 lub 5 znaków są maskowane tylko jako całe słowo i nigdy, gdy są pospolitym słowem, jak admin czy test.

API

Trasa	Kto	Co
GET /api/v1/app/storage	Change settings	Ścieżki z wolnym miejscem
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Właściciel, administratorzy	Linie i suma
GET /api/v1/logs/download	Właściciel, administratorzy	Najnowsze 2 MB jako zwykły tekst

Klucze API potrzebują zakresu admin dla wszystkich trzech.

Powiązane strony

• Uzyskaj pomoc
• Kontrole kondycji
• Backupy