Passer au contenu principal
🗓 Cette documentation a été révisée en novembre 2026 pour refléter les changements d’interface utilisateur de Jira. Si, au moment de la lecture, vous constatez que nos instructions ne sont plus à jour, merci de nous le faire savoir !
AppSignal se connecte à Jira via OAuth 1.0. Jira prend désormais aussi en charge OAuth 2.0, mais AppSignal ne l’utilise pas encore ; la configuration ci-dessous utilise donc un lien d’application OAuth 1.0.
Jira est un outil utilisé pour la gestion de projet. Il s’organise autour d’un système de tickets permettant de créer, suivre et assigner des fonctionnalités, des tâches et des bugs. AppSignal peut être intégré à Jira pour créer un ticket à partir de l’écran de détails d’un incident d’erreur. AppSignal ne crée jamais de tickets Jira automatiquement, afin d’éviter une surcharge de tickets. Cette documentation vous guidera à travers les étapes nécessaires pour intégrer AppSignal à votre projet Jira.

Configurer Jira

Avant de pouvoir lier AppSignal à Jira, nous devons configurer Jira pour qu’il accepte notre requête OAuth. Pour ce faire, sélectionnez la roue dentée des paramètres (⚙️) dans la barre de navigation. Sous Jira admin settings, sélectionnez Jira apps. Dans les anciennes versions de Jira, cet élément de menu s’appelle Products.
Le menu des paramètres de Jira ouvert depuis la roue dentée, avec Jira apps mis en évidence sous Jira admin settings

Sélectionnez Jira apps sous Jira admin settings.

Dans Integrations, dans la navigation latérale, sélectionnez Application links, puis sélectionnez Create link.
La page Application links de Jira sous Integrations, qui liste les liens existants, avec le bouton Create link en haut à droite

La page Application links, avec le bouton Create link.

Jira ouvre la boîte de dialogue Create an application link, qui demande un type de connexion et l’URL de l’application :
  1. Sous Application link type, sélectionnez Direct application link, la dernière des quatre options, qui utilise OAuth 1.0. Les deux premières options utilisent OAuth 2.0, et Tunneled application link nécessite un tunnel d’application existant.
  2. Sous External application details, saisissez https://www.appsignal.com dans le champ Application URL.
  3. Sélectionnez Continue.
La boîte de dialogue Create an application link de Jira avec Direct application link sélectionné et https://www.appsignal.com dans le champ Application URL

Sélectionnez Direct application link et saisissez l'URL d'AppSignal.

Jira peut ensuite afficher Configure Application URL, avec l’avertissement « No response was received from the URL you entered ». Vous pouvez ignorer cet avertissement. Conservez https://www.appsignal.com dans le champ New URL et sélectionnez Continue.
La boîte de dialogue Configure Application URL de Jira indiquant qu'aucune réponse n'a été reçue, avec https://www.appsignal.com dans le champ New URL et un bouton Continue

Ignorez l'avertissement et sélectionnez Continue.

Jira affiche ensuite la boîte de dialogue Review link. Saisissez AppSignal comme Application Name, vérifiez que l’Application Type est Generic Application, puis sélectionnez Continue. Seul le nom de l’application est à renseigner.
La boîte de dialogue Review link de Jira avec AppSignal comme Application Name et Generic Application comme Application Type

Nommez l'application AppSignal.

Configuration OAuth

Configurez maintenant l’Incoming Authentication pour AppSignal. Sur la page Application links, ouvrez le menu … à côté d’AppSignal et sélectionnez Edit.
La page Application links de Jira qui liste AppSignal comme Generic Application avec un lien Direct, avec son menu ouvert sur Edit, Go to remote et Delete

Ouvrez le menu à côté d'AppSignal et sélectionnez Edit.

Jira ouvre la boîte de dialogue Configure AppSignal. Sélectionnez Incoming Authentication dans le menu de gauche.
La boîte de dialogue Configure AppSignal de Jira sur Incoming Authentication, avec l'onglet OAuth affichant les champs Consumer Key et Consumer Name

Configurez OAuth sous Incoming Authentication.

Dans l’onglet OAuth, configurez OAuth avec les valeurs suivantes. La page de l’intégration Jira dans AppSignal les affiche aussi, sous OAuth credentials.
  • Consumer Key : ce2jejafmni3qmnzrfergg9fLpzxmppl
  • Consumer Name : AppSignal
  • Public Key :
Text
Sélectionnez Save.

Configurer AppSignal

