Journaux d'intégration SIS

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.

Si vous définissez Verbosité du journal sur Tous les messages de diagnostic ou Tous les messages de diagnostic et de débogage lorsque vous créez ou modifiez une intégration système d'informations pour les étudiants, sélectionnez une heure dans la liste Active Diagnostic Logging. 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. Une fois le temps que vous avez choisi écoulé, les journaux enregistreront Erreurs et avertissements. Nous vous recommandons de purger les journaux une fois les tests terminés.

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.

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.

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/<type_intégration>/<nom_intégration>

où :

<integration_type>est l'un des fichiers suivants : bb-flatfile (Snapshot Flat File), bb-lis (LIS 2.0), bb-ss-xml (Snapshot XML), bb-ims-vista-xml (IMS Enterprise Vista) ou bb-ims-xml (IMS Enterprise)

et où :

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

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} à 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 :

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.