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. Al configurar el detalle del registro durante la creación de la integración se configura el tipo y la cantidad de información registrada 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 de registro

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 o que impida las operaciones de creación, actualización, desactivación o borrado.
  • Advertencia y arriba: cualquier problema que no sea grave o que esté relacionado con un registro individual, o cualquier operación con éxito que haya requerido un cambio en el registro.
  • Mensaje y arriba: cualquier actividad que se realice con éxito, incluidos los tipos y recuentos de registros, las duraciones y los datos.
  • Depurar y arriba: todos los registros individuales e intentos de transformación de datos.

Si establece el Contenido del registro como Todos los mensajes de diagnóstico o Todos los mensajes de diagnóstico y depuración cuando crea o etita una integración SIS, seleccione un horario en la lista Registros activos para el diagnóstico. 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 que transcurre el tiempo elegido, los registros recopilan Errores y advertencias. Le recomendamos que los depure cuando haya finalizado las pruebas.


Visualizar 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 purga de registros no puede deshacerse y se mostrará un mensaje de verificación antes de la purga definitiva de los registros. El botón Borrar registro solo se aplica a la integración seleccionada. El botón Borrar recuentos se aplica a todas las integraciones.

  1. En el Panel del administrador, en Integraciones, seleccione Integración de datos.
  2. Seleccione Integraciones del sistema de información de los alumnos.
  3. Seleccione Ver todos los errores.
  4. Escriba un término de búsqueda en el campo Buscar. Se presentan los resultados exactos.
  5. Seleccione la integración en el primer menú.
  6. Seleccione el nivel de detalle en el segundo menú.
  7. Seleccione la casilla de verificación Desde para configurar un rango de fecha y hora de inicio. Escriba la fecha y la hora en los cuadros correspondientes o utilice las opciones desplegables Calendario de selección de fecha y Menú de selección de hora para seleccionarlas.
  8. Seleccione la casilla de verificación Hasta para configurar un rango de fecha y hora de inicio. Escriba la fecha y la hora en los cuadros correspondientes o utilice las opciones desplegables Calendario de selección de fecha y Menú de selección de hora para seleccionarlas.

    No puede buscar registros en un rango de fechas que supere los siete días.

  9. Seleccione la opción Ir.
  10. Se muestran las entradas del registro junto con la integración, la fecha, el nivel de registro y la descripción.
  11. Seleccione la entrada del registro para ver los detalles de este.

Administrar 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.

  1. En el Panel del administrador, en Integraciones, seleccione Integración de datos.
  2. Seleccione Integraciones del sistema de información de los alumnos.
  3. Seleccione Ver todos los errores.
  4. Seleccione Actualizar para recuperar registros nuevos.
  5. Seleccione Borrar recuentos para eliminar todos los recuentos de errores, advertencias, mensajes y elementos de depuración para todas las integraciones.
  6. Seleccione Borrar registro para eliminar la información de registro para 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 de instantánea sin formato), bb-lis (LIS 2.0), bb-ss-xml (instantánea XML), bb-ims-vista-xml (IMS Enterprise Vista) o bb-ims-xml (IMS Enterprise)

y

<integration_name> es el nombre de su integración tal y como se especifica en la configuración de integración.


Acceder a los registros a través de los servicios web de REST

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 de 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 de paginación estándar: /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.