Position dans la file Train at Home : lire le journal T@H

Si vous fixez la fenêtre de Train at Home en vous demandant si elle fait vraiment quelque chose, vous n'imaginez pas un bug. L'information existe — elle n'est simplement pas là où l'application officielle l'affiche. Ce guide est la version détaillée de ce que le guide de configuration optimale ne fait qu'effleurer.

Pourquoi l'application officielle ne peut pas l'afficher

C'est le processus de calcul lui-même qui appelle un point d'entrée de l'orchestrateur, /register/queue_state, pour remonter votre position — mais le back-end de Macrocosmos n'a aucun gestionnaire pour cela :

register_set_queue_state exhausted retries (3): POST /register/queue_state failed 503:
{"detail":"unsupported: No handler for register.queue_state"}

C'est une route morte confirmée et reproductible, pas un problème réseau de votre côté. L'interface de l'application se fige sur la dernière étape visible (généralement « Running speedtest... ») pendant que, en dessous, le mineur continue d'avancer dans la vraie file d'inscription. L'état réel est écrit dans le journal en permanence — l'interface ne sait simplement jamais aller le relire.

Où regarder

Chaque jour, Train at Home écrit un nouveau fichier de journal :

~/Library/Logs/IOTA Train at Home/<AAAA-MM-JJ>-cli.log

Tout ce qui suit consiste à chercher dans ce fichier. Vous n'avez besoin ni d'y écrire, ni de le modifier — seulement de le lire.

Les deux champs qui comptent

Les réponses d'inscription portent deux champs à surveiller : 'position' et 'status'.

• 'position' est votre place numérique dans la file d'admission. Il n'est présent que tant que vous êtes encore en file.
• 'status' est le mot d'état courant du cycle de vie. D'après le propre analyseur de cette application (qui a observé ce champ sur de nombreuses exécutions réelles), la séquence est : queued (en file) → parfois processing (une lecture transitoire, non confirmée) → confirming (une étape d'attestation) → confirmed (en attente qu'un emplacement de couche se libère — cette seule étape peut durer des heures) → succeeded (vous avez été affecté et êtes sur le point de commencer l'entraînement). Une inscription peut aussi se terminer par expired ou failed au lieu de succeeded — voir l'un de ces deux mots signifie que cette tentative précise n'a pas abouti, pas que ce guide ou l'application ont oublié un état.

Une fois sortis de la file d'admission, l'orchestrateur cesse complètement d'envoyer une position numérique — les réponses suivantes indiquent 'status': 'confirming', 'confirmed' ou 'succeeded' avec 'position': None. Voir None à cet endroit n'est pas une erreur : cela signifie que vous avez déjà quitté la file.

Suivre cela en direct

Une façon simple d'observer cela sans aucun outil :

tail -f ~/Library/Logs/IOTA\ Train\ at\ Home/*-cli.log | grep --line-buffered -E "'position'|'status'"

Cela affiche en continu chaque nouvelle ligne mentionnant l'un ou l'autre champ au fur et à mesure de son écriture, pour suivre votre position (ou votre statut de cycle de vie) quasiment en temps réel.

Flèches de tendance, vitesse et ETA

Si vous utilisez subnera, le nombre affiché dans la barre des menus est cette même valeur 'position', accompagnée d'une flèche de tendance. La flèche est calculée sur les 10 dernières minutes de variations de position, et non sur tout l'historique : elle réagit donc à ce qui se passe maintenant.

Flèche	Signification	Que faire
▼	Vous avancez vers la tête de file	Rien, tout fonctionne
=	Stable (moins de 0,15 place par minute dans un sens ou dans l'autre)	Patientez, la file fait parfois des pauses
▲	Vous vous éloignez de la tête de file	Arrêtez de redémarrer l'application

Le menu ouvert affiche la vitesse exacte, par exemple Queue: 1564 (-2.0/min) : une vitesse négative signifie que vous gagnez des places.

L'ETA

L'ETA divise votre position par la vitesse de progression actuelle : 1 564 places à 3 places par minute font environ 8 h 40, affichées avec l'heure à laquelle vous devriez atteindre la tête de file. C'est une estimation approximative, car une file n'avance pas à vitesse constante. Si la file avance de moins de 0,1 place par minute, le menu affiche — (queue not advancing) plutôt qu'un chiffre absurde, et l'ETA n'apparaît que pendant que vous êtes en file : elle disparaît dès que l'inscription commence.

L'erreur qui coûte le plus cher

Ne redémarrez pas l'application officielle pendant que vous êtes en file. Le faire envoie une nouvelle requête d'inscription, à laquelle l'orchestrateur répond par un nouvel identifiant de file — remettant votre position à zéro, là où se trouve actuellement la fin de la file. Si votre position semble grimper plutôt que descendre, la cause la plus fréquente observée dans les journaux est justement celle-ci : quelqu'un (souvent avec de bonnes raisons) a redémarré l'application en espérant « réparer » un chiffre qui semblait bloqué, et s'est ainsi replacé en fin de file.

Si rien d'autre ne semble clairement cassé, laisser tourner est généralement le chemin le plus rapide.

Quand redémarrer est la bonne décision

Uniquement quand le mineur est réellement bloqué, pas quand c'est l'écran : l'application officielle a planté (le processus a disparu), ou elle tourne encore mais son journal n'a pas été écrit depuis plusieurs minutes. subnera affiche off dès que le journal reste silencieux plus de 2 minutes. Son watchdog optionnel Auto-restart on crash n'agit qu'après plus de 5 minutes de journal figé, et reste inactif pendant 5 minutes après un arrêt ou un redémarrage que vous faites vous-même, pour ne jamais défaire une action délibérée.

Ce qu'il est prudent d'ignorer

Toutes les lignes à l'air alarmant ne signifient pas qu'il y a un problème. Notamment :

Failed to run speedtest: Unable to connect to servers to test latency.

Cette ligne est journalisée au niveau debug et est explicitement non bloquante — l'inscription continue normalement après. Si c'est votre speed test lui-même qui semble anormalement bas plutôt qu'un échec pur et simple, c'est une situation différente (et plus fréquente), couverte dans le guide sur le speed test.

Les phases en un coup d'œil

Au-delà de la seule file d'admission, le journal reflète un cycle de vie plus large. Dans l'ordre approximatif où vous les verrez généralement :

Phase	Ce qui se passe
starting	L'application lance le processus de calcul.
queued	En attente dans la file d'admission ; 'position' est présent et (avec un peu de chance) diminue.
registering	Sortie de la file ; confirmation/attestation/attente d'un emplacement de couche ('position': None).
idle	Une couche a été affectée, mais l'orchestrateur n'a pas encore envoyé de travail réel.
working	Entraînement actif — vous verrez des lignes comme ✅ FORWARD complete, ✅ BACKWARD complete, et ✅ Optimization step #<n>.
resetting / off	Le mineur redémarre, ou l'application ne tourne pas / le journal est devenu obsolète.

Dès que vous voyez de vraies lignes d'entraînement plutôt que le bruit de la file ou de l'inscription, c'est gagné — c'est la récompense de l'attente.

Laisser un outil lire à votre place

Tout ce qui précède est une méthode manuelle, au Terminal, pour répondre à « où en suis-je vraiment ? ». Si vous préférez que cela s'affiche automatiquement, subnera est une petite application en lecture seule, dans la barre des menus, conçue précisément autour de ce journal : elle affiche votre position dans la file, sa tendance, une estimation approximative du temps restant, et votre phase actuelle, sans jamais ouvrir de Terminal. Voir comment l'installer. Si vous faites tourner Train at Home sur plusieurs Mac, subnera hub étend la même idée à un tableau de bord unique pour toute la flotte.

Checklist

1. Trouvez le journal du jour : ~/Library/Logs/IOTA Train at Home/<date>-cli.log.
2. Cherchez 'position' et 'status' pour savoir où vous en êtes.
3. Souvenez-vous : 'position': None après avoir été en file signifie que vous en êtes sorti, pas une erreur.
4. Ne redémarrez pas l'application pendant que vous êtes en file — cela vous replace en fin de file ; l'effet pendant la phase d'inscription qui suit est moins certain, mais reste à éviter par prudence.
5. Ignorez une ligne « Failed to run speedtest » de niveau debug ; elle est non bloquante.
6. Guettez les vraies lignes d'entraînement (FORWARD complete, BACKWARD complete, Optimization step #) comme signe que vous avez réellement démarré.
7. Installez subnera si vous préférez ne pas chercher manuellement à chaque fois (guide).

Si vous n'avez pas encore installé Train at Home, commencez par le guide d'installation. Si quelque chose semble bloqué bien au-delà de ce qui est décrit ici, le guide de dépannage couvre les pannes plus persistantes.