# 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

```text
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 :

```text
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

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

Sur TrueNAS :

```bash
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/`