Pular para o conteúdo

Bug reports no Linear com a gravação de tela e os logs de console e de rede

Atualizado em

Times que usam Linear andam rápido, e uma issue que diz "o checkout está quebrado" atrasa todo mundo. Com o Midge, qualquer pessoa do time grava um bug com os logs de console, as requisições de rede e as informações do dispositivo, e depois clica em Send to Linear para abrir uma issue com o resumo escrito por IA, os passos para reproduzir, a causa provável e um link para a gravação.

Como funciona

  1. Conecte o Linear uma vez. Um admin do workspace abre Settings › Workspace › Integrations no Midge, clica em Connect no Linear, faz login e escolhe o time que faz a triagem dos bugs.
  2. Grave o bug. Com a extensão do Chrome, o Midge para Mac ou o Midge para iPhone, grave a tela ou tire um screenshot. O report recebe o console, as requisições de rede, os seus cliques e os detalhes do dispositivo.
  3. Envie para o Linear. No report, clique em Send to Linear. A issue é aberta naquele time, e o report mostra a issue que criou.

O que a issue do Linear contém

O Linear renderiza Markdown, então a issue faz sentido sozinha:

  • Watch the Midge report: o link para a gravação com o console, as requisições de rede e os passos.
  • Summary: o que deu errado, em duas ou três frases.
  • Steps to reproduce: numerados, rascunhados a partir do que você realmente fez na gravação.
  • Likely cause: por exemplo, um 500 de uma chamada de API seguido de um erro não tratado.
  • Contexto: a URL da página e o número de erros de console e de requisições com falha.

Uma nota no final avisa que o resumo foi escrito por IA a partir dos logs ocultados, para que quem pegar a issue confira com a gravação.

As suas palavras primeiro

O que quem reportou digitou ao enviar o report, como o resultado esperado ou qual conta usou, entra na issue logo abaixo do link, antes do resumo de IA. Quem viu o bug fala primeiro, e o resumo completa o que a pessoa não anotou.

Por que combina com o jeito de trabalhar no Linear

O Linear funciona melhor quando as issues são pequenas e claras o bastante para serem pegas sem reunião. Uma gravação com os logs anexados responde às perguntas que costumam voltar num bug: qual navegador, qual conta, o que a rede fez, o que tinha no console. O engenheiro abre o link, assiste a 20 segundos, vê a requisição que falhou e já começa a correção.

Para times que usam agentes de código, o mesmo link funciona lá: cole no Claude Code ou no Cursor e o agente lê o report pelo servidor MCP do Midge.

Segredos ficam fora do Linear

O Midge remove senhas, tokens, cookies, headers de autorização e números de cartão dos logs antes que eles saiam do navegador ou do celular, e mascara e-mails e telefones. O resumo de IA e a issue do Linear são escritos a partir desses logs ocultados, então um token num header de requisição nunca vai parar no seu issue tracker. Veja a ocultação.

Também a partir dos clientes

O suporte pode mandar a um cliente um link de gravação. O cliente grava o problema no navegador dele, sem conta, o report cai no seu workspace do Midge, e Send to Linear transforma tudo numa issue com a gravação do próprio cliente por trás.

Sem a integração

Todo report também tem um link que é copiado quando você o cria. Cole esse link em qualquer issue ou comentário do Linear e ele abre o mesmo report. A integração poupa a cópia e escreve o resumo para você.

Veja também

O Midge é grátis, incluindo a integração com o Linear: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água.

Perguntas frequentes

Que acesso o Midge recebe no Linear?
Ele lê os seus times, para que um admin possa escolher um, e cria issues. Ele não lê issues nem comentários existentes.
Para qual time as issues vão?
Para o que um admin do workspace escolher ao conectar o Linear. Dá para trocar depois em Settings.
A issue inclui o vídeo?
Ela aponta para o report do Midge, onde o vídeo roda ao lado dos logs de console e de rede. A issue em si traz o resumo, os passos e a causa provável em Markdown.