Pular para o conteúdo

Logs de rede do Chrome, capturados em todo bug report

Atualizado em

O Midge captura os logs de rede do Chrome automaticamente em todo bug report. Requisições fetch e XHR vêm com headers, bodies de requisição e resposta, status codes e tempos; mensagens de WebSocket são gravadas à medida que são enviadas e recebidas; scripts, estilos, imagens e fontes aparecem com status, tamanho e tempo. Um dev pode abrir qualquer requisição, copiá-la como cURL ou baixar o log inteiro como um arquivo HAR ocultado.

Você não precisa do DevTools aberto, e quem reporta o bug não precisa saber o que é um arquivo HAR. Toda gravação inclui logs de console, requisições de rede, ações do usuário e informações do dispositivo.

Por que o painel de rede do DevTools não basta

O painel Network do Chrome é excelente quando é você quem está debugando. Para bug reports, ele tem três problemas:

  1. Ele precisa estar aberto antes de a requisição acontecer. Requisições feitas antes de você abrir o DevTools não estão lá, e a maioria das pessoas só o abre depois do bug.
  2. Ele é limpo a cada navegação, a menos que alguém tenha lembrado de marcar "Preserve log".
  3. Uma exportação HAR contém segredos. Cookies, headers Authorization e tokens nas query strings vão todos parar no arquivo. O nosso guia sobre como remover dados sensíveis de um arquivo HAR explica por que isso importa.

O Midge captura a atividade de rede em segundo plano em cada página, guarda as requisições recentes na memória e as anexa quando você cria um report. Os segredos são removidos antes do upload.

Como uma requisição aparece num report

Cada requisição fica na mesma linha do tempo do vídeo e do console. Abra uma e você vê a troca completa:

POST /api/v2/invoices HTTP/1.1
Content-Type: application/json
Authorization: [REDACTED]

{"customerId": "cus_8812", "lines": [{"sku": "PRO-M", "qty": 3}]}

HTTP/1.1 409 Conflict
Content-Type: application/json

{"error": "invoice_already_open", "invoiceId": "inv_3021"}

Junto com os bodies, você vê o status code, a duração e quando a requisição começou. Como as requisições ficam ordenadas por tempo ao lado do vídeo, o 409 acima aparece logo depois do clique que o causou, em vez de ficar enterrado entre dezenas de carregamentos de imagem.

Mensagens de WebSocket

Apps em tempo real muitas vezes falham num socket, não no HTTP. O Midge grava mensagens de WebSocket nas duas direções, com timestamps, então você consegue ver que o servidor mandou {"type":"price_update"} duas vezes e o cliente renderizou só a primeira.

Outros recursos

Scripts, folhas de estilo, imagens, fontes e documentos aparecem com status code, tamanho e tempo, sem os bodies. Normalmente é disso que você precisa: um 404 em app.4f2c1.js depois de um deploy, ou uma imagem de destaque de 3 MB que atrasa o first paint.

GraphQL do jeito certo

O GraphQL deixa os logs de rede difíceis de ler. Toda requisição vai para o mesmo endpoint /graphql, e os erros muitas vezes voltam com HTTP 200:

{
  "data": { "updateProfile": null },
  "errors": [{ "message": "Not authorized to update this profile", "path": ["updateProfile"] }]
}

O Midge mostra o nome da operação, como UpdateProfile, ao lado de cada requisição GraphQL e sinaliza respostas 200 que contêm um array errors. Uma falha que um filtro por status code esconderia aparece marcada como falha.

Copiar como cURL

Qualquer requisição capturada pode ser copiada como comando cURL, para que um dev de backend a repita no terminal e veja a mesma resposta. Como a ocultação acontece antes, o header Authorization e os cookies chegam como [REDACTED]. Troque por um token da sua própria conta de teste e rode. Isso é proposital: um bug report nunca deveria entregar uma sessão funcionando.

Exporte um HAR ocultado

Alguns times e alguns fornecedores querem um arquivo HAR. O Midge permite baixar o log de rede de um report como HAR, e o arquivo contém os dados ocultados. Você pode abri-lo no visualizador de HAR gratuito ou anexá-lo a um ticket de suporte com um provedor de API sem vazar as suas chaves. Se você tem um HAR exportado direto do DevTools, limpe-o com o sanitizador de HAR, que usa as mesmas regras da extensão.

O que é ocultado

Senhas, números de cartão, tokens e cookies são ocultados no seu navegador antes que qualquer coisa saia do seu dispositivo. Nos dados de rede, isso quer dizer:

  • Headers Authorization, Cookie, Set-Cookie, de API key e de CSRF, e qualquer header cujo nome contenha palavras como token, secret, session ou auth.
  • Parâmetros de URL sensíveis, como access_token, code, api_key e signature.
  • Campos de body como password, otp, cvv, iban ou card_number, inclusive os aninhados.
  • JWTs, números de cartão válidos pelo algoritmo de Luhn e formatos conhecidos de API key em qualquer parte do payload.

E-mails e telefones internacionais ficam parcialmente mascarados. A lista completa está na página de ocultação.

Limites

Os bodies de requisição e resposta são capturados para fetch, XHR e WebSocket; os outros tipos de recurso mostram só metadados. O tráfego de apps fora do Chrome não entra no report, e o Midge não roda nos sites que você adicionou à lista de nunca capturar. Se você precisa de uma captura completa no nível do navegador para uma investigação pontual, o nosso guia sobre como capturar o tráfego de rede no Chrome explica o caminho pelo DevTools.

O Midge é grátis: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água.

Perguntas frequentes

Quais requisições o Midge captura?
Requisições fetch e XHR com headers, bodies de requisição e resposta, status codes e tempos, além de mensagens de WebSocket. Outros recursos, como scripts, folhas de estilo, imagens, fontes e documentos, aparecem com status, tamanho e tempo.
Posso exportar o log de rede como arquivo HAR?
Sim. O log de rede de um report pode ser baixado como arquivo HAR, e o download contém os dados ocultados, não os valores originais.
Como o Midge lida com GraphQL?
Ele mostra o nome da operação de cada requisição GraphQL e sinaliza respostas que retornam HTTP 200 mas contêm um array errors, algo que um filtro por status code deixaria passar.
O copiar como cURL inclui o meu token de autenticação?
Não. Headers Authorization e cookies são ocultados antes do upload, então o comando copiado traz [REDACTED] no lugar deles. Coloque o seu próprio token quando for rodar.