Replay instantâneo para bug reports: salve o bug que já aconteceu
Atualizado em
O replay instantâneo do Midge permite reportar um bug depois que ele aconteceu. Quando está ligado para um site, o Midge mantém uma gravação contínua dos últimos 30 a 120 segundos da página, e um clique salva essa janela como um bug report, com logs de console, requisições de rede e ações do usuário anexados. Ele vem desligado por padrão, e você ativa por site ou para todos os sites.
O problema de sempre com bugs intermitentes é o timing. Um dropdown pisca, um toast mostra a mensagem errada, uma tabela pula, e quando você abre um gravador já passou. Com o replay instantâneo, você não precisa reproduzir o bug. Ele já está com você.
Como funciona
O replay instantâneo não grava vídeo. Ele grava a própria página: o DOM, que é a estrutura de elementos e textos que o navegador desenha. O Midge guarda um snapshot da página e depois cada mudança nela, como um nó adicionado, uma classe trocada ou um texto atualizado, junto com a rolagem e os cliques. O player de replay reconstrói a página a partir desse registro, passo a passo.
Você escolhe o tamanho do buffer, de 30 a 120 segundos. As mudanças mais antigas saem do fim à medida que as novas chegam, então o uso de memória fica limitado. Quando você clica para salvar um replay, o Midge pega o buffer atual, adiciona os logs de console e de rede do mesmo período e deixa você criar um report.
Por que não vídeo contínuo?
Nós consideramos gravar a tela o tempo todo e guardar os últimos dois minutos. Decidimos não fazer isso por dois motivos.
- O Chrome mostra um indicador de compartilhamento enquanto uma captura estiver rodando. Uma barra permanente de "esta aba está sendo compartilhada" distrai, e ensina as pessoas a ignorar um aviso que existe para a segurança delas.
- Vídeo consome CPU, memória e bateria. Codificar frames sem parar em toda aba que você usa deixaria o seu navegador mais lento, o oposto do que uma ferramenta de debug deveria fazer.
A gravação do DOM evita as duas coisas. Ainda assim, ela é mais pesada do que a captura de logs, porque guarda uma cópia do conteúdo da página, então a deixamos desligada até você decidir que quer usá-la.
Como ligar
O replay instantâneo vem desligado por padrão. Você pode ligá-lo:
- para todos os sites, se você passa o dia testando muitas aplicações diferentes, ou
- por site, por exemplo só em
staging.yourapp.comelocalhost.
A lista de nunca capturar continua tendo prioridade. Se um site está nessa lista, o Midge não roda nele de jeito nenhum, replay incluído. Uma boa configuração inicial é ativar o replay nos seus hosts de staging e de desenvolvimento local, deixá-lo desligado para todo o resto e adicionar o seu banco e o seu e-mail à lista de nunca capturar.
O que um report de replay contém
Um replay salvo é um report completo do Midge. Toda gravação inclui logs de console, requisições de rede, ações do usuário e informações do dispositivo. Um replay não é exceção. Um dev que abre o link vê:
- a página reproduzida num player,
- as mensagens de console dos mesmos 30 a 120 segundos, incluindo erros não tratados (veja logs de console),
- o tráfego fetch, XHR e WebSocket com bodies e tempos (veja logs de rede),
- cliques, mudanças de página e os campos em que você digitou, sem o texto,
- navegador, sistema operacional, tamanho da janela e a URL da página.
Privacidade nos replays
Como um replay contém o conteúdo da página, as regras aqui são mais rígidas do que para um vídeo de aba:
- Todos os valores de input são mascarados. O que foi digitado em qualquer campo não aparece no replay.
- O texto da página é escaneado com os mesmos padrões usados para os logs: JWTs, números de cartão válidos pelo algoritmo de Luhn, API keys e chaves privadas são removidos, e e-mails e telefones internacionais ficam parcialmente mascarados.
- Os logs também são ocultados. Senhas, números de cartão, tokens e cookies são ocultados no seu navegador antes que qualquer coisa saia do seu dispositivo.
A página de ocultação lista todas as regras. A ocultação funciona por regras, então um segredo incomum mostrado como texto puro na tela pode não ser reconhecido. Os times podem adicionar os próprios nomes de campos.
Limites que vale conhecer
Um replay do DOM é uma reconstrução, não uma cópia pixel a pixel. A maioria das páginas é reproduzida fielmente, mas conteúdo que não é descrito pelo DOM, como desenhos num canvas ou mídia tocando dentro da página, pode não aparecer exatamente como estava. Se o bug é visual nesse sentido, use uma gravação de tela.
O replay também só cobre o tempo em que estava rodando. Se você ativou para um site há um minuto, o buffer guarda no máximo esse minuto.
Quando usar o replay instantâneo
- Bugs de interface instáveis que você não consegue reproduzir quando quer.
- Testes exploratórios, em que você só sabe que era um bug depois que ele aconteceu.
- Demos e apresentações em staging, quando algo quebra na frente de um colega.
Para bugs que você reproduz quando quiser, uma gravação comum ou um screenshot com anotações muitas vezes basta. Para dicas gerais sobre o que incluir em qualquer caso, leia como reportar um bug. E se você só precisa da parte de rede de um incidente de um colega que não estava com o Midge rodando, peça um arquivo HAR e limpe-o com o sanitizador de HAR gratuito antes de ele ir para um ticket.
O Midge é grátis: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água.
Perguntas frequentes
- O replay instantâneo é um vídeo?
- Não. Ele grava as mudanças na estrutura da página (o DOM) e as reconstrói num player de replay. Isso é mais leve do que vídeo e evita o indicador permanente de compartilhamento de tela do Chrome.
- O replay instantâneo vem ligado por padrão?
- Não. Ele fica desligado até você ligar, para todos os sites ou só para os sites que você escolher. A captura de console e de rede funciona sem ele.
- Até quanto tempo para trás ele vai?
- Você escolhe uma janela entre 30 e 120 segundos. Quando você salva um replay, o Midge guarda essa quantidade de segundos antes do momento em que você clicou.
- O replay instantâneo grava o que eu digito?
- Não. Todos os valores de input são mascarados no replay, e o texto da página passa pelas mesmas regras de ocultação dos logs, então tokens, números de cartão e valores parecidos são removidos.