Pour terminer la liaison de votre projet Jira à AppSignal, AppSignal doit être configuré pour communiquer avec votre projet Jira. L’intégration Jira est personnelle : chaque personne qui souhaite envoyer des incidents à Jira suit ces étapes.
  1. Ouvrez votre application dans AppSignal et allez dans App settings → Integrations.
  2. Sous Personal issue tracker integrations, sélectionnez Configure à côté de Jira. Vous pouvez aussi suivre ce lien.
La page Integrations des paramètres de l'application dans AppSignal, avec Jira indiqué comme Inactive sous Personal issue tracker integrations et son lien Configure mis en évidence

Sélectionnez Configure à côté de Jira.

  1. Sous Jira installation location, saisissez l’URL complète de votre site Jira dans Full path to the site. Par exemple : https://your-project-name.atlassian.net. Au-dessus de ce formulaire, AppSignal affiche la Consumer Key, le Consumer Name et la Public Key que vous avez saisis dans Jira lors de la configuration OAuth. Ils sont déjà renseignés, vous n’avez donc pas besoin de les saisir à nouveau.
  2. Sélectionnez Link AppSignal to Jira.
La page de l'intégration Jira dans AppSignal avec la fin de la clé publique et le formulaire Jira installation location, une URL de site Jira dans le champ Full path to the site et le bouton Link AppSignal to Jira

Saisissez l'URL de votre site Jira et liez AppSignal à Jira.

  1. Jira vous demande d’autoriser AppSignal à accéder en lecture et en écriture à votre site Jira. Sélectionnez Allow.
La page Welcome to JIRA de Jira qui demande d'autoriser l'accès en lecture et en écriture pour AppSignal, avec les boutons Allow et Deny

Autorisez AppSignal à accéder à votre site Jira.

AppSignal vous ramène ensuite à la page de l’intégration Jira. Si vous avez déjà lié AppSignal à Jira, par exemple pour une autre application, Configure vous y amène directement.
  1. De retour dans AppSignal, sous Your integration details > Select your project and issue type, sélectionnez le projet Jira et le type de ticket pour les tickets créés par AppSignal.
  2. Sélectionnez Create integration.
La page de l'intégration Jira dans AppSignal avec un projet et un type de ticket sélectionnés sous Select your project and issue type, et le bouton Create integration

Choisissez le projet et le type de ticket, puis créez l'intégration.

Si cette étape produit un message d’erreur, lisez la section erreurs pour plus d’aide.

Créer des tickets Jira pour les incidents

Une fois Jira connecté, vous pouvez créer un ticket Jira pour un incident d’erreur :
  1. Allez dans Errors → Issue list et sélectionnez l’incident.
  2. Dans le panneau Actions, sélectionnez Send to Jira.
L'onglet Summary d'un incident d'erreur dans AppSignal, avec Send to Jira sous Actions, en dessous de Time detective

Sélectionnez Send to Jira dans le panneau Actions de l'incident.

Suivre les tickets Jira liés depuis l’incident

Cette fonctionnalité est en bêta, dans le cadre d’AppSignal Labs. Demandez au support de l’activer pour votre organisation.
Après l’envoi d’un incident à Jira, le panneau Actions affiche un bouton pour le ticket, intitulé avec sa clé, comme View #WEB-142 in Jira. Le bouton affiche le statut du ticket sous forme de badge, nommé comme dans votre projet Jira, comme In Review. AppSignal met à jour le badge lorsque le ticket change dans Jira. Les changements de statut apparaissent aussi dans le logbook de l’incident. Par exemple : Changed the status of #WEB-142 on Jira from In Progress → In Review. L’entrée indique qui a effectué le changement dans Jira.
Un incident dans AppSignal avec une entrée de logbook ayant changé le statut de #KAN-5 sur Jira de In Progress à In Review, et une action View #KAN-5 in Jira avec un badge In Review

Un ticket Jira lié affiche son statut dans le panneau Actions, et les changements de statut apparaissent dans le logbook.

Quelques limitations à connaître :
  • Un nouveau ticket reçoit son badge peu après que vous l’avez envoyé à Jira, une fois que Jira en a informé AppSignal.
  • Les tickets envoyés à Jira avant que vous activiez les mises à jour de statut n’affichent aucun badge jusqu’à leur prochain changement dans Jira.
  • Le logbook n’affiche pas le premier statut d’un ticket, car il n’existe pas de statut antérieur avec lequel le comparer.

Activer les mises à jour de statut

Jira envoie les changements de tickets à AppSignal via un webhook sur votre site Jira. AppSignal l’ajoute lorsque vous enregistrez l’intégration :
  1. Allez dans App settings → Integrations, puis sélectionnez Configure à côté de Jira.
  2. Sélectionnez Update integration. Si l’intégration est nouvelle, sélectionnez Create integration.
Vous avez besoin de la permission globale Jira Administrators dans Jira. Sans elle, l’intégration est tout de même enregistrée, mais AppSignal affiche : « Two-way sync is off: AppSignal couldn’t add a webhook to Jira. That needs the Jira Administrators global permission. Save the integration again to retry. » Demandez à un administrateur Jira d’enregistrer l’intégration, ou obtenez la permission et enregistrez-la à nouveau. Parfois, le bug est déjà dans Jira : un collègue l’a créé après le signalement d’un client, avant que l’erreur n’atteigne AppSignal. Collez le lien du ticket dans une note, et AppSignal le lie à l’incident. Ouvrez l’onglet Summary de l’incident. Écrivez une note contenant l’URL du ticket Jira dans l’encadré Logbook, puis sélectionnez Post note. AppSignal lie chaque URL de ticket Jira présente dans la note, comme https://your-site.atlassian.net/browse/WEB-142. Le logbook enregistre que vous avez lié le ticket, et le ticket apparaît dans le panneau Actions. Son badge de statut s’affiche dès que le ticket change à nouveau dans Jira. Le serveur MCP d’AppSignal lie les tickets de la même manière lorsqu’un agent IA écrit une note sur un incident. AppSignal ne lie un ticket que si toutes les conditions suivantes sont remplies. Sinon, il ignore l’URL, et la note est tout de même publiée.
  • Le support a activé ces fonctionnalités pour votre organisation, dans le cadre d’AppSignal Labs.
  • L’intégration Jira de l’application est Active sous App settings → Integrations. Après l’activation de ces fonctionnalités par le support, une personne disposant de la permission globale Jira Administrators a enregistré l’intégration.
  • Vous avez vous-même lié AppSignal à Jira, avec la même URL de site Jira que l’intégration de l’application, comme https://your-site.atlassian.net. AppSignal recherche le ticket avec votre compte Jira.
  • Le ticket se trouve dans le projet Jira utilisé par l’intégration de l’application, et votre compte Jira peut l’ouvrir.
  • La note contient l’URL /browse/ du ticket, comme https://your-site.atlassian.net/browse/WEB-142. Une clé de ticket seule, comme WEB-142, n’est pas liée.
  • Le ticket n’est pas encore lié à l’incident. Cela inclut un ticket que vous avez créé avec Send to Jira. AppSignal ne le lie pas deux fois, et le logbook n’enregistre rien. Modifier la note ne crée pas non plus de doublons.

Changer de projet ou supprimer l’intégration

  • Passer à un autre projet Jira : enregistrez l’intégration avec le nouveau projet. AppSignal déplace son webhook vers le nouveau projet.
  • Supprimer l’intégration dans AppSignal : allez dans App settings → Integrations, sélectionnez Configure à côté de Jira, puis sélectionnez Remove integration. AppSignal supprime son webhook de Jira. Si Jira ne le permet pas, AppSignal vous l’indique, et un administrateur Jira peut supprimer le webhook dans Jira sous System → WebHooks.
Pour supprimer aussi AppSignal de Jira, supprimez son lien d’application :
  1. Dans Jira, sélectionnez la roue dentée des paramètres (⚙️). Sous Jira admin settings, sélectionnez Jira apps.
  2. Dans Integrations, dans la navigation latérale, sélectionnez Application links.
  3. Ouvrez le menu … à côté d’AppSignal et sélectionnez Delete.
La page Application links de Jira qui liste AppSignal comme Generic Application avec un lien Direct, avec son menu ouvert et Delete mis en évidence

Supprimez le lien d'application AppSignal dans Jira.

Erreurs

AppSignal exige que quatre champs soient présents dans Jira :
  • Labels
  • Environment
  • Summary
  • Description
AppSignal affichera un message d’erreur à la fin de la configuration si des champs manquent et précisera lesquels doivent être ajoutés dans Jira. Erreur d'intégration AppSignal Jira Vous devrez ajouter les champs aux écrans Jira en allant dans l’onglet « Issues » du menu « Settings » : Paramètres Issues Jira Allez ensuite dans « Screens » dans le volet de navigation de gauche et cliquez sur « Configure » pour l’écran concerné : Options d'écran Jira Sur cette page « Configure », Jira vous présentera une liste des champs déjà configurés. Faites défiler jusqu’en bas et ajoutez les champs requis manquants. Configuration d'écran Jira Une fois tous les champs créés, vous devriez pouvoir reprendre et terminer la configuration de votre intégration Jira depuis l’application AppSignal.

Besoin d’aide ?

Si vous avez suivi les étapes de cette page et que vous êtes toujours bloqué, n’hésitez pas à nous contacter à support@appsignal.com.

Liste des intégrations