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.
Sélectionnez Jira apps sous Jira admin settings.

La page Application links, avec le bouton Create link.
- 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.
- Sous External application details, saisissez
https://www.appsignal.comdans le champ Application URL. - Sélectionnez Continue.

Sélectionnez Direct application link et saisissez l'URL d'AppSignal.
https://www.appsignal.com dans le champ New URL et sélectionnez Continue.

Ignorez l'avertissement et sélectionnez Continue.
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.

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.
Ouvrez le menu à côté d'AppSignal et sélectionnez Edit.

Configurez OAuth sous Incoming Authentication.
- Consumer Key :
ce2jejafmni3qmnzrfergg9fLpzxmppl - Consumer Name :
AppSignal - Public Key :
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.- Ouvrez votre application dans AppSignal et allez dans App settings → Integrations.
- Sous Personal issue tracker integrations, sélectionnez Configure à côté de Jira. Vous pouvez aussi suivre ce lien.

Sélectionnez Configure à côté de Jira.
-
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. - Sélectionnez Link AppSignal to Jira.

Saisissez l'URL de votre site Jira et liez AppSignal à Jira.
- Jira vous demande d’autoriser AppSignal à accéder en lecture et en écriture à votre site Jira. Sélectionnez Allow.

Autorisez AppSignal à accéder à votre site Jira.
- 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.
- Sélectionnez Create integration.

Choisissez le projet et le type de ticket, puis créez l'intégration.
Créer des tickets Jira pour les incidents
Une fois Jira connecté, vous pouvez créer un ticket Jira pour un incident d’erreur :- Allez dans Errors → Issue list et sélectionnez l’incident.
- Dans le panneau Actions, sélectionnez Send to Jira.

Sélectionnez Send to Jira dans le panneau Actions de l'incident.
Suivre les tickets Jira liés depuis l’incident

Un ticket Jira lié affiche son statut dans le panneau Actions, et les changements de statut apparaissent dans le logbook.
- 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 :- Allez dans App settings → Integrations, puis sélectionnez Configure à côté de Jira.
- Sélectionnez Update integration. Si l’intégration est nouvelle, sélectionnez Create integration.
Lier un ticket Jira existant
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, commehttps://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, commehttps://your-site.atlassian.net/browse/WEB-142. Une clé de ticket seule, commeWEB-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.
- Dans Jira, sélectionnez la roue dentée des paramètres (⚙️). Sous Jira admin settings, sélectionnez Jira apps.
- Dans Integrations, dans la navigation latérale, sélectionnez Application links.
- Ouvrez le menu … à côté d’AppSignal et sélectionnez Delete.

Supprimez le lien d'application AppSignal dans Jira.
Erreurs
AppSignal exige que quatre champs soient présents dans Jira :- Labels
- Environment
- Summary
- Description



