Log e archiviazione

Leggere il log

1. Apri Settings > Logs (Impostazioni > Log). Lo vedono il proprietario e gli amministratori.
2. Scegli un Level (livello): Every line (ogni riga), Warnings and errors (avvertenze ed errori) o Errors only (solo errori).
3. Scrivi in Text (testo) per tenere le righe con quelle parole. Maiuscole e minuscole non contano.
4. Imposta From (da) e To (a) per limitare i giorni; To è incluso. Premi Apply (applica).
5. Scorri con Newer (più recenti) e Older (meno recenti), 100 righe alla volta, dalla più recente. Dovresti vedere solo le righe che corrispondono.

Condividere il log

1. In Settings > Logs, premi Download (scarica). Ottieni le righe più recenti, fino a 2 MB, come file di testo.
2. Allegalo dove chiedi aiuto. Vedi Ottenere assistenza.

Chiavi, token e password sono già nascosti come [hidden]. Rileggi comunque il file una volta prima di pubblicarlo: i nomi dei titoli, delle cartelle e l’indirizzo del tuo server restano visibili.

Dove sono i file

Settings > This app > Storage (Impostazioni > Questa app > Archiviazione) elenca ogni percorso come lo vede HolyArrs, con lo spazio libero sul suo disco. In Docker sono percorsi dentro il container.

Percorso	Contiene
Cartella di configurazione	Tutti i dati di HolyArrs
holyarrs.db	Database principale
holyarrs-events.db	Database della Cronologia
Cartelle di backup, immagini e log	Dentro la cartella di configurazione
Cartelle della Libreria, cartella di salvataggio del downloader	I tuoi file multimediali e i download

“free space unknown” (spazio libero sconosciuto) significa che il sistema non l’ha comunicato.

Il file di log è logs/holyarrs.log nella cartella di configurazione. A 5 MB passa a logs/holyarrs.log.1, così i log restano intorno ai 10 MB. docker logs holyarrs mostra lo stesso output.

Se non funziona

Sintomo: la pagina Logs non c’è. Causa: la vedono solo il proprietario e gli amministratori. Soluzione: chiedi a uno di loro.

Sintomo: un percorso sembra sbagliato. Causa: in Docker, Storage mostra i percorsi del container. Soluzione: confrontali con i tuoi mapping dei volumi. Vedi Cartelle.

Per esperti

Come si indovinano i livelli

Il livello viene dalle parole nella riga. “failed”, “crashed” e “error” indicano errori. “could not”, “refused” e “timed out” indicano avvertenze.

Cosa viene nascosto

Ogni riga viene nascosta quando è scritta, e di nuovo quando viene letta o scaricata:

• Ogni chiave, token, password e link di webhook salvati, anche nelle forme con escape per i link e in base64.
• I vecchi valori. Quando un segreto cambia o viene rimosso, entrambi i file di log vengono riscritti con quel valore nascosto prima che il vecchio valore sia eliminato.
• Nomi e password nei link: http://user:pass@host diventa http://[hidden]@host.
• Parametri dei link come apikey=, token=, passkey=, password=.
• Coppie con il nome di un segreto: chiave API, token, password, segreto, cookie, authorization, codice di configurazione. I valori tra virgolette vengono nascosti fino alla virgoletta di chiusura.
• Token bearer e basic, chiavi API di HolyArrs (hak_...), il codice di configurazione del primo avvio e lunghe stringhe simili a token.

Gli a capo e i codici colore del terminale dentro i valori vengono mostrati con escape, così un valore non può simulare una nuova riga. I valori salvati di 4 o 5 caratteri vengono nascosti solo come parola intera, e mai quando sono una parola comune come admin o test.

API

Route	Chi	Cosa
GET /api/v1/app/storage	Change settings	Percorsi con spazio libero
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Proprietario, amministratori	Righe e un totale
GET /api/v1/logs/download	Proprietario, amministratori	Gli ultimi 2 MB come testo semplice

Le chiavi API richiedono l’ambito admin per tutte e tre.

Correlati

• Ottenere assistenza
• Controlli di salute
• Backup