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.
De correlatie-id is bedoeld om een SharePoint Beheer te helpen traceren wat er gebeurde op het moment van een fout. Het is alleen waardevol als een interactief hulpmiddel om de Beheer je fout op te sporen. Een Beheer gebruikt de correlatie-id als 'breadcrumbs' om aanvragen of processen in het SharePointUnified Logging System (ULS) te herstellen om te vinden wat tot een probleem leidt en veroorzaakt. Als SharePoint een fout krijgt die niet kan worden geïdentificeerd tijdens het werken aan die taak, wordt het bericht 'Onverwachte fout is opgetreden' geplaatst en wordt de correlatie-id opgenomen. De correlatie-id kan helpen te achterhalen wat er is gebeurd, maar identificeert niet wat er is gebeurd.
Geslaagde aanvragen worden getagd met een correlatie-id en mislukte aanvragen. De id is uniek en verschilt voor elke nieuwe aanvraag en duurt alleen de duur van de aanvraag. Het is niet als een Windows-fout die je een 80xxxxxx-nummer geeft waarmee het exacte probleem wordt geïdentificeerd. Het helpt niet om te zoeken naar een specifieke correlatie-id op het web, omdat elke correlatie-id verschilt en uniek is voor je server en dat tijdstip.
Waar een correlatie-id waardevol is, is tracering via een proces. SharePoint maakt een logboek (ULS) van alles wat het doet bij het verwerken van aanvragen, en de correlatie-id is in feite de thread die elke stap 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 je een eindgebruiker bent, heb je waarschijnlijk geen toegang tot de logboeken die de informatie bevatten waar een correlatie-id nuttig kan zijn. In dit geval kun je hier stoppen en je helpdesk of Beheerder bellen. Leg je probleem uit en neem contact met hen op om het probleem te diagnosticeren. Geef ze de correlatie-id die u in je foutbericht ziet. Ze hebben mogelijk nodig.
Als IT-professional of Beheer moet je, om erachter te komen wat er is gebeurd, de ULS-logboeken vinden voor het moment dat de gebeurtenis zich voordeed en zoeken naar de correlatie-id in die logboeken. Mogelijk moet je op verschillende front-ends van het web zoeken om de web-id te vinden die de correlatie-id heeft die je zoekt. De correlatie-id lost je fout niet op, maar het kan je helpen bij het traceren van een aanvraag om te zien wat er mis is gegaan. Mogelijk krijg je inzicht in wat er is gebeurd vlak voordat de fout werd gegenereerd, welke foutberichten werden weergegeven of welke gebeurtenissen zijn geactiveerd vanwege deze fout (indien aanwezig). Je kunt een hulpprogramma zoals ULSViewer gebruiken om het bekijken van deze gegevens te vergemakkelijken en de aanvragen te filteren die je niet hoeft te zien. Zie de SharePoint-blogpost logboekregistratie en probleemoplossing 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. Omdat SharePointeen platform is, dus is er een community met duizenden ontwikkelaars, IT-professionals en gebruikers die hulpmiddelen, apps en documentatie ontwikkelen om elkaar te helpen.
