> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-css-tab-borders.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Envoyez des alertes depuis votre code Python vers Slack ou par e-mail
# Envoyer une alerte
export const ColabLink = ({url}) =>
Essayer sur Colab
;
Créez des alertes avec Slack ou par e-mail si 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 (renvoie NaN) ou lorsqu’une étape de votre pipeline ML se termine. Les alertes s’appliquent à tous les projets dans lesquels vous initialisez des runs, y compris les projets personnels et les projets d’équipe.
Vous pouvez ensuite voir les messages W\&B Alerts dans Slack (ou dans votre messagerie) :
Pour utiliser W\&B Alerts, vous devez ajouter `run.alert()` à votre code. Sans modifier votre code, [Automations](/fr/models/automations/) offrent un autre moyen de notifier Slack en fonction d’un événement dans W\&B, par exemple lorsqu’une version d’[artifact](/fr/models/artifacts/) est créée ou lorsqu’une [métrique de run](/fr/models/runs/) atteint un seuil ou varie au-delà d’un seuil.
Par exemple, une automation peut notifier un canal Slack lorsqu’une nouvelle version est créée, exécuter un webhook de test automatisé lorsque l’alias `production` est ajouté à un artifact, ou démarrer un job de validation uniquement lorsque la `loss` d’un run se situe dans des limites acceptables.
Consultez l’[aperçu d’Automations](/fr/models/automations/) ou [créez une automation](/fr/models/automations/create-automations/).
Le guide suivant s’applique uniquement aux alertes du Cloud mutualisé.
Si vous utilisez [W\&B Server](/fr/platform/hosting/) dans votre Cloud privé ou sur W\&B Cloud dédié, reportez-vous à [Configurer les alertes Slack dans W\&B Server](/fr/platform/hosting/monitoring-usage/slack-alerts) pour configurer les alertes Slack.
## Alertes automatisées du cycle de vie des runs
W\&B peut vous notifier lorsqu’un run se termine ou a planté, sans aucune modification du code. Dans vos [Paramètres utilisateur](https://wandb.ai/settings), faites défiler jusqu’à la section **alertes** et activez :
* **Run finished** pour être notifié lorsqu’un run se termine avec succès.
* **Run crashed** pour être notifié lorsqu’un run s’arrête sans appeler [`run.finish()`](/fr/models/ref/python/experiments/run#finish).
Ces bascules sont propres à chaque utilisateur. Les alertes **Run finished** ne se déclenchent pas pour les runs dans les notebooks Jupyter. Dans les notebooks, utilisez `run.alert()` pour les notifications de fin d’exécution.
Les alertes sont envoyées par e-mail ou via Slack, configurés dans le même panneau Paramètres utilisateur. La configuration de l’envoi est partagée avec les alertes scriptables, décrites 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 valeur de perte NaN.
Pour configurer des alertes scriptables avec `run.alert()`, suivez ces étapes, détaillées dans les sections suivantes :
1. Activez alertes dans vos [Paramètres utilisateur](https://wandb.ai/settings) W\&B.
2. Ajoutez `run.alert()` à votre code.
3. Testez la configuration.
### 1. Activez les alertes dans les Paramètres utilisateur de W\&B
Dans vos [Paramètres utilisateur](https://wandb.ai/settings) :
* Faites défiler la page jusqu'à la section **Alertes**
* Activez **Scriptable run alerts** pour recevoir des alertes via `run.alert()`
* Utilisez **Connect Slack** pour choisir un canal Slack où envoyer les alertes. Nous recommandons le canal **Slackbot**, car il permet de garder les alertes privées.
* Les **e-mails** seront envoyés à l'adresse e-mail que vous avez utilisée lors de votre inscription à W\&B. Nous vous recommandons de configurer un filtre dans votre messagerie afin que toutes ces alertes soient dirigées vers un dossier et n'encombrent pas votre boîte de réception.
Vous n'aurez à le faire qu'une seule fois, lors de la configuration initiale de W\&B Alerts, ou si vous souhaitez modifier la façon dont vous recevez les alertes.
### 2. Ajoutez `run.alert()` à votre code
Ajoutez `run.alert()` à votre code (dans un Notebook ou un script Python) à l’endroit où vous voulez le déclencher
```python theme={null}
import wandb
with wandb.init() as run:
run.alert(title="High Loss", text="Loss is increasing rapidly")
```
### 3. Tester la configuration
Consultez Slack ou vos e-mails pour voir si vous avez reçu le message d’alerte. Si vous n’avez rien reçu, assurez-vous que les e-mails ou Slack sont activés pour les **Scriptable Alerts** dans vos [Paramètres utilisateur](https://wandb.ai/settings)
## Exemple
Cette alerte simple envoie un avertissement lorsque la métrique accuracy passe sous un seuil. Dans cet exemple, elle n’envoie des alertes qu’à 5 minutes d’intervalle minimum.
```python theme={null}
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,
)
```
## Identifier ou mentionner des utilisateurs
Utilisez le symbole `@`, suivi de l’ID utilisateur Slack, pour vous mentionner vous-même ou mentionner vos collègues dans le titre ou le texte de l’alerte. Vous trouverez l’ID utilisateur Slack sur la page de profil Slack de l’utilisateur concerné.
```python theme={null}
run.alert(title="Loss is NaN", text=f"Hey <@U1234ABCD> loss has gone to NaN")
```
## Configurer les alertes d’équipe
Les administrateurs d’équipe peuvent configurer des alertes pour l’équipe sur la page Team settings : `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**, car il permet de garder les alertes privées.
## Modifier le canal Slack auquel envoyer les alertes
Pour modifier le canal auquel les alertes sont envoyées, cliquez sur **Disconnect Slack**, puis reconnectez Slack. Après la reconnexion, choisissez un autre canal Slack.
