Logy a úložisko

Čítaj log

1. Otvor Settings > Logs (nastavenia > logy). Vidí ho vlastník a admini.
2. Vyber Level (úroveň): Every line (každý riadok), Warnings and errors (varovania a chyby) alebo Errors only (iba chyby).
3. Do Text zadaj slová, podľa ktorých sa riadky ponechajú. Na veľkosti písmen nezáleží.
4. Nastav From (od) a To (do), aby si obmedzil dni; To sa započíta. Klikni na Apply (použiť).
5. Prechádzaj cez Newer (novšie) a Older (staršie), po 100 riadkov, od najnovšieho. Mal by si vidieť iba zodpovedajúce riadky.

Zdieľaj log

1. V Settings > Logs klikni na Download (stiahnuť). Dostaneš najnovšie riadky, najviac 2 MB, ako textový súbor.
2. Pripoj ho tam, kde žiadaš o pomoc. Pozri Získanie podpory.

Kľúče, tokeny a heslá sú už zamaskované ako [hidden]. Súbor si aj tak raz prečítaj pred odoslaním: názvy titulov, priečinkov a adresa tvojho servera zostávajú viditeľné.

Kde sa súbory ukladajú

Settings > This app > Storage (nastavenia > táto aplikácia > úložisko) vypisuje každú cestu tak, ako ju vidí HolyArrs, spolu s voľným miestom na jej disku. V Dockeri ide o cesty vo vnútri kontajnera.

Cesta	Obsahuje
Konfiguračný priečinok	Všetky dáta HolyArrs
holyarrs.db	Hlavná databáza
holyarrs-events.db	Databáza histórie
Priečinky záloh, obrázkov a logov	Vo vnútri konfiguračného priečinka
Priečinky knižnice, priečinok sťahovača na ukladanie	Tvoje médiá a sťahovania

„free space unknown“ znamená, že systém voľné miesto nezistil.

Súbor logu je logs/holyarrs.log v konfiguračnom priečinku. Pri 5 MB sa presunie do logs/holyarrs.log.1, takže logy zostanú okolo 10 MB. docker logs holyarrs ukazuje ten istý výstup.

Ak to nefunguje

Príznak: stránka Logs chýba. Príčina: vidí ju iba vlastník a admini. Riešenie: požiadaj jedného z nich.

Príznak: cesta vyzerá zle. Príčina: v Dockeri Storage ukazuje cesty v kontajneri. Riešenie: porovnaj ich so svojimi mapovaniami volume. Pozri Priečinky.

Pre expertov

Ako sa odhaduje úroveň

Úroveň sa určuje podľa slov v riadku. „failed“, „crashed“ a „error“ označujú chyby. „could not“, „refused“ a „timed out“ označujú varovania.

Čo sa maskuje

Každý riadok sa maskuje pri zápise a znova pri čítaní alebo stiahnutí:

• Každý uložený kľúč, token, heslo a odkaz webhooku, aj v tvare s escapovaním odkazu a base64.
• Staré hodnoty. Keď sa tajomstvo zmení alebo odstráni, oba súbory logu sa prepíšu s jeho maskovaním skôr, než sa stará hodnota zahodí.
• Mená a heslá v odkazoch: http://user:pass@host sa zmení na http://[hidden]@host.
• Parametre odkazov ako apikey=, token=, passkey=, password=.
• Dvojice s názvom tajomstva: API key, token, password, secret, cookie, authorization, setup code. Hodnoty v úvodzovkách sa maskujú po koncovú úvodzovku.
• Tokeny typu Bearer a basic, kľúče API HolyArrs (hak_...), kód prvého spustenia a dlhé reťazce podobné tokenom.

Zalomenia riadkov a farebné kódy terminálu vo vnútri hodnôt sa zobrazujú escapované, takže hodnota nemôže predstierať nový riadok. Uložené hodnoty so 4 alebo 5 znakmi sa maskujú iba ako celé slovo a nikdy, ak ide o bežné slovo ako admin alebo test.

API

Trasa	Kto	Čo
GET /api/v1/app/storage	Change settings (meniť nastavenia)	Cesty s voľným miestom
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Vlastník, admini	Riadky a celkový počet
GET /api/v1/logs/download	Vlastník, admini	Najnovšie 2 MB ako obyčajný text

Kľúče API potrebujú pre všetky tri rozsah admin.

Súvisiace stránky

• Získanie podpory
• Kontroly stavu
• Zálohy