> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-dbrian-docs-serverless-training-quickstart.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Journaux de console

> Consultez et déboguez les messages de console, y compris les informations, les avertissements et les erreurs, de vos runs d’expérience W&B.

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.

<div id="view-console-logs">
  ## Afficher les journaux de console
</div>

Accédez aux journaux de console d'un run dans W\&B App pour examiner les messages produits pendant le run.

1. Accédez à votre projet dans W\&B App.
2. Sélectionnez un run dans le tableau **Runs**.
3. Cliquez sur l'onglet **Logs** dans la barre latérale du projet.

<Note>
  W\&B stocke au maximum 100 000 lignes de journaux pour un run. Dans W\&B App, 10 000 lignes de journaux au maximum s'affichent à la fois. Pour voir toutes les lignes stockées, faites défiler les journaux afin d'afficher les lignes plus anciennes.
</Note>

<div id="types-of-console-logs">
  ## Types de journaux de console
</div>

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`                                   |

<div id="console-log-settings">
  ## Paramètres des journaux de console
</div>

Pour contrôler les types de sortie de console que W\&B capture et affiche, passez un objet [`wandb.Settings`](/fr/models/ref/python/experiments/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](/fr/models/ref/python/experiments/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) :

```python theme={null}
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 ?](/fr/support/models/articles/why-is-console-output-not-captured-for-my-run).

<div id="multipart-console-logging">
  ### Journalisation multipart de la console
</div>

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](/fr/models/ref/python/experiments/settings) pour les valeurs par défaut et le comportement lorsque les deux sont à `0`.

<Note>
  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.
</Note>

```python theme={null}
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 ?](/fr/support/models/articles/why-is-console-output-not-captured-for-my-run) et [Comment puis-je télécharger le fichier journal de console d’un run ?](/fr/support/models/articles/how-do-i-download-the-console-log-file-from-a-run).

<div id="custom-logging">
  ## Journalisation personnalisée
</div>

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.

```python theme={null}
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 :

```text theme={null}
1 epoch:  100 loss: 1.3191105127334595
2 epoch:  200 loss: 0.8664389848709106
3 epoch:  300 loss: 0.6157898902893066
4 epoch:  400 loss: 0.4961796700954437
5 epoch:  500 loss: 0.42592573165893555
6 epoch:  600 loss: 0.3771176040172577
7 epoch:  700 loss: 0.3393910825252533
8 epoch:  800 loss: 0.3082585036754608
9 epoch:  900 loss: 0.28154927492141724
```

<div id="timestamps">
  ## Horodatages
</div>

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.

<div id="search-console-logs">
  ## Rechercher dans les journaux de la console
</div>

Pour localiser rapidement les entrées pertinentes, utilisez la barre de recherche sur la page des journaux de la console pour filtrer les journaux à l’aide de mots-clés. Vous pouvez rechercher des termes, des libellés ou des messages d’erreur spécifiques.

<div id="filter-with-custom-labels">
  ## Filtrer avec des libellés personnalisés
</div>

<Warning>
  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](https://github.com/wandb/wandb) pour nous faire part de vos commentaires.
</Warning>

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.

```python theme={null}
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
```

<div id="download-console-logs">
  ## Télécharger les journaux de console
</div>

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 :

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

<div id="copy-console-logs">
  ## Copier les journaux de console
</div>

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

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