Tines

info

Aperçu

Lakewatch est en aperçu privé. Pour demander l'accès, contactez votre équipe de compte Databricks.

Exporter les alertes Lakewatch alertes vers une story Tines. Lorsqu’une alerte est créée, Lakewatch publie un événement JSON sur un webhook Tines, et votre story Tines détermine ce qui se passe ensuite. Pour connaître le comportement de l’exportation selon les destinations, consultez Destinations d’alerte.

L’exportation vers Tines est unidirectionnelle, de Lakewatch vers Tines. Lakewatch envoie l’événement par le biais d’une action webhook Tines, en s’authentifiant avec un secret de webhook que vous stockez en tant que secret Unity Catalog.

Comment l’événement est envoyé

• Lors de la création de l'alerte : Lakewatch publie un événement JSON avec event_type lakewatch.alert.created. La charge utile utilise le même schéma et les mêmes noms de champs que la destination webhook générique ; une histoire Tines peut donc lire les mêmes champs.
• Lors des mises à jour des alertes : lorsque la livraison des mises à jour est activée pour la destination, Lakewatch publie également un événement lakewatch.alert.updated pour les modifications ultérieures d'une alerte déjà exportée. Pour activer la livraison des mises à jour, consultez Configurer les paramètres.
• Votre scénario détermine le résultat : Lakewatch transmet l'événement à votre scénario Tines. Une réponse 2xx signifie que Tines a accepté l'événement, pas que votre scénario a agi en conséquence. Si Lakewatch signale une exportation réussie mais que rien ne se passe dans Tines, vérifiez votre logique de scénario plutôt que la configuration de l'exportation.

attention

La livraison est au plus une fois. Si une POST vers Tines échoue, Lakewatch enregistre l’échec mais ne relance pas l’opération, et l’événement n’est pas renvoyé. L’alerte est toujours créée dans Lakewatch.

Pour éviter de traiter deux fois la même alerte, corrélez les événements dans votre story Tines selon le champ data.alert_id. Ne dédupliquez pas sur delivery_attempt_id, qui prend une nouvelle valeur à chaque livraison. Si la livraison des mises à jour est activée, vous recevez plusieurs événements pour le même alert_id (un événement created, puis des événements updated) ; distinguez-les par event_type plutôt que de les regrouper sur alert_id.

Prérequis

Configurer le webhook Tines

Dans votre story Tines, ajoutez une action de webhook entrant et configurez-la pour l’authentification avec un secret :

1. Ajoutez une action Webhook à votre story.
2. Définissez l’action de sorte à requérir un secret, envoyé en tant qu’en-tête (mode d’accès secret). Notez l’URL du webhook et le secret.

Pour plus de détails, consultez la documentation sur l'action de webhook Tines.

L’URL du webhook doit être une URL d’action de webhook, au format https://<tenant>.tines.com/webhook/<path>.

Stockez le secret du webhook en tant que secret Unity Catalog

Lakewatch lit le secret du webhook à partir d’un secret Unity Catalog, un élément sécurisable avec un nom à trois niveaux sous la forme catalog.schema.secret, chaque fois qu’il exporte une alerte. Lakewatch stocke uniquement le nom du secret, pas sa valeur.

Vous pouvez créer ce secret à l’avance ou le créer en ligne lors de la configuration de l’export Tines avec le bouton Créer un secret . Quoi qu’il en soit, la création d’un secret nécessite USE CATALOG sur le catalogue et la propriété du schéma ou à la fois CREATE SECRET et USE SCHEMA sur le schéma. Pour les étapes, voir Créer un secret.

Autorisations requises

Pour configurer l'exportation Tines, vous avez besoin des éléments suivants :

• READ SECRET sur le secret Unity Catalog contenant le secret du webhook, ou sur son schéma ou catalogue parent. Lakewatch vérifie que vous avez l'autorisation de lire le secret lorsque vous sauvegardez la configuration. Pour l'accorder, consultez la rubrique Gérer les autorisations sur les secrets.
• Autorisation de modifier la configuration d'exportation des alertes dans les paramètres de Workspace.

Lors de l’exportation, Lakewatch lit lui-même le secret du webhook en tant que Service Principal. Comme Lakewatch lit le secret par son nom à chaque fois qu’il l’exporte, la rotation du secret est sans intervention : mettez à jour le secret Unity Catalog et Lakewatch utilisera la nouvelle valeur lors de l’exportation suivante, sans aucune modification de la configuration de l’exportation.

Configurer l’exportation Tines

Configurez une destination Tines pour les alertes dans la section des paramètres Alertes .

1. Dans la barre latérale de Lakewatch, accédez à Paramètres , puis ouvrez Alertes .
2. Trouvez le paramètre Exporter sous Alertes .
3. Définissez la destination d’exportation sur Tines .
4. Pour Workspace , conservez le workspace actuel, sauf si la destination se trouve derrière le réseau d’un workspace spécifique, tel qu’un endpoint PrivateLink ou un service restreint à une région. Le réseau de ce workspace assure l'exportation.
5. Dans URL du webhook , entrez l’URL de l’action du webhook Tines (https://<tenant>.tines.com/webhook/<path>).
6. Définissez le Secret du webhook sur le secret Unity Catalog contenant le secret du webhook. Saisissez ou collez son nom à trois niveaux (catalog.schema.secret), cliquez sur Sélectionner un secret pour choisir un secret existant, ou cliquez sur Créer un secret pour en créer un à partir du secret du webhook sans quitter la page. Après la sauvegarde, le champ du secret devient en lecture seule ; pour le mettre à jour, faites pivoter le secret dans Unity Catalog.
7. Enregistrez vos modifications.

Pour obtenir la référence complète des paramètres d’alerte, reportez-vous à Configurer les paramètres.

Dépannage

• Les événements n’atteignent pas votre scénario : l’URL du webhook n’est pas une URL d’action de webhook Tines ou le scénario est désactivé. Confirmez que l’URL est sous la forme https://<tenant>.tines.com/webhook/<path> et que le scénario est en ligne.
• La configuration n'est pas enregistrée : vous n'avez pas l'autorisation de lire le secret Unity Catalog, ou le nom du secret n'est pas au format catalog.schema.secret. Confirmez votre accès au secret et au nom du secret.
• Lakewatch signale une exportation réussie mais rien ne se passe dans Tines : une réponse 2xx signifie que Tines a accepté l’événement, et non que votre histoire a agi dessus. Vérifiez la logique de votre story Tines.
• Vous avez effectué une rotation du secret du webhook : mettez à jour le secret Unity Catalog avec la nouvelle valeur. Aucune modification de la configuration d’exportation n’est nécessaire.