Gérer les destinations de notification

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

Les notifications système sont des messages qui vous indiquent quand votre workflow rencontre un événement d’exécution (démarrage, réussite et échec). Par défaut, les notifications sont envoyées aux adresses e-mail des utilisateurs, mais les administrateurs peuvent configurer des destinations de notifications alternatives via des webhooks ou l’application Databricks Genie pour Slack et Microsoft Teams (Beta). Cela vous permet de créer des intégrations basées sur des événements avec Azure Databricks.

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

Vous devez être administrateur d’espace de travail Azure Databricks pour gérer les destinations de notification. Une fois qu’une destination est configurée, elle est disponible pour tous les utilisateurs.

Exigences réseau

Pour les destinations basées sur webhook, le point d’accès récepteur doit répondre aux exigences suivantes :

• Azure Databricks applique l’utilisation du protocole HTTPS pour la sécurité. La destination de notification doit utiliser des certificats SSL (Secure Sockets Layer) signés par une autorité de certification approuvée.
• La destination de notification doit ajouter à sa liste d'autorisation à la fois le plan de contrôle de l'espace de travail et les adresses IP sortantes du plan de données.

  • Pour connaître les adresses IP de l'application web du plan de contrôle, consultez adresses IP et domaines pour les services et les ressources Azure Databricks.

  • Pour les adresses IP sortantes du plan de données, consultez le ip-ranges.json fichier qui Azure Databricks publie. Recherchez le fichier dans la région du plan de données de votre espace de travail et autorisez la liste des adresses IP sortantes correspondantes dans votre pile réseau.

    Azure Databricks pouvez mettre à jour les adresses IP sortantes aussi souvent qu’une fois toutes les 30 jours. Les adresses IP mises à jour deviennent actives dès 60 jours après la publication. Vérifiez donc régulièrement le fichier et mettez à jour votre liste verte avant la fermeture de la fenêtre d’activation.

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

    • Le service champ est Databricks
    • Le platform champ est azure
    • Le type champ 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 de l’espace de travail, puis sélectionnez Paramètres dans la liste déroulante.
2. Dans la section Administrateur de l’espace de travail, cliquez sur l’onglet Notifications.
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, avec authentification OAuth optionnelle (Beta)
   • Microsoft Teams
   • PagerDuty
6. Configurez la destination en fonction du type.
7. Cliquez sur Créer.

Charges utiles des webhooks

Le service qui envoie une notification définit la charge utile du webhook. Pour les payloads envoyés par les jobs, voir les payloads du webhook HTTP. Pour la charge utile envoyée par les alertes SQL de Databricks après un changement d’état, voir la charge utile webhook d’alerte SQL.

Utiliser des informations d’identification différentes pour chaque destination

La configuration d’une destination est stockée en toute sécurité dans votre espace de travail Azure Databricks. Pour les destinations qui nécessitent de fournir une URL ou des identifiants, Azure Databricks recommande d’utiliser différents identifiants pour chaque destination configurée. Cela limite l’impact si un point de terminaison tiers est compromis. Il s’agit notamment des paramètres suivants :

• Slack utilisant un webhook : l’URL vers laquelle la notification est envoyée.
• Microsoft Teams utilisant un webhook : l’URL à laquelle la notification est envoyée.
• PagerDuty : clé d’intégration utilisée pour acheminer de manière unique des notifications vers un service PagerDuty.
• Webhook : un nom d’utilisateur et un mot de passe pour l’authentification HTTP Basic, ou un identifiant client et un secret client pour l’authentification OAuth (Beta).

L’utilisation de secrets différents pour chaque destination configurée vous permet de révoquer individuellement l’accès des destinations de notification individuelles sans affecter l’opération de toutes les autres destinations de votre espace de travail Azure Databricks.

Authentification OAuth pour les destinations webhook

Utilisez les identifiants client OAuth 2.0 pour envoyer des notifications à un point de terminaison nécessitant un jeton d’accès. Azure Databricks obtient le jeton auprès de votre fournisseur d’identité et l’utilise pour authentifier la demande de notification.

Votre fournisseur d’identité doit soutenir l’octroi des identifiants du client. Le point de terminaison de réception et le point de terminaison du jeton doivent tous les deux utiliser HTTPS.

Pour créer une destination de webhook OAuth :

1. Dans les Notifications des paramètres>, cliquez sur Gérer, puis sur +Ajouter la destination.
2. Saisissez un nom et sélectionnez Webhook pour Type.
3. Pour le mode Authentification, sélectionnez OAuth.
4. Entrez les valeurs suivantes :
   • URL : Le point de terminaison qui reçoit les notifications.
   • ID client et secret client : Les identifiants délivrés par votre fournisseur d’identité.
   • URL du point de terminaison du jeton: Point de terminaison à partir duquel Azure Databricks obtient un jeton d’accès.
   • Étendues et audience : saisissez ces valeurs optionnelles si votre fournisseur d’identité l’exige. Séparez les étendues par des virgules.
5. Cliquez sur Créer.

L’identifiant client, le secret client et l’URL du point de terminaison du jeton sont requis ensemble. OAuth ne peut pas être combiné avec l’authentification HTTP Basic.

Pour vérifier la configuration, ouvrez le menu à trois points de la destination et cliquez sur Test. Azure Databricks obtient un token d’accès et envoie une notification d’exemple. Si le test échoue, vérifiez les identifiants, les périmètres, l’audience, les permissions du récepteur et l’accès réseau aux deux points de terminaison.

Destination Slack

Pour configurer une destination Slack basée sur des webhooks, suivez les instructions dans Incoming webhooks pour Slack. Collez l’URL générée dans votre destination de notification Azure Databricks. Pour utiliser l’application Databricks Genie à la place, consultez les destinations des applications Slack et Microsoft Teams Genie.

Destinations des applications Slack et Microsoft Teams Genie

Utilisez l’application Databricks Genie pour connecter votre espace de travail Slack ou votre locataire Microsoft Teams à votre espace de travail Azure Databricks. Ensuite, sélectionnez un canal disponible comme destination de notification.

Vous pouvez utiliser les destinations de l’application Genie avec les fonctionnalités suivantes :

• Alertes SQL : Slack et Microsoft Teams.
• Demandes d’accès au catalogue Unity : Slack et Microsoft Teams.
• Notification de points de terminaison de mise en service de modèles : Slack.

Créer une destination pour l’application Genie

Avant de créer une destination d’application Genie, vous devez installer l’application Databricks Genie pour Slack ou Microsoft Teams, la connecter à votre espace de travail Azure Databricks, puis l’ajouter au canal qui reçoit les notifications. Pour plus de détails sur l’installation des applications et les étapes de connexion, consultez Slack ou Microsoft Teams.

Pour créer une destination d’application Genie :

1. Dans les Notifications des paramètres>, cliquez sur Gérer, puis sur +Ajouter la destination.

2. Pour Type, sélectionnez Slack ou Microsoft Teams, puis utilisez l’application Databricks.

3. Saisissez un nom pour la destination.

4. Sélectionnez l’espace de travail ou le locataire et la chaîne :

   • Pour Slack, sélectionnez l’espace de travail et le canal Slack.
   • Pour Microsoft Teams, sélectionnez le Locataire et la Chaîne. Le sélecteur de locataire identifie chaque locataire par les six derniers caractères de son identifiant locataire.

   Si aucun espace de travail Slack ou locataire Microsoft Teams n’est connecté, cliquez respectivement sur Connecter un espace de travail Slack ou Connecter un locataire Teams, et terminez la configuration de l’application Genie. Retournez au formulaire de destination et cliquez sur Actualiser. Si vous venez d’ajouter l’application Genie à une chaîne, cliquez sur Recharger les chaînes pour mettre à jour la liste des chaînes.

5. Cliquez sur Créer.

Destination PagerDuty

Pour configurer une destination PagerDuty :

1. Dans PagerDuty, ajoutez une intégration à votre service et sélectionnez le type d’intégration Events API V2 .
2. Copiez la clé d’intégration que PagerDuty génère pour l’intégration.
3. Dans Azure Databricks, collez la clé d’intégration dans la destination de notification PagerDuty.

Ajouter un webhook à un travail

Après avoir configuré des destinations, vous pouvez les accéder dans les paramètres des notifications de tâche. Pour plus d’informations, consultez Ajouter des notifications à une tâche.

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

Limites

Les destinations de notification ont actuellement les limitations suivantes :

• Les destinations de notification par e-mail ont une limite de 1 300 caractères sur l’adresse du destinataire.
• Pour les corps de notifications personnalisés, les destinations non liées aux emails comme Slack et Microsoft Teams ne prennent pas en charge la mise en forme HTML. Certaines destinations de notification prennent en charge le formatage Markdown.
• Pour les travaux, les destinations de messagerie doivent être définies manuellement dans les paramètres du travail.