Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette page vous guide tout au long de la création d’une alerte Databricks SQL de bout en bout. Il couvre l’éditeur d’alerte, le didacticiel de création d’alerte, la façon de passer en revue les détails de l’évaluation, ainsi que les paramètres avancés et les modèles de notification que vous pouvez configurer.
Explorez l’éditeur d’alertes
Les étapes de cette section vous guident tout au long de la création de l’alerte illustrée dans l’image suivante. Utilisez les étiquettes et les explications pour comprendre chaque composant.
- Éditeur de requêtes : Écrivez et testez la requête sur laquelle vous souhaitez alerter.
- Compute : Choisissez l’entrepôt SQL qui exécute la requête d’alerte. L’indicateur d’état indique si le dépôt sélectionné fonctionne. Pour connaître les recommandations et le comportement de dimensionnement de l’entrepôt au moment de l’exécution planifiée, consultez Choisir un entrepôt SQL pour une alerte.
- Programme: Définissez une planification périodique pour l’exécution de l’alerte.
- Partager : Définissez des autorisations qui définissent comment les autres membres de votre espace de travail peuvent travailler avec votre alerte.
- Condition : Sélectionnez le seuil de valeur qui devrait déclencher une notification d’alerte. Vous pouvez exécuter la requête pour tester la condition à partir de cette section.
-
Notifications : Indiquez quels utilisateurs ou destinations de notification doivent être alertés lorsque la valeur seuil dépasse la plage attendue. Si vous le souhaitez, définissez une fréquence de notification afin de répéter les notifications jusqu’à ce que l’alerte revienne à
OK. - Avancé : Utilisez les paramètres avancés pour alerter sur des valeurs et conditions particulières.
Créer une alerte
Pour créer une alerte, procédez comme suit :
Cliquez
sur Alertes dans la barre latérale, puis cliquez sur Créer une alerte.Copiez et collez la requête suivante dans l’éditeur de requête. Cliquez sur Exécuter tout (1000). Pour en savoir plus sur le fonctionnement de l’éditeur SQL, consultez l’éditeur SQL de Databricks.
SELECT to_date(tpep_pickup_datetime) as date, SUM(fare_amount) as amount FROM `samples`.`nyctaxi`.`trips` GROUP BY ALL ORDER BY 1 DESCCliquez sur le sélecteur de calcul, puis cliquez sur un entrepôt dans la liste pour spécifier la ressource de calcul qui exécute l’alerte.
Dans le champ Condition , définissez les conditions qui doivent déclencher l’alerte.
Appliquez les paramètres suivants, comme indiqué :
- Sélectionnez Sum comme valeur de données à vérifier. Vous pouvez définir une condition d’alerte sur la première valeur d’une colonne dans le résultat de la requête, ou vous pouvez choisir de définir une agrégation sur toutes les lignes d’une seule colonne, comme SOMME ou MOYENNE.
- Sélectionnez la quantité en tant que colonne à vérifier.
- Sélectionnez > (supérieur à) comme opérateur logique à appliquer.
- Définissez la valeur de seuil sur
Static value4 000. La valeur statique est sélectionnée par défaut. Entrez 4000 dans le champ valeur.
Cliquez sur Condition de test pour afficher un aperçu de l’alerte et tester si l’alerte se déclencherait avec les données actuelles. Les paramètres fournis doivent déclencher l’alerte. Vous pouvez modifier la valeur de seuil pour tester davantage.
Dans la section Notifications , recherchez votre nom d’utilisateur et cliquez dessus quand il apparaît.
Cliquez sur
Icône de calendrier pour ouvrir la boîte de dialogue Modifier la planification . Utilisez les menus déroulants pour définir l’alerte afin qu’elle s’exécute toutes les 5minutes à partir de 0 minutes après l'heure. Cliquez sur Enregistrer. Si vous le souhaitez, sélectionnez la case à cocher Afficher la syntaxe Cron pour modifier la planification dans la Syntaxe Quartz Cron.
Cliquez sur Afficher l’alerte.
Votre alerte est enregistrée et s’exécute selon la planification que vous avez fournie. Les données utilisées dans cet exemple sont statiques. Par conséquent, si votre condition de test est retournée comme déclenchée, elle déclenche à nouveau la prochaine fois qu’elle s’exécute. Vous recevez une notification par e-mail en tant qu’alerte. Si la condition de test a retourné OK, aucune notification n’est envoyée.
Examiner les détails de l’alerte
Une page s’ouvre pour afficher les détails de votre alerte. La page affiche également un historique des alertes avec les détails de l’évaluation. Cliquez sur le bouton Exécuter maintenant pour exécuter la requête d’alerte immédiatement et renvoyer le résultat sur cette page.
Cliquez sur Modifier dans le coin supérieur droit de la page pour continuer à modifier l’alerte.
Analysez une alerte avec Genie Code
Important
Cette fonctionnalité est en version bêta. Pour l’utiliser, un administrateur de l’espace de travail doit activer l’aperçu Alertv2 Genie Analysis. Voir Configurer l’analyse Genie Code.
Après avoir configuré l’analyse Genie Code pour une alerte, l’analyse commence lorsque l’alerte passe d’un autre état à Triggered ou Error. Voir Configurer l’analyse du code Genie. Une évaluation qui reste dans le même état ne déclenche pas une autre analyse. Si le démarrage de l’analyse échoue ou prend plus de 60 secondes, l’évaluation des alertes et les notifications continuent sans lien d’enquête.
Une fois l’analyse terminée, cliquez sur Examiner pour l’évaluation dans Historique. Vous pouvez également ouvrir Détails de l’évaluation et cliquer sur Investigate. Les deux liens ouvrent la même enquête sur Genie Code.
Les modèles de notification par défaut pris en charge peuvent également inclure un lien d’enquête. Ces modèles incluent l’email, Microsoft Teams, PagerDuty, Slack Block Kit et les webhooks par défaut. Les pièces jointes Slack anciennes et les modèles de webhook personnalisés n’incluent pas le lien.
L’utilisateur dont les identifiants exécutent l’alerte est propriétaire du fil Genie Code généré. Un lien d’enquête n’accorde pas d’accès, et les autorisations d’alerte et de thread sont distinctes. Voir Configurer les permissions d’alerte et transférer la propriété de l’alerte. Le propriétaire du fil doit partager le fil de discussion avec les destinataires avant qu’ils ne puissent l’ouvrir. Les enquêtes générées sont en lecture seule. Pour poursuivre l’enquête dans une copie modifiable, cliquez sur Cloner pour continuer.
Limites des exécutions actives de l’espace de travail
Les exécutions d’alerte sont soumises à une limite d’exécution active au niveau de l’espace de travail. Chaque espace de travail a une limite par défaut de 250 exécutions d’alertes actives simultanées. Lorsque tous les emplacements d’exécution sont utilisés et qu’une alerte planifiée se déclenche, l’exécution de l’alerte est ignorée et l’alerte n’est pas évaluée.
Si vous soupçonnez que des alertes sont sautées, vérifiez dans l’historique d’évaluation s’il y a des lacunes à l’heure planifiée. Le cas le plus courant est que toutes les alertes concernées partagent la même planification et qu’un lancement manuel via Run now réussit, car il s’exécute en dehors du pic de concurrence.
Évitez d’atteindre la limite d’exécution active
Pour réduire la demande simultanée sur les créneaux d’exécution, décalez les horaires des alertes afin qu’elles ne se déclenchent pas toutes en même temps. Par exemple, au lieu de planifier toutes les alertes à l’adresse 01:30, planifiez-les à 01:30, 01:32, 01:34et ainsi de suite.
Demander une augmentation de quota
Si votre espace de travail atteint de manière cohérente la limite d’exécution active, contactez le support Databricks pour demander une augmentation du quota maximal d’exécutions actives de votre espace de travail. Indiquez l’ID de l’espace de travail, la fenêtre temporelle approximative pendant laquelle des exécutions ont été ignorées, ainsi que le nombre total d’alertes affectées.
Paramètres avancés
Cliquez sur Paramètres avancés pour appliquer les paramètres suivants :
-
Notifier lorsque l’état est OK : Envoyez une notification lorsque l’alerte repasse à l’état
OK. - État de résultat vide : Définissez un statut spécial à retourner lorsque la requête ne donne aucun résultat.
- Modèle : Configurez le modèle de notification. Consultez les modèles de notification.
Les administrateurs d’espace de travail peuvent configurer de nouvelles destinations de notification. Consultez Gérer les destinations de notification.
Pour le corps JSON envoyé par une alerte à une destination de notification webhook, voir SQL alert webhook payload.
Configurer l’analyse du code Genie
Important
Cette fonctionnalité est en version bêta. Pour l’utiliser, un administrateur d’espace de travail doit activer Alertv2 Genie Analysis depuis la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.
Un administrateur d’espace de travail doit activer l’aperçu Alertv2 Genie Analysis avant que les propriétaires d’alertes puissent configurer la fonctionnalité :
- En tant qu’administrateur d’espace de travail, cliquez sur votre nom d’utilisateur dans la barre supérieure de l’espace de travail Azure Databricks et sélectionnez Aperçus.
- Activez l’analyse Alertv2 Genie.
Consultez Gérer les préversions au niveau de l’espace de travail.
Pour configurer l’analyse du code Genie dans l’éditeur d’alertes :
- Cliquez sur Paramètres avancés.
- Sélectionnez Exécuter l’analyse du code Genie lors du déclenchement d’une alerte.
- Facultativement, saisissez des instructions personnalisées pour l’investigation. Des instructions personnalisées remplacent l’instruction d’analyse générique.
- Cliquez sur Afficher l’alerte pour enregistrer l’alerte.
L’alerte est configurée pour lancer une nouvelle enquête lorsque son état passe à Déclenché ou Erreur.
L’analyse s’applique uniquement aux alertes qui s’exécutent en tant qu’utilisateur. Les alertes qui s’exécutent en tant que principal de service ne lancent pas d’analyse. Voir Enquêter sur une alerte avec Genie Code.
Modèles de notification
Les notifications utilisent le modèle par défaut, sauf si vous les personnalisez. Pour personnaliser l’objet et le corps, sélectionnez Personnaliser le modèle. Deux éditeurs sont disponibles : l’éditeur standard et l’éditeur Markdown. Cliquez sur les onglets ci-dessous pour les comparer.
Éditeur standard
Dans l’éditeur standard, référencez des variables dans l’objet et le corps avec {{VARIABLE_NAME}}. Les variables suivantes sont prises en charge :
-
ALERT_STATUS: Le statut d’alerte évalué (chaîne). -
ALERT_CONDITION: L’opérateur de condition d’alerte (chaîne). -
ALERT_THRESHOLD: Le seuil d’alerte (chaîne ou nombre). -
ALERT_COLUMN: Le nom de la colonne d’alerte (chaîne). -
ALERT_NAME: Le nom de l’alerte (chaîne). -
ALERT_URL: L’URL de la page d’alerte (chaîne). -
QUERY_RESULT_TABLE: La table HTML (chaîne) du résultat de la requête. Les résultats sont limités aux 100 premières lignes. Seules les destinations de notification par e-mail peuvent afficher le code HTML. -
QUERY_RESULT_VALUE: La valeur du résultat de la requête (chaîne ou nombre). -
QUERY_RESULT_ROWS: Les lignes de résultats de la requête (tableau de valeurs). -
QUERY_RESULT_COLS: Les colonnes de résultats de requête (tableau de chaînes).
Par exemple : Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.
L’éditeur standard prend également en charge le code HTML pour la mise en forme. Seules les destinations de notification par e-mail peuvent afficher le code HTML. Les balises HTML suivantes sont autorisées : <a>, , , <b><blockquote><br><code><del><div><em><h1><h2><h3><h4><h5><h6><hr><i>, <img>, <li>, <ol>, , <p><pre><span><table><thead><tbody><td><th><tr><u><ul>
Les attributs suivants sont autorisés sur les balises répertoriées :
| Attribut | Balises prises en charge |
|---|---|
href |
<a> |
title |
<img> |
target |
<a> |
alt |
<img> |
src |
<img> |
start |
<b>, <blockquote>, <code>, <del>, <em>, <hr>, <i>, <pre>, <u> |
Cliquez sur le bouton bascule Preview (Aperçu) pour afficher un aperçu du résultat du rendu.
Important
L’aperçu permet de vérifier que les variables de modèle sont rendues correctement. Il ne s’agit pas d’une représentation précise du contenu de notification final, car chaque destination de notification peut afficher des notifications différemment.
Éditeur Markdown
Activez l’éditeur Markdown pour écrire le corps à l’aide de Markdown. L’éditeur Markdown a une barre d’outils de mise en forme et un aperçu rendu.
Dans l’éditeur Markdown, référencez des variables avec @VARIABLE_NAME. Saisissez @ dans le corps du message pour ouvrir le sélecteur de variables. L’éditeur Markdown prend en charge ALERT_NAME, , ALERT_STATUSALERT_CONDITIONALERT_THRESHOLD, ALERT_COLUMN, , ALERT_URLet .QUERY_RESULT_TABLE