Registros de la integración de SIS
La página Registros SIS muestra todos los registros del proceso de la interfaz del usuario (UI) para todas las integraciones del sistema de información de estudiantes (SIS). Los archivos de registro juegan un papel importante a la hora de solucionar problemas del sistema, así como para supervisar el progreso de las transacciones del sistema. Establezca la verbosidad del log durante la creación de la integración para determinar el tipo y la profundidad del registro que se mantiene en el sistema para la integración seleccionada. Los registros se realizan en directo y pueden filtrarse, visualizarse y purgarse en la pantalla de registros SIS.
Niveles logarítmicos
Hay cuatro tipos de niveles de registro disponibles. Cada integración SIS notifica un nivel de registro diferente en función de la configuración de la integración. Esta lista describe el tipo de mensajes que cada integración debería publicar en los registros en diferentes niveles.
Error: Cualquier problema fatal, cualquier problema que impida crear, actualizar, deshabilitar o purgar operaciones.
Advertencia y superiores: Cualquier problema no fatal, cualquier incidencia con un registro individual o cualquier operación exitosa que haya requerido un cambio en el registro.
Mensaje y superiores: Cualquier actividad exitosa, incluyendo tipos y conteos de registros, tiempos y datos.
Depuración y superiores: Todos los registros individuales e intentos de transformación de datos.
Si configura Registro de verbosidad en Todos los mensajes de diagnóstico o Todos los mensajes de diagnóstico y depuración cuando cree o edite una integración SIS o Sistema de información del estudiante, seleccione una hora en la lista de Registro Diagnóstico Activo. Los registros para el diagnóstico se usan a fin de realizar pruebas a corto plazo y pueden generar problemas de rendimiento si se dejan habilitados. Después de transcurrido el tiempo seleccionado, los registros mostrarán Errores y Advertencias. Le recomendamos que los depure cuando haya finalizado las pruebas.
Ver y filtrar las entradas del registro
Los registros pueden filtrarse utilizando un método de búsqueda avanzada, que incluye el tipo de error, la integración y un intervalo de fechas. Las nuevas entradas del registro se ven con facilidad, con un recuento adjunto al tipo de entrada. Los registros pueden actualizarse para recuperar el recuento más reciente y los detalles de cada tipo de registro. Al borrar el recuento de registros, solo se borrará el número asociado con el tipo de registro, pero no los registros. La eliminación de los registros no se puede deshacer y se mostrará un mensaje de verificación antes de que se borren los registros de forma definitiva. El botón Purgar registro solo se aplica a la integración seleccionada.
En el Panel de Administradores, en Integraciones, seleccione Integración de Datos.
Seleccione Integraciones del sistema de información del estudiante.
Seleccione Ver todos los errores.
Escribe una palabra de búsqueda en el campo Buscar. Se presentan los resultados exactos.
Seleccione la integración en el primer menú.
Seleccione el nivel de detalle en el segundo menú.
Seleccione la casilla De para establecer una fecha de inicio y un rango de tiempo. Escriba fechas y horas en los cuadros o utilice el menú emergente Calendario de Selección de Fechas y menú de selección de horarios para seleccionar fechas y horas.
Seleccione la casilla Para para establecer una fecha y un rango de tiempo de finalización. Escriba fechas y horas en los cuadros o utilice el menú emergente Calendario de Selección de Fechas y menú de selección de horarios para seleccionar fechas y horas.
Nota
No puede buscar registros en un rango de fechas que supere los siete días.
Seleccione Ir.
Se muestran las entradas del registro junto con la integración, la fecha, el nivel de registro y la descripción.
Seleccione la entrada del registro para ver los detalles de este.
Gestionar las entradas del registro
Puede gestionar sus entradas del registro para facilitar encontrar problemas de datos. Por ejemplo, si se encuentra con un error específico, es más fácil desplazarse entre menos información. Gestionar entradas de registro también resulta útil para mantener la cantidad de espacio utilizada al mínimo. Debería borrar los registros de forma periódica para mantener la información actualizada.
En el Panel de Administradores, en Integraciones, seleccione Integración de Datos.
Seleccione Integraciones del sistema de información del estudiante.
Seleccione Ver todos los errores.
Seleccione Actualizar para recuperar nuevos registros.
Seleccione Purgar registro para eliminar la información del registro de una integración específica.
Ubicación del registro
Para fines de administración de archivos de registro o análisis de datos históricos, puede encontrar los archivos de registro de integración de datos en el directorio de registros de ~blackboard:
~blackboard/logs/data-integration/<integration_type>/<integration_name>
donde:
<integration_type> es uno de: bb-flatfile (Archivo plano de instantáneas), bb-lis (LIS 2.0), bb-ss-xml (XML de instantánea), bb-ims-vista-xml (IMS Enterprise Vista) o bb-ims-xml (IMS Enterprise)</integration_type>
y
<integration_name> es el nombre de su integración tal y como se especifica en la configuración de integración.
Registros de acceso a través de REST Web Services
En el nuevo marco de trabajo, puede acceder a este informe a través de los servicios web de REST. Para acceder a los registros, añada /learn/api/v1/logs/sis/{dataSetUid} a su dominio Blackboard Learn. El sistema le proporcionará un código de referencia, dataSetUid, cada vez que se procese un archivo de fuente. Este parámetro es obligatorio para que la búsqueda arroje resultados. Los mensajes de error y de operación correcta se registran en la tabla DATA_INTGR_LOG.
Hay otros parámetros disponibles para segmentar los datos:
parámetro logLevel:
/learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).Parámetros estándar de paginación:
/learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10. De forma predeterminada, la solicitud estándar tiene un límite de 20 páginas, a menos que usted cambie este valor.
El proceso para solucionar los errores de registro en los servicios web no se ha modificado respecto del proceso para solucionar los problemas de los registros de errores. Si recibe un mensaje de error "no encontrado", es posible que dataSetUid no exista en el sistema o que el archivo de fuente todavía esté en proceso.