Passer au contenu principal
W&B LEET (Lightweight Experiment Exploration Tool) est une interface de terminal pilotée au clavier pour explorer les runs journalisés sur la machine sur laquelle vous travaillez. Utilisez LEET pour comparer des métriques, inspecter l’utilisation des ressources système, parcourir les images enregistrées et suivre la sortie console sans ouvrir de navigateur. LEET lit les journaux de transactions locaux .wandb, ce qui vous permet d’inspecter les runs avant qu’ils ne soient synchronisés avec le cloud.
Vue Workspace de W&B LEET avec des volets pour les runs, les métriques, les métriques système, les médias, les journaux de console et l’aperçu du run.

​
Quand utiliser LEET

LEET est conçu pour les ingénieurs qui passent le plus clair de leur temps dans un terminal, en particulier sur des machines distantes, des clusters ou des sessions SSH où un navigateur graphique est lent ou indisponible. LEET et W&B App affichent les mêmes données de run sous-jacentes lorsque ces données existent localement et ont été synchronisées. LEET ne remplace pas un workspace de projet dans le navigateur. Il s’agit d’une interface différente pour les fichiers de run locaux et les mises à jour en temps réel d’un processus d’entraînement actif.

​
Prérequis

Installez ou mettez à jour la CLI W&B vers la dernière version à l’aide de pip ou uv :
Ce guide décrit le comportement le plus récent de la CLI. Pour les modifications d’une version à l’autre, voir le journal des modifications sur cette page.
Dans le SDK v0.27.x et les versions antérieures, lancez le TUI LEET avec wandb beta leet au lieu de wandb leet.

​
Launch LEET

Depuis le répertoire qui contient votre dossier wandb/, ouvrez le Workspace par défaut et sélectionnez automatiquement le run local le plus récent :
Vous pouvez fournir un PATH facultatif pointant vers un répertoire Workspace, le répertoire d’un run spécifique ou un fichier .wandb :
Ouvrez le moniteur système autonome (SYMON) pour consulter les métriques de l’hôte en dehors de tout contexte de run :
Pour la syntaxe de la commande et les sous-commandes, voir wandb leet dans la Référence CLI.

​
Vues et mise en page des volets

LEET propose trois vues principales : workspace, run unique et SYMON.

​
Vue Workspace

La vue Workspace s’affiche par défaut. Elle est conçue pour comparer plusieurs runs issus du même répertoire local wandb/. Les volets typiques incluent :
  • Barre latérale Runs — parcourez et filtrez les dossiers de runs locaux.
  • Grille de métriques — superposez les runs sélectionnés sur les mêmes graphiques scalaires.
  • Métriques système — graphiques du run en surbrillance.
  • Médias — miniatures wandb.Image affichées dans le terminal.
  • Journal de la console — sorties stdout et stderr regroupées pour le run en surbrillance.
  • Aperçu du run — état, ID, tag, notes, configuration et valeurs de synthèse.
Utilisez space pour sélectionner ou désélectionner un run afin de superposer ses métriques. Les runs sélectionnés sont marqués d’une icône pleine. Utilisez p pour épingler un run afin que sa série reste au premier plan dans les graphiques de métriques. Appuyez sur enter sur le run en surbrillance pour ouvrir la vue run unique. Les runs en cours continuent de se mettre à jour dans Workspace, ce qui vous permet d’utiliser LEET aussi bien pour l’analyse après exécution que pour surveiller un job actif.

​
Vue d’un run unique

La vue d’un run unique se concentre sur un run, avec une grille de métriques au centre, l’aperçu du run à gauche et les métriques système à droite. Les volets des médias et du journal de la console s’ouvrent sous la grille de métriques lorsqu’ils sont activés.
Vue LEET d’un run unique dans W&B, avec des volets d’aperçu du run, de graphiques de métriques et de métriques système.
Appuyez sur esc pour revenir à la vue de l’espace de travail.

​
SYMON

SYMON surveille les métriques locales du CPU, de la mémoire, du disque, du réseau et des accélérateurs. Il utilise le même moteur de graphiques que les volets de métriques système associés à des runs, mais n’est pas lié à un fichier de run W&B.
Vue des métriques système de W&B LEET avec des graphiques GPU et un mode de carte thermique par buckets.

​
Fonctionnalités clés

​
Comparaison de plusieurs runs

Sélectionnez plusieurs runs dans la vue Workspace pour comparer des métriques scalaires sur des graphiques partagés. Chaque run se voit attribuer une couleur stable, et LEET réduit les collisions entre couleurs de base afin que les séries superposées restent faciles à distinguer. L’épinglage est utile lorsque de nombreux runs sont sélectionnés et que vous souhaitez qu’une série soit affichée au-dessus des autres. Appuyez sur f pour filtrer la liste des runs par nom, projet, tags, notes, valeurs de configuration et autres métadonnées. Les termes seuls effectuent une recherche dans la clé du run, le nom d’affichage, l’ID du run, le projet, les tags et les notes. Le filtre prend également en charge les requêtes par champ : Les opérateurs pris en charge sont :, =, !=, >, >=, < et <=. Les comparaisons numériques sont utiles pour les valeurs de configuration telles que le taux d’apprentissage, la taille de lot ou le nombre de couches. Utilisez des espaces ou AND pour la conjonction, OR ou | pour les alternatives, et -, ! ou NOT pour la négation. Utilisez des guillemets pour les expressions contenant des espaces.
Lors de la modification d’un filtre, appuyez sur tab pour basculer entre les modes regex et glob. Le mode regex fonctionne comme une recherche de sous-chaîne insensible à la casse, sauf si la requête contient des métacaractères regex. Le mode glob prend en charge * pour toute séquence de caractères et ? pour n’importe quel caractère unique.

​
Métriques et métriques système

LEET affiche les métriques scalaires sous forme de graphiques linéaires dans le terminal. Filtrez les métriques de run avec / et les métriques système avec \. Appuyez sur y lorsqu’un graphique est sélectionné pour faire défiler des modes tels que l’échelle logarithmique sur l’axe Y ou des vues en carte thermique par plages pour les métriques système basées sur des pourcentages. Utilisez la molette de la souris pour zoomer sur le graphique sélectionné. Sur les graphiques de métriques système en temps réel, LEET utilise par défaut une fenêtre glissante sur les dernières valeurs (10 minutes par défaut). Cliquez avec le bouton droit et faites glisser sur un graphique pour inspecter le point le plus proche. Maintenez alt enfoncée tout en faisant glisser pour inspecter tous les graphiques visibles à la même position sur l’axe X.

​
Médias et journal de la console

Le volet multimédia affiche les séries wandb.Image sous forme de miniatures ANSI. Basculez-le avec 3 dans la vue Workspace ou la vue d’un run unique.
Vue Workspace de W&B LEET avec le volet multimédia affichant plusieurs séries d’images.
Basculez le journal de la console avec 4. LEET reconstruit des lignes de log lisibles à partir de la sortie brute du terminal, y compris les codes d’échappement ANSI et les lignes de progression avec retour chariot. Pour le comportement du journal de la console dans W&B App, voir Journal de la console.

​
Configuration

Enregistrez la mise en page, les couleurs, les volets par défaut et le mode de démarrage avec l’éditeur de configuration :
LEET écrit wandb-leet.json dans ~/.config/wandb/ par défaut, ou dans WANDB_CONFIG_DIR si cette variable est définie. Vous pouvez aussi redimensionner les grilles directement dans LEET avec c et r.
Éditeur de configuration LEET de W&B affichant les paramètres de grille, les jeux de couleurs, les paramètres de visibilité et la sélection de palette.

​
Clés de configuration courantes

Plusieurs palettes de couleurs sont disponibles, comme wandb-vibe-10, wandb-vibe-20, sunset-glow, blush-tide, gilded-lagoon, bootstrap-vibe, dusk-shore, clear-signal, traffic-light, viridis, plasma, inferno, magma et cividis.
  • Les palettes dusk-shore et clear-signal sont adaptées aux personnes daltoniennes.
  • Les palettes séquentielles comme viridis, plasma, inferno, magma, cividis et traffic-light conviennent bien aux cartes thermiques par compartiments.
LEET est conçu pour être utilisé au clavier et à la souris. Appuyez sur h ou ? dans LEET pour ouvrir la superposition d’aide intégrée à l’application pour la vue actuelle. Dans les vues du Workspace et du run unique :
  • tab et shift+tab font passer le focus d’un volet visible à l’autre.
  • w, a, s, d et les touches fléchées permettent de se déplacer dans le volet actif (sauf dans le volet multimédia, où les flèches font défiler l’axe X et WASD permet de se déplacer entre les tuiles).
  • home, end, pgup et pgdown permettent de sauter rapidement dans les listes, les pages de graphiques ou les éléments multimédias.
  • 1, 2, 3 et 4 affichent ou masquent la grille des métriques, les métriques système, le multimédia et le volet des journaux de la console.
  • [ et ] affichent ou masquent les barres latérales (liste des runs, aperçu du run ou métriques système selon la vue).
Pour consulter les tableaux complets des raccourcis clavier pour le Workspace, le run unique, SYMON et les actions de la souris, voir Keyboard shortcuts (onglet LEET).

​
Limitations par rapport à la W&B App

LEET complète la W&B App, mais ne reprend pas toutes les fonctionnalités du Workspace. Si vous avez besoin d’Artifacts, d’analyses de Sweeps ou de types de panneaux que LEET ne propose pas, ouvrez le run dans la W&B App après synchronisation.

​
Journal des modifications

LEET a d’abord été lancé en version bêta dans le SDK v0.23.0, puis est passé en disponibilité générale (GA) dans le SDK v0.28.0. Pour plus de détails, référez-vous aux notes de version du SDK.