Pular para o conteúdo

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

Atualizado em

O Jira é onde a maioria dos times decide o que vai ser corrigido, e um bug report no Jira só é tão bom quanto o que está dentro dele. Com o Midge, qualquer pessoa do seu 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 Jira para abrir uma issue com o resumo escrito por IA, os passos para reproduzir e um link para a gravação completa.

Como funciona

  1. Conecte o Jira uma vez. Um admin do workspace abre Settings › Workspace › Integrations no Midge, clica em Connect no Jira e faz login com a Atlassian. Ele escolhe o site do Jira e o projeto para onde os bugs devem ir.
  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 Jira. No report, clique em Send to Jira. O Midge cria a issue e mostra a key dela no report, então a próxima pessoa vê que o bug já foi registrado.

O que a issue do Jira contém

  • Summary: o título do report, ou o título escrito por IA se você deixou o campo vazio.
  • Description: um link para o report do Midge, o resumo de IA, os passos numerados para reproduzir e a causa provável.
  • Contexto: a URL da página e quantos erros de console e requisições com falha a gravação pegou.

O tipo da issue é Bug quando o seu projeto tem esse tipo; se não, Task.

O resumo de IA é escrito a partir dos logs ocultados do report, e a issue avisa isso. É um primeiro rascunho forte que um dev confere com a gravação, não um substituto para ela.

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 linkar a gravação em vez de anexá-la

Anexos do Jira são arquivos: um vídeo que alguém precisa baixar e logs exportados à parte que já não ficam alinhados com ele. Um link do Midge abre o vídeo com os painéis de console e de rede ao lado, e clicar numa linha de log leva o vídeo àquele momento. Nada é copiado para o armazenamento do Jira, e se você mudar depois quem pode abrir o report, isso vale em todo lugar onde o link foi colado.

Se o seu time também quer arquivos no Jira, baixe o HAR ocultado do report e anexe, ou copie uma requisição que falhou como cURL num comentário.

Segredos ficam fora do Jira

Tickets do Jira são lidos por muita gente, e muitas vezes por ferramentas e integrações que ninguém lembra de ter adicionado. 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 são escritos a partir desses logs ocultados. Veja a ocultação.

Quem usa

  • Times de QA registram vários bugs por rodada de testes sem escrever a seção de ambiente na mão.
  • Times de suporte escalam o problema de um cliente com a gravação do próprio cliente, feita por um link de gravação.
  • Product managers transformam uma sessão de revisão em issues que o time consegue pegar sem reunião.

Campos de bug report só no Jira vs. Midge

Muitos times mantêm um modelo de bug no Jira com campos para navegador, sistema operacional, URL e saída do console. O Midge preenche esses dados a partir da gravação, e o guia de modelo de bug report mostra quais campos ainda vale a pena manter. Os passos e os resultados esperado e real continuam sendo seus para conferir; o Midge rascunha os passos a partir do que você fez.

Sem a integração

Todo report também tem um link que é copiado quando você o cria. Cole esse link em qualquer issue, comentário ou página do Confluence 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 Jira: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água.

Perguntas frequentes

Quais versões do Jira o Midge suporta?
O Jira Cloud. Jira Data Center e Server não são suportados; um webhook assinado consegue chegar até eles por meio de um serviço seu.
Que tipo de issue o Midge cria?
Um Bug quando o projeto tem esse tipo; se não tiver, uma Task; se também não tiver, o primeiro tipo de issue do projeto que não seja uma sub-task.
Que acesso o Midge recebe no Jira?
Ele lê a lista de projetos e cria issues. Ele não lê issues, comentários nem anexos existentes.
O vídeo é enviado para dentro do Jira?
Não. A issue aponta para o report do Midge, onde o vídeo é transmitido ao lado dos logs de console e de rede. O armazenamento do seu Jira não é usado.