Cómo reportar un error que solo ocurre a veces
Cómo reportar un error intermitente: cuenta tus ejecuciones, encuentra qué cambia entre ellas y anota las condiciones para que un desarrollador pueda rastrearlo.
Lo viste. Un botón que no hizo nada, un total que salió mal, una página que se congeló. Lo intentaste de nuevo y funcionó. Lo intentaste una tercera vez y volvió a funcionar. Ahora estás mirando un formulario de ticket sin saber cómo describir algo que acaba de dejar de existir.
Bienvenido al error fantasma. Es uno de los problemas más frustrantes del software, porque el consejo habitual, «da pasos claros para reproducirlo», parece desmoronarse cuando los pasos solo funcionan algunas veces. La buena noticia es que un fantasma se puede describir. Solo necesita otro tipo de reporte: menos centrado en el camino exacto y más en las condiciones que lo rodean.
Por qué «a veces» es una pista, no un callejón sin salida
Un error que aparece de vez en cuando no es aleatorio. Algo es distinto en las ejecuciones en las que falla. Puede ser la sincronización, el orden de las acciones, los datos de la cuenta, el tamaño de un archivo, la red o el tiempo que lleva abierta la aplicación. La máquina hace exactamente lo que se le ordenó. Tu trabajo es ayudar a alguien a encontrar la diferencia.
Eso cambia la forma de escribir el reporte. En lugar de un único camino limpio, reúnes pruebas sobre cuándo ocurre y cuándo no.
Paso uno: repítelo a propósito
Antes de registrarlo, repite los pasos unas cuantas veces y anota lo que pasa en cada una. Basta con un pequeño registro de ejecuciones:
`` Ejecución 1: falló Ejecución 2: funcionó Ejecución 3: funcionó Ejecución 4: falló Ejecución 5: funcionó ``
Ahora puedes decir con qué frecuencia ocurre en lugar de «a veces». Un desarrollador que lee «falló en dos de cinco ejecuciones» sabe más que uno que lee «es inestable», porque lo primero se puede probar y comparar.
Paso dos: cambia una sola cosa cada vez
Busca qué separa las ejecuciones que fallan de las que funcionan. Los sospechosos habituales:
- Sincronización. ¿Hiciste clic justo después de que cargara una página? ¿Falló cuando esperaste un minuto?
- Orden. ¿Hiciste los pasos en un orden ligeramente distinto en las ejecuciones que fallaron?
- Datos. Una cuenta nueva, una cuenta antigua, un nombre largo, un campo vacío, un archivo grande.
- Estado. Un inicio en limpio frente a la aplicación abierta durante una hora. Con la sesión iniciada frente a recién iniciada.
- Entorno. Otro navegador, dispositivo, red o compilación.
- Carga. Otras cosas ejecutándose al mismo tiempo, o un momento de mucha actividad en el servidor.
Cambia uno de estos factores entre ejecuciones, no tres a la vez. Si los fallos se concentran en torno a un cambio, has encontrado la pista.
Paso tres: captura la ejecución que falla
Cuando falle, recoge las pruebas de inmediato, porque el siguiente intento puede funcionar y borrar el rastro.
- Anota la hora exacta, para que alguien pueda encontrarla en los logs.
- Copia el mensaje de error, si lo hay.
- Guarda las líneas del log en torno al fallo, recortadas a lo que importa.
- Anota la compilación o la versión.
- Si tienes un id de solicitud o un id de sesión, consérvalo.
La hora y la compilación son los dos datos que convierten «falló una vez» en «busca este momento en los logs».
Paso cuatro: escribe el reporte para un fantasma
Un reporte de error intermitente tiene las partes habituales más algunas que importan más de lo normal. Este es un formato que puedes copiar:
``` Título: [Área] Síntoma, intermitente
Qué ocurre Describe el fallo con palabras sencillas.
Frecuencia Falló en 2 de 5 ejecuciones con los pasos de abajo.
Pasos
- ...
- ...
- El paso en el que falla
Condiciones observadas Falló cuando el carrito tenía un código promocional aplicado. Funcionó sin él. Todavía no se ha probado en otros navegadores.
Entorno Compilación, plataforma, tipo de cuenta.
Pruebas Hora de la ejecución que falló, fragmento del log, id de solicitud. ```
Las líneas «Condiciones observadas» y «Todavía no se ha probado» son el núcleo. Le dicen al desarrollador qué has confirmado y, igual de útil, qué no has comprobado todavía.
Qué no hacer
- No esperes a poder reproducirlo todas las veces. Un reporte honesto con una frecuencia y algunas pistas es mejor que el silencio. Algunos errores no llegan a reproducirse de forma fiable, y aun así hay que corregirlos.
- No presentes tu suposición sobre la causa como si fuera un hecho. «Parece un problema de sincronización» está bien. «Es una condición de carrera» es una afirmación que quizá no puedas respaldar.
- No cierres tu propio ticket cuando deje de ocurrir. Un error que ha dejado de manifestarse a menudo sigue ahí. Añade una nota y déjalo abierto.
- No omitas las ejecuciones que funcionaron. Son la mitad de las pruebas.
Dónde encaja BugIt
Los errores fantasma son justo donde un reporte se queda corto, porque quien lo reporta está cansado y los detalles se le escapan. BugIt es un agente de control de calidad que funciona en el asistente que ya usas. Describes lo que pasó en una frase rápida, sin pulir y BugIt te pide lo que falta, como la compilación y con qué frecuencia ocurre, antes de redactar el borrador. Conserva la línea de error y la pila de llamadas de un log que pegues, y oculta los datos personales comunes en la medida de lo posible, así que lee el borrador antes de que vaya a ninguna parte. Tú revisas cada borrador antes de que se registre, y no se escribe nada en tu tracker hasta que escribas FILE IT.
Consulta bugit.dev y taskivator.com/bugit.
En resumen
Un error intermitente es un error con una condición oculta. Repítelo y cuenta, cambia una sola cosa cada vez, captura la ejecución que falla con su hora y su compilación, y anota tanto lo que viste como lo que todavía no has probado. Describe las condiciones, no solo el camino, y un fantasma se convierte en algo que un desarrollador puede rastrear.