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
- 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.
- 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 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
- Todas as integrações: Jira, Linear, Slack e webhooks.
- Como escrever um bug report.
- Exemplos de bug report.
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.