Jurnale și stocare

Citește jurnalul

1. Deschide Settings > Logs (Setări > Jurnale). Proprietarul și administratorii îl văd.
2. Alege un Level (nivel): Every line (fiecare linie), Warnings and errors (avertismente și erori) sau Errors only (doar erori).
3. Scrie în Text ca să păstrezi liniile cu acele cuvinte. Literele mari sau mici nu contează.
4. Setează From (de la) și To (până la) ca să limitezi zilele; To e inclusă. Apasă Apply (aplică).
5. Navighează cu Newer (mai noi) și Older (mai vechi), câte 100 de linii, cele mai noi primele. Ar trebui să vezi doar liniile care se potrivesc.

Partajează jurnalul

1. În Settings > Logs, apasă Download (descarcă). Primești cele mai noi linii, până la 2 MB, ca fișier text.
2. Atașează-l unde ceri ajutor. Vezi Cere ajutor.

Cheile, token-urile și parolele sunt deja ascunse ca [hidden]. Citește totuși fișierul o dată înainte să-l postezi: numele titlurilor, ale dosarelor și adresa serverului tău rămân vizibile.

Unde se țin fișierele

Settings > This app > Storage (Setări > Această aplicație > Stocare) listează fiecare cale așa cum o vede HolyArrs, cu spațiul liber de pe discul ei. În Docker, acestea sunt căi din interiorul containerului.

Cale	Conține
Dosarul de configurare	Toate datele HolyArrs
holyarrs.db	Baza de date principală
holyarrs-events.db	Baza de date a Istoricului
Dosarele pentru copii de rezervă, imagini și jurnale	În interiorul dosarului de configurare
Dosarele Bibliotecii, dosarul de salvare al programului de descărcare	Media și descărcările tale

„free space unknown“ înseamnă că sistemul nu a spus.

Fișierul jurnal este logs/holyarrs.log în dosarul de configurare. La 5 MB se mută în logs/holyarrs.log.1, așa că jurnalele rămân la aproximativ 10 MB. docker logs holyarrs arată aceeași ieșire.

Dacă nu merge

Simptom: pagina Logs lipsește. Cauză: o văd doar proprietarul și administratorii. Soluție: roagă-l pe unul dintre ei.

Simptom: o cale pare greșită. Cauză: în Docker, Storage arată căile din container. Soluție: compară cu mapările tale de volume. Vezi Dosare.

Pentru experți

Cum se ghicesc nivelurile

Nivelul vine din cuvintele din linie. „failed“, „crashed“ și „error“ marchează erorile. „could not“, „refused“ și „timed out“ marchează avertismentele.

Ce se ascunde

Fiecare linie e ascunsă când se scrie și din nou când se citește sau se descarcă:

• Fiecare cheie, token, parolă și link de webhook salvat, inclusiv în formele cu escape de link și base64.
• Valorile vechi. Când un secret se schimbă sau se șterge, ambele fișiere jurnal sunt rescrise cu el ascuns înainte ca valoarea veche să fie aruncată.
• Numele și parolele din linkuri: http://user:pass@host devine http://[hidden]@host.
• Parametrii de link precum apikey=, token=, passkey=, password=.
• Perechile cu nume de secret: API key, token, password, secret, cookie, authorization, setup code. Valorile între ghilimele sunt ascunse până la ghilimeaua de închidere.
• Token-urile Bearer și basic, cheile API HolyArrs (hak_...), codul de configurare de la prima pornire și șirurile lungi care seamănă cu un token.

Întreruperile de linie și codurile de culoare ale terminalului din valori sunt afișate cu escape, deci o valoare nu poate falsifica o linie nouă. Valorile salvate de 4 sau 5 caractere sunt ascunse doar ca cuvânt întreg și niciodată când sunt un cuvânt obișnuit precum admin sau test.

API

Rută	Cine	Ce
GET /api/v1/app/storage	Change settings (modifică setările)	Căi cu spațiu liber
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Proprietar, administratori	Linii și un total
GET /api/v1/logs/download	Proprietar, administratori	Ultimii 2 MB ca text simplu

Cheile API au nevoie de domeniul admin pentru toate trei.

Vezi și

• Cere ajutor
• Verificări de sănătate
• Copii de rezervă