Skip to main content

4.4 - Tâches, files d'attente et intégrité

Immich traite les médias avec des tâches en arrière-plan : extraction de métadonnées, miniatures, transcodage vidéo, reconnaissance faciale, recherche intelligente et migration de stockage.

Consulter les tâches

Administration > Jobs

Lors d'un import important, des files actives sont normales. Examiner les journaux si le nombre d'échecs augmente ou si aucune tâche ne progresse.

Ordre de traitement

Après un upload, Immich lance généralement :

  1. extraction des métadonnées ;
  2. génération de miniatures ;
  3. traitement machine learning ;
  4. transcodage selon les paramètres ;
  5. autres tâches planifiées.

Concurrence

Augmenter la concurrence au-delà du nombre de coeurs peut réduire la réactivité sans accélérer le traitement. Procéder par petites étapes et surveiller CPU, mémoire et latence du stockage.

Intégrité système

Immich vérifie :

  • les fichiers présents mais non suivis ;
  • les fichiers référencés mais absents ;
  • les différences de somme de contrôle.

Les dossiers contrôlés comprennent :

upload
library
thumbs
encoded-video
profile
backups

Les fichiers .immich servent de marqueurs de montage. Ne pas les créer ou supprimer manuellement sans comprendre la cause de l'erreur.

Contrôles serveur

docker compose ps
docker compose logs --tail=200 immich-server
docker stats --no-stream
df -hT
df -i

Sur TrueNAS :

sudo docker logs --tail 200 NOM_CONTENEUR_IMMICH
sudo zpool status
sudo zfs list

Réparer sans aggraver

  • une miniature manquante peut être régénérée ;
  • un original manquant doit être recherché dans les sauvegardes ;
  • un checksum différent peut signaler une modification ou une corruption ;
  • ne pas supprimer un original directement de la bibliothèque interne ;
  • déclencher les tâches manquantes tout en suivant les journaux.

La variable IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true désactive une protection importante. Ne l'utiliser que pour un diagnostic maîtrisé, jamais comme correction permanente.

Références :

  • https://docs.immich.app/administration/jobs-workers/
  • https://docs.immich.app/administration/system-integrity/

No comments to display