Envoyer une alerte

Envoyez des alertes depuis votre code Python vers Slack ou par e-mail

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 offrent un autre moyen de notifier Slack en fonction d’un événement dans W&B, par exemple lorsqu’une version d’artifact est créée ou lorsqu’une métrique de run 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 ou créez une automation.

Le guide suivant s’applique uniquement aux alertes du Cloud mutualisé.

Si vous utilisez W&B Server dans votre Cloud privé ou sur W&B Cloud dédié, reportez-vous à Configurer les alertes Slack dans W&B Server pour configurer les alertes Slack.

Pour configurer une alerte, suivez ces étapes, détaillées dans les sections suivantes :

1. Activez les alertes dans les Paramètres utilisateur de 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 :

• 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

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

​

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.

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é.

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.