Saltar al contenido

Logs de red de Chrome, capturados con cada reporte de bug

Actualizado

Midge captura automáticamente los logs de red de Chrome con cada reporte de bug. Las peticiones fetch y XHR llegan con cabeceras, cuerpos de petición y de respuesta, códigos de estado y tiempos; los mensajes de WebSocket se registran a medida que se envían y se reciben; los scripts, estilos, imágenes y fuentes aparecen con su estado, tamaño y tiempo. Un desarrollador puede abrir cualquier petición, copiarla como cURL o descargar el log completo como archivo HAR sin secretos.

No necesitas tener DevTools abierto, y quien reporta el bug no necesita saber qué es un archivo HAR. Cada grabación incluye logs de consola, peticiones de red, acciones del usuario y datos del dispositivo.

Por qué el panel de red de DevTools no basta

El panel Network de Chrome es excelente cuando eres tú quien depura. Para los reportes de bugs tiene tres problemas:

  1. Tiene que estar abierto antes de que se haga la petición. Las peticiones hechas antes de abrir DevTools no aparecen, y la mayoría de la gente lo abre después del bug.
  2. Se vacía al navegar a menos que alguien se haya acordado de marcar «Preserve log».
  3. Una exportación HAR contiene secretos. Las cookies, las cabeceras Authorization y los tokens de las query strings acaban todos en el archivo. Nuestra guía sobre cómo eliminar datos sensibles de un archivo HAR explica por qué importa.

Midge captura la actividad de red en segundo plano en cada página, guarda en memoria las peticiones recientes y las adjunta cuando creas un reporte. Los secretos se eliminan antes de subir.

Cómo se ve una petición en un reporte

Cada petición se coloca en la misma línea de tiempo que el vídeo y la consola. Abre una y verás el intercambio completo:

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 con los cuerpos tienes el código de estado, la duración y el momento en que empezó la petición. Como las peticiones se ordenan por tiempo junto al vídeo, el 409 de arriba aparece justo después del clic que lo provocó, en lugar de quedar enterrado entre decenas de cargas de imágenes.

Mensajes de WebSocket

Las apps en tiempo real suelen fallar por un socket, no por HTTP. Midge registra los mensajes de WebSocket en ambas direcciones con su marca de tiempo, así que puedes ver que el servidor envió {"type":"price_update"} dos veces y el cliente solo mostró el primero.

Otros recursos

Los scripts, hojas de estilo, imágenes, fuentes y documentos aparecen con su código de estado, tamaño y tiempo, sin sus cuerpos. Normalmente es lo que necesitas: un 404 en app.4f2c1.js después de un deploy o una imagen de cabecera de 3 MB que retrasa el primer pintado.

GraphQL, bien resuelto

GraphQL hace que los logs de red cuesten de leer. Todas las peticiones van al mismo endpoint /graphql, y los errores suelen volver con HTTP 200:

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

Midge muestra el nombre de la operación, como UpdateProfile, junto a cada petición GraphQL y marca las respuestas 200 que contienen un array errors. Un fallo que un filtro por código de estado ocultaría queda marcado como fallo.

Copiar como cURL

Cualquier petición capturada se puede copiar como comando cURL, para que un desarrollador de backend la repita desde una terminal y vea la misma respuesta. Como la ocultación ocurre antes, la cabecera Authorization y las cookies llegan como [REDACTED]. Pon un token de tu propia cuenta de prueba y ejecútalo. Es a propósito: un reporte de bug nunca debería entregar una sesión que funcione.

Exportar un HAR sin secretos

Algunos equipos y algunos proveedores quieren un archivo HAR. Midge te permite descargar el log de red de un reporte como HAR, y el archivo contiene los datos ya ocultados. Puedes abrirlo en el visor HAR gratuito o adjuntarlo a un ticket de soporte con un proveedor de API sin filtrar tus claves. Si tienes un HAR exportado directamente desde DevTools, límpialo con el sanitizador de HAR, que usa las mismas reglas que la extensión.

Qué se oculta

Las contraseñas, números de tarjeta, tokens y cookies se ocultan en tu navegador antes de que nada salga de tu dispositivo. En los datos de red, eso significa:

  • Las cabeceras Authorization, Cookie, Set-Cookie, de clave de API y de CSRF, y cualquier cabecera cuyo nombre contenga palabras como token, secret, session o auth.
  • Los parámetros de URL sensibles, como access_token, code, api_key y signature.
  • Los campos del cuerpo como password, otp, cvv, iban o card_number, también los anidados.
  • Los JWT, los números de tarjeta que superan la comprobación de Luhn y los formatos conocidos de claves de API en cualquier parte del contenido.

Los correos y los teléfonos internacionales se enmascaran a medias. La lista completa está en la página de ocultación.

Límites

Los cuerpos de petición y de respuesta se capturan para fetch, XHR y WebSocket; los demás tipos de recurso solo muestran metadatos. El tráfico de apps fuera de Chrome no forma parte del reporte, y Midge no se ejecuta en los sitios que hayas añadido a su lista de exclusión. Si necesitas una captura completa a nivel de navegador para una investigación puntual, nuestra guía sobre cómo capturar el tráfico de red en Chrome explica el camino con DevTools.

Midge es gratis: grabaciones ilimitadas, vídeos de hasta 15 minutos y sin marca de agua.

Preguntas frecuentes

¿Qué peticiones captura Midge?
Las peticiones fetch y XHR con cabeceras, cuerpos de petición y de respuesta, códigos de estado y tiempos, además de los mensajes de WebSocket. Otros recursos, como scripts, hojas de estilo, imágenes, fuentes y documentos, aparecen con su estado, tamaño y tiempo.
¿Puedo exportar el log de red como archivo HAR?
Sí. El log de red de un reporte se puede descargar como archivo HAR, y la descarga contiene los datos ya ocultados, no los valores originales.
¿Cómo trata Midge GraphQL?
Muestra el nombre de la operación de cada petición GraphQL y marca las respuestas que devuelven HTTP 200 pero contienen un array errors, algo que un filtro por código de estado no detectaría.
¿Copiar como cURL incluye mi token de autenticación?
No. Las cabeceras de autorización y las cookies se ocultan antes de subir, así que el comando copiado lleva [REDACTED] en su lugar. Añade tu propio token cuando lo ejecutes.