Aller au contenu principal
Dernière mise à jour le

Jira

info

Aperçu

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

Exporter des alertes Lakewatch vers Jira sous forme de tickets. Lorsqu'une alerte est créée, Lakewatch crée un ticket Jira et le met à jour au fur et à mesure que l'alerte change. Pour savoir comment l'exportation se comporte selon les destinations, voir Destinations d'alerte.

L'exportation vers Jira est unidirectionnelle, de Lakewatch vers Jira. Lakewatch s'authentifie auprès de Jira Cloud avec une adresse e-mail utilisateur et un jeton API comme identifiant d'authentification de base.

Prérequis​

Configurer Jira​

  • Un compte Jira qui peut créer et mettre à jour des tickets dans le projet cible.
  • Un jeton d’API pour ce compte, associé à l’e-mail du compte en tant qu’identifiant d’authentification de base Jira Cloud. Créez des jetons d'API dans les paramètres de votre compte Atlassian.

Stocker le jeton API en tant que secret Unity Catalog​

Lakewatch lit le jeton d’API Jira à partir d’un secret Unity Catalog, une ressource sécurisable avec un nom à trois niveaux de la forme catalog.schema.secret, à chaque fois qu’il exporte une alerte. Lakewatch ne stocke que le nom du secret, et non la valeur du secret.

Vous pouvez créer ce secret à l'avance, ou le créer en ligne lors de la configuration de l'exportation Jira 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, soit CREATE SECRET et USE SCHEMA sur le schéma. Pour connaître les étapes, voir Créer un secret.

Autorisations requises​

Pour configurer l’exportation Jira, vous avez besoin des éléments suivants :

  • READ SECRET sur le secret Unity Catalog contenant le jeton API, ou sur son schéma ou catalogue parent. Lakewatch vérifie que vous pouvez lire le secret lorsque vous enregistrez la configuration. Pour l'accorder, voir Gérer les permissions sur les secrets.
  • Autorisation de modifier la configuration d'exportation d'alertes dans les paramètres du workspace.

Au moment de l’exportation, Lakewatch lit le jeton API lui-même, en tant que service principal. Comme Lakewatch lit le secret par son nom à chaque exportation, la rotation du secret est transparente : 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 Jira​

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

  1. Dans la barre latérale Lakewatch, accédez à Paramètres , puis ouvrez Alertes .
  2. La configuration Export se trouve sous Alertes .
  3. Définissez la destination d’exportation sur Jira .
  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 fournit l’export.
  5. Dans URL de l’instance , saisissez l’instance Jira dans laquelle les tickets sont déposés, par exemple https://acme.atlassian.net.
  6. Dans Clé de projet , saisissez le projet dans lequel les tickets doivent être créés.
  7. Dans E-mail de l'utilisateur , saisissez l'adresse e-mail du compte associée au jeton API.
  8. Définissez Jeton d’API sur le secret Unity Catalog qui contient le jeton d’API Jira. Tapez ou collez son nom à trois niveaux (catalog.schema.secret), cliquez sur Sélectionner le secret pour choisir un secret existant ou cliquez sur Créer un secret pour en créer un à partir du jeton d’API sans quitter la page. Une fois que vous avez enregistré, le champ secret devient en lecture seule ; pour le mettre à jour, faites pivoter le secret dans Unity Catalog.
  9. Dans Type de problème default , définissez éventuellement le type de problème à créer, par exemple Task.
  10. Enregistrez vos modifications.

Pour obtenir les références complètes des paramètres d’alerte, consultez la section Configurer les paramètres.

Dépannage​

  • Les tickets ne sont pas créés dans Jira : l’URL de l’instance ou la clé de projet est incorrecte, ou le compte ne peut pas créer de tickets dans le projet. Vérifiez l’URL de l’instance, la clé de projet et le fait que le compte et le jeton d’API peuvent créer des tickets dans le projet.
  • 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 sous la forme catalog.schema.secret. Confirmez votre accès au secret et au nom du secret.
  • L'authentification échoue : l'e-mail de l'utilisateur ou le jeton d'API est incorrect. Vérifiez que l'e-mail est bien celui associé au jeton et que le jeton stocké dans le secret est valide.
  • Vous avez fait tourner le jeton d’API : mettez à jour le secret Unity Catalog avec la nouvelle valeur. Aucune modification de la configuration d’exportation n’est nécessaire.
Sur cette page