Journaux de console

Lorsque vous lancez une expérience, vous pouvez voir des messages s’afficher dans votre console. W&B capture les journaux de console et les affiche dans la W&B App. Utilisez ces messages pour déboguer et surveiller le comportement de votre expérience. Les sections suivantes décrivent comment consulter, configurer, rechercher, filtrer, télécharger et copier les journaux de console de vos runs.

Afficher les journaux de console

Affichez les journaux de console d’un run dans W&B App pour examiner les messages générés pendant le run.

Accédez à votre projet dans W&B App.
Sélectionnez un run dans le tableau Runs.
Sélectionnez l’onglet Logs sur la page du run.
Facultatif : pour un run dont les journaux sont diffusés en continu, sélectionnez Jump to bottom pour revenir aux journaux les plus récents après avoir fait défiler la page vers le haut.

Pendant la diffusion des journaux, une icône de points de suspension () apparaît dans le coin supérieur droit. Lorsque l’interrogation des journaux est terminée, W&B remplace l’icône par un bouton de téléchargement ().

Types de journaux de console

W&B capture trois types de journaux de console et ajoute un préfixe pour indiquer le niveau de gravité de chaque log. Le préfixe vous aide à parcourir rapidement les logs et à identifier les messages les plus utiles pour le débogage. Le tableau suivant résume chaque type, classé du plus grave au moins grave.

Gravité	Préfixe	Description	Exemple
Erreur	`ERROR`	Problèmes graves susceptibles d’empêcher le run de se terminer correctement.	`ERROR Failed to save notebook.`
Avertissement	`WARNING`	Problèmes potentiels qui n’interrompent pas l’exécution.	`WARNING Found .wandb file, not streaming tensorboard metrics.`
Info	`wandb:`	Mises à jour sur la progression et le statut du run.	`wandb: Starting Run: abc123`

Paramètres des journaux de console

Pour contrôler les types de sortie de console que W&B capture et affiche, passez un objet wandb.Settings à wandb.init() lorsque vous initialisez un run. Les paramètres pertinents incluent show_errors, show_warnings, show_info et silent. La référence de Settings répertorie tous les paramètres et est générée à partir du SDK. Elle reste donc à jour à mesure que de nouvelles options sont ajoutées. L’exemple ci-dessous active ou désactive l’affichage des messages informatifs, des avertissements et des erreurs de W&B dans l’onglet Logs. Définissez silent=True pour supprimer toute sortie de console de W&B (utile si vous voulez qu’un script d’entraînement n’affiche rien) :

import wandb

settings = wandb.Settings(
    show_errors=True,
    silent=False,
    show_warnings=True,
)

with wandb.init(settings=settings) as run:
    run.log({"accuracy": 0.95})

Pour la capture de stdout et stderr (console), les téléversements multipart (console_multipart, console_chunk_max_bytes, console_chunk_max_seconds) et le dépannage, voir les sections ci-dessous et la référence des paramètres. L’entraînement distribué et d’autres cas limites sont traités dans Pourquoi la sortie de la console n’est-elle pas capturée pour mon run ?.

Journalisation multipart de la console

Par défaut, W&B stocke les flux stdout et stderr de votre script dans un seul fichier output.log et le téléverse à la fin du run. Tant qu’un run est actif, l’onglet Logs affiche la sortie en streaming, mais output.log n’apparaît pas dans l’onglet Files avant la fin du run. Activez la journalisation multipart de la console si vous avez besoin d’un journal de console téléchargeable pendant qu’un run est encore actif, si un run risque de planter avant la fin, ou si vous reprenez un run et souhaitez conserver la sortie du journal de console des sessions précédentes. Définissez console_multipart=True (SDK v0.22.3 ou version ultérieure) pour que le SDK écrive des fragments horodatés dans logs/ et téléverse chaque fragment à sa fermeture. Utilisez console_chunk_max_bytes et console_chunk_max_seconds pour contrôler le découpage ; voir la référence des paramètres pour les valeurs par défaut et le comportement lorsque les deux sont à 0.

Les fragments téléversés sont immuables. Les séquences de contrôle du terminal qui modifient des lignes précédentes (par exemple, les barres de progression qui utilisent des retours chariot) n’affectent que le fragment en cours.

import wandb

with wandb.init(
    project="my-project",
    settings=wandb.Settings(
        console_multipart=True,
        console_chunk_max_bytes=1_000_000,  # rotation vers ~1 Mo
        console_chunk_max_seconds=60,     # ou toutes les 60 secondes, selon la première limite atteinte
    ),
) as run:
    print("Logs upload in chunks while this run is active.")

Vous devez définir console_multipart au moment de l’appel à wandb.init. La cadence de téléversement ne peut pas être modifiée une fois le run démarré. Pour le dépannage (capture de la console désactivée, entraînement distribué, reprise de runs et limites d’affichage), voir Pourquoi la sortie de console n’est-elle pas capturée pour mon run ? et Comment puis-je télécharger le fichier journal de console d’un run ?.

Journalisation personnalisée

Si vous disposez déjà de votre propre configuration de journalisation, vous pouvez continuer à l’utiliser avec W&B. W&B capture les journaux de console de votre application, mais n’interfère pas avec votre propre configuration de journalisation. Vous pouvez utiliser la fonction print() intégrée à Python ou le module logging pour enregistrer des messages.

import wandb

with wandb.init(project="my-project") as run:
    for i in range(100, 1000, 100):
        # Journalise dans W&B et affiche dans la console
        run.log({"epoch": i, "loss": 0.1 * i})
        print(f"epoch: {i} loss: {0.1 * i}")

Les journaux de console se présentent comme suit :

epoch:  100 loss: 1.3191105127334595
epoch:  200 loss: 0.8664389848709106
epoch:  300 loss: 0.6157898902893066
epoch:  400 loss: 0.4961796700954437
epoch:  500 loss: 0.42592573165893555
epoch:  600 loss: 0.3771176040172577
epoch:  700 loss: 0.3393910825252533
epoch:  800 loss: 0.3082585036754608
epoch:  900 loss: 0.28154927492141724

Horodatages

W&B ajoute automatiquement des horodatages à chaque entrée des journaux de console. Cela vous permet de savoir à quel moment chaque message de log a été généré. Pour afficher ou masquer les horodatages dans les journaux de console, sélectionnez la liste déroulante Timestamp visible sur la page des journaux de console.

Rechercher dans les journaux de console

Utilisez la barre de recherche sur la page des journaux de console pour trouver du texte spécifique, tel que des libellés, des mots-clés ou des messages d’erreur. À mesure que de nouveaux journaux arrivent, W&B met à jour le nombre de correspondances.

Filtrer avec des libellés personnalisés

Les paramètres préfixés par x_ (comme x_label) sont en aperçu public. Créez une issue GitHub dans le dépôt W&B pour nous faire part de vos commentaires.

Vous pouvez filtrer les journaux de console à partir des libellés que vous passez comme arguments à x_label dans wandb.Settings. Saisissez le libellé dans la barre de recherche de la page des journaux de console.

import wandb

# Initialiser un run dans le nœud principal
with wandb.init(
    entity="[ENTITY-NAME]",
    project="[PROJECT-NAME]",
    settings=wandb.Settings(
        x_label="[CUSTOM-LABEL]"  # (Facultatif) Libellé personnalisé pour filtrer les journaux
    )
) as run:
    # Votre code ici

Télécharger les journaux de console

Pour enregistrer les journaux localement afin de les analyser hors ligne ou de les partager, téléchargez les journaux de console d’un run dans la W&B App :

Accédez à votre projet dans la W&B App.
Sélectionnez un run dans le tableau Runs.
Cliquez sur l’onglet Logs dans la barre latérale du projet.
Cliquez sur le bouton permettant de télécharger le fichier journal () sur la page des journaux de console.

Il se peut que vous ne puissiez temporairement pas télécharger les journaux lorsqu’un run les diffuse activement. Pendant la diffusion, W&B remplace le bouton de téléchargement par une icône de points de suspension (). Attendez que le run se termine ou cesse la diffusion, puis réessayez.

Copier les journaux de console

Pour coller des journaux dans un autre outil ou message, copiez les journaux de console d’un run dans la W&B App :

Accédez à votre projet dans la W&B App.
Sélectionnez un run dans le tableau Runs.
Cliquez sur l’onglet Logs dans la barre latérale du projet.
Cliquez sur le bouton de copie sur la page des journaux de console.

Guides

Intégrations

Référence

Afficher les journaux de console

Types de journaux de console

Paramètres des journaux de console

Journalisation multipart de la console

Journalisation personnalisée

Horodatages

Rechercher dans les journaux de console

Filtrer avec des libellés personnalisés

Télécharger les journaux de console

Copier les journaux de console

​Afficher les journaux de console

​Types de journaux de console

​Paramètres des journaux de console

​Journalisation multipart de la console

​Journalisation personnalisée

​Horodatages

​Rechercher dans les journaux de console

​Filtrer avec des libellés personnalisés

​Télécharger les journaux de console

​Copier les journaux de console

Afficher les journaux de console

Types de journaux de console

Paramètres des journaux de console

Journalisation multipart de la console

Journalisation personnalisée

Horodatages

Rechercher dans les journaux de console

Filtrer avec des libellés personnalisés

Télécharger les journaux de console

Copier les journaux de console