Pular para o conteúdo

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

Atualizado em

O GitHub Issues é onde muitos times de produto e projetos open source acompanham bugs, bem ao lado do código. 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 GitHub 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. Instale o app uma vez. Um admin do workspace abre Settings › Workspace › Integrations no Midge e clica em Connect no GitHub. O GitHub pede que ele instale o app Midge Bug Reports e escolha os repositórios onde o app pode abrir issues. O Midge confere, com o login do GitHub dessa pessoa, que a instalação é dela antes de guardá-la, e então ela escolhe o repositório para onde os bugs vão.
  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 GitHub. No report, clique em Send to GitHub. A issue é aberta pelo app, e o report mostra a issue que criou.

O que a issue do GitHub contém

O GitHub renderiza Markdown, então dá para ler a issue sem abrir mais nada:

  • um link para o report do Midge com o vídeo e os painéis de console e de rede,
  • o resumo de IA,
  • os passos numerados para reproduzir, rascunhados a partir do que você fez na gravação,
  • a causa provável,
  • 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.

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.

O mínimo de acesso

O app Midge Bug Reports pede issues: write e metadata: read, nos repositórios que você escolher, e nada além disso. Ele não consegue ler o seu código, os pull requests nem as Actions, e você pode remover um repositório ou desinstalar o app nas configurações do GitHub a qualquer momento.

Segredos ficam fora do seu repositório

Em repositórios públicos, o texto das issues é público. 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. A issue é escrita a partir desses logs ocultados. A gravação em si fica no Midge, com a própria configuração de compartilhamento: "Workspace members" ou "Only me" a mantém privada mesmo quando a issue é pública. Veja a ocultação.

Da issue à correção

Um dev abre a issue, clica para ir até a gravação e vê a requisição que falhou e o stack trace no momento em que o bug aconteceu. Se ele trabalha com um agente de código, o mesmo link vai para o Claude Code ou o Cursor, e o agente lê o console, as requisições de rede e os passos pelo servidor MCP do Midge.

Quem usa

  • Times de produto pequenos que acompanham tudo no GitHub e não querem mais uma ferramenta para bugs.
  • QA e suporte, registrando bugs no repositório que os engenheiros já acompanham.
  • Mantenedores que querem reports com os logs anexados em vez de issues do tipo "não funciona".

Sem a integração

Todo report também tem um link que é copiado quando você o cria. Cole esse link em qualquer issue, pull request ou discussion e ele abre o mesmo report.

Veja também

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

Perguntas frequentes

Que acesso o GitHub App do Midge tem?
Issues: write e metadata: read, nos repositórios que você escolher ao instalá-lo. Ele não consegue ler nem alterar o seu código.
Quem aparece como autor da issue?
O app Midge Bug Reports. A issue aponta para o report do Midge, que mostra quem gravou.
Funciona com repositórios privados?
Sim, em qualquer repositório onde o app estiver instalado. Lembre que a issue aponta para o report; ajuste o compartilhamento do report para que as pessoas certas consigam abri-lo.
Ele suporta GitHub Enterprise Server ou GitLab?
Não, só o GitHub.com. Um webhook assinado consegue abrir issues em outros lugares por meio de um pequeno serviço seu.