BugIt4 min de lectura

Detecta errores duplicados antes de registrarlos

Por qué un error acaba convertido en varios tickets, cómo buscar en un tracker para encontrar el anterior y qué hacer cuando lo encuentras.

Un flujo que va de describir un error a buscar por síntoma y texto del error, revisar candidatos y, al final, añadir pruebas, vincular como relacionado o registrar uno nuevo.

Imagina un error en la pantalla de inicio de sesión. El lunes, un tester escribe «el spinner del login no deja de girar». El martes, un ingeniero de soporte escribe «no puedo iniciar sesión después de la página de la contraseña». El miércoles, un desarrollador encuentra un tercer reporte que menciona un tiempo de espera agotado al renovar el token.

Tres tickets, tres personas, un error. Cada ticket contiene una parte de la respuesta. El primero tiene los pasos, el segundo tiene un cliente esperando, el tercero tiene el log. Nadie ve el panorama completo, y alguien hará el triaje del mismo problema tres veces.

Los duplicados no son señal de gente descuidada. Son lo que pasa cuando distintas personas describen lo mismo con palabras distintas. La buena noticia es que una búsqueda breve antes de registrar evita la mayoría, y unos cuantos hábitos mantienen el resto bajo control.

Por qué falla una simple búsqueda por palabras clave

Una búsqueda de «spinner» no encontrará «no puedo iniciar sesión». Una búsqueda de «login» no encontrará «autenticar». Además, los trackers crecen. El ticket que necesitas puede estar cerrado, haber cambiado de nombre o estar enterrado bajo cientos de tickets más recientes.

Así que la búsqueda requiere un poco de oficio. Esta es una rutina que lleva un par de minutos.

Seis pasos antes de registrar

  1. Busca el síntoma, no tu título. Usa las palabras que vería un usuario: el mensaje en pantalla, el nombre de la pantalla, la acción que falló.
  2. Busca el texto del error. Si tienes el nombre de una excepción o un código de estado, búscalo. Los desarrolladores suelen pegarlos en los tickets, y coinciden exactamente.
  3. Prueba sinónimos. Cierre inesperado, congelación, cuelgue y spinner pueden describir un mismo fallo. También login, iniciar sesión y autenticar.
  4. Acota por área. Filtra por el componente o la etiqueta de la parte del producto que estabas usando, para que la lista se reduzca a algo que puedas leer.
  5. Incluye los tickets cerrados. Un error corregido que vuelve es una regresión, y el ticket antiguo guarda el historial y a veces la causa.
  6. Sigue los vínculos. A veces la coincidencia está a un vínculo de distancia de un ticket que ya encontraste.

Un ticket parecido no es necesariamente un duplicado, y fusionar los que no son oculta errores.

  • Duplicado: mismo síntoma y misma causa. Los tickets describen un único problema.
  • Relacionado: mismo síntoma con otra causa, o la misma área con otro síntoma. Mantenlos separados y vincúlalos.
  • Distinto: solo coincide el vocabulario. Déjalo como está.

Cuando no lo tengas claro, márcalo como relacionado y vincúlalo. Un vínculo cuesta unos segundos, y la persona responsable del área puede fusionarlos más adelante con más conocimiento del que tienes tú.

Qué hacer cuando encuentras una coincidencia

Encontrar el ticket anterior es el principio, no el final. Haz que la coincidencia sea útil.

  • Añade lo que sea nuevo. Tu compilación, tus pasos, un log o una nota de que otro cliente está afectado. Si hay algo que a un ticket le viene bien tener de más, son las pruebas.
  • Evita el ticket de «a mí también». Abrir un segundo ticket para decir que a ti también te pasa vuelve a dividir las pruebas. Comenta en el primero.
  • Reabre con cuidado. Si la coincidencia está cerrada y todavía puedes repetir el problema, sigue la práctica de tu equipo: reábrelo, o registra un ticket nuevo que remita al anterior.
  • Pide una segunda opinión. Si no estás seguro, registra tu ticket y vincula el candidato como relacionado. Quien hace el triaje decide.

Mantener a raya los duplicados en equipo

La búsqueda individual ayuda, pero los hábitos de equipo ayudan más. Un tracker es una memoria compartida, y solo funciona si la gente escribe en él de forma que la siguiente persona pueda encontrar lo que busca.

  • Acordar un formato de título. Cuando los tickets de un área se leen de forma parecida, se ordenan juntos y los duplicados saltan a la vista.
  • Usar un conjunto reducido de etiquetas para los componentes. Aplicarlas de forma coherente, para que un filtro encuentre lo que debe.
  • Cerrar los duplicados con un vínculo. Hacer que apunten al ticket que se conserva, para que el historial se pueda seguir encontrando.
  • Echar un vistazo a los tickets más recientes en el triaje. Un repaso de cinco minutos de lo que llegó desde ayer detecta los pares mientras aún son recientes.

Un ejemplo rápido

Te encuentras con un cierre inesperado al exportar un informe a PDF. Tu primera búsqueda, «exportar cierre inesperado», no encuentra nada. Así que buscas el mensaje en pantalla, «no se pudo generar el archivo», y aparece un ticket titulado «El botón PDF no hace nada en informes grandes». Palabras distintas, mismo síntoma, y los pasos coinciden con los tuyos.

No registras un ticket nuevo. Comentas con tu compilación y la línea del log, y vinculas el otro ticket que encontraste que menciona la misma pantalla de exportación. Dos minutos, ningún ticket nuevo, y el siguiente desarrollador que lo abra verá el panorama completo.

Dónde encaja BugIt

Buscar bien en un tracker requiere paciencia, y es justo el paso que la gente se salta cuando tiene prisa. BugIt lo hace por ti. Cuando describes un error, BugIt busca en tu tracker tickets parecidos al tuyo antes de que veas el borrador. La búsqueda solo lee. Asigna una puntuación a cada candidato para que puedas valorar lo cerca que está, y enumera los tickets relacionados en el borrador para que el vínculo esté a un clic. Un error rápido se salta la búsqueda.

Es una pista, no un veredicto. Tú revisas cada borrador antes de que se registre, BugIt oculta los datos personales comunes en la medida de lo posible, y no se escribe nada en tu tracker hasta que escribas FILE IT.

Más información en bugit.dev y taskivator.com/bugit.

En resumen

Los duplicados nacen de usar palabras distintas para el mismo problema. Busca el síntoma y el texto del error, prueba sinónimos, incluye los tickets cerrados y sigue los vínculos. Cuando encuentres una coincidencia, añade tus pruebas en lugar de abrir otro ticket. Dos minutos de búsqueda le ahorran a un equipo corregir, hacer el triaje y explicar el mismo error más de una vez.

Ya disponibleAgente de control de calidad para tu asistente de IA

BugIt

Español