この記事では、Linear 側から Sentry 連携を有効化して、基本的な Issue 連携ができるまでの手順を確認した内容を残しておきます。

Linear 側で Sentry を有効化する

Linear の Settings > Workspace > Integrations を開くと、Integrations の一覧が表示されます。

Sentry を選ぶと詳細画面に遷移します。「Enable」ボタンを押して連携を開始します。

ここで Sentry 側の OAuth インストール画面に遷移します。

Sentry 側でインストールを完了させる

Sentry 側では「Finish integration installation」という確認画面が表示されます。

権限は「Organization・Member リソースへの Read アクセス」と「Event リソースへの Read/Write アクセス」が付与されます。内容を確認したら「Accept & Install」を押して完了します。

なお、この連携は Sentry が管理しているのではなく、「Authored by Linear Orbit, Inc.」と表示されています。Linear 側が実装・管理している連携です。

有効化後の設定を確認する

インストールが完了すると、Linear 側の設定画面に戻ります。

デフォルトで2つのトグルが有効になっています。

• Automatically complete Linear issues: Linear の Issue が Resolved になると、紐づいた Sentry の Issue も自動でクローズされます。
• Automatically reopen Linear issues: Sentry の Issue が Unresolved に戻ると、対応する Linear の Issue も自動で再開されます。

両方 ON のまま使うのが自然な初期設定です。

連携後は、Sentry の Issue 詳細画面の右サイドバーに「Linked Issues」セクションが表示されます。そこから Linear Issue を新規作成するか、既存の Issue を検索して紐づけることができます。

まとめ

フリープランの範囲でも、Sentry のエラーを Linear Issue として作成・リンクする基本的なフローは完結します。自動完了・再開のトグルもあるので、Issue のステータス管理を手動で追いかける必要がなくなります。

アラートをトリガーにした自動 Issue 作成は Team プラン以上の機能なので、そちらは別途試してみたいところです。

参考

• Sentry – Linear Docs
• Linear – Sentry Docs