Drift och övervakning

Varje lärosäte är själv ansvarig för att övervaka sina egna händelser och eventuella fel som inträffar när händelsen skall verkställas i Canvas. De fel som inträffar beror oftast på konflikter i Canvasdatat som kan uppstå om lärosätet har raderat en kurs eller student och att sedan adaptern försöker återskapa kursen eller studenten. 

LogDb

Alla händelser som går igenom Ladok LIS adaptern loggas, det går därför i efterhand att se allt som canvasadaptern har tagit emot och bearbetat. För att göra det använder man https://lis.ladok.se/LogDb som är webgränssnitt mot händelseloggen, här finns mer om hur man ansluter sig till LogDb. I LogDb listas alla händelser sorterat på tid, om något går fel i en händelse markeras detta med en felstatus, i LogDb kan man välja att filtrera fram endast felaktiga händelser. Händelser kan också köras om, dvs om någonting har gått fel och att händelsen inte har verkställts i Canvas så kan man köra om och på så sätt reparera Canvas, exempel på detta är om Canvas inte var åtkomligt när adaptern försökte utföra händelsen eller om en student försökte skapas men att SIS id för studenten var upptaget. Varje lärosäte kan och bör prenumerera på händelser som går fel, på så sätt finns goda möjligheter att kunna reparera Canvas utan störningar för lärare och studenter.

För att underlätta övervakningen rekommenderas att varje lärosäte så snart som möjligt tar hand om sina felaktiga händelser, om lärosätet bedömer att ingen åtgärd behövs så återställer man felstatusen på händelsen genom att klicka på "Markera felet som löst", behövs en åtgärd så gör man en eventuell korrigering av data i Canvas och kör sedan om händelsen genom att klicka på "Skicka om ursprungshändelse" och sedan återställer man felstatusen genom att klicka på "Markera felet som löst".

I LogDb kan man också söka fram händelser, man använder då något som i LogDb kallas "Target-id", ett Target-id består av identifierare från Ladok (uid) och är antingen en identifierare för en person, kurstillfälle eller sammansättning av dessa.

Target-idTyp av händelse
<uid för person>Alla händelser som endast rör en person, tex ändring av personuppgifter
<uid för kurstillfälle>Alla händelser som endast rör ett kurstillfälle, tex ändring av kursinformation
<uid för person><uid för kurstillfälle>Alla händelser som rör åtkomst för en person till ett kurstillfälle. OBS alltid person uid först och inget mellanslag mellan.

Ladok identifierare (uid)

En uid ser alltid ut enligt följande format ex. 71a7e61c-e0f2-11e7-8888-683643294f39. För att hitta den uid man behöver för att söka så använder man Ladoks webbgränssnitt.
För student:

  1. Gå in på studenten det gäller.
  2. Titta i fältet för webbadressen. Där står nu t.ex. (sista ordet i adressen beror på vilken flik man är inne på): https://www.start.ladok.se/gui/#/studiedokumentation/student/71e7e64c-e0f2-11e7-8888-683643294f39/oversikt
  3. Det markerade i länken är studentens uid.

För kurstillfälle:

  1. Sök fram kurstillfället antingen i Studiedokumentation eller i Utbildningsinformation.
  2. Titta i fältet för webbadressen.
  3. I Studiedokumentation hittar man kurstillfällets uid i den del av adressen där det står valtKurstillfalle=9999e64c-e0f2-11e7-8888-683643294f39
  4. I Utbildningsinformation är det den del av adressen där det står ”tillfalleUID=9999e64c-e0f2-11e7-8888-683643294f39

Vanliga fel

FelIdentifiering av feletÅtgärd
Canvas ej tillgängligt
Kör om händelsen utan åtgärd.
Temporärt internt fel i CanvasFelmeddelande i LogDb: Catched CanvasAdapterFault with result: One or more errors occurred. Canvas HTTP status code:InternalServerError, reason:Internal Server Error, response data:{"errors":[{"message":"An error occurred.","error_code":"internal_server_error"}]}Kör om händelsen utan åtgärd.
Student kunde inte skapasFelstatus på händelsen personRecord, i LogDb kan det finnas tips om vad felet beror på ex "ID:t används redan för det här kontot och autentiseringsleverantören". Ett vanligt följdfel är att ett membershipRecord misslyckas direkt efter men om man kör om ursprungshändelse så kommer även membershipRecord att köras om.Kontrollera om personen redan finns i Canvas, om den inte finns kontrollera då om personen funnits tidigare och har raderats. Det kan vara konflikter med SIS id, login id eller email.
Kurstillfälle kunde inte skapasFelstatus på händelsen courseOfferingRecord, i LogDb kan det finnas tips om vad felet beror på ex Sektionen kunde inte skapas, Canvas HTTP status code:BadRequest, reason:Bad Request, response data:{"errors":{"sis_source_id":[{"attribute":"sis_source_id","type":"SIS ID ”e60e4916-2011-11ea-a622-3565135944de” används redan","message"Kontrollera om kursen redan har skapats i Canvas, om den inte syns kontrollera då om den har raderats men att SIS id ligger kvar i den raderade kursen och inte kan återanvändas. I exemplet till vänster klagar adaptern på att sektionen inte kunde skapas på grund av konflikt med sektionens SIS id, kontrollera då om det finns en raderas sektion med samma SIS id.
Student kunde inte läggas till i kursFelstatus på händelsen membershipRecord, i LogDb kan det finnas tips om vad felet beror på ex Catched SiteDoesNotExistFault with description: Åtkomst för kursen är begränsad till kursens start och slutdatum, kursens startdatum (2021-04-08 06:00:00) har inte inträffatKursens eller terminens startdatum har ännu inte inträffat, se felmeddelande i LogDb om det gäller kurs eller termin, kontrollera om inställningarna för kursen eller terminen behöver ändras och kör sedan om händelsen.

Hur repareras en SIS id konflikt 

De vanligaste problemen beror på konflikter i SIS id och då oftast på grund av att en person, kurstillfälle eller sektion har blivit manuellt raderad i Canvas utan att först städa SIS id. Adaptern kan oftast hantera detta men det finns fall där det inte går och då behövs en manuell städning i Canvas. För att lösa detta så ändrar man SIS id för det raderade objektet så att det inte kan uppstå en konflikt men om objektet är raderat så är det inte heller synligt i Canvas utan man måste göra detta genom en csv import. Här finns information om hur man ändrar ett SIS id i Canvas lämpligtvis ändrar man ett SIS id genom att döpa om det till samma namn med ett tillägg "_raderad_datum" då får man spårbarhet.

Support

Om man behöver hjälp med att hitta orsaken eller med att avhjälpa felet så skriver man en felrapport i Jira.

  • No labels