Passer au contenu principal
Linear est un outil de suivi de tickets organisé autour de cycles, avec des workflows intégrés pour la planification et le triage. Connectez-le à AppSignal pour transformer des incidents d’erreur en tickets Linear, ou lier des tickets qui existent déjà. Vous pouvez ensuite suivre leur statut depuis l’incident. Linear est une intégration personnelle : chaque personne ayant accès à une application qui souhaite utiliser cette fonctionnalité doit effectuer ces étapes elle-même.

Ajouter Linear à votre application

Linear fonctionne avec OAuth, vous n’avez donc pas besoin de saisir manuellement de jetons d’API.
  1. Ouvrez l’écran d’intégration Linear de l’application que vous voulez lier, puis sélectionnez Add new Linear integration.
  2. Linear vous demande d’approuver l’accès d’AppSignal. AppSignal demande un accès en lecture et en écriture à votre compte Linear, ainsi que la permission de créer et de mettre à jour des tickets. Approuvez la demande.
  3. Vous revenez sur AppSignal avec votre compte Linear lié. Dans le tableau des applications Linear, choisissez l’équipe Linear que vous voulez utiliser, puis sélectionnez Link Linear app.
AppSignal confirme à quelle organisation et à quelle équipe Linear l’application est liée. Depuis cet écran, vous pouvez également sélectionner Unlink Linear from this app à tout moment. Lorsque de nouvelles fonctionnalités Linear nécessitent plus de permissions, AppSignal affiche une bannière vous demandant de réautoriser votre intégration Linear. Sélectionnez Re-authorize Linear pour approuver les nouvelles permissions.

Créer des tickets Linear pour les incidents

Une fois Linear lié, vous pouvez créer un ticket Linear pour un incident d’erreur :
  1. Ouvrez l’écran de détails de l’incident d’erreur.
  2. Dans le panneau Actions, sélectionnez Send to Linear.
Parfois, le bug est déjà dans Linear : 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. Toute personne qui ouvre l’incident voit que la correction est déjà suivie. Ouvrez l’onglet Summary de l’incident. Écrivez une note contenant l’URL du ticket Linear dans l’encadré Logbook, puis sélectionnez Post note. AppSignal lie chaque URL de ticket Linear présente dans la note, comme https://linear.app/acme/issue/APP-123/fix-checkout-timeout. Le logbook enregistre que vous avez lié le ticket, avec son identifiant Linear qui pointe vers celui-ci. Le ticket apparaît aussi dans le panneau Actions avec son statut. Le serveur MCP d’AppSignal lie les tickets de la même manière lorsqu’un agent IA écrit une note sur un incident. Ce qu’AppSignal lie, et ce qu’il ignore :
  • Vous devez avoir ajouté Linear à l’application vous-même, car AppSignal recherche le ticket avec votre compte Linear.
  • AppSignal ne lie que les tickets de l’espace de travail Linear que vous avez lié à cette application. Votre compte Linear doit aussi y avoir accès. Il ignore les autres URL sans faire échouer la note.
  • Seules les URL complètes sont liées. Un identifiant de ticket seul, comme APP-123, ne l’est pas.
  • Un ticket déjà lié n’est pas lié à nouveau, donc modifier la note ne crée pas de doublons.

Suivre les tickets liés depuis l’incident

Le panneau Actions affiche un bouton View in Linear pour chaque ticket Linear lié. Son libellé inclut l’identifiant Linear du ticket. Sélectionnez-le pour ouvrir le ticket dans Linear, ou pour recréer le ticket. Chaque bouton affiche le statut du ticket sous forme de badge, comme To do, In Progress ou Done. Le badge utilise les noms des états de workflow de votre équipe. AppSignal lit le statut lorsque vous créez ou liez un ticket. Il met à jour le badge chaque fois que quelqu’un déplace le ticket vers un autre état dans Linear. Vous n’avez rien à configurer pour cela. Le panneau Actions d'un incident dans AppSignal. Un ticket Linear lié a un badge de statut Done, et un ticket GitHub lié a un badge Closed Les changements de statut apparaissent aussi dans le logbook de l’incident. Par exemple, lorsque quelqu’un déplace le ticket de Todo à In Progress dans Linear, le logbook enregistre ce changement. L’entrée indique qui a effectué le changement dans Linear. Si cette personne est membre de votre application AppSignal et a ajouté Linear, l’entrée affiche son nom AppSignal. Les tickets envoyés à Linear avant qu’AppSignal ne commence à suivre leur statut n’affichent aucun badge jusqu’à leur prochain changement de statut.

Dissocier et révoquer l’accès

Pour déconnecter complètement Linear, supprimez-le dans AppSignal et dans Linear :
  1. Sur l’écran d’intégration Linear de l’application dans AppSignal, sélectionnez Unlink Linear from this app.
  2. Dans vos paramètres personnels AppSignal, ouvrez Integrations, puis sélectionnez Manage integration et Remove pour l’intégration Linear.
  3. Dans Linear, ouvrez vos paramètres Security & access. Sous Authorized applications, survolez AppSignal et sélectionnez Revoke access.
Si quelque chose se passe mal lors de la validation de l’intégration, le message d’erreur vous sera présenté. N’hésitez pas à nous contacter si vous rencontrez des problèmes lors de la configuration de cette intégration.

Liste des intégrations