Informe de Errores y Advertencias
El paso de acción Informe de Errores y Advertencias envía notificaciones automáticas sobre problemas detectados en tu proyecto. Esto ayuda a los propietarios del proyecto a mantenerse informados sobre problemas sin tener que revisar manualmente cada análisis.
Panorama General
Cuando configuras un Informe de Errores y Advertencias, el sistema:
- Escanea todos los notebooks y análisis en tu proyecto
- Recopila cualquier error o advertencia que ocurrió durante la ejecución
- Genera un informe resumido de todos los problemas encontrados
- Envía por correo electrónico el informe a los destinatarios especificados
Esto es esencial para mantener proyectos saludables y detectar problemas antes de que afecten la calidad de tu análisis.
Cuándo Usar el Informe de Errores y Advertencias
Usa el Informe de Errores y Advertencias cuando:
- Seas dueño de un proyecto y necesites monitorear su estado
- Quieras una notificación temprana de problemas con los datos
- Necesites rastrear si las enriquecimientos o calculadoras dejan de funcionar
- Tenga miembros del equipo realizando cambios en proyectos compartidos
- Quieras aseguramiento de calidad automatizado para tu trabajo de minería de procesos
Configuración
Para agregar un Informe de Errores y Advertencias a tu acción, haz clic en el botón + en la sección de Pasos de Acción y selecciona Error & Warning Report Email.
Ajustes
Título (Obligatorio): Un nombre para este paso de informe de errores. Esto te ayuda a identificar el paso si tienes múltiples pasos de acción.
Ejemplo: "Informe de Errores y Advertencias"
Descripción (Opcional): Notas adicionales sobre qué monitorea este informe o por qué existe.
Usuarios: Selecciona las direcciones de correo electrónico que recibirán los informes de error. Normalmente es el dueño del proyecto o una lista de distribución del equipo.
Opciones de Contenido del Informe
Incluir Errores: Cuando está marcado (por defecto), el informe incluye todos los mensajes de error de notebooks y análisis fallidos.
Los errores ocurren cuando:
- Un notebook no logra ejecutarse completamente
- Un enriquecimiento hace referencia a una columna que ya no existe
- Una calculadora encuentra datos inválidos
- Fallan las conexiones a bases de datos
Incluir Advertencias: Cuando está marcado (por defecto), el informe incluye mensajes de advertencia que indican posibles problemas.
Las advertencias ocurren cuando:
- Se detectan problemas de calidad de datos
- Se exceden los umbrales de rendimiento
- Se usan funciones obsoletas
- Ocurren fallas parciales
Enviar correo si no se encuentran problemas: Controla si recibes un informe cuando todo está funcionando correctamente.
- Marcado: Recibes un informe en cada ejecución programada, incluso si no hay problemas. Esto confirma que el monitoreo está funcionando.
- No marcado: Solo recibes un informe cuando se encuentran errores o advertencias. Esto reduce el ruido de correos pero significa que el silencio indica éxito.
Casos de Uso Comunes
Monitoreo del Dueño del Proyecto
Configura monitoreo semanal para detectar cualquier problema:
| Ajuste | Valor |
|---|---|
| Título | Revisión Semanal de Salud del Proyecto |
| Usuarios | project-owner@company.com |
| Incluir Errores | Marcado |
| Incluir Advertencias | Marcado |
| Enviar si no hay problemas | No marcado |
| Programación | Todos los lunes a las 7:00 AM |
Solo recibes un correo si algo requiere atención.
Notificación al Equipo
Mantén a todo el equipo informado sobre problemas:
| Ajuste | Valor |
|---|---|
| Título | Alertas de Errores del Equipo |
| Usuarios | process-mining-team@company.com |
| Incluir Errores | Marcado |
| Incluir Advertencias | No marcado |
| Enviar si no hay problemas | No marcado |
| Programación | Diario a las 6:00 AM |
El equipo recibe alertas diarias sobre errores, pero no advertencias (para reducir el ruido).
Monitoreo de Cumplimiento
Para proyectos que requieren documentar la salud del sistema:
| Ajuste | Valor |
|---|---|
| Título | Informe de Salud para Cumplimiento |
| Usuarios | compliance@company.com |
| Incluir Errores | Marcado |
| Incluir Advertencias | Marcado |
| Enviar si no hay problemas | Marcado |
| Programación | Diario a las 8:00 AM |
Se envía un informe todos los días como evidencia del monitoreo, haya o no problemas.
Qué Dispara Errores y Advertencias
Cambios en los Datos
Cuando los datos subyacentes cambian, los análisis existentes pueden romperse:
- Se renombra o elimina una columna de la fuente de datos
- Cambian los tipos de datos (texto a número, etc.)
- Los datos requeridos dejan de estar disponibles
- Expiran las credenciales de conexión
Problemas de Configuración
Cuando la configuración del análisis se vuelve inválida:
- Enriquecimientos hacen referencia a columnas eliminadas
- Calculadoras usan tipos de datos incompatibles
- Filtros hacen referencia a valores que ya no existen
- Investigaciones hacen referencia a conjuntos de datos eliminados
Fallos en la Ejecución
Cuando los notebooks no se ejecutan:
- Tiempo de espera durante cálculos prolongados
- Se exceden limitaciones de memoria
- Servicio externo no disponible
- Errores de scripts Python
Mejores Prácticas
Configura para cada proyecto que poseas: Si eres responsable de un proyecto, crea un Informe de Errores y Advertencias para mantenerte informado.
Elige bien a los destinatarios: Envía a personas que puedan actuar sobre los problemas. Evita enviar a interesados que no pueden solucionar los problemas.
Usa una programación apropiada: El monitoreo diario es adecuado para proyectos activos. La semanal suele ser suficiente para proyectos estables.
Habilita “Enviar si no hay problemas” inicialmente: Al configurar por primera vez, recibe informes incluso cuando no hay problemas para confirmar que la acción funciona. Desactívalo luego para reducir el volumen de correos.
Combina con otras acciones: Programa los informes de error para que se ejecuten antes que otros informes. Así detectas problemas antes de que los interesados reciban datos posiblemente incorrectos.
Cómo Responder a los Informes de Error
Cuando recibas un informe de errores:
- Revisa los mensajes de error: Entiende qué falló y por qué
- Verifica los análisis afectados: Abre los notebooks mencionados en mindzieStudio
- Investiga la causa raíz: ¿Fue un cambio en los datos, un problema de configuración o un problema del sistema?
- Corrige el problema subyacente: Actualiza configuraciones, arregla las fuentes de datos o corrige scripts
- Vuelve a ejecutar los análisis afectados: Ejecuta manualmente notebooks para verificar la corrección
- Monitorea los informes siguientes: Asegura que el error no se repita
Solución de Problemas
No recibes los informes esperados
- Verifica que la acción esté habilitada (la columna Activo muestra verde)
- Comprueba que la programación sea correcta
- Confirma que las direcciones de correo sean válidas
- Revisa las carpetas de spam/correo no deseado
- Consulta el historial de la acción para errores de ejecución
Recibes demasiados informes
- Desmarca "Enviar correo si no se encuentran problemas"
- Considera enviar sólo errores, no advertencias
- Reduce la frecuencia de la programación si los problemas no requieren atención inmediata
- Soluciona los problemas subyacentes que causan errores repetidos
El contenido del informe no es claro
- Anota los nombres de notebooks y mensajes de error
- Abre los notebooks específicos en mindzieStudio
- Ejecuta notebooks manualmente para ver detalles de errores
- Revisa las conexiones de datos y mapeos de columnas
Documentación Relacionada
Soporte
Si encuentras problemas con los Informes de Errores y Advertencias:
- Correo electrónico: support@mindzie.com
- Incluye los mensajes de error de tu informe
- Indica cuándo comenzaron a ocurrir los problemas