Logy a úložiště

Čti log

1. Otevři Settings > Logs (Nastavení > Logy). Vidí ho vlastník a správci.
2. Vyber Level (úroveň): Every line (každý řádek), Warnings and errors (varování a chyby) nebo Errors only (jen chyby).
3. Do Text zadej slova, podle kterých se řádky mají ponechat. Na velikosti písmen nezáleží.
4. Nastav From (od) a To (do), abys omezil dny; To se počítá včetně. Klikni na Apply (použít).
5. Listuj tlačítky Newer (novější) a Older (starší), po 100 řádcích, nejnovější nahoře. Měl bys vidět jen odpovídající řádky.

Sdílej log

1. Na Settings > Logs klikni na Download (stáhnout). Dostaneš nejnovější řádky, nejvýš 2 MB, jako textový soubor.
2. Přilož ho tam, kde žádáš o pomoc. Viz Získání podpory.

Klíče, tokeny a hesla jsou už zakryté jako [hidden]. Přesto si soubor před odesláním jednou projdi: názvy titulů, složek a adresa tvého serveru zůstávají vidět.

Kde se soubory ukládají

Settings > This app > Storage (Nastavení > Tato aplikace > Úložiště) vypisuje každou cestu tak, jak ji vidí HolyArrs, s volným místem na jejím disku. V Dockeru jsou to cesty uvnitř kontejneru.

Cesta	Obsahuje
Konfigurační složka	Všechna data HolyArrs
holyarrs.db	Hlavní databáze
holyarrs-events.db	Databáze historie
Složky záloh, obrázků a logů	Uvnitř konfigurační složky
Složky knihovny, složka pro ukládání ve stahovači	Tvoje média a stahování

„free space unknown“ znamená, že systém místo nesdělil.

Soubor logu je logs/holyarrs.log v konfigurační složce. Při 5 MB se přesune do logs/holyarrs.log.1, takže logy zůstávají kolem 10 MB. docker logs holyarrs ukazuje stejný výstup.

Když to nefunguje

Příznak: stránka Logs chybí. Příčina: vidí ji jen vlastník a správci. Řešení: požádej jednoho z nich.

Příznak: některá cesta vypadá špatně. Příčina: v Dockeru Storage ukazuje cesty v kontejneru. Řešení: porovnej je s mapováním svých volumů. Viz Složky.

Pro pokročilé

Jak se odhaduje úroveň

Úroveň se určuje podle slov v řádku. „failed“, „crashed“ a „error“ označují chyby. „could not“, „refused“ a „timed out“ označují varování.

Co se zakrývá

Každý řádek se zakryje při zápisu a znovu při čtení nebo stažení:

• Každý uložený klíč, token, heslo a odkaz webhooku, i ve formě s escapovanými znaky v odkazu a v base64.
• Staré hodnoty. Když se tajný údaj změní nebo odebere, oba soubory logu se přepíšou se zakrytou hodnotou, než se stará hodnota zahodí.
• Jména a hesla v odkazech: http://user:pass@host se změní na http://[hidden]@host.
• Parametry odkazů jako apikey=, token=, passkey=, password=.
• Dvojice s názvem tajného údaje: API key, token, password, secret, cookie, authorization, setup code. Hodnoty v uvozovkách se zakryjí až po koncovou uvozovku.
• Bearer a basic tokeny, API klíče HolyArrs (hak_...), kód pro první spuštění a dlouhé řetězce podobné tokenům.

Zalomení řádků a barevné kódy terminálu uvnitř hodnot se ukazují jako escapované, takže hodnota nemůže předstírat nový řádek. Uložené hodnoty o 4 nebo 5 znacích se zakrývají jen jako celé slovo a nikdy, pokud jde o běžné slovo jako admin nebo test.

API

Routa	Kdo	Co
GET /api/v1/app/storage	Change settings	Cesty s volným místem
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Vlastník, správci	Řádky a celkový počet
GET /api/v1/logs/download	Vlastník, správci	Nejnovější 2 MB jako prostý text

API klíče potřebují pro všechny tři rozsah admin.

Související

• Získání podpory
• Kontroly zdraví
• Zálohy