Grupos de errores y agregación

Aprende cómo Zenovay agrupa inteligentemente errores similares para reducir el ruido y acelerar la depuración.

Dónde encontrar grupos de errores

Abre el panel de control de tu sitio web desde Domains y selecciona la pestaña Errors. La pestaña tiene dos subpestañas:

• Errors — la lista agrupada de errores de JavaScript y red (este artículo).
• Frustration — rage clicks, dead clicks y otras señales de frustración.

El seguimiento de errores está disponible en el plan Pro y superiores.

Cómo funciona la agrupación de errores

Agrupación por huella digital

En lugar de mostrar cada ocurrencia individual, Zenovay colapsa errores idénticos en un único grupo usando una huella digital derivada de:

1. Tipo de error — TypeError, ReferenceError, etc.
2. Mensaje de error — el patrón del mensaje
3. Stack trace — los frames superiores de la pila de llamadas

Dos ocurrencias con la misma huella digital caen en el mismo grupo, por lo que un único error recurrente aparece una vez con un conteo de ocurrencias, no miles de veces.

Ejemplo

Estas dos ocurrencias se agrupan juntas:

// Error 1: Usuario ID 123
TypeError: Cannot read property 'name' of undefined
    at getUserName (user.js:45:12)
    at renderProfile (profile.js:78:5)

// Error 2: Usuario ID 456
TypeError: Cannot read property 'name' of undefined
    at getUserName (user.js:45:12)
    at renderProfile (profile.js:78:5)

Mismo grupo porque:

• Mismo tipo de error (TypeError)
• Mismo mensaje
• Misma ubicación en stack trace

Lista de grupos de errores

Cada grupo en la lista muestra:

Métrica	Descripción
Ocurrencias	Número total de veces que se disparó el error
Usuarios	Visitantes únicos afectados
Primera aparición	Cuándo se registró el grupo por primera vez
Última aparición	Ocurrencia más reciente
Categoría	JavaScript, Red, Recurso o Personalizado
Severidad	Crítico, Alto, Medio o Bajo
Estado	Sin resolver, Investigando, Resuelto o Ignorado

Panel de detalle del grupo

Haz clic en un grupo para abrir su panel de detalle, que incluye:

• Ejemplos de ocurrencias — detalles completos (mensaje, frames de stack, breadcrumbs) para instancias recientes
• Gráfico de frecuencia — ocurrencias a lo largo del tiempo
• Páginas afectadas — dónde ocurre el error más
• Desglose de navegador y dispositivo — qué navegadores, sistemas operativos y dispositivos se ven afectados
• Insights — orientación específica de la categoría sobre por qué ocurre el error, dónde buscar y cómo solucionarlo

Flujo de trabajo del estado de errores

Tipos de estado

Estado	Descripción
Sin resolver	Errores nuevos o aún abiertos — por defecto
Investigando	Lo estás investigando activamente
Resuelto	La corrección está implementada y el error debería detenerse
Ignorado	Problema conocido que no planeas solucionar (p. ej. ruido de terceros)

Cambiar estado

Desde el panel de detalle de un grupo de errores, usa los botones de estado para marcarlo Investigando, Resuelto o Ignorado. Marcar un grupo Resuelto o Ignorado lo elimina de la vista Sin resolver por defecto para que tu lista se mantenga enfocada en lo que está realmente abierto.

Cambiar el estado requiere un rol de equipo con acceso de edición al sitio web. Los espectadores pueden explorar grupos de errores pero no pueden cambiar su estado.

Filtrado & Búsqueda

La lista de errores se puede reducir con:

Filtro	Opciones
Estado	Todos, Sin resolver, Investigando, Resuelto, Ignorado
Categoría	JavaScript, Red, Recurso, Personalizado
Severidad	Crítico, Alto, Medio, Bajo
Rango de fechas	Hoy, Ayer, 7 / 14 / 30 / 90 días, Todos los tiempos

Un cuadro de búsqueda filtra grupos por mensaje de error o tipo. Los rangos de fechas disponibles dependen de la ventana de retención de datos de tu plan.

Supresión de grupos ruidosos

Si un grupo es puro ruido (p. ej. una ocurrencia única de una extensión del navegador), márcalo Ignorado desde su panel de detalle. Los grupos ignorados se descartan de la vista Sin resolver por defecto para que tu lista se mantenga enfocada, pero su historial se conserva en caso de que quieras revisarlo más tarde. Si cambias de opinión, cambia el estado de vuelta a Sin resolver o Investigando.

Mejores prácticas

Flujo de trabajo de triage

1. Revisar regularmente — revisa los errores sin resolver como parte de tu rutina.
2. Priorizar por impacto — un grupo que afecta a muchos usuarios generalmente importa más que el número bruto de ocurrencias.
3. Victorias rápidas primero — resuelve las correcciones fáciles inmediatamente para reducir el ruido.
4. Usar el estado consistentemente — mantén la lista Sin resolver para cosas que realmente necesitan atención; ignora el ruido conocido de terceros.
5. Vigilar picos — configura alertas de rendimiento para que te enteres proactivamente de nuevos picos de errores.

Agrupación efectiva

• Mantén los source maps actualizados para que los stack traces sigan siendo legibles.
• Usa mensajes de error consistentes y descriptivos en tu código.
• Agrega contexto a errores rastreados manualmente (personalizados).

Solución de problemas

Demasiados grupos

Causas:

• Mensajes de error altamente dinámicos (muchos datos variables en el texto del mensaje)
• Source maps faltantes
• Errores de scripts de terceros

Soluciones:

• Usa mensajes de error estables y normalizados
• Carga source maps
• Marca el ruido de terceros como Ignorado

Los errores no se agrupan

Verifica:

• Un stack trace está disponible en el error
• Los errores comparten la misma ubicación de origen
• El tipo de error y el mensaje coinciden

Próximos pasos

• Análisis de Stack Trace
• Errores de JavaScript
• Source Maps & JS Errors
• Alertas de rendimiento