Intégration externe - TrueNAS

Développement
1

cover-truenas

Salut tout le monde !

Synology, Unraid, UGREEN, QNAP… il manquait TrueNAS, le NAS de tous ceux qui ont monté le leur en ZFS. Je fais beaucoup d’auto-hébergement (Sonarr & Radarr, c’était un régal), et cette série est pour ceux qui ont un NAS ou un serveur à la maison : celle-ci surveille le NAS en local, sans cloud.

Ce que ça fait

  • Le NAS : en ligne, processeur, mémoire, température du processeur, durée de fonctionnement, version, « mise à jour disponible », nombre d’alertes actives et leur niveau le plus haut.
  • Un appareil par pool ZFS : état (en ligne, erreurs, dégradé, en panne…), espace utilisé, espace libre, capacité, jours depuis le dernier scrub et ses erreurs.
  • Un appareil par disque : température et état SMART.
  • Un appareil par application et par VM : en marche ou non, état. Un interrupteur Marche / arrêt en option, désactivé par défaut.
  • Deux déclencheurs : « Pool dégradé » et « Nouvelle alerte TrueNAS » (filtrable par niveau, avec le texte de l’alerte).
  • Deux actions « Redémarrer / Éteindre le NAS », désactivées par défaut (à cocher dans la configuration).
  • Un widget : jauges processeur et mémoire, problèmes en tête, puis pools, applications et VM.
  • En français, anglais, allemand et espagnol.

Le truc sympa

Pool dégradé → message à toute la maison et une lampe qui passe au rouge
Nouvelle alerte de niveau Erreur ou plus → notification avec le texte de l’alerte
Premier dimanche du mois, un pool sans scrub depuis 35 jours → rappel

Installation

:warning: Gladys 5.1 minimum.

Elle arrive dans le store au prochain passage de l’indexeur. En attendant : Intégrations → Installer depuis GitHub, avec GitHub - guim31/gladys-truenas: TrueNAS pools, disks, alerts and apps for Gladys Assistant · GitHub

  1. Dans TrueNAS : Credentials → Users → Add, un utilisateur gladys avec le rôle Read-only Administrator (ni shell ni partage nécessaires).
  2. Connecté avec cet utilisateur : menu utilisateur en haut à droite → API Keys → Add, et copiez la clé (TrueNAS ne l’affiche qu’une fois). Pour démarrer et arrêter applications et VM, il faut en plus les droits APPS_WRITE et VM_WRITE ; pour redémarrer ou éteindre le NAS, un administrateur complet.
  3. Dans Gladys : l’adresse du NAS et la clé, cochez Accepter un certificat auto-signé (TrueNAS en génère un par défaut), puis Tester la connexion.
  4. Onglet Découverte : ajoutez le NAS, les pools, les disques et les applications.

Petites réserves honnêtes

  • HTTPS uniquement : TrueNAS révoque une clé d’API envoyée en HTTP simple, donc l’intégration refuse une adresse en http:// avant d’envoyer quoi que ce soit.
  • TrueNAS 25.04 ou plus récent seulement (Community Edition, ex-SCALE) : ni TrueNAS CORE ni SCALE 24.10, qui n’ont pas cette API. Un NAS par installation.
  • Les textes des alertes restent en anglais, tels que TrueNAS les écrit. Datasets, partages et instantanés ne sont pas lus.
  • Développée sans TrueNAS. C’est un système complet, que je n’ai pas pu faire tourner pour l’occasion : l’intégration est testée sur des réponses reconstruites à partir du code source de TrueNAS (25.04, 25.10 et 26.0 bêta). Seule la connexion chiffrée a été vérifiée pour de vrai. Les graphiques processeur, mémoire et température, les températures des disques en 25.04 et le démarrage / arrêt des applications sont à confirmer. Si vous avez un TrueNAS, vos retours sont plus que bienvenus, et le dépôt contient un petit script de test en lecture seule si vous voulez m’aider.

Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à iXsystems.

Dépôt : GitHub - guim31/gladys-truenas: TrueNAS pools, disks, alerts and apps for Gladys Assistant · GitHub