> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

> Envoyez vers Slack ou par e-mail des alertes déclenchées depuis votre code Python

# Envoyer une alerte

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Try in Colab
  </a>;

<ColabLink url="https://wandb.me/alerts-colab" />

Créez des alertes par Slack ou par e-mail lorsque votre run plante, ou à l’aide d’un déclencheur personnalisé. Par exemple, vous pouvez créer une alerte si le gradient de votre boucle d’entraînement commence à exploser (valeur NaN) ou lorsqu’une étape de votre pipeline de ML se termine. Les alertes s’appliquent à tous les projets dans lesquels vous initialisez des runs, qu’il s’agisse de projets personnels ou de projets d’équipe.

Vous recevez ensuite les messages d’alertes W\&B dans Slack (ou par e-mail) :

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/send_alerts_slack.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=3739fea03fd05adb2a76cbd8d20514b0" alt="Configuration d’une alerte Slack" width="567" height="331" data-path="products/wandb/_media/send_alerts_slack.png" />
</Frame>

<Note>
  Pour utiliser les alertes W\&B, vous devez ajouter `run.alert()` à votre code. Si vous ne souhaitez pas modifier votre code, les [Automatisations](/fr/products/wandb/automations) permettent également de notifier Slack en fonction d’un événement dans W\&B, par exemple lorsqu’une version d’[artifact](/fr/products/wandb/artifacts) est créée ou lorsqu’une [métrique de run](/fr/products/wandb/runs) atteint un seuil ou varie d’une valeur donnée.

  Par exemple, une automatisation peut notifier un canal Slack lorsqu’une nouvelle version est créée, exécuter un webhook de tests automatisés lorsque l’alias `production` est ajouté à un artifact, ou lancer un job de validation uniquement lorsque la `loss` d’un run reste dans des limites acceptables.

  Consultez l’[aperçu des Automatisations](/fr/products/wandb/automations) ou [créez une automatisation](/fr/products/wandb/automations/create-automations).
</Note>

<Note>
  Le guide suivant s’applique uniquement aux alertes dans le Cloud mutualisé.

  Si vous utilisez [W\&B Server](/fr/products/wandb/platform/hosting) dans votre cloud privé ou sur le Cloud dédié W\&B, reportez-vous à [Configurer les alertes Slack dans W\&B Server](/fr/products/wandb/platform/hosting/monitoring-usage/slack-alerts) pour configurer les alertes Slack.
</Note>

<h2 id="automated-run-lifecycle-alerts">
  Alertes automatiques sur le cycle de vie des runs
</h2>

W\&B peut vous avertir lorsqu’un run se termine ou plante, sans aucune modification de code. Dans vos [Paramètres utilisateur](https://forge.coreweave.com/settings), faites défiler jusqu’à la section **Alertes** et activez :

* **Run finished** pour être averti lorsqu’un run se termine avec succès.
* **Run crashed** pour être averti lorsqu’un run s’arrête sans appeler [`run.finish()`](/fr/products/wandb/ref/python/experiments/run#finish).

Ces options sont propres à chaque utilisateur. Les alertes **Run finished** ne se déclenchent pas pour les runs exécutés dans des notebooks Jupyter. Dans les notebooks, utilisez `run.alert()` pour être averti de la fin d’exécution.

Les alertes sont envoyées par e-mail ou sur Slack, selon ce que vous avez configuré dans ce même panneau Paramètres utilisateur. Cette configuration d’envoi est commune aux alertes scriptables, présentées dans les sections suivantes, qui vous permettent de déclencher des alertes selon des conditions personnalisées, comme un seuil de métrique ou une perte NaN.

Pour configurer des alertes scriptables avec `run.alert()`, suivez les étapes ci-dessous, détaillées dans les sections suivantes :

1. Activez les alertes dans vos [Paramètres utilisateur](https://forge.coreweave.com/settings) W\&B.
2. Ajoutez `run.alert()` à votre code.
3. Testez la configuration.

<h3 id="1-turn-on-alerts-in-your-wb-user-settings">
  1) Activer les alertes dans vos Paramètres utilisateur W\&B
</h3>

Dans vos [Paramètres utilisateur](https://forge.coreweave.com/settings) :

* Faites défiler la page jusqu’à la section **Alertes**
* Activez **Scriptable run alerts** pour recevoir les alertes émises par `run.alert()`
* Cliquez sur **Connect Slack** pour choisir le canal Slack dans lequel publier les alertes. Nous vous recommandons le canal **Slackbot**, car il garde les alertes privées.
* Les alertes par **Email** sont envoyées à l’adresse e-mail utilisée lors de votre inscription à W\&B. Nous vous recommandons de configurer un filtre dans votre messagerie afin que toutes ces alertes soient classées dans un dossier et n’encombrent pas votre boîte de réception.

Vous n’aurez à effectuer cette opération que lors de votre première configuration des alertes W\&B, ou si vous souhaitez modifier la façon dont vous recevez les alertes.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/demo_connect_slack.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=447031fea4fc850c58c6910d1aa6059d" alt="Paramètres des alertes dans les Paramètres utilisateur W&B" width="1420" height="900" data-path="products/wandb/_media/demo_connect_slack.png" />
</Frame>

<h3 id="2-add-runalert-to-your-code">
  2. Ajoutez `run.alert()` à votre code
</h3>

Ajoutez `run.alert()` à votre code (dans un notebook ou un script Python) à l'endroit où vous souhaitez déclencher l'alerte

```python theme={"system"}
import wandb

with wandb.init() as run:
    run.alert(title="High Loss", text="Loss is increasing rapidly")
```

<h3 id="3-test-the-configuration">
  3. Tester la configuration
</h3>

Consultez Slack ou vos e-mails pour vérifier que vous avez bien reçu le message d’alerte. Si ce n’est pas le cas, assurez-vous d’avoir activé les notifications par e-mail ou Slack pour **Scriptable Alerts** dans vos [Paramètres utilisateur](https://forge.coreweave.com/settings)

<h2 id="example">
  Exemple
</h2>

Cette alerte simple envoie un avertissement lorsque la précision passe sous un seuil donné. Dans cet exemple, deux alertes sont toujours espacées d’au moins 5 minutes.

```python theme={"system"}
import wandb
from wandb import AlertLevel

with wandb.init() as run:

    if acc < threshold:
        run.alert(
            title="Low accuracy",
            text=f"Accuracy {acc} is below the acceptable threshold {threshold}",
            level=AlertLevel.WARN,
            wait_duration=300,
        )
```

<h2 id="tag-or-mention-users">
  Identifier ou mentionner des utilisateurs
</h2>

Utilisez l’arobase `@` suivie de l’ID utilisateur Slack pour vous identifier, vous ou vos collègues, dans le titre ou dans le texte de l’alerte. Vous pouvez trouver l’ID utilisateur Slack d’une personne sur la page de son profil Slack.

```python theme={"system"}
run.alert(title="Loss is NaN", text=f"Hey <@U1234ABCD> loss has gone to NaN")
```

<h2 id="configure-team-alerts">
  Configurer les alertes d’équipe
</h2>

Les administrateurs d’équipe peuvent configurer des alertes pour l’équipe depuis la page des paramètres de l’équipe : `wandb.ai/teams/your-team`.

Les alertes d’équipe s’appliquent à tous les membres de votre équipe. W\&B recommande d’utiliser le canal **Slackbot**, qui garantit la confidentialité des alertes.

<h2 id="change-slack-channel-to-send-alerts-to">
  Modifier le canal Slack de destination des alertes
</h2>

Pour modifier le canal qui reçoit les alertes, cliquez sur **Disconnect Slack**, puis reconnectez Slack. Une fois la connexion rétablie, choisissez un autre canal Slack.


## Related topics

- [Comment puis-je configurer les alertes et les notifications W&B ?](/fr/support/models/articles/how-do-i-set-up-wandb-alerts-and-notifications.md)
