Resumen
Los registros y el estado de las integraciones (Integration Logs and Status) le permiten revisar el historial de ejecución de las integraciones de una cuenta y ver el estado de cada tarea de integración. Cada tarea lleva un estado (waiting, in process, succeeded, failed, canceled o locked) junto con su registro y sus intentos, y un registro de auditoría (audit record) captura los cambios de configuración. Este artículo explica cómo leer estos registros e interpretar cada estado.
Introducción
Las integraciones de KnowledgeCity mueven datos reales, incluidos usuarios, inscripciones y resultados, entre la plataforma y los sistemas externos conectados. Cada acción de integración se ejecuta como una tarea en segundo plano, y la vista Logs es donde observa la ejecución de esas tareas y confirma que terminaron como se esperaba.
Esta vista la utilizan principalmente los equipos de Atención al Cliente y Operaciones. Cuando una sincronización se detiene, falla o produce resultados inesperados, los registros y estados son el primer lugar donde buscar para entender qué sucedió y por qué.
Conceptos clave
- Job (tarea): una única tarea de integración (por ejemplo, una importación de usuarios) que se ejecuta en segundo plano, cada una con su propio estado y registro.
- Status (estado): el estado actual de una tarea, como waiting, in process, succeeded, failed, canceled o locked.
- Log (registro): el registro por tarea de lo que hizo la tarea, utilizado para investigar por qué se comportó de esa manera.
- Attempts (intentos): cuántas veces se ha intentado una tarea, lo que le ayuda a detectar tareas que reintentan repetidamente o que están atascadas.
- Handler (controlador): el proceso que ejecuta una tarea, identificando qué tipo de trabajo de integración se realizó.
- Audit record (registro de auditoría): un historial de cambios de configuración de integración para la cuenta, útil para confirmar quién cambió qué y cuándo.
Pasos a seguir
Abrir la vista de Logs
Navegue hasta la integración de la cuenta que está investigando y abra su pestaña Logs. Esta vista enumera las tareas de la integración junto con el estado y el registro de cada ejecución, de modo que pueda revisar el historial de ejecución de la integración de la cuenta en un solo lugar.
Leer el estado de una tarea
Cada tarea muestra un Status que indica en qué punto de su ciclo de vida se encuentra. Interprete los estados de la siguiente manera:
- waiting: la tarea está en cola y aún no ha comenzado a ejecutarse.
- in process: la tarea se está ejecutando actualmente.
- succeeded: la tarea se completó correctamente.
- failed: la tarea no se completó; abra su registro para encontrar la causa.
- canceled: la tarea se detuvo antes de completarse.
- locked: la tarea está retenida y no es elegible para ejecutarse en este momento.
Inspeccionar los registros y los intentos
Cuando una tarea no terminó como se esperaba, abra su Log para ver los detalles de la ejecución, y revise los Attempts para ver cuántas veces se ha intentado. Un número creciente de intentos en una tarea failed o locked es una señal clara de que una sincronización necesita atención.
Revisar el registro de auditoría
Junto con el historial de ejecución, use el Audit Log de la integración para revisar los cambios de configuración de la cuenta. Esto es útil cuando una sincronización comienza a comportarse de manera diferente y necesita confirmar si se cambió recientemente una configuración, y quién lo hizo.
Nota: Las tareas de integración sincronizan datos reales de usuarios y cursos con sistemas externos. Revise siempre el registro de una tarea y confirme la causa antes de volver a ejecutar o cambiar el estado de una sincronización.
Conclusión
La vista de registros y estado es la ventana operativa a las integraciones de una cuenta: muestra el estado, el registro y los intentos de cada tarea, y combina el historial de ejecución con un registro de auditoría de los cambios de configuración. Leer estos estados y registros es la forma más rápida de confirmar que una sincronización tuvo éxito, o de diagnosticar una que no lo tuvo.