Gérer les destinations de notification

Cette page vous explique comment créer et configurer des destinations de notification pour votre Workspace.

Les notifications système sont des messages qui vous informent lorsque votre workflow rencontre un événement d'exécution (start, succès et échec). By default, les notifications sont envoyées aux adresses e-mail des utilisateurs, mais les administrateurs peuvent configurer des destinations de notification alternatives en utilisant des webhooks. Cela vous permet de créer des intégrations basées sur les événements avec Databricks.

Les administrateurs peuvent également configurer des destinations de notification pour recevoir les demandes d'accès des utilisateurs de l'espace de travail, telles que les demandes de privilèges sur les objets Unity Catalog.

Vous devez être administrateur du Workspace Databricks pour gérer les destinations de notification. Une fois la destination configurée, elle est disponible pour tous les utilisateurs.

Exigences réseau

• Databricks impose l'utilisation de HTTPS pour la sécurité. La destination de notification doit utiliser des certificats Secure Sockets Layer (SSL) signés par une autorité de certification de confiance.
• La destination de notification doit ajouter les adresses IP sortantes du plan de contrôle et du plan de données du Workspace à sa liste d'autorisation :

  • Pour les adresses IP de l'application web du plan de contrôle, consultez les adresses IP et les domaines pour les services et assets Databricks.

  • Pour les adresses IP sortantes du plan de données, consultez le fichier ip-ranges.json publié par Databricks. Recherchez dans le fichier la région du plan de données de votre Workspace et autorisez les adresses IP sortantes correspondantes dans votre pile réseau.

    Databricks peut mettre à jour les adresses IP sortantes jusqu'à une fois tous les 30 jours. Les adresses IP mises à jour deviennent actives 60 jours après la publication au plus tôt ; examinez donc le fichier régulièrement et mettez à jour votre liste d'autorisation avant la fin de la fenêtre d'activation.

    Pour suivre les modifications entre les versions, enregistrez les versions successives du fichier JSON et comparez la valeur timestampSeconds. Filtrer les entrées où :

    • Le champ service est Databricks
    • Le champ platform est aws
    • Le champ type est outbound

Créer une nouvelle destination de notification

Pour configurer une nouvelle destination de notification

1. Cliquez sur votre nom d'utilisateur dans la barre supérieure du Workspace et sélectionnez Paramètres dans le menu déroulant.

2. Dans la section Administration du Workspace , cliquez sur l'onglet tab .

3. Cliquez sur le bouton **Gérer**.

4. Cliquez sur +Ajouter une destination .

5. Sélectionnez un type de destination. Les destinations suivantes sont actuellement prises en charge :

   • E-mail
   • Slack
   • Webhook
   • MS Teams
   • PagerDuty

6. Configurez la destination en fonction du type.

7. Cliquez sur Créer .

Utilisez des informations d'identification différentes pour chaque destination

La configuration d'une destination est stockée de manière sécurisée et chiffrée dans votre workspace Databricks. Pour améliorer la sécurité si l'Endpoint tiers est compromis, Databricks recommande d'utiliser des informations d'identification différentes pour chaque destination configurée. Celles-ci incluent :

• Slack : l'URL à laquelle la notification est envoyée.
• MS Teams : l'URL à laquelle la notification est envoyée.
• PagerDuty : clé d'intégration utilisée pour acheminer de manière unique les notifications vers un service PagerDuty.
• Webhook : nom d’utilisateur et mot de passe utilisés pour s’authentifier auprès d’un endpoint tiers à l’aide de l’authentification HTTP de base lors de la diffusion des notifications.

L’utilisation de différents secrets pour chaque destination configurée vous permet de révoquer individuellement l’accès aux destinations de notification individuelles sans incidence sur le fonctionnement de toutes les autres destinations de votre workspace Databricks.

Destination Slack

Pour configurer une destination Slack, suivez les instructions dans Webhooks entrants pour Slack. Collez l’URL générée dans votre destination de notification Databricks.

Ajouter un webhook à un job

Après avoir configuré les destinations, vous pouvez y accéder dans les paramètres des notifications de Job d'un Job. Pour plus d'informations, consultez Ajouter des notifications sur un Job.

Chaque Job prend en charge jusqu'à trois destinations système par type d'événement. Lors de la configuration des notifications de Job, les adresses e-mail doivent être saisies manuellement.

Limitations

Les destinations de notification présentent actuellement les limitations suivantes :

• Vous ne pouvez configurer les notifications que pour Databricks SQL et les Jobs.
• Les destinations de notification par e-mail ont une limite de 1 300 caractères pour la longueur de l’adresse du destinataire.
• Pour les corps de notification personnalisés, les destinations autres que l'e-mail, telles que Slack et MS Teams, ne prennent pas en charge le formatage HTML. Certaines destinations de notification prennent en charge le Markdown.
• Pour les Jobs, les destinations des e-mails doivent être définies manuellement dans les paramètres du Job.