Zum Hauptinhalt springen
Linear ist ein Issue Tracker, der auf Zyklen aufgebaut ist und integrierte Workflows für Planung und Triage bietet. Verbinden Sie Linear mit AppSignal, um aus Fehlervorfällen Linear-Issues zu erstellen oder bereits vorhandene Issues zu verknüpfen. Anschließend können Sie deren Status vom Vorfall aus verfolgen. Linear ist eine persönliche Integration: Jede Person mit Zugriff auf eine App, die diese Funktion nutzen möchte, muss diese Schritte selbst durchführen.

Linear zu Ihrer App hinzufügen

Linear funktioniert mit OAuth, sodass Sie keine API-Tokens manuell eingeben müssen.
  1. Öffnen Sie den Linear-Integrationsbildschirm für die App, die Sie verknüpfen möchten, und wählen Sie Add new Linear integration aus.
  2. Linear fordert Sie auf, den Zugriff von AppSignal zu genehmigen. AppSignal fordert Lese- und Schreibzugriff auf Ihr Linear-Konto sowie die Berechtigung an, Issues zu erstellen und zu aktualisieren. Genehmigen Sie die Anfrage.
  3. Sie kehren zu AppSignal zurück, Ihr Linear-Konto ist nun verknüpft. Wählen Sie in der Tabelle der Linear-Apps das Linear-Team aus, das Sie verwenden möchten, und wählen Sie anschließend Link Linear app aus.
AppSignal bestätigt, mit welcher Linear-Organisation und welchem Team die App verknüpft ist. Auf diesem Bildschirm können Sie auch jederzeit Unlink Linear from this app auswählen. Wenn neue Linear-Funktionen mehr Berechtigungen benötigen, zeigt AppSignal ein Banner an, das Sie bittet, Ihre Linear-Integration erneut zu autorisieren. Wählen Sie Re-authorize Linear, um die neuen Berechtigungen zu genehmigen.

Linear-Issues für Vorfälle erstellen

Sobald Linear verknüpft ist, können Sie ein Linear-Issue für einen Fehlervorfall erstellen:
  1. Öffnen Sie den Detailbildschirm des Fehlervorfalls.
  2. Wählen Sie im Panel Actions die Option Send to Linear aus.
Manchmal ist der Bug bereits in Linear: Ein Teammitglied hat ihn nach einer Kundenmeldung angelegt, bevor der Fehler AppSignal erreicht hat. Fügen Sie den Link zum Issue in eine Notiz ein, und AppSignal verknüpft es mit dem Vorfall. Jeder, der den Vorfall öffnet, sieht, dass die Behebung bereits verfolgt wird. Öffnen Sie den Tab Summary des Vorfalls. Schreiben Sie eine Notiz mit der URL des Linear-Issues in die Box Logbook und wählen Sie Post note. AppSignal verknüpft jede Linear-Issue-URL in der Notiz, etwa https://linear.app/acme/issue/APP-123/fix-checkout-timeout. Das Logbook hält fest, dass Sie das Issue verknüpft haben, wobei die Linear-Kennung auf das Issue verlinkt. Das Issue erscheint außerdem mit seinem Status im Panel Actions. Der AppSignal MCP-Server verknüpft Issues auf dieselbe Weise, wenn ein KI-Agent eine Notiz zu einem Vorfall schreibt. Was AppSignal verknüpft und was es überspringt:
  • Sie müssen Linear selbst zur App hinzugefügt haben, da AppSignal das Issue mit Ihrem Linear-Konto nachschlägt.
  • AppSignal verknüpft nur Issues aus dem Linear-Workspace, den Sie mit dieser App verknüpft haben. Ihr Linear-Konto benötigt außerdem Zugriff darauf. Andere URLs überspringt es, ohne dass die Notiz fehlschlägt.
  • Nur vollständige URLs werden verknüpft. Eine Issue-Kennung allein, etwa APP-123, nicht.
  • Ein bereits verknüpftes Issue wird nicht erneut verknüpft, sodass das Bearbeiten der Notiz keine Duplikate erzeugt.

Verknüpfte Issues vom Vorfall aus verfolgen

Das Panel Actions zeigt für jedes verknüpfte Linear-Issue einen Button View in Linear. Seine Beschriftung enthält die Linear-Kennung des Issues. Wählen Sie ihn, um das Issue in Linear zu öffnen oder das Issue neu zu erstellen. Jeder Button zeigt den Status des Issues als Badge, etwa To do, In Progress oder Done. Das Badge verwendet die Namen der Workflow-Status Ihres Teams. AppSignal liest den Status, wenn Sie ein Issue erstellen oder verknüpfen. Es aktualisiert das Badge, sobald jemand das Issue in Linear in einen anderen Status verschiebt. Dafür müssen Sie nichts einrichten. Das Actions-Panel eines Vorfalls in AppSignal. Ein verknüpftes Linear-Issue hat ein Status-Badge Done, und ein verknüpftes GitHub-Issue hat ein Badge Closed Statusänderungen erscheinen auch im Logbook des Vorfalls. Wenn zum Beispiel jemand das Issue in Linear von Todo nach In Progress verschiebt, hält das Logbook diese Änderung fest. Der Eintrag zeigt, wer die Änderung in Linear vorgenommen hat. Ist diese Person Mitglied Ihrer AppSignal-App und hat Linear hinzugefügt, zeigt der Eintrag ihren AppSignal-Namen. Issues, die an Linear gesendet wurden, bevor AppSignal begann, ihren Status zu verfolgen, zeigen kein Badge bis zu ihrer nächsten Statusänderung.

Verknüpfung aufheben und Zugriff widerrufen

Um Linear vollständig zu trennen, entfernen Sie es in AppSignal und in Linear:
  1. Wählen Sie auf dem Linear-Integrationsbildschirm der App in AppSignal Unlink Linear from this app aus.
  2. Öffnen Sie in Ihren persönlichen AppSignal-Einstellungen Integrations und wählen Sie für die Linear-Integration Manage integration und dann Remove aus.
  3. Öffnen Sie in Linear Ihre Security & access-Einstellungen. Bewegen Sie den Mauszeiger unter Authorized applications über AppSignal und wählen Sie Revoke access.
Falls beim Validieren der Integration etwas schief gegangen ist, wird Ihnen eine Fehlermeldung angezeigt. Kontaktieren Sie uns gerne, wenn Sie Probleme beim Einrichten dieser Integration haben.

Liste der Integrationen