Skip to main content

Logboeken

Beheerders hebben vaak de taak om problemen in de Blackboard-omgeving van hun instelling op te lossen. Om je te helpen een volledig beeld te krijgen van wat er gebeurt tijdens een lastig probleem, genereert Blackboard logboeken die je kunt raadplegen. Deze logboeken worden opgeslagen in de lokale bestandsopslag van de instelling voor snelle naslag en betrouwbare opslag. Je kunt de bestanden desgewenst downloaden of bestandsmachtigingen gebruiken om de bestanden met anderen te delen. Raadpleeg het inzichtrapport om te bepalen hoeveel schijfruimte wordt gebruikt door logboeken.

Toegangslogboeken

Systeemlogboeken zijn toegankelijk via Content Collection. Selecteer in het configuratiescherm voor systeembeheer de optie Inhoud beheren in het gedeelte Inhoud beheren. Selecteer intern en selecteer vervolgens logboeken. Logboeken worden opgeslagen in een mapstructuur die is ingedeeld naar jaar, maand, dag en tijd (uur). Blader door de mapstructuur om het logboek te vinden dat je zoekt.

Overdracht en bewaarperiode van logboeken

In de tijdmap wordt de tijdzone UTC (Universal Time Coordinated) gebruikt. Logboeken worden eenmaal per uur overgebracht naar het lokale bestandssysteem, maar met een vertraging van vier uur. De vertraging verwijst naar het tijdstip waarop de logboeken worden gegenereerd en die beschikbaar worden gemaakt in de grafische gebruikersinterface.

Logboeken worden opgeslagen in de lokale bestandsopslag van de instelling, zodat de instelling het eigen bewaarbeleid voor logboeken kan bepalen en toepassen.

Indeling van logboeken

Logboeken bevatten één uur aan logboekgegevens per Blackboard-knooppunt en worden opgeslagen in een gecomprimeerde indeling. Als er drie nodes in een uur worden uitgevoerd, ziet u drie bestanden.

De logboeken worden gecomprimeerd met behulp van gzip. Je kunt deze bestanden uitpakken met tools zoals 7Zip voor Windows of unzip voor Mac of Linux. Het resultaat is een tekstbestand met logboekgebeurtenissen die zijn opgeslagen in JSON-objecten. Elk JSON-object begint en eindigt met accolades ({ }) en bevat de volgende velden:

  • pad, dat het bestand op de Blackboard-server weergeeft waar de gebeurtenis is ontstaan

  • @timestamp, het tijdstip van de gebeurtenis

  • clientId

  • logboektag

  • host, het IP-adres voor het Blackboard-knooppunt waar de gebeurtenis vandaan komt

  • bericht, de informatie die Blackboard in het logbestand over de gebeurtenis bevat

Logboeken opmaken om ze beter leesbaar te maken

Logboekbestanden worden opgeslagen als JSON-bestanden, die lastig te lezen zijn als je niet bekend bent met de indeling. Je kunt de opmaak van het bestand daarom wijzigen om de inhoud beter leesbaar te maken.

Om dit doel te bereiken, gaat u naar het configuratiescherm voor systeembeheer. Selecteer in de sectie Extra en hulpprogramma's de optie Logboeken en selecteer vervolgens Systeemlogboeken. U vindt de instructies die u moet volgen om het script te downloaden en uit te voeren.