Skip to main content

SIS-integratielogboeken

De pagina SIS-logboeken bevat voor alle SIS-integraties (Student Information System) alle logboeken met processen uit de gebruikersinterface. Logboeken spelen een belangrijke rol bij het oplossen van problemen met het systeem, maar ook bij het controleren van de voortgang van systeemtransacties. Het detailniveau van de logboekfunctie bepaalt het type en de uitgebreidheid van de gegevens die voor de geselecteerde integratie worden vastgelegd. Dit niveau wordt ingesteld tijdens het maken van de integratie. De logboeken zijn live en kunnen worden gefilterd, weergegeven en verwijderd vanuit de SIS-logboeken.

Logniveaus

Er zijn vier soorten logboekniveaus beschikbaar en elke SIS-integratie rapporteert op een ander logboekregistratieniveau op basis van de configuratie van de integratie. Deze lijst beschrijft het soort berichten dat elke integratie op de verschillende niveaus in de logboeken moet posten.

  • Fout: Eventuele fatale problemen, eventuele problemen die het maken van aanmaken, updaten, uitschakelen of wissen belemmeren.

  • Waarschuwing en boven: Niet-fatale problemen, problemen met een individueel dossier, of een succesvolle operatie waarbij een wijziging van het record nodig was.

  • Bericht en boven: Elke succesvolle activiteit, inclusief recordtypes en -tellingen, timing en data.

  • Debug en Boven: Alle individuele records en pogingen tot data-transformatie.

Als je Log Verbosity instelt op Alle diagnostische berichten of Alle diagnostische en debugberichten selecteer je bij het maken of bewerken van een Studentinformatiesysteem-integratie een tijd in de lijst Active Diagnostic Logging. Diagnostische logboekregistratie kan het best worden gebruikt voor korte testperioden en kan prestatieproblemen veroorzaken als deze functie ingeschakeld blijft. Nadat de door je gekozen tijd is verstreken, zullen logboeken Fouten en Waarschuwingen noteren. We raden je aan de logboeken op te schonen wanneer je klaar bent met testen.

Bekijk en filter logboekvermeldingen

Logbestanden kunnen worden gefilterd via een geavanceerde zoekmethode. U kunt bijvoorbeeld filteren op het type fout, de integratie en een datumbereik. Nieuwe vermeldingen zijn eenvoudig zichtbaar, met een aantal gekoppeld aan het type logboekvermelding. De logbestanden kunnen worden bijgewerkt om de laatste aantallen en de actuele gegevens van elk type logbestand weer te geven. Als u de aantallen van een logbestand wist, worden alleen die gegevens gewist. De logbestanden worden verder niet opgeschoond. Het opschonen van een logbestand kan niet ongedaan worden gemaakt. U moet het opschonen van een logbestand dan ook bevestigen voordat de bewerking daadwerkelijk wordt uitgevoerd. De functie Logboek opschonen is alleen van toepassing op de geselecteerde integratie.

  1. Op het Administrator Paneel selecteert u onder IntegratiesGegevensintegratie.

  2. Selecteer Integraties van studenteninformatiesysteem.

  3. Selecteer Alle fouten bekijken.

  4. Typ een zoekwoord in het veld Zoeken. De zoekresultaten worden weergegeven.

  5. Selecteer de integratie in het eerste menu.

  6. Selecteer het detailniveau in het tweede menu.

  7. Selecteer het selectievakje From om een startdatum en tijdsbereik in te stellen. Typ data en tijden in de vakjes of gebruik de pop-up Datumselectiekalender en Tijdselectiemenu om data en tijden te selecteren.

  8. Selecteer het selectievakje Aan om een einddatum en tijdsperiode in te stellen. Typ data en tijden in de vakjes of gebruik de pop-up Datumselectiekalender en Tijdselectiemenu om data en tijden te selecteren.

    Opmerking

    Je kunt niet zoeken naar logboeken in een datumbereik dat groter is dan zeven dagen.

  9. Selecteer Ga.

  10. U ziet de geselecteerde logboekvermeldingen, inclusief de bijbehorende integratie, datum, logboekniveau en beschrijving.

  11. Selecteer de logboekvermelding om details van het logboek weer te geven.

Logboekvermeldingen beheren

Je kunt je logboekvermeldingen beheren, zodat je gegevensproblemen eenvoudiger kunt vinden. Als je bijvoorbeeld een specifieke fout tegenkomt, is het eenvoudiger om door minder informatie te bladeren. Het beheren van logboekvermeldingen is ook nuttig, omdat je de hoeveelheid gebruikte ruimte zo tot een minimum beperkt. Je moet logboeken regelmatig opschonen om de informatie actueel te houden.

  1. Op het Administrator Paneel selecteert u onder IntegratiesGegevensintegratie.

  2. Selecteer Integraties van studenteninformatiesysteem.

  3. Selecteer Alle fouten bekijken.

  4. Selecteer Verversen om nieuwe logs op te halen.

  5. Selecteer Log Zuiveren om de loginformatie voor een specifieke integratie te verwijderen.

Locatie logboek

Voor logboekbeheer of historische gegevensanalyse kun je de logbestanden met gegevensintegratie vinden in de map met logboeken van ~blackboard:

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

waarbij:

<integration_type> is een van: bb-flatfile (Snapshot Flat File), bb-lis (LIS 2.0), bb-ss-xml (Snapshot XML), bb-ims-vista-xml (IMS Enterprise Vista), of bb-ims-xml (IMS Enterprise)</integration_type>

en

<integration_name> de naam van jouw integratie is, zoals in de integratieconfiguratie is opgegeven.

Toegangslogs via REST Web Services

In het nieuwe framework kun je dit rapport openen via REST Web Services. Om toegang te krijgen tot de logs, voeg je /learn/api/v1/logs/sis/{dataSetUid} toe aan je Blackboard Learn-domein. Het systeem genereert een referentiecode, dataSetUid, voor elke keer dat een invoerbestand wordt verwerkt. Deze parameter is vereist voor het retourneren van resultaten. De fout en het uitvoeringsbericht worden vastgelegd in de tabel DATA_INTGR_LOG.

Er zijn aanvullende parameters beschikbaar om de gegevens te segmenteren:

  • logLevel-parameter: /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG, WARNING,ERROR,INFORMATION).

  • Standaard pagingparameters: /learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10. Een standaardaanvraag heeft een limiet van 20 pagina's, tenzij je deze waarde wijzigt.

Het proces voor het oplossen van problemen met records in Web Services is niet gewijzigd ten opzichte van het proces voor het oplossen van fouten met logboeken. Als je het foutbericht "niet gevonden" ziet, is het mogelijk dat de dataSetUid niet bestaat in het systeem of dat het invoerbestand nog wordt verwerkt.