Comment empêcher les journaux Jellyfin de saturer le disque système
Les journaux Jellyfin ne devraient jamais pouvoir grossir au point de concurrencer la base de données, le cache ou le système d’exploitation pour les derniers gigaoctets disponibles. Évitez cette panne en limitant à la fois le niveau de verbosité des journaux de Jellyfin et la couche de journalisation du conteneur ou de l’hôte qui peut collecter à nouveau les mêmes événements.
C’est particulièrement facile à manquer sur le disque système d’un petit serveur domestique, car deux chemins de journalisation indépendants peuvent croître simultanément : Jellyfin écrit les journaux de l’application, tandis que Docker, journald ou un autre superviseur peut conserver séparément stdout et stderr. Commencez par identifier le chemin qui consomme réellement l’espace, limitez la conservation à ce niveau, vérifiez le nettoyage en utilisation normale et configurez une alerte d’espace libre afin qu’une future session de débogage ne puisse pas remplir silencieusement le disque.
Identifiez le stockage de journaux qui augmente réellement
Mesurez avant de supprimer quoi que ce soit. Comparez la taille du répertoire de journaux configuré de Jellyfin avec celle du stockage des journaux du moteur de conteneurs ou du gestionnaire de services, et observez lequel évolue pendant que vous reproduisez une analyse normale de la bibliothèque ou une session de lecture. Si un seul chemin augmente, corrigez celui-ci au lieu d’appliquer plusieurs modifications de rotation simultanément.
Le guide de dépannage de Jellyfin avertit que la journalisation de débogage peut générer une très grande quantité de sorties et qu’elle est destinée à de courtes périodes de dépannage. La première vérification préventive consiste donc à déterminer si un fichier logging.json personnalisé a laissé des catégories verbeuses activées. Consultez les instructions sur la journalisation de débogage avant de modifier les valeurs de conservation.
Si le répertoire de journaux de Jellyfin reste stable mais que le disque système de l’hôte continue de se remplir, examinez ensuite les journaux du moteur d’exécution. Cela signifie que supprimer les fichiers journaux de Jellyfin ne traiterait que le symptôme visible, tandis que la seconde couche de journalisation continuerait de croître.
Définissez une limite de conservation au niveau du moteur d’exécution
Pour les conteneurs, choisissez un pilote de journalisation et une politique de rotation avec une taille maximale définie, plutôt que de compter sur une croissance illimitée. Appliquez ce réglage aux conteneurs nouvellement créés et notez la limite choisie afin qu’une future reconstruction du fichier Compose ne supprime pas cette protection.
Docker indique que sa journalisation json-file par défaut peut consommer une quantité importante d’espace disque lorsque la rotation n’est pas configurée, tandis que le pilote local effectue une rotation par défaut. Appuyez-vous sur ce fonctionnement de la rotation des journaux des conteneurs pour décider de définir max-size/max-file ou d’utiliser le pilote local.
Après avoir modifié la politique du moteur d’exécution, recréez le conteneur Jellyfin si votre environnement l’exige et vérifiez que le conteneur actif utilise bien le nouveau pilote. Un réglage au niveau du démon qui ne s’applique qu’aux nouveaux conteneurs n’est pas une correction réussie tant que l’instance Jellyfin ne l’a pas hérité.
Conservez un nettoyage Jellyfin utile, sans le considérer comme l’unique protection
Jellyfin inclut des tâches de maintenance qui suppriment les journaux, le cache, les journaux d’activité et les données de transcodage, mais le nettoyage planifié constitue une seconde ligne de défense et non une autorisation à laisser la journalisation croître sans limite. Une tâche peut échouer, être retardée ou s’exécuter après qu’une brusque accumulation a déjà consommé l’espace système restant.
Consultez l’historique des tâches dans le tableau de bord pour confirmer que la tâche de nettoyage des journaux s’exécute correctement, puis comparez la taille du répertoire de journaux avant et après sa prochaine exécution planifiée. Si le répertoire ne diminue jamais, recherchez des erreurs de tâche ou un décalage de chemin au lieu de raccourcir aveuglément l’intervalle.
Une approche utile pour un serveur domestique consiste à conserver une bonne visibilité sur l’état de l’application et les flux multimédias sans laisser les fichiers de diagnostic dominer le disque de démarrage. Cette même approche axée sur les ressources est utile pour dépanner les problèmes de mise en mémoire tampon de Jellyfin, car les journaux ne sont utiles que lorsqu’ils indiquent le véritable goulot d’étranglement.
Utilisez la journalisation de débogage comme mode de diagnostic temporaire
Lorsque vous avez besoin de sorties de débogage, déterminez l’heure de début, la fenêtre de reproduction et la condition d’arrêt avant de l’activer. Capturez l’action qui échoue, enregistrez la portion pertinente du journal dans un emplacement sûr, puis rétablissez immédiatement le niveau de verbosité normal une fois les éléments recueillis.
Ne laissez pas la journalisation de débogage activée pendant plusieurs jours simplement parce que l’espace disque est actuellement disponible. Une soirée peu chargée et une analyse de bibliothèque peuvent produire des volumes très différents ; un réglage qui semble inoffensif pendant un test peut donc devenir coûteux lors des tâches planifiées.
Après être revenu à la journalisation normale, redémarrez une fois si la configuration l’exige, puis reproduisez une lecture normale ainsi qu’une tâche planifiée. Le taux de croissance des journaux devrait revenir à son niveau habituel ; dans le cas contraire, rouvrez la configuration et vérifiez que le fichier attendu est bien celui que Jellyfin a réellement chargé.
Ajoutez une condition d’arrêt liée à l’espace libre avant que le disque ne devienne critique
Configurez une alerte simple sur le système de fichiers qui contient les données de Jellyfin, les journaux du moteur d’exécution ou le système d’exploitation. Le seuil doit laisser suffisamment de marge pour examiner la cause et arrêter les services en toute sécurité, plutôt que d’attendre que les écritures commencent à échouer sur l’ensemble de l’hôte.
Si l’espace libre diminue de manière inattendue, arrêtez d’abord la source de journalisation à fort volume, conservez un petit échantillon de diagnostic et supprimez uniquement les journaux ou caches connus comme jetables. Ne commencez pas par supprimer les bases de données, la configuration ou le contenu inconnu des volumes de Jellyfin pour récupérer de l’espace.
La prévention est complète lorsque la lecture normale, une tâche de bibliothèque et un redémarrage ne produisent plus de croissance illimitée, et que l’alerte reste confortablement au-dessus de son seuil de déclenchement. Si l’espace continue de diminuer malgré la limitation de la journalisation, élargissez l’audit de l’utilisation du disque, car il n’est alors plus prouvé que les journaux Jellyfin en sont la cause.
Produits recommandés
Assistance et conseils
Plus à lire
Jellyfin doit-il utiliser un compte partagé unique ou des comptes distincts pour chaque membre du foyer ?
Choisissez les comptes familiaux Jellyfin selon les limites d’identité, d’accès, de contrôle parental et de récupération dont vous avez besoin.
Pourquoi l’utilisation de la mémoire de Jellyfin reste-t-elle élevée une fois la tâche terminée ?
Distinguez la croissance du processus Jellyfin du cache Linux, et n’intervenez que lorsque la mémoire continue d’augmenter ou crée une réelle pression.
Signes indiquant qu’une configuration de stockage Jellyfin devient un risque pour la récupération des données
Auditez les rôles de stockage de Jellyfin, séparez l’état actif des sauvegardes et des données reconstructibles, puis validez la disposition par une restauration.
