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
- 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.
- 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.
- 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
500de 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
- Todas as integrações: Jira, GitHub Issues, Slack e webhooks.
- Logs de rede e logs de console: o que a gravação captura.
- Modelo de bug report.
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.