
Le plafond d'ARC qui ne plafonnait pas : vérifier les trois couches de TrueNAS
Un plafond d'ARC ne se vérifie pas dans un seul fichier. Sur le TrueNAS qui héberge ce homelab, le noyau en cours d'exécution utilise une valeur, un fichier modprobe en annonce une autre et la ligne de commande de démarrage en impose une troisième. Le diagnostic n'a pas demandé de redémarrage : il a demandé de comparer les trois couches.
Le symptôme : quatre gigaoctets en mémoire vive
Le contrôle commence par la valeur réellement utilisée par ZFS, pas par le réglage que l'on croit avoir posé. Le fichier /proc/spl/kstat/zfs/arcstats donne deux compteurs utiles :
c_max 4 4294967296
size 4 4255674952
c_max est la cible maximale exposée par le noyau. Ici, elle vaut 4294967296 octets, soit la limite de 4 Gio. La taille actuelle de l'ARC, size, est légèrement inférieure à cette cible au moment de la lecture. La vérification directe du paramètre du module confirme la même valeur :
cat /sys/module/zfs/parameters/zfs_arc_max
4294967296
La machine dispose de 30 Gio de mémoire et n'a aucun swap actif. free -h affichait 4,2 Gio disponibles lors de la mesure. Ce chiffre ne prouve pas que l'ARC est la cause d'une panne, mais il justifie de vérifier que le plafond annoncé est réellement celui appliqué.
Trois couches, trois réponses
Le même réglage peut apparaître à trois endroits, avec des rôles différents :
| Couche | Lecture | Valeur observée |
| Noyau actif | /sys/module/zfs/parameters/zfs_arc_max | 4294967296 |
| État mesuré | /proc/spl/kstat/zfs/arcstats | c_max = 4294967296 |
| Configuration modprobe | /etc/modprobe.d/zfs.conf | zfs_arc_max=2147483648 |
| Paramètre de démarrage | /etc/default/grub.d/truenas.cfg | zfs.zfs_arc_max=4294967296 |
La contradiction est nette : le fichier modprobe contient une limite de 2 Gio, alors que le noyau actif et la configuration GRUB portent 4 Gio. Ce n'est pas une différence d'affichage entre deux commandes équivalentes. Ce sont deux sources persistantes différentes, puis une valeur runtime qui permet de savoir laquelle a effectivement gagné.
La ligne de commande explique la valeur active
Le contenu de /proc/cmdline reprend effectivement zfs.zfs_arc_max=4294967296 pour le noyau démarré. La même option apparaît dans les entrées générées de GRUB. Elle explique pourquoi le paramètre runtime vaut 4 Gio malgré la présence d'un fichier modprobe qui demande 2 Gio.
Le diagnostic permet donc de distinguer le fait établi de l'hypothèse inutile. Le fait établi est que le noyau a démarré avec 4 Gio et que ZFS l'a appliqué. L'hypothèse inutile serait de modifier immédiatement le fichier qui affiche 2 Gio en espérant que le runtime change. Une modification de fichier ne réécrit pas la valeur déjà chargée dans le noyau.
Pourquoi une seule commande peut tromper
Lire uniquement /etc/modprobe.d/zfs.conf donne l'impression que l'ARC est plafonné à 2 Gio. Lire uniquement /sys/module/zfs/parameters/zfs_arc_max donne la valeur active, mais ne dit pas quel fichier la réimposera au prochain démarrage. Lire uniquement /proc/spl/kstat/zfs/arcstats confirme l'effet, sans identifier la source qui l'a produit.
La méthode fiable est donc un petit triptyque, complété par la ligne de commande de démarrage :
grep -E '^size |^c_max ' /proc/spl/kstat/zfs/arcstats
cat /sys/module/zfs/parameters/zfs_arc_max
grep -R -n 'zfs_arc_max' /etc/modprobe.d /etc/default /boot/grub
grep -o 'zfs[^ ]*arc_max[^ ]*' /proc/cmdline
Ces commandes ne parcourent pas les données du pool et ne provoquent aucun changement. Elles répondent à quatre questions différentes : quelle cible ZFS utilise maintenant, quelle valeur expose le module, quelles valeurs sont persistées et quelle option a servi au démarrage actuel.
Le réglage middleware n'est pas une preuve suffisante
TrueNAS peut aussi conserver des réglages via son middleware. Dans ce cas précis, la recherche des tunables ne renvoie pas d'entrée correspondant à l'ARC. Cela ne rend pas les autres sources invisibles : la ligne GRUB et le fichier modprobe restent présents, et le noyau les reflète.
La conséquence pratique est simple : l'absence d'une entrée dans une interface ou dans une base de configuration ne signifie pas que le noyau utilise sa valeur par défaut. Il faut toujours confronter l'état déclaré à l'état chargé.
Ce que je ne corrige pas à l'aveugle
Le diagnostic prouve une divergence, pas la bonne valeur à appliquer. Abaisser l'ARC à 2 Gio pourrait libérer de la mémoire pour les conteneurs, mais pourrait aussi augmenter les lectures depuis le pool. Le bon choix dépend de la charge réelle, de la marge mémoire et du comportement des services. L'article ne transforme donc pas une observation en correctif automatique.
La séquence sûre serait d'abord de choisir une source de vérité, puis d'aligner la configuration persistante, de régénérer la configuration de démarrage si nécessaire, et enfin de vérifier après un redémarrage planifié les trois lectures : /proc, /sys et les fichiers persistants. Tant que cette séquence n'est pas faite, annoncer « ARC plafonné à 2 Gio » serait faux pour la machine en fonctionnement.
Les limites, honnêtement
Cette mesure a été prise sur un seul hôte, à un instant donné, avec 4,2 Gio de mémoire disponible et sans swap. Elle ne fournit ni benchmark avant/après, ni preuve que les 4 Gio d'ARC ont déclenché un incident. Elle montre seulement qu'un réglage documenté à 2 Gio n'était pas celui utilisé par le noyau, et que la ligne de démarrage permettait de retrouver la cause de cette divergence.
Ce qu'on retient
Un plafond d'ARC n'est pas une ligne isolée. La configuration modprobe décrit une intention persistante, GRUB peut fournir un paramètre au démarrage et /sys révèle la valeur chargée. /proc/spl/kstat/zfs/arcstats confirme ensuite la cible réellement observée par ZFS. Sur un NAS où chaque gigaoctet compte, la vérification complète évite de corriger le mauvais fichier et de publier un état qui n'est pas celui de la machine.
Documentation : OpenZFS, ARC et primarycache · OpenZFS, paramètres de module.
Couverture : Wikimedia Servers-0051 16, Helpameout, licence CC BY-SA 3.0.
← Retour aux articles