Pular para o conteúdo principal
O Linear é um rastreador de issues organizado em torno de ciclos, com workflows integrados para planejamento e triagem. Conecte-o ao AppSignal para transformar incidentes de erro em issues do Linear, ou vincular issues que já existem. Depois, você pode acompanhar o status delas a partir do incidente. O Linear é uma integração pessoal: cada pessoa com acesso a um app que quiser usar esse recurso precisa concluir estes passos por conta própria.

Adicionando o Linear ao seu app

O Linear funciona com OAuth, então você não precisa inserir manualmente nenhum token de API.
  1. Abra a tela de integração do Linear do app que você quer vincular e selecione Add new Linear integration.
  2. O Linear pede que você aprove o acesso do AppSignal. O AppSignal solicita acesso de leitura e escrita à sua conta do Linear, e permissão para criar e atualizar issues. Aprove a solicitação.
  3. Você retorna ao AppSignal com sua conta do Linear vinculada. Na tabela de apps do Linear, escolha o time do Linear que você quer usar e, em seguida, selecione Link Linear app.
O AppSignal confirma a qual organização e time do Linear o app está vinculado. Nessa tela, você também pode selecionar Unlink Linear from this app a qualquer momento. Quando novos recursos do Linear precisam de mais permissões, o AppSignal mostra um banner pedindo que você reautorize sua integração com o Linear. Selecione Re-authorize Linear para aprovar as novas permissões.

Criar issues do Linear para incidentes

Depois que o Linear estiver vinculado, você pode criar uma issue do Linear para um incidente de erro:
  1. Abra a tela de detalhes do incidente de erro.
  2. No painel Actions, selecione Send to Linear.
Às vezes o bug já está no Linear: um colega o registrou depois do relato de um cliente, antes de o erro chegar ao AppSignal. Cole o link da issue em uma nota, e o AppSignal a vincula ao incidente. Qualquer pessoa que abrir o incidente verá que a correção já está sendo acompanhada. Abra a aba Summary do incidente. Escreva uma nota com a URL da issue do Linear na caixa Logbook e selecione Post note. O AppSignal vincula todas as URLs de issues do Linear na nota, como https://linear.app/acme/issue/APP-123/fix-checkout-timeout. O logbook registra que você vinculou a issue, com o identificador do Linear apontando para ela. A issue também aparece no painel Actions com seu status. O servidor MCP do AppSignal vincula issues da mesma forma quando um agente de IA escreve uma nota em um incidente. O que o AppSignal vincula, e o que ele ignora:
  • Você precisa ter adicionado o Linear ao app por conta própria, porque o AppSignal busca a issue com a sua conta do Linear.
  • O AppSignal só vincula issues do workspace do Linear que você vinculou a este app. Sua conta do Linear também precisa ter acesso a elas. Ele ignora outras URLs sem fazer a nota falhar.
  • Apenas URLs completas são vinculadas. Um identificador de issue sozinho, como APP-123, não é.
  • Uma issue já vinculada não é vinculada novamente, então editar a nota não cria duplicatas.

Acompanhar issues vinculadas a partir do incidente

O painel Actions mostra um botão View in Linear para cada issue do Linear vinculada. O rótulo inclui o identificador da issue no Linear. Selecione-o para abrir a issue no Linear, ou para recriar a issue. Cada botão mostra o status da issue como um badge, como To do, In Progress ou Done. O badge usa os nomes dos estados de workflow do seu time. O AppSignal lê o status quando você cria ou vincula uma issue. Ele atualiza o badge sempre que alguém move a issue para outro estado no Linear. Você não precisa configurar nada para isso. O painel Actions de um incidente no AppSignal. Uma issue do Linear vinculada tem um badge de status Done, e uma issue do GitHub vinculada tem um badge Closed As mudanças de status também aparecem no logbook do incidente. Por exemplo, quando alguém move a issue de Todo para In Progress no Linear, o logbook registra essa mudança. A entrada mostra quem fez a mudança no Linear. Se essa pessoa for membro do seu app no AppSignal e tiver adicionado o Linear, a entrada mostra o nome dela no AppSignal. Issues enviadas ao Linear antes de o AppSignal começar a acompanhar o status delas não mostram badge até a próxima mudança de status.

Desvincular e revogar o acesso

Para desconectar o Linear completamente, remova-o no AppSignal e no Linear:
  1. Na tela de integração do Linear do app no AppSignal, selecione Unlink Linear from this app.
  2. Nas suas configurações pessoais do AppSignal, abra Integrations, selecione Manage integration e depois Remove para a integração do Linear.
  3. No Linear, abra suas configurações de Security & access. Em Authorized applications, passe o cursor sobre o AppSignal e selecione Revoke access.
Se algo der errado ao validar a integração, você será informado com a mensagem de erro. Sinta-se à vontade para entrar em contato conosco se tiver algum problema ao configurar essa integração.

Lista de integrações