Gestión de errores
Consola de Gestión de Errores (EMC)
Sección titulada «Consola de Gestión de Errores (EMC)»La pestaña Error Monitor en la aplicación DQS proporciona una interfaz dedicada para monitorear y resolver errores que ocurren durante el procesamiento de escaneos. Ofrece visibilidad completa sobre fallos de lotes, errores de estrategia y problemas de la plataforma — todo en un solo lugar.
La Consola de Gestión de Errores utiliza un diseño de 3 zonas:
- Barra lateral de filtros (izquierda) — Filtra errores por tipo de error, clase fuente, mensaje de error, rango de tiempo (Desde/Hasta) y dirección IP. Una sección Desgloses agrupa los errores por tipo, fuente u otros criterios, mostrando conteos junto a cada categoría para una clasificación rápida.
- Tabla de registro de errores (centro) — Tabla ordenable que lista todos los errores con columnas de resumen. Muestra el total de conteos de errores en tres ventanas de tiempo: Últimas 24 horas, Últimos 7 días y Próximos a expirar. Haga clic en cualquier fila para ver los detalles completos.
- Panel de acciones (derecha) — Actualiza el registro, crea una exportación CSV descargable, elimina entradas seleccionadas y configura el período de retención.
Tabla de registro de errores
Sección titulada «Tabla de registro de errores»Cada fila de error en la tabla muestra las siguientes columnas:
| Columna | Descripción |
|---|---|
| Error ID | Identificador único para la entrada del registro de errores |
| Type | Categoría del error (p. ej., DML_FAILED, QUERY_FAILED, FIELD_INSERT_FAILED, BATCH_EXECUTE_FAILED) |
| Message | Descripción breve del error (truncada — haga clic en la fila para ver el mensaje completo) |
| Source | La clase Apex que generó el error (p. ej., DQS_ExportFileService, DQS_DynamicQueryBuilder01) |
| Event Time | Marca de tiempo de cuándo ocurrió el error |
La parte superior de la tabla muestra contadores agregados — Total Errors, Last 24 Hours, Last 7 Days y Expiring Soon — proporcionando una vista general del estado de un vistazo.
Modal de detalle de fila
Sección titulada «Modal de detalle de fila»Haga clic en cualquier fila de error para abrir un modal de detalle con el contexto completo:
- Error ID y Type (resaltado en rojo para identificación rápida)
- Source — la clase Apex de origen
- uniqueIdentifier_01 — el registro relacionado o identificador del lote
- Insert Type — si la operación fue una inserción, actualización u otro tipo de DML
- Event Time y First Event Time — marcas de tiempo de la ocurrencia del error
- Message — mensaje de error completo incluyendo el tipo de excepción de Salesforce (p. ej.,
System.AsyncException,System.DmlException) - Stack Trace — stack trace completo de Apex para depuración
Fuentes de errores
Sección titulada «Fuentes de errores»| Fuente | Ejemplos |
|---|---|
| Procesamiento por lotes | Governor limit excedido, timeout de consulta |
| Estrategia de dimensión | Acceso inválido a campo, puntero nulo en la lógica de estrategia |
| Platform Events | Fallo en la publicación de eventos |
| Programación | Problemas con expresiones CRON, errores de permisos |
Integración con Platform Events
Sección titulada «Integración con Platform Events»DQS usa Platform Events DQS_Processing_Error__e para mostrar errores en tiempo real. Cuando ocurre un error durante el procesamiento por lotes:
- El error es capturado y registrado
- Se publica un Platform Event
- La EMC recibe el evento y lo muestra
Esto reemplaza los bloques catch silenciosos con reportes de errores visibles.
Retención de errores
Sección titulada «Retención de errores»Los registros de errores se purgan automáticamente según el período de retención configurado. La retención predeterminada es de 7 días.
Para cambiar el período de retención, use la sección Retention Configuration en el panel de acciones en el lado derecho de la consola. Ingrese el número de días deseado en el campo Error Log Retention (days) y haga clic en Save. Los registros de errores más antiguos que el período especificado serán purgados automáticamente. Los cambios se implementan a través de la Metadata API y pueden tardar un momento en surtir efecto.
Mejores prácticas
Sección titulada «Mejores prácticas»- Revise la EMC regularmente después de configurar nuevas definiciones de escaneo
- Revise los errores después de cambiar las configuraciones de capacidades
- Use los patrones de errores para identificar problemas sistemáticos (p. ej., permisos de acceso a campos)
- Use el contador Expiring Soon para revisar errores antes de que sean purgados automáticamente
- Exporte los registros de errores a CSV antes de que expiren si necesita conservarlos para un análisis más prolongado
- Contacte al soporte si los errores de plataforma persisten entre múltiples escaneos