Foutberichten over correlatie-id in SharePoint 2010: wat is het en wat doe ik ermee

Foutberichten over correlatie-id in SharePoint 2010: wat is het en wat doe ik ermee

Als u een gebruiker bent die problemen heeft met een openbare website of enquête, e-mail of een andere app, kunt u bellen naar het bedrijf dat eigenaar is van de website.   De contactgegevens voor websites of enquêtes vindt u meestal onderaan een pagina of in de sectie Over ons of Contact in het navigatiemenu.

Als u een gebruiker bij een bedrijf bent en fouten krijgt, neemt u contact op met de persoon die de interne website van het bedrijf beheert.   Dit type problemen kan meestal worden opgelost door de webmaster (SharePoint-beheerder) of iemand van uw bedrijf.

Als u een SharePoint-beheerder, webmaster of sitebeheerder bent,   en uw gebruikers vragen stellen over correlatie-id's, kan dit artikel van pas komen.

Wat houdt een correlatie-id in en wat houdt deze niet in?

De correlatie-id is geen foutnummer of foutcode. Het is een zogenaamde GUID (Globally Unique Identifier) die automatisch wordt gegenereerd bij elke aanvraag die door de SharePoint-server wordt ontvangen. Deze is uniek voor elke aanvraag, niet voor elke fout. Als er echter een fout optreedt, bevat het foutbericht de correlatie-id die toen geldig was voor de aanvraag.

Een SharePoint-beheerder kan aan de hand van de correlatie-id nagaan wat er gebeurde op het moment dat de fout optrad. De id is slechts waardevol als een interactief hulpmiddel waarmee de beheerder de fout kan opsporen. Een beheerder gebruikt de correlatie-id als een rij 'broodkruimels' om de aanvragen of processen langs te lopen in de SharePointUnified Logging System (ULS) om de oorzaak van een probleem te achterhalen. Als in SharePoint een foutbericht wordt weergegeven dat niet kan worden geïdentificeerd terwijl aan deze taak wordt gewerkt, wordt het bericht 'Er is een onverwachte fout opgetreden' weergegeven. Het bericht bevat tevens de correlatie-id. Met de correlatie-id kan worden nagegaan wat er is gebeurd, maar er vindt geen identificatie van de fout plaats.

Diagram van hoe een correlatie-ID wordt toegewezen

Zowel succesvolle als mislukte aanvragen zijn gelabeld met een correlatie-id. De id is uniek en dus voor elke aanvraag anders. De id is slechts geldig gedurende de duur van de aanvraag. Het is dus niet zoals een Windows-fout, waarbij een 80xxxxxx-nummer het precieze probleem identificeert. U kunt een bepaalde correlatie-id ook niet op internet vinden, omdat ze allemaal verschillen en uniek zijn voor uw server en op dat moment.

Een correlatie-id is alleen waardevol voor het nalopen van een bepaald proces. In SharePoint wordt een logboek (ULS) gemaakt van alles wat er tijdens het verwerken van aanvragen gebeurt. De correlatie-id is in feite de draad die de stappen met elkaar verbindt. Omdat in SharePoint duizenden aanvragen tegelijk plaatsvinden, kan de correlatie-id worden gebruikt om precies die stappen eruit te filteren die in SharePoint voor een bepaalde aanvraag werden uitgevoerd.

Een beheerder kan de correlatie-id gebruiken om fouten op te sporen, maar ook prestatie- en andere problemen. Door gebruik te maken van de correlatie-id's voor aanvragen die het problematische gedrag vertonen, kan een beheerder nader onderzoek doen.  Als er geen fouten optreden en er geen foutmeldingen worden gegenereerd, kan het ontwikkelaars-dashboard worden gebruikt om de correlatie-id te bekijken die door de processen worden gegenereerd. 

Als u een eindgebruiker bent, hebt u waarschijnlijk geen toegang tot de logboeken met de informatie waarbij een correlatie-id handig kan zijn. In dat geval kunt u nu stoppen en contact opnemen met uw helpdesk of beheerder. Leg het probleem uit en probeer samen het probleem op te lossen. Geef de correlatie-id door dat in het foutbericht wordt vermeld. Dit kan van pas komen.

Als u een IT-professional of beheerder bent en u wilt weten wat er is gebeurd, dan hebt u de ULS-logboeken nodig voor het tijdstip waarop het probleem zich heeft voorgedaan. U kunt de correlatie-id in deze logboeken vinden. Wellicht dient u in meerdere web-frontends te zoeken naar het logboek met de gezocht correlatie-id. Het probleem kan niet met de correlatie-id worden opgelost, maar u kunt er wel de aanvraag mee terugvinden om te kijken wat er aan de hand was. U kunt ook inzicht krijgen in wat er gebeurde vlak voor de fout optrad, welk foutbericht werd weergegeven of welke gebeurtenissen er eventueel vanwege deze fout werden getriggerd. U kunt met een hulpprogramma als ULSViewer deze gegevens makkelijker opzoeken en de aanvragen eruit filteren die u niet nodig hebt. Zie het blogbericht SharePoint logging and troubleshooting using ULSViewer (Logboekregistratie in SharePoint en problemen oplossen met ULSViewer) voor meer ideeën en tips.

Hier is een typisch scenario dat een beheerder kan gebruiken met een correlatie-id:

  • De gebruiker krijgt een foutmelding bij het openen van een bestand in Excel, zodat de beheerder over de correlatie-id en de datum en het tijdstip van het incident beschikt:

  • Zoek de map met het logboek en de bewuste datum en open het bestand in Excel:

  • Zoek de gewenste correlatie-id. U kunt filteren op het niveau van de gebeurtenissen om een idee te krijgen van wat er gebeurt:

  • Als u de correlatie-id niet kunt vinden, kunt u een andere webserver proberen die werd gebruikt op het moment dat het probleem werd gerapporteerd.

Hier zijn nog enkele bronnen voor beheerders die nuttig kunnen zijn bij het opsporen van fouten in SharePoint. Naast deze koppelingen kunt u op internet nog talloze sites en community's van derden vinden die ondersteuning en hulpmiddelen bieden voor het werken met SharePoint. SharePointis een platform, dus is er een community met duizenden ontwikkelaars, IT-professionals en gebruikers die hulpmiddelen, apps en documentatie ontwikkelen om elkaar te helpen.

Uw Office-vaardigheden uitbreiden
Training verkennen
Als eerste nieuwe functies krijgen
Deelnemen aan Office Insiders

Was deze informatie nuttig?

Bedankt voor uw feedback.

Hartelijk dank voor uw feedback! Het lijkt ons een goed idee om u in contact te brengen met een van onze Office-ondersteuningsagents.

×