OpenSimulator · FR

FSAssets : inodes, stockage et performances

Surveiller les inodes, le remplissage du volume, les petits fichiers, les points de montage et les risques d’I/O.

Guide fondé sur les fichiers sources du fork OpenSimulator 0.9.3.1 / .NET 8. Vérifiez la version et sauvegardez avant toute modification en production.

Pourquoi les inodes sont critiques

Sur ext4, chaque fichier et répertoire consomme un inode ; le nombre total est fixé lors de la création du système de fichiers. FSAssets crée de nombreux fichiers .gz dans une arborescence profonde. Un volume peut afficher 50 % d’espace libre et 100 % des inodes utilisés : les nouvelles créations échouent malgré les Go disponibles.

Mesurer immédiatement l’état du disque

df -h affiche la capacité en octets ; df -i affiche la capacité en inodes. Exécutez les deux sur le répertoire réellement utilisé, pas seulement sur /. En cas de lien symbolique, résolvez le chemin et vérifiez le montage réel.

Exemple à adapter : ne jamais appliquer aveuglément en production.

readlink -f /srv/opensim/fsassets/data
findmnt -T /srv/opensim/fsassets/data
df -h /srv/opensim/fsassets/data
df -i /srv/opensim/fsassets/data
du -sh /srv/opensim/fsassets/data /srv/opensim/fsassets/tmp

Compter les fichiers sans parcourir au hasard

Une exploration de millions de fichiers peut durer longtemps et saturer les métadonnées du stockage. Lancez-la hors heures de pointe, limitez-la au bon répertoire et surveillez son impact. Le nombre de fichiers .gz n’est pas égal au nombre de lignes fsassets en SQL à cause de la déduplication.

Exemple à adapter : ne jamais appliquer aveuglément en production.

# Potentiellement très coûteux sur un grand volume :
find /srv/opensim/fsassets/data -type f -name '*.gz' -printf '.' | wc -c
# Échantillonner les sous-répertoires de premier niveau :
du -h --max-depth=1 /srv/opensim/fsassets/data | sort -h | tail

Ext4 et XFS : limites différentes

Ext4 réserve généralement une population d’inodes à la création ; la densité est liée aux options de formatage comme -i. Sur XFS, l’allocation des inodes est dynamique, mais reste soumise aux limites et à l’espace libre du filesystem. df -i demeure utile sur les deux. Ne reformatez jamais un disque FSAssets existant pour « ajouter des inodes » : cela détruirait les données.

Quand les inodes sont épuisés

Symptômes : erreurs de création de fichiers ou répertoires, « No space left on device », spool qui grossit, nouveaux assets impossibles. Préservez les logs puis vérifiez à la fois df -h et df -i ; la même erreur peut aussi provenir d’un disque plein, de quotas ou d’un montage passé en lecture seule.

Alertes de capacité et projection

Surveillez séparément % d’espace utilisé, % d’inodes utilisés, nombre de fichiers et taille du spool. Exemple de politique locale : alerte précoce à 70 %, action à 85 % et intervention urgente à 95 %, à ajuster à la croissance réelle. Les seuils proposés sont des recommandations d’exploitation, non des constantes OpenSimulator.

Exemple à adapter : ne jamais appliquer aveuglément en production.

df -P /srv/opensim/fsassets/data
df -Pi /srv/opensim/fsassets/data
stat -f -c 'Type=%T Inodes libres=%f? (voir df -i)' /srv/opensim/fsassets/data
# Évolution : enregistrer ces métriques chaque jour via supervision

Le spool est aussi un indicateur

FSAssets stocke d’abord les fichiers temporaires dans SpoolDirectory/spool puis SpoolDirectory. Si le thread écrivain ne peut plus traiter les fichiers à cause des droits, du disque, des inodes ou d’erreurs d’I/O, le spool peut augmenter. Ne le videz jamais comme un cache : il peut contenir des assets non encore écrits dans BaseDirectory.

Exemple à adapter : ne jamais appliquer aveuglément en production.

du -sh /srv/opensim/fsassets/tmp
find /srv/opensim/fsassets/tmp -maxdepth 1 -type f | wc -l
ls -ld /srv/opensim/fsassets/tmp /srv/opensim/fsassets/tmp/spool

Performances HDD, SSD et NAS

Les accès à de très nombreux petits fichiers sollicitent les métadonnées et les IOPS ; la latence peut être plus pénalisante que le débit séquentiel. Mesurez avant de déplacer des données : iostat, iowait, latence et erreurs disque. Sur NAS, validez aussi la sémantique des verrous, des renommages, la persistance et les interruptions réseau ; ne supposez pas que toute solution réseau convient au spool.

Exemple à adapter : ne jamais appliquer aveuglément en production.

iostat -xz 1 5
vmstat 1 10
journalctl -k --since '2 hours ago' | grep -Ei 'I/O error|ext4|xfs|nvme|ata'

Des limites au-delà des inodes

Vérifiez quotas utilisateurs, réservations du filesystem, permissions, espace des snapshots, saturation du système de sauvegarde et allocation des fichiers temporaires. Les fichiers de métadonnées SQL et les journaux peuvent résider sur d’autres disques : surveillez chacun d’eux.

Continuer la lecture

Sources vérifiables