La page Journaux de système d'informations étudiants répertorie tous les journaux de processus de l'interface utilisateur pour la totalité des intégrations de systèmes d'informations étudiants (SIS). Les fichiers journaux jouent un rôle important dans le dépannage du système et dans le contrôle de la progression des transactions système. La configuration de la verbosité du journal lors de la création du processus d'intégration détermine le type et la profondeur de la journalisation conservée dans votre système pour l'intégration sélectionnée. Les journaux sont dynamiques et peuvent être filtrés, consultés et purgés à partir de l'écran Journaux de système d'informations étudiants.

Niveau de journalisation

Il existe quatre types de niveaux de journalisation, et chaque intégration SIS présente un niveau de journalisation différent selon la configuration de l'intégration. Cette liste décrit le type de messages que chaque intégration doit envoyer aux journaux des différents niveaux.

  • Erreur : Toute erreur fatale ou tout problème empêchant des opérations de création, de mise à jour, de désactivation ou de purge.
  • Avertissement et au-dessus : Toute erreur non fatale, tout problème rencontré avec un enregistrement individuel ou toute opération réussie ayant nécessité une modification de l'enregistrement.
  • Message et au-dessus : Toute activité réussie, incluant les types d'enregistrements et les comptages, le minutage et les données.
  • Déboguer et au-dessus : Tout enregistrement individuel et toute tentative de transformation des données.

Si vous définissez l'option Verbosité du journal sur Tous les messages de diagnostic ou sur Tous les messages de diagnostic et de débogage lorsque vous créez ou modifiez une intégration SIS, sélectionnez une durée dans la liste Journalisation des diagnostics active. La journalisation des diagnostics se révèle mieux adaptée aux tests à court terme, car elle peut altérer les performances si elle reste activée. À l'issue de la durée choisie, les journaux enregistrent les erreurs et avertissements. Nous vous recommandons de purger les journaux une fois les tests terminés.

Afficher et filtrer les entrées de journal

Les journaux peuvent être filtrés à l'aide d'une méthode de recherche avancée qui inclut le type d'erreur, l'intégration et une plage de dates. Les nouvelles entrées de journal sont facilement visibles et un nombre est associé au type d'entrée. Les journaux peuvent être actualisés pour extraire le nombre le plus récent et les détails de chaque type de journal. L'effacement du nombre de journaux ne supprimera que le nombre associé au type de journal, mais il ne provoquera pas la purge des journaux. L'opération de purge des journaux ne peut pas être annulée. Une invite de vérification s'affiche avant la purge permanente des journaux. Le bouton Purger le journal ne s'applique qu'à l'intégration sélectionnée. 

  1. Dans le panneau de configuration de l'administrateur, sous Intégrations, sélectionnez Intégration de données.
  2. Sélectionnez Intégrations des systèmes d'informations étudiants.
  3. Sélectionnez Afficher toutes les erreurs.
  4. Entrez un terme de recherche dans le champ Rechercher. Les résultats exacts sont renvoyés.
  5. Sélectionnez l'intégration dans le premier menu.
  6. Sélectionnez le niveau de verbosité dans le deuxième menu.
  7. Cochez la case De pour définir une date de début et un intervalle de temps. Entrez des dates et des heures dans les champs ou utilisez les fenêtres contextuelles Calendrier de sélection de date et Menu de sélection d'heure pour sélectionner les dates et les heures.
  8. Cochez la case To (À) pour définir une date de fin et un intervalle de temps. Entrez des dates et des heures dans les champs ou utilisez les fenêtres contextuelles Calendrier de sélection de date et Menu de sélection d'heure pour sélectionner les dates et les heures.

    Vous ne pouvez pas rechercher des journaux dans une plage de dates supérieure à sept jours.

  9. Sélectionnez OK.
  10. Les entrées de journal sont répertoriées, ainsi que l'intégration, la date, le niveau de journal et la description.
  11. Sélectionnez l'entrée de journal pour consulter les détails du journal.

Gérer les entrées de journal

Vous pouvez gérer vos entrées de journal pour faciliter la recherche des problèmes de données. Par exemple, si vous rencontrez une erreur spécifique, la réduction du volume d'informations à passer en revue vous simplifiera la tâche. La gestion des entrées de journal offre également l'avantage de minimiser continuellement la quantité d'espace utilisée. Vous devez purger les journaux à intervalles réguliers pour faire en sorte que les informations restent récentes et à jour.

  1. Dans le panneau de configuration de l'administrateur, sous Intégrations, sélectionnez Intégration de données.
  2. Sélectionnez Intégrations des systèmes d'informations étudiants.
  3. Sélectionnez Afficher toutes les erreurs.
  4. Sélectionnez Actualiser pour récupérer les nouveaux journaux.
  5. Sélectionnez Purger le journal pour supprimer les informations de journal d'une intégration spécifique.

Emplacement du journal

Pour les besoins de la gestion des fichiers journaux ou de l'analyse des données d'historique, vous trouverez les fichiers journaux d'intégration de données sous le répertoire de journaux ~blackboard :

~blackboard/logs/data-integration/<integration_type>/<integration_name>

où :

<integration_type> fait partie des éléments suivants : bb-flatfile (fichier plat d'instantané), bb-lis (LIS 2.0), bb-ss-xml (XML d'instantanés), bb-ims-vista-xml (IMS Enterprise Vista) ou bb-ims-xml (IMS Enterprise)

et où :

<integration_name> est le nom de votre intégration comme spécifié dans la configuration de l'intégration.

Accéder aux journaux par le biais des services Web REST

Dans la nouvelle structure, vous pouvez accéder à ce rapport par l'intermédiaire des services Web REST. Pour accéder aux journaux, ajoutez /learn/api/v1/logs/sis/{dataSetUid} à la fin de votre domaine Blackboard Learn. Le système fournit un code de référence, dataSetUid, chaque fois qu'un fichier source est traité. Ce paramètre est nécessaire pour renvoyer les résultats. Les messages d'erreur et de réussite sont enregistrés dans la table DATA_INTGR_LOG.

D'autres paramètres sont disponibles pour segmenter les données :

  • Paramètre logLevel : /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).
  • Paramètres de pagination standard : /learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10. Par défaut, la requête standard est limitée à 20 pages, sauf si vous modifiez cette valeur.

Le processus de correction des erreurs d'enregistrement dans les services Web n'a pas changé par rapport au processus de résolution des problèmes de journaux d'erreurs. Si vous rencontrez un message d'erreur « introuvable », il est possible que la valeur dataSetUid n'existe pas dans le système ou que le fichier source soit toujours en cours de traitement.