Los administradores suelen tener la tarea de solucionar problemas en el entorno de Blackboard Learn de su institución. Para ayudarlo a obtener una imagen completa de lo que sucede durante un evento problemático, Blackboard Learn genera registros para que pueda consultarlos. Estos registros se guardan en el almacenamiento de archivos local de su institución para una referencia rápida y un almacenamiento confiable. Puede descargar los archivos según sea necesario o utilizar los permisos de archivos para compartirlos con otros usuarios.Consulte el informe de datos para determinar cuánto espacio en disco usan los registros.

Acceder a los registros

Puede encontrar los registros del sistema en la colección de contenido. Desde el Panel del administrador, seleccione Administrar contenido en la sección Administración de contenido. Haga clic en interno > registros. Los registros se almacenan en una estructura de carpetas por año, mes, día y hora. Navegue por el árbol de carpetas para encontrar el registro exacto que está buscando.

Transferencia y retención de los registros

La carpeta de horas utiliza la zona horaria de tiempo universal coordinado (UTC). Los registros se transfieren al sistema de archivos local una vez por hora, pero con un retraso de cuatro horas. Por ejemplo, si la hora actual es cuatro, durante esa hora, se transferirán los registros de la hora cero.

Los registros se guardan en el almacenamiento de archivos local de su institución, por lo que puede determinar y aplicar sus propias políticas de retención para los registros.

Formato de los registros

Los registros contienen una hora de datos de registro por nodo de Blackboard Learn y se almacenan en un formato comprimido. Si durante una hora se ejecutan tres nodos, verá tres archivos.

Los registros se comprimen con gzip. Usted puede descomprimir estos archivos con herramientas como 7Zip para Windows o Unzip para Mac o Linux. Una vez descomprimido, el resultado es un archivo de texto que contiene eventos de registro almacenados en objetos JSON. Cada uno de estos objetos comienza y finaliza con una llave e incluye los siguientes campos:

  • path: muestra el archivo en el servidor de Blackboard Learn donde se originó el evento;
  • @timestamp: la hora a la que ocurrió el evento;
  • clientId;
  • version;
  • host: la dirección IP para el nodo de Blackboard Learn donde se originó el evento;
  • message: la información sobre el evento que Blackboard Learn incluyó en el archivo de registro.

Dar formato a los registros para que sean más legibles

Los archivos de registro se almacenan como archivos JSON, que pueden ser difíciles de leer si no está familiarizado con el formato. Usted puede cambiarles el formato para que sean más legibles.

Antes de comenzar, descargue e instale Python 3. Si utiliza un equipo Mac o Linux, es posible que ya lo tenga instalado.

Para comprobar qué versión de Python tiene instalada, abra la terminal y ejecute el comando python --version. Si recibe un error, o si tiene instalada una versión anterior de Python, pruebe con python3 --version.

Si python o python3 funcionan, utilícelos en los siguientes comandos.

Para comenzar, ingrese al enlace que aparece a continuación y descargue la secuencia de comandos convertLogs.py. El documento adjunto es un archivo de texto sin formato. Para utilizarlo como una secuencia de comandos de Python, edite la extensión del archivo para utilizar .py después de descargarlo en su equipo. Tome nota del lugar donde se guarda la secuencia de comandos, por ejemplo, ~/Downloads/scripts. Deberá conocer la ruta cuando ejecute la secuencia de comandos en los siguientes pasos.

Si tiene un equipo con Windows, use la terminal de PowerShell en los pasos a continuación.

Para descargar y convertir una hora de registro, realice lo siguiente:

  1. Inicie sesión en Blackboard Learn como administrador.
  2. Vaya a Panel del administrador > Administrar contenido.
  3. Busque la carpeta de registros que desee descargar. Por ejemplo, /Internal/logs/2019/03/03/12.
  4. Descargue un archivo de registro de una de las carpetas de hora.
  5. En la ventana de terminal, ejecute la secuencia de comandos. Ejecute python ~/Downloads/scripts/convertLogs.py -f ~/Downloads/Logs -o ~/LearnLogs.
    • El parámetro –f debe ser la ruta de una carpeta. Aquí es donde se guardan actualmente los registros sin formato.
    • El parámetro –o debe ser una carpeta vacía. Aquí es donde se guardarán los registros formateados. La secuencia de comandos creará la carpeta si no existe.

Para descargar y convertir varias horas de registros, realice lo siguiente:

  1. Inicie sesión en Blackboard Learn como administrador.
  2. Vaya a Panel del administrador > Administrar contenido.
  3. Busque la carpeta de registros que desee descargar. Por ejemplo, /Internal/logs/2019/03/03/12.
  4. Seleccione las horas que desea descargar, p. ej.: 11, 12, 13.
  5. Haga clic en Descargar comprimido y guárdelo en una carpeta local. Se creará un archivo zip con los registros.
  6. Extraiga el archivo zip con el programa de descompresión integrado en su equipo. En Windows, haga clic con el botón derecho en el archivo zip y elija Extraer todo.
  7. En la ventana de terminal, ejecute la secuencia de comandos. Ejecute python ~/Downloads/scripts/convertLogs.py -f ~/Downloads/Logs -o ~/LearnLogs.
    • El parámetro –f debe ser la ruta de la carpeta. Aquí es donde se guardan actualmente los registros sin formato.
    • El parámetro –o debe ser una carpeta vacía. Aquí es donde se guardarán los registros formateados. La secuencia de comandos creará la carpeta si no existe.