Cómo documentar y compartir registros de errores con Loom
Loom permite a los equipos grabar incidencias técnicas, lo que les ayuda a combinar el contexto visual con los registros, paneles y mensajes del sistema pertinentes. En lugar de depender únicamente de las descripciones por escrito, los equipos podrán ver cómo se produjo la incidencia, qué aparecía en pantalla y qué pasos causaron el error.
Esto puede facilitar la comprensión y agilizar la capacidad de tomar medidas sobre la base de los informes de errores, las derivaciones y las revisiones de incidentes.
Paso 1: Identifica y reproduce la incidencia
Antes de grabar una demostración, confirma la incidencia exacta que quieres documentar. Sigue los mismos pasos que provocaron el problema y haz referencia al entorno, las acciones del usuario y las condiciones que lo causaron.
El objetivo es garantizar que la incidencia se pueda reproducir de manera coherente antes de proceder con la grabación. Algunos errores solo aparecen en condiciones específicas, por lo que puede ser importante mencionar detalles como el navegador, el dispositivo, el rol del usuario, la configuración de la cuenta o el momento en el que se produjo el problema.
Paso 2: Prepara los registros pertinentes y el contexto técnico
A continuación, abre las herramientas para desarrolladores, paneles o registros del sistema que muestran el error. Busca la marca de tiempo correspondiente al momento exacto en el que se produjo el error. Toma nota de los códigos y mensajes de error que puedan proporcionar detalles sobre este.
También deberías revisar lo que sucede justo antes y después del error para recabar más contexto.
Paso 3: Graba una demostración de la incidencia con Loom
Una vez que hayas reproducido la incidencia y abierto los registros pertinentes, utiliza la grabadora de pantalla de Loom para grabar una demostración clara.
A la vez que grabas, describe el comportamiento esperado y explica con claridad en qué punto ocurre la incidencia. Señalar la incidencia de forma clara puede ayudar a los equipos de TI o ingeniería a reproducirla e investigar la causa. También puedes usar Loom para grabar una narración una vez que hayas terminado de documentar la incidencia.
Paso 4: Destaca los mensajes de error y las respuestas del sistema
Durante la grabación, incide en los mensajes, las alertas, las solicitudes fallidas o los comportamientos inesperados que puedan ayudarte a explicar la incidencia. Esto permitirá a quienes vean el contenido establecer una conexión entre lo que están viendo en pantalla y los detalles técnicos presentes en los registros.
No te limites a mostrar que se ha producido un error. Explica cómo afecta a la experiencia de usuario, qué flujo de trabajo interrumpe y por qué requiere atención. Este contexto adicional puede ayudar a los equipos a priorizar la incidencia y decidir por dónde deben empezar la investigación.
Paso 5: Comparte la grabación de Loom con las partes interesadas
Cuando termines de grabar un vídeo con Loom, se añadirá automáticamente a tu cuenta. Loom también crea un enlace que puedes compartir y enviar a las partes interesadas.
Puedes compartir tu grabación de Loom con las partes interesadas a través de las aplicaciones de colaboración que ya utilizas, como Jira, Confluence o Slack. Envía la grabación a ingenieros, gerentes de producto o equipos de soporte. Compartir grabaciones de Loom entre equipos de ingeniería y soporte puede facilitar la colaboración interdisciplinar.
Utiliza la configuración de uso compartido de Loom para asegurarte de que las partes interesadas pertinentes puedan ver y dejar comentarios en la grabación.
Paso 6: Documenta los resultados y almacena las grabaciones para poder consultarlas en el futuro
Una vez que se resuelva la incidencia, almacena la grabación de Loom junto con el resto de la documentación del incidente. Esto te permitirá crear un registro más claro de lo que ocurrió, cómo surgió la incidencia y qué pasos ayudaron al equipo a resolverla.
Estas grabaciones también pueden resultar de utilidad para las comprobaciones posteriores a los incidentes, los procesos de incorporación y la resolución de futuros problemas. Con la biblioteca de vídeos de Loom, los equipos pueden organizar las grabaciones por proyecto, tipo de incidente, fecha o sistema para que sea más fácil encontrarlas en otro momento.