Logs og lager

Læs loggen

1. Åbn Settings > Logs (Indstillinger > Logs). Ejeren og adminerne kan se den.
2. Vælg et Level (niveau): Every line (hver linje), Warnings and errors (advarsler og fejl) eller Errors only (kun fejl).
3. Skriv i Text (tekst) for kun at beholde linjer med de ord. Store og små bogstaver er ligegyldige.
4. Sæt From (fra) og To (til) for at begrænse dagene; To er med. Klik på Apply (anvend).
5. Bladr med Newer (nyere) og Older (ældre), 100 linjer ad gangen, nyeste først. Du bør kun kunne se linjer, der passer.

Del loggen

1. Klik på Download under Settings > Logs. Du får de nyeste linjer, op til 2 MB, som en tekstfil.
2. Vedhæft den dér, hvor du beder om hjælp. Se Få support.

Nøgler, tokens og adgangskoder er allerede skjult som [hidden]. Læs alligevel filen igennem én gang, før du poster den: navne på titler, mapper og din serveradresse er stadig synlige.

Hvor filerne ligger

Settings > This app > Storage (Indstillinger > Denne app > Lager) viser hver sti, som HolyArrs ser den, med ledig plads på dens disk. I Docker er det stier inde i containeren.

Sti	Indeholder
Konfigurationsmappe	Alle HolyArrs’ data
holyarrs.db	Hoveddatabase
holyarrs-events.db	Historikdatabase
Mapper til backups, artwork og logs	Inde i konfigurationsmappen
Biblioteksmapper, downloaderens gemmemappe	Dine medier og downloads

“free space unknown” betyder, at systemet ikke oplyste det.

Logfilen er logs/holyarrs.log i konfigurationsmappen. Ved 5 MB flyttes den til logs/holyarrs.log.1, så logs holder sig omkring 10 MB. docker logs holyarrs viser det samme output.

Hvis det ikke virker

Symptom: siden Logs mangler. Årsag: kun ejeren og adminerne kan se den. Løsning: spørg en af dem.

Symptom: en sti ser forkert ud. Årsag: i Docker viser Storage containerstier. Løsning: sammenlign med dine volume-koblinger. Se Mapper.

For erfarne

Sådan gættes niveauerne

Niveauet kommer fra ord i linjen. “failed”, “crashed” og “error” markerer fejl. “could not”, “refused” og “timed out” markerer advarsler.

Hvad der bliver skjult

Hver linje bliver skjult, når den skrives, og igen, når den læses eller downloades:

• Hver gemt nøgle, token, adgangskode og webhook-link, også i link-escapede og base64-former.
• Gamle værdier. Når en hemmelighed ændres eller fjernes, bliver begge logfiler skrevet om med den skjult, før den gamle værdi fjernes.
• Navne og adgangskoder i links: http://user:pass@host bliver til http://[hidden]@host.
• Linkparametre som apikey=, token=, passkey=, password=.
• Par med et hemmeligt navn: API key, token, password, secret, cookie, authorization, setup code. Værdier i anførselstegn bliver skjult til det afsluttende anførselstegn.
• Bearer- og basic-tokens, HolyArrs API-nøgler (hak_...), opsætningskoden ved første start og lange token-lignende strenge.

Linjeskift og farvekoder til terminalen inde i værdier vises escapet, så en værdi ikke kan forfalske en ny linje. Gemte værdier på 4 eller 5 tegn bliver kun skjult som et helt ord, og aldrig når de er et almindeligt ord som admin eller test.

API

Rute	Hvem	Hvad
GET /api/v1/app/storage	Change settings (ændre indstillinger)	Stier med ledig plads
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Ejer, admins	Linjer og et samlet antal
GET /api/v1/logs/download	Ejer, admins	De nyeste 2 MB som ren tekst

API-nøgler skal have admin-scope til alle tre.

Se også

• Få support
• Tilstandstjek
• Backups