Loggar och lagring

Läs loggen

1. Öppna Settings > Logs (inställningar > loggar). Ägaren och admins ser den.
2. Välj en Level (nivå): Every line (varje rad), Warnings and errors (varningar och fel) eller Errors only (bara fel).
3. Skriv i Text för att behålla rader med de orden. Versaler och gemener spelar ingen roll.
4. Ange From (från) och To (till) för att begränsa dagarna; To är inkluderad. Klicka på Apply (använd).
5. Bläddra med Newer (nyare) och Older (äldre), 100 rader i taget, nyast först. Du ska bara se matchande rader.

Dela loggen

1. På Settings > Logs klickar du på Download (ladda ner). Du får de senaste raderna, upp till 2 MB, som en textfil.
2. Bifoga den där du ber om hjälp. Se Få support.

Nycklar, token och lösenord är redan maskerade som [hidden]. Läs ändå igenom filen en gång innan du postar den: namn på titlar, mappar och din serveradress syns kvar.

Var filerna ligger

Settings > This app > Storage (inställningar > den här appen > lagring) listar varje sökväg så som HolyArrs ser den, med ledigt utrymme på dess disk. I Docker är det sökvägar inne i containern.

Sökväg	Innehåller
Konfigurationsmapp	All HolyArrs-data
holyarrs.db	Huvuddatabas
holyarrs-events.db	Historikdatabas
Mapparna för backuper, omslagsbilder och loggar	Inne i konfigurationsmappen
Biblioteksmappar, nedladdarens sparmapp	Dina media och nedladdningar

“free space unknown” betyder att systemet inte sa något.

Loggfilen är logs/holyarrs.log i konfigurationsmappen. Vid 5 MB flyttas den till logs/holyarrs.log.1, så loggarna håller sig runt 10 MB. docker logs holyarrs visar samma utdata.

Om det inte fungerar

Symptom: sidan Logs saknas. Orsak: bara ägaren och admins ser den. Lösning: be en av dem.

Symptom: en sökväg ser fel ut. Orsak: i Docker visar Storage containerns sökvägar. Lösning: jämför med dina volymmappningar. Se Mappar.

För experter

Hur nivåerna gissas

Nivån kommer från orden på raden. “failed”, “crashed” och “error” markerar fel. “could not”, “refused” och “timed out” markerar varningar.

Vad som maskeras

Varje rad maskeras när den skrivs, och igen när den läses eller laddas ner:

• Varje sparad nyckel, token, lösenord och webhook-länk, även i länkkodad form och base64.
• Gamla värden. När en hemlighet ändras eller tas bort skrivs båda loggfilerna om med den maskerad innan det gamla värdet släpps.
• Namn och lösenord i länkar: http://user:pass@host blir http://[hidden]@host.
• Länkparametrar som apikey=, token=, passkey=, password=.
• Par med ett hemligt namn: API key, token, password, secret, cookie, authorization, setup code. Värden inom citattecken maskeras till det avslutande citattecknet.
• Bearer- och basic-token, HolyArrs API-nycklar (hak_...), konfigurationskoden vid första start och långa token-liknande strängar.

Radbrytningar och färgkoder för terminal inne i värden visas som escape-tecken, så att ett värde inte kan fejka en ny rad. Sparade värden på 4 eller 5 tecken maskeras bara som ett helt ord, och aldrig när de är ett vanligt ord som admin eller test.

API

Route	Vem	Vad
GET /api/v1/app/storage	Change settings (ändra inställningar)	Sökvägar med ledigt utrymme
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Ägare, admins	Rader och en total
GET /api/v1/logs/download	Ägare, admins	De senaste 2 MB som ren text

API-nycklar behöver admin-scope för alla tre.

Relaterat

• Få support
• Hälsokontroller
• Backuper