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.
• Sur les mises à jour des alertes : lorsque l'envoi des mises à jour est activé pour la destination, Lakewatch publie également un événement lakewatch.alert.updated lorsque l'état, le titre, la gravité, la description, la classification ou le responsable d'une alerte déjà exportée change. Lorsqu'une alerte se ferme, vous recevez un événement updated avec alert_state défini sur RESOLVED ou DUPLICATE. Il n'y a pas d'événement de fermeture séparé. Pour activer l'envoi des mises à jour, sélectionnez Envoyer également les mises à jour des alertes dans les paramètres. Voir Configurer les paramètres.
• Votre story décide du résultat : une exportation réussie signifie que Tines a reçu l’événement, pas que votre story a agi dessus.

attention

Lakewatch envoie chaque événement une fois. Si la remise à Tines échoue, Lakewatch enregistre l’échec et ne renvoie pas l’événement. L'alerte apparaît toujours dans Lakewatch.

Utilisez data.alert_id pour faire correspondre les événements à la même alerte. Avec la livraison des mises à jour activée, une alerte produit un événement created puis des événements updated, donc vérifiez event_type pour les différencier. delivery_attempt_id change à chaque livraison, donc il ne peut pas vous dire si deux événements concernent la même alerte.

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, sous la forme https://<tenant>.tines.com/webhook/<path>, et accessible depuis l’Internet public. Lakewatch ne peut pas effectuer de livraison vers des réseaux privés, tels que des Endpoint situés derrière Private Service Connect.

Stockez le secret du webhook en tant que secret Unity Catalog

Stockez le secret de webhook Tines dans un secret Unity Catalog dans le schéma __lakewatch du catalogue de votre environnement Lakewatch. Sélectionner un secret liste les secrets de ce schéma et Créer un secret en crée un. Lakewatch stocke uniquement le nom du secret, pas la valeur du secret.

Vous pouvez créer ce secret à l'avance dans <catalog>.__lakewatch, ou le créer 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 soit la propriété du schéma __lakewatch, soit CREATE SECRET et USE SCHEMA sur celui-ci. Pour les étapes, consultez 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.
• Le privilège MANAGE sur le catalogue de votre environnement Lakewatch. Voir Configurer les paramètres.

Pour modifier le secret du webhook, mettez à jour la valeur du même secret Unity Catalog. Lakewatch utilise la nouvelle valeur lors de l'exportation suivante, sans modifier les paramètres. Pour utiliser un autre secret, cliquez sur Sélectionner un secret ou Créer un secret dans les paramètres et enregistrez.

Configurer Tines comme destination d'alerte

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. Sous Remise , définissez Destination d’alerte sur Tines .
3. Dans URL du webhook , entrez l’URL de l’action du webhook Tines (https://<tenant>.tines.com/webhook/<path>).
4. Pour secret Webhook , cliquez sur Sélectionner un secret pour choisir le secret qui détient le secret webhook, ou cliquez sur Créer un secret pour en créer un à partir du secret webhook sans quitter la page. Le champ affiche le nom du secret, pas sa valeur.
5. 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, le secret se trouve dans un catalogue différent de votre environnement Lakewatch, ou l’URL du webhook n’utilise pas HTTPS ou pointe vers un réseau privé. Confirmez votre accès au secret, à son catalogue et à l’URL du webhook.
• Votre secret ne figure pas dans Sélectionner le secret : Sélectionner le secret répertorie uniquement les secrets auxquels vous pouvez accéder dans le schéma __lakewatch du catalogue de votre environnement. Stockez le secret à cet endroit ou demandez READ SECRET dessus.
• 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.