Logger og lagring

Les loggen

1. Åpne Settings > Logs (innstillinger > logger). Eieren og adminene ser den.
2. Velg et Level (nivå): Every line (hver linje), Warnings and errors (advarsler og feil) eller Errors only (bare feil).
3. Skriv i Text (tekst) for å beholde linjer med de ordene. Store og små bokstaver spiller ingen rolle.
4. Sett From (fra) og To (til) for å begrense dagene; To er med. Trykk på Apply (bruk).
5. Bla med Newer (nyere) og Older (eldre), 100 linjer om gangen, nyeste først. Du skal bare se linjer som passer.

Del loggen

1. Under Settings > Logs trykker du på Download (last ned). Du får de nyeste linjene, opptil 2 MB, som en tekstfil.
2. Legg den ved der du ber om hjelp. Se Få hjelp.

Nøkler, tokens og passord er allerede maskert som [hidden]. Les gjennom filen én gang før du legger den ut likevel: navn på titler, mapper og serveradressen din er fortsatt synlige.

Hvor filene ligger

Settings > This app > Storage (lagring) viser hver sti slik HolyArrs ser den, med ledig plass på disken. I Docker er dette stier inne i containeren.

Sti	Inneholder
Konfigurasjonsmappe	Alle data i HolyArrs
holyarrs.db	Hoveddatabase
holyarrs-events.db	Historikkdatabase
Mappene for backuper, artwork og logger	Inne i konfigurasjonsmappen
Bibliotekmapper, nedlasterens lagringsmappe	Mediene og nedlastingene dine

«free space unknown» betyr at systemet ikke oppga det.

Loggfilen er logs/holyarrs.log i konfigurasjonsmappen. Ved 5 MB flyttes den til logs/holyarrs.log.1, så loggene holder seg rundt 10 MB. docker logs holyarrs viser den samme utskriften.

Hvis det ikke fungerer

Symptom: siden Logs mangler. Årsak: bare eieren og adminene ser den. Løsning: spør en av dem.

Symptom: en sti ser feil ut. Årsak: i Docker viser Storage stier i containeren. Løsning: sammenlign med volumkoblingene dine. Se Mapper.

For viderekomne

Hvordan nivået gjettes

Nivået kommer fra ordene i linjen. «failed», «crashed» og «error» markerer feil. «could not», «refused» og «timed out» markerer advarsler.

Hva som maskeres

Hver linje maskeres når den skrives, og igjen når den leses eller lastes ned:

• Hver lagret nøkkel, token, passord og webhook-lenke, også i lenke-escapede former og base64.
• Gamle verdier. Når en hemmelighet endres eller fjernes, skrives begge loggfilene om med den maskert før den gamle verdien fjernes.
• Navn og passord i lenker: http://user:pass@host blir http://[hidden]@host.
• Lenkeparametere som apikey=, token=, passkey=, password=.
• Par med et hemmelig navn: API key, token, password, secret, cookie, authorization, setup code. Verdier i anførselstegn maskeres til avsluttende anførselstegn.
• Bearer- og basic-tokens, API-nøkler i HolyArrs (hak_...), oppsettkoden for første oppstart og lange tokenlignende strenger.

Linjeskift og fargekoder for terminal inne i verdier vises escapet, så en verdi kan ikke late som den er en ny linje. Lagrede verdier på 4 eller 5 tegn maskeres bare som et helt ord, og aldri når de er et vanlig ord som admin eller test.

API

Rute	Hvem	Hva
GET /api/v1/app/storage	Change settings	Stier med ledig plass
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Eier, adminer	Linjer og et totalt antall
GET /api/v1/logs/download	Eier, adminer	Nyeste 2 MB som ren tekst

API-nøkler trenger admin-omfanget for alle tre.

Relatert

• Få hjelp
• Helsesjekker
• Backuper