Être prévenu quand un Mac Train at Home s'arrête : alertes Telegram, e-mail et webhook

Un Mac sous Train at Home peut cesser de travailler sans aucun signe visible : l'application est toujours ouverte, la fenêtre officielle n'a pas changé, et rien ne vous dit que le mineur est inactif depuis des heures. subnera hub peut vous écrire à votre place. Ce guide présente les alertes qui existent, la façon de configurer un canal sur app.subnera.com↗ et la manière de lire ce que vous recevez. Il suppose que votre Mac envoie déjà ses rapports au hub ; sinon, commencez par connecter un Mac.

Les alertes disponibles

subnera hub lit les rapports envoyés par chaque Mac enrôlé et applique neuf règles. Ce sont des constats que subnera hub tire lui-même de ces rapports, pas un statut officiel.

Règle	Se déclenche quand
offline	Aucun rapport n'est arrivé depuis plus de 90 secondes.
phaseBad	Le mineur est en phase off, error ou disconnected (réseau IOTA injoignable) depuis au moins 2 minutes.
stuck	Le mineur apparaît au travail (ou stalled, bloqué par des pairs injoignables), mais sans débit d'entraînement (ou sans nouvelle passe depuis 15 minutes) depuis plus de 15 minutes.
unsent	Le mineur s'entraîne (ou est stalled) et a des passes jamais transmises, mais aucune confirmée par le réseau, depuis plus de 15 minutes.
kicked	Le mineur a quitté l'entraînement et est revenu dans la file.
queueLost	Le Mac a perdu sa place dans la file. Le message indique la cause et la position détenue, quand elle est connue.
speedGap	La vitesse vue par le mineur est inférieure à 25 % de la bande passante réelle mesurée sur le Mac.
newOfficialVersion	La version de l'application officielle a changé. Le message vous invite à vérifier que l'analyse fonctionne toujours.

Dans l'interface en français, ces règles apparaissent sous des noms comme « Arrêt ou erreur », « Entraînement bloqué » et « Place en file perdue ». Pour les phases concernées, voir les états d'inscription et de file ; le journal lu par l'agent est décrit dans le guide sur la position dans la file.

Ajouter un canal

Les alertes sont envoyées par pool, à tous les canaux activés de ce pool. Seul un admin ou un owner du pool peut gérer les canaux ; les autres rôles voient la liste des alertes mais pas les réglages des canaux (voir pools et rôles).

1. Connectez-vous sur app.subnera.com↗ et ouvrez le pool concerné.
2. Ouvrez Alertes dans la navigation, puis la section Canaux en bas de page.
3. Sous Ajouter un canal, choisissez un Type de canal, remplissez le champ et validez avec Ajouter un canal.
4. Cliquez sur Envoyer un test sur la nouvelle ligne. Un message de test part vers ce canal, et la ligne affiche Livré ou l'erreur.

Ce qu'il faut saisir selon le type :

• Telegram : un Identifiant de discussion, soit un nombre (par exemple 123456789), soit le @nom d'un canal.
• E-mail : une adresse dans le champ E-mail.
• Webhook : une URL du webhook commençant par https://. Le hub envoie une requête POST JSON avec un seul champ, text, qui contient le message. Les URL qui pointent vers des adresses privées ou locales sont refusées, et les redirections ne sont pas suivies. Seule l'origine de l'URL vous est réaffichée, car le reste contient souvent un secret.

Chaque ligne a un interrupteur Activé / Désactivé et un bouton Supprimer : vous pouvez donc mettre un canal en pause sans le perdre. Telegram et l'e-mail dépendent du bot et de la messagerie du hub, que vous ne contrôlez pas. Si un test n'arrive pas, essayez un autre type de canal ou vérifiez d'abord la destination. Un pool est limité à 10 canaux.

Webhooks signés

Chaque envoi webhook porte une signature HMAC-SHA256 dans l'en-tête X-Subnera-Signature, calculée avec un secret affiché une seule fois à la création du canal (ou lorsque vous utilisez Renouveler le secret). Votre récepteur peut s'en servir pour confirmer qu'une requête vient bien de subnera hub et qu'elle n'est pas un rejeu. Les canaux créés avant l'arrivée de la signature affichent Non signé jusqu'à ce que vous utilisiez Activer la signature. Les en-têtes, la chaîne signée et du code Node.js et Python qui fonctionne sont dans la vérification des signatures de webhook. Les canaux webhook sont disponibles avec les offres Team et Fleet.

Une alerte par problème

Les règles sont conçues pour éviter le bruit :

• Une alerte par problème. Une règle notifie quand elle se déclenche, puis reste silencieuse tant que le problème dure. Un mineur instable ne produit pas un message par rapport.
• Délai de renouvellement. Après une notification pour une règle donnée sur une machine donnée, cette règle ne peut pas se redéclencher avant 30 minutes.
• Message de rétablissement. Quand offline, phaseBad, stuck, unsent ou speedGap disparaît, vous recevez un message « back to normal » (retour à la normale).
• Événements instantanés (kicked, queueLost, newOfficialVersion) : ils notifient une seule fois et n'envoient jamais de message de rétablissement, puisqu'il n'y a rien à rétablir.
• Les seuils absorbent les coupures brèves. Un Mac qui se met en veille ou perd sa connexion un court instant interrompt le compte à rebours d'un phaseBad ou d'un stuck en attente au lieu de le déclencher.
• Nouvelles tentatives. Si aucun canal n'a livré une alerte, le hub réessaie environ toutes les 5 minutes. La page Alertes l'indique par « en attente — aucun canal livré ». Les événements instantanés ne sont pas retentés.

Chaque message ressemble à Mac-mini: stuck firing — training but no throughput for 15 min (working, L12) : nom de la machine, règle, ce qui s'est passé, puis la phase et la couche à ce moment-là. Le texte des messages est en anglais.

La page Alertes liste aussi l'état récent par machine et par règle : active, en attente ou résolue, avec Depuis et Dernière notification.

Alerte de place libre

En plus des règles ci-dessus, un pool peut demander à être prévenu quand une place Train at Home se libère. Cette alerte est désactivée tant que vous ne l'activez pas sur la page Alertes du pool. Vous pouvez choisir d'être prévenu pour tous les niveaux ou pour un seul niveau. Le message part vers les canaux d'alerte activés du pool, et il est envoyé au plus une fois par run toutes les 30 minutes. Cette alerte est disponible avec toutes les offres, Solo comprise.

Ce qu'une alerte signifie, et ce qu'elle ne signifie pas

• Une alerte signifie que la lecture d'un rapport par le hub a franchi un seuil. Elle ne prouve pas la cause : offline peut être un Mac en veille, une connexion perdue ou un agent arrêté. Voir garder un Mac éveillé et le dépannage.
• Le silence n'est pas une garantie. Si le Mac est hors ligne, le hub ne voit que l'absence de rapports, et un canal peut échouer à livrer.
• Les alertes ne sont pas un statut officiel de Macrocosmos ou d'IOTA, et ne disent rien des récompenses.
• Les alertes ne réparent rien. Le redémarrage à distance est une fonction distincte, à activer volontairement, voir le consentement au contrôle à distance, et le surveillant de redémarrage automatique en est une autre, sur le Mac.

subnera n'est pas officiel et n'est affilié ni à IOTA, ni à Macrocosmos, ni à Bittensor. Pour la vue d'ensemble de plusieurs Mac, voir le guide du hub de flotte.