Les administrateurs sont souvent chargés de résoudre les problèmes dans l'environnement Blackboard Learn de leur établissement. Pour vous aider à obtenir une vue d'ensemble de ce qui se passe lors d'un problème, Blackboard Learn génère des journaux que vous pouvez consulter à titre de référence. Ces journaux sont enregistrés dans le stockage de fichiers locaux de votre établissement pour une consultation ultérieure et un stockage fiable. Vous pouvez télécharger les fichiers si nécessaire ou utiliser les autorisations de fichier pour les partager avec d'autres personnes. Consultez le rapport Insight pour déterminer la quantité d’espace disque utilisée par les journaux.

Accéder aux journaux

Vous pouvez accéder aux journaux système via la bibliothèque de contenus. Depuis le menu Gérer le contenu du Panneau de configuration de l'administrateur, sélectionnez Gestion de contenu. Sélectionnez Interne > Journaux. Les journaux sont stockés dans une structure de dossier par année, par mois, par jour et par heure. Parcourez l'arborescence de dossiers pour trouver le journal que vous recherchez précisément.

Transfert et conservation des journaux

Le dossier heure utilise le fuseau horaire UTC (Universal Time Coordinated). Les journaux sont transférés vers le système de fichiers local une fois par heure, mais sous un délai de quatre heures. Par exemple, si l'heure actuelle affiche 4, alors les journaux de cette heure seront transférés à partir de l'heure 0.

Les journaux sont stockés dans le stockage de fichiers locaux de votre établissement. Vous pouvez donc définir et appliquer vos propres règles de conservation des journaux.

Format du journal

Les journaux contiennent une heure de données de journal par nœud Blackboard Learn et sont stockés dans un format compressé. Si trois nœuds sont exécutés pendant une heure, vous verrez donc trois fichiers.

Les journaux sont compressés à l'aide de gzip. Vous pouvez décompresser ces fichiers à l'aide d'outils tels que 7Zip pour Windows ou unzip pour Mac ou Linux. Le résultat de la décompression est un fichier texte contenant des événements de journal stockés dans des objets JSON. Chaque objet JSON commence et se termine par une accolade et comporte les champs suivants :

  • chemin d'accès, qui permet d'accéder au fichier sur le serveur Blackboard Learn qui est le point d'origine de l'événement
  • @timestamp, heure à laquelle l'événement s'est produit
  • clientId
  • version
  • hôte, l'adresse IP du nœud Blackboard Learn qui est le point d'origine de l'événement
  • message, les informations Blackboard Learn incluses dans le fichier journal à propos de l'événement

Formater les journaux pour les rendre plus lisibles

Les fichiers journaux sont stockés en tant que fichiers JSON, qui peuvent être difficiles à lire si le formatage ne vous est pas familier. Vous pouvez reformater le fichier pour le rendre plus lisible.

Avant de commencer, téléchargez et installez Python 3. Si vous utilisez un ordinateur Mac ou Linux, vous avez peut-être déjà installé Python 3.

Pour vérifier la version de Python que vous avez installée, ouvrez le terminal et exécutez la commande python --version. Si vous recevez une erreur ou si vous avez installé une version antérieure de Python, essayez python3 --version.

Si python ou python3 fonctionne, utilisez-le dans les commandes ci-dessous.

Pour commencer, téléchargez le script convertLogs.py à l'aide du lien ci-dessous. La pièce jointe est un fichier texte brut. Pour l'utiliser comme script Python, modifiez l'extension de fichier .py à utiliser après l'avoir téléchargé sur votre ordinateur. Prenez note de l'emplacement où le script est enregistré, par exemple, ~/Downloads/scripts. Vous devez connaître le chemin d'accès lorsque vous exécutez le script dans les étapes ci-dessous.

Si vous utilisez Windows, utilisez le terminal PowerShell dans les étapes ci-dessous.

Pour télécharger et convertir une heure de journaux :

  1. Connectez-vous à Blackboard Learn en tant qu'administrateur.
  2. Accédez à Panneau de configuration de l'administrateur > Gérer le contenu.
  3. Recherchez le dossier journal que vous souhaitez télécharger. Par exemple, /internal/logs/2019/03/03/12.
  4. Téléchargez un fichier journal à partir de l'un des dossiers de l'heure.
  5. Dans la fenêtre du terminal, exécutez le script. Exécutez python ~/Downloads/scripts/convertLogs.py -f ~/Downloads/Logs -o ~/LearnLogs.
    • Le paramètre –f doit être un chemin d'accès au dossier. Il s'agit de l'emplacement où les journaux non formatés sont actuellement enregistrés.
    • Le paramètre –o doit être un dossier vide. Il s'agit de l'emplacement où les journaux formatés seront enregistrés. Le script créera le dossier s'il n'existe pas.

Pour télécharger et convertir plusieurs heures de journaux :

  1. Connectez-vous à Blackboard Learn en tant qu'administrateur.
  2. Accédez à Panneau de configuration de l'administrateur > Gérer le contenu.
  3. Recherchez le dossier journal que vous souhaitez télécharger. Par exemple, /internal/logs/2019/03/03/12.
  4. Sélectionnez les heures que vous souhaitez télécharger, par exemple, 11, 12, 13.
  5. Sélectionnez Télécharger le paquet et enregistrez-le dans un dossier local. Cette opération crée un fichier .zip avec des journaux.
  6. Extrayez le fichier .zip à l'aide du programme de décompression intégré à votre ordinateur. Pour Windows : effectuez un clic droit sur le fichier .zip et sélectionnez Tout extraire.
  7. Dans la fenêtre du terminal, exécutez le script. Exécutez python ~/Downloads/scripts/convertLogs.py -f ~/Downloads/Logs -o ~/LearnLogs.
    • Le paramètre –f doit être un chemin d'accès au dossier. Il s'agit de l'emplacement où les journaux non formatés sont actuellement enregistrés.
    • Le paramètre –o doit être un dossier vide. Il s'agit de l'emplacement où les journaux formatés seront enregistrés. Le script créera le dossier s'il n'existe pas.