Registres i emmagatzematge

Llegeix el registre

1. Obre Settings > Logs (Paràmetres > Registres). El veuen el propietari i els administradors.
2. Tria un Level (nivell): Every line (cada línia), Warnings and errors (advertències i errors) o Errors only (només errors).
3. Escriu a Text per quedar-te amb les línies que tinguin aquestes paraules. No importa si són majúscules o minúscules.
4. Posa From (des de) i To (fins a) per limitar els dies; To s’hi inclou. Clica a Apply (aplicar).
5. Passa de pàgina amb Newer (més nous) i Older (més antics), de 100 línies en 100, primer les més noves. Hauries de veure només les línies que coincideixen.

Comparteix el registre

1. A Settings > Logs, clica a Download (baixar). Obtens les línies més noves, fins a 2 MB, com a fitxer de text.
2. Adjunta’l allà on demanis ajuda. Consulta Obtén suport.

Les claus, els tokens i les contrasenyes ja estan emmascarats com a [hidden]. Tot i així, llegeix el fitxer una vegada abans de publicar-lo: els noms dels títols, de les carpetes i l’adreça del teu servidor continuen visibles.

On es desen els fitxers

Settings > This app > Storage (Paràmetres > Aquesta app > Emmagatzematge) llista cada ruta tal com la veu HolyArrs, amb l’espai lliure del seu disc. A Docker, són rutes dins del contenidor.

Ruta	Conté
Carpeta de configuració	Totes les dades d’HolyArrs
holyarrs.db	Base de dades principal
holyarrs-events.db	Base de dades de l’Historial
Carpetes de còpies de seguretat, il·lustracions i registres	Dins de la carpeta de configuració
Carpetes de la Biblioteca, carpeta on el gestor de baixades desa	Els teus mitjans i baixades

“free space unknown” vol dir que el sistema no ho ha dit.

El fitxer de registre és logs/holyarrs.log a la carpeta de configuració. En arribar a 5 MB passa a logs/holyarrs.log.1, així que els registres es queden a prop de 10 MB. docker logs holyarrs mostra la mateixa sortida.

Si no funciona

Símptoma: falta la pàgina de Registres. Causa: només la veuen el propietari i els administradors. Solució: demana-ho a un d’ells.

Símptoma: una ruta sembla incorrecta. Causa: a Docker, Storage mostra rutes del contenidor. Solució: compara-ho amb els teus mapatges de volums. Consulta Carpetes.

Per a experts

Com s'endevinen els nivells

El nivell surt de les paraules de la línia. “failed”, “crashed” i “error” marquen errors. “could not”, “refused” i “timed out” marquen advertències.

Què s'emmascara

Cada línia s’emmascara quan s’escriu, i un altre cop quan es llegeix o es baixa:

• Totes les claus, tokens, contrasenyes i enllaços de webhook desats, també en formes d’enllaç escapat i base64.
• Valors antics. Quan un secret canvia o s’elimina, els dos fitxers de registre es reescriuen amb el secret emmascarat abans de descartar el valor antic.
• Noms i contrasenyes en enllaços: http://user:pass@host passa a http://[hidden]@host.
• Paràmetres d’enllaç com apikey=, token=, passkey=, password=.
• Parells amb un nom de secret: clau d’API, token, contrasenya, secret, cookie, autorització, codi de configuració. Els valors entre cometes s’emmascaren fins a les cometes de tancament.
• Tokens bearer i basic, claus d’API d’HolyArrs (hak_...), el codi de configuració del primer inici i cadenes llargues que semblen tokens.

Els salts de línia i els codis de color del terminal dins dels valors es mostren escapats, així que un valor no pot falsificar una línia nova. Els valors desats de 4 o 5 caràcters només s’emmascaren com a paraula sencera, i mai quan són una paraula comuna com admin o test.

API

Ruta	Qui	Què
GET /api/v1/app/storage	Change settings	Rutes amb espai lliure
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Propietari, administradors	Línies i un total
GET /api/v1/logs/download	Propietari, administradors	Els 2 MB més nous com a text pla

Les claus d’API necessiten l’àmbit admin per a les tres.

Relacionat

• Obtén suport
• Comprovacions de salut
• Còpies de seguretat