Journaux et stockage

Lire le journal

1. Ouvrez Settings > Logs (Paramètres > Journaux). Le propriétaire et les administrateurs y ont accès.
2. Choisissez un Level (niveau) : Every line (toutes les lignes), Warnings and errors (avertissements et erreurs) ou Errors only (erreurs seulement).
3. Saisissez des mots dans Text (texte) pour ne garder que les lignes qui les contiennent. La casse ne compte pas.
4. Réglez From (du) et To (au) pour limiter les jours ; le jour To est inclus. Choisissez Apply (appliquer).
5. Passez d’une page à l’autre avec Newer (plus récentes) et Older (plus anciennes), 100 lignes à la fois, les plus récentes en premier. Vous devriez voir seulement les lignes qui correspondent.

Partager le journal

1. Dans Settings > Logs, choisissez Download (télécharger). Vous obtenez les lignes les plus récentes, jusqu’à 2 Mo, dans un fichier texte.
2. Joignez-le là où vous demandez de l’aide. Voir Obtenir de l’aide.

Les clés, les jetons et les mots de passe sont déjà masqués par [hidden]. Relisez quand même le fichier une fois avant de le publier : les noms des titres, les dossiers et l’adresse de votre serveur restent visibles.

Où sont gardés les fichiers

Settings > This app > Storage (Paramètres > Cette application > Stockage) liste chaque chemin tel que HolyArrs le voit, avec l’espace libre sur son disque. Avec Docker, ce sont des chemins à l’intérieur du conteneur.

Chemin	Contient
Dossier de configuration	Toutes les données de HolyArrs
holyarrs.db	Base de données principale
holyarrs-events.db	Base de données de l’historique
Dossiers des sauvegardes, des illustrations et des journaux	Dans le dossier de configuration
Dossiers de bibliothèque, dossier d’enregistrement du client de téléchargement	Vos médias et vos téléchargements

« free space unknown » veut dire que le système n’a pas donné l’information.

Le fichier journal est logs/holyarrs.log, dans le dossier de configuration. À 5 Mo, il passe dans logs/holyarrs.log.1, donc les journaux restent autour de 10 Mo. docker logs holyarrs affiche la même sortie.

Si ça ne fonctionne pas

Symptôme : la page Logs n’apparaît pas. Cause : seuls le propriétaire et les administrateurs la voient. Solution : demandez à l’un d’eux.

Symptôme : un chemin a l’air faux. Cause : avec Docker, Storage affiche les chemins du conteneur. Solution : comparez avec vos mappages de volumes. Voir Dossiers.

Pour les experts

Comment les niveaux sont devinés

Le niveau vient des mots de la ligne. « failed », « crashed » et « error » marquent les erreurs. « could not », « refused » et « timed out » marquent les avertissements.

Ce qui est masqué

Chaque ligne est masquée à l’écriture, puis de nouveau à la lecture ou au téléchargement :

• Chaque clé, jeton, mot de passe et lien de webhook enregistré, y compris sous forme échappée pour un lien ou en base64.
• Les anciennes valeurs. Quand un secret change ou est supprimé, les deux fichiers journaux sont réécrits avec ce secret masqué avant que l’ancienne valeur soit oubliée.
• Les noms et les mots de passe dans les liens : http://user:pass@host devient http://[hidden]@host.
• Les paramètres de lien comme apikey=, token=, passkey=, password=.
• Les paires qui portent un nom de secret : API key, token, password, secret, cookie, authorization, setup code. Les valeurs entre guillemets sont masquées jusqu’au guillemet fermant.
• Les jetons bearer et basic, les clés API HolyArrs (hak_...), le code de configuration du premier lancement et les longues chaînes qui ressemblent à des jetons.

Les sauts de ligne et les codes de couleur du terminal à l’intérieur des valeurs sont affichés échappés, pour qu’une valeur ne puisse pas se faire passer pour une nouvelle ligne. Les valeurs enregistrées de 4 ou 5 caractères ne sont masquées que comme mot entier, et jamais quand il s’agit d’un mot courant comme admin ou test.

API

Route	Qui	Quoi
GET /api/v1/app/storage	Change settings (modifier les paramètres)	Les chemins avec l’espace libre
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Propriétaire, administrateurs	Des lignes et un total
GET /api/v1/logs/download	Propriétaire, administrateurs	Les 2 Mo les plus récents en texte brut

Les clés API ont besoin de la portée admin pour les trois.

Voir aussi

• Obtenir de l’aide
• Contrôles de santé
• Sauvegardes