Logs en opslag

De log lezen

1. Open Settings > Logs (Instellingen > Logs). De eigenaar en beheerders zien deze pagina.
2. Kies een Level (niveau): Every line (elke regel), Warnings and errors (waarschuwingen en fouten) of Errors only (alleen fouten).
3. Typ in Text (tekst) om regels met die woorden te houden. Hoofdletters maken niet uit.
4. Stel From (van) en To (tot) in om de dagen te beperken; To hoort erbij. Klik op Apply (toepassen).
5. Blader met Newer (nieuwer) en Older (ouder), 100 regels per keer, nieuwste eerst. Je ziet nu alleen passende regels.

De log delen

1. Klik op Settings > Logs op Download (downloaden). Je krijgt de nieuwste regels, tot 2 MB, als tekstbestand.
2. Voeg het toe waar je om hulp vraagt. Zie Hulp krijgen.

Sleutels, tokens en wachtwoorden zijn al gemaskeerd als [hidden]. Lees het bestand toch eerst een keer door voordat je het plaatst: namen van titels, mappen en het adres van je server blijven zichtbaar.

Waar bestanden staan

Settings > This app > Storage (Instellingen > Deze app > Opslag) toont elk pad zoals HolyArrs het ziet, met de vrije ruimte op die schijf. In Docker zijn dit paden binnen de container.

Pad	Bevat
Configuratiemap	Alle gegevens van HolyArrs
holyarrs.db	Hoofddatabase
holyarrs-events.db	Geschiedenisdatabase
Mappen voor backups, artwork en logs	Binnen de configuratiemap
Bibliotheekmappen, opslagmap van de downloader	Je media en downloads

“free space unknown” betekent dat het systeem het niet doorgaf.

Het logbestand is logs/holyarrs.log in de configuratiemap. Bij 5 MB gaat het naar logs/holyarrs.log.1, dus de logs blijven rond 10 MB. docker logs holyarrs toont dezelfde uitvoer.

Als het niet werkt

Symptoom: de pagina Logs ontbreekt. Oorzaak: alleen de eigenaar en beheerders zien hem. Oplossing: vraag het aan een van hen.

Symptoom: een pad ziet er verkeerd uit. Oorzaak: in Docker toont Storage paden van de container. Oplossing: vergelijk met je volume-koppelingen. Zie Mappen.

Voor gevorderden

Hoe niveaus worden geraden

Het niveau komt uit woorden in de regel. “failed”, “crashed” en “error” markeren fouten. “could not”, “refused” en “timed out” markeren waarschuwingen.

Wat wordt gemaskeerd

Elke regel wordt gemaskeerd bij het schrijven, en opnieuw bij het lezen of downloaden:

• Elke bewaarde sleutel, token, elk wachtwoord en elke webhooklink, ook in link-escaped en base64-vorm.
• Oude waarden. Verandert of verdwijnt een geheim, dan worden beide logbestanden herschreven met het geheim gemaskeerd voordat de oude waarde wordt weggegooid.
• Namen en wachtwoorden in links: http://user:pass@host wordt http://[hidden]@host.
• Linkparameters zoals apikey=, token=, passkey=, password=.
• Paren met een geheime naam: API key, token, password, secret, cookie, authorization, setup code. Waarden tussen aanhalingstekens worden gemaskeerd tot het sluitende aanhalingsteken.
• Bearer- en basic-tokens, HolyArrs-API-sleutels (hak_...), de installatiecode van de eerste start en lange tokenachtige tekenreeksen.

Regeleinden en kleurcodes van de terminal binnen waarden worden getoond als escape-tekens, zodat een waarde geen nieuwe regel kan nabootsen. Bewaarde waarden van 4 of 5 tekens worden alleen gemaskeerd als heel woord, en nooit als het een gewoon woord is zoals admin of test.

API

Route	Wie	Wat
GET /api/v1/app/storage	Change settings	Paden met vrije ruimte
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Eigenaar, beheerders	Regels en een totaal
GET /api/v1/logs/download	Eigenaar, beheerders	Nieuwste 2 MB als platte tekst

API-sleutels hebben voor alle drie de admin-scope nodig.

Gerelateerde pagina’s

• Hulp krijgen
• Gezondheidscontroles
• Backups