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’export vers Jira est unidirectionnel, de Lakewatch vers Jira. Lakewatch se connecte à Jira Cloud avec un e-mail de compte et son jeton d’API.

Prérequis​

Configurer Jira​

  • Une instance Jira accessible via HTTPS 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 Link.
  • Un compte Jira qui peut créer et mettre à jour des tickets dans le projet cible.
  • Un jeton d'API pour ce compte. Créez-le dans les paramètres de votre compte Atlassian.

Stocker le jeton API en tant que secret Unity Catalog​

Stockez le jeton d’API Jira dans un secret du Unity Catalog dans le schéma __lakewatch du catalogue de votre environnement Lakewatch. Sélectionner le secret répertorie les secrets de ce schéma, et Créer un secret en crée un à cet endroit. 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'exportation Jira avec le bouton Créer un secret . Dans les deux cas, 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 connaître les étapes à suivre, consultez 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.
  • Le privilège MANAGE sur le catalogue de votre environnement Lakewatch. Voir Configurer les paramètres.

Pour changer le jeton d'API, mettez à jour la valeur du même secret Unity Catalog. Lakewatch utilise la nouvelle valeur lors de l’export suivant, sans modification des paramètres. Pour utiliser un secret différent, cliquez sur Sélectionner un secret ou Créer un secret dans les paramètres et enregistrez.

Configurer Jira comme destination d'alerte​

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. Sous Remise , définissez Destination de l'alerte sur Jira .
  3. Dans URL de l’instance Jira , saisissez l’instance Jira dans laquelle les tickets sont déposés, par exemple https://acme.atlassian.net.
  4. Dans Clé de projet , saisissez le projet dans lequel les tickets doivent être créés.
  5. Dans E-mail de l'utilisateur , saisissez l'adresse e-mail du compte associée au jeton API.
  6. Pour le secret du jeton API , cliquez sur Sélectionner un secret pour choisir le secret qui contient le jeton API, ou cliquez sur Créer un secret pour en créer un à partir du jeton API sans quitter la page. Le champ affiche le nom du secret, pas sa valeur.
  7. Dans Type de ticket default , saisissez le type de ticket à créer, comme Task ou Incident. Ce champ est obligatoire et Lakewatch ne remplit pas de valeur par default. Si le projet ne contient pas ce type de ticket, Jira rejette l'exportation.
  8. 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 ne s’enregistre pas : vous n’avez pas la permission de lire le secret du Unity Catalog, le secret est dans un catalogue différent de votre environnement Lakewatch, ou l’URL de l’instance n’utilise pas HTTPS ou pointe vers un réseau privé. Confirmez votre accès au secret, à son catalogue et à l'URL de l'instance.
  • Votre secret ne figure pas dans Sélectionner un secret : Sélectionner un 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 sur celui-ci.
  • 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