SharePoint-Korrelations-ID in Fehlermeldungen: Zweck und Verwendung
Gilt für
Microsoft Office SharePoint Online Server 2016 SharePoint in Microsoft 365

Wenn Sie als Benutzer Probleme mit einer öffentlichen Website oder einer Umfrage, E-Mail- oder anderen App haben, bitten Sie das Unternehmen, das die Website betreibt, um Unterstützung.   Normalerweise sind die Kontaktinformationen für eine Website oder Umfrage am unteren Seitenrand oder im Abschnitt "Info" oder "Kontakt" des Navigationsmenüs zu finden.

Als Benutzer in einem Unternehmen wenden Sie sich bei Fehlern an die Person, die die interne Website des Unternehmens verwaltet.   Solche Probleme können oftmals nur vom Webmaster (SharePoint-Administrator) oder jemanden in Ihrem Unternehmen gelöst werden.

Wenn Sie als SharePoint-Administrator, -Webmaster oder -Websiteverwalter    von Benutzern nach Korrelations-IDs gefragt werden, kann der folgende Artikel für Sie hilfreich sein.

Was eine Korrelations-ID ist und was nicht

Die Korrelations-ID ist keine Fehlernummer und kein Fehlercode. Sie ist einfach eine GUID (Globally Unique Identifier), die für jede auf dem SharePoint-Server empfangene Anforderung automatisch generiert wird. Sie ist für jede Anforderung (nicht für jeden Fehler) eindeutig. Wenn jedoch ein Fehler auftritt, enthält die Fehlermeldung die Korrelations-ID, die zum betreffenden Zeitpunkt für die Anforderung gültig war.

Die Korrrelations-ID ist für den SharePoint-Administrator hilfreich, um zu verfolgen, was zu dem Zeitpunkt, zu dem der Fehler auftrat, geschehen ist. Sie ist nur als interaktives Tool nützlich, das dem Administrator hilft, dem Fehler auf den Grund zu gehen. Ein Admin verwendet die Korrelations-ID als "Breadcrumbs", um Anforderungen oder Prozesse im SharePointUnified Logging System (ULS) nachzuverfolgen, um zu ermitteln, was zu einem Problem führt und verursacht. Wenn in SharePoint ein Fehler gemeldet wird, der bei der Bearbeitung der Aufgabe nicht identifiziert werden kann, wird die Meldung "Unerwarteter Fehler" protokolliert und die Korrelations-ID mit erfasst. Anhand der Korrelations-ID kann ermittelt werden, was geschehen ist, aber nicht, warum.

Diagramm der Zuweisung einer Korrelations-ID

Erfolgreiche Anforderungen werden mit einer Korrelations-ID gekennzeichnet. so sind auch die fehlgeschlagenen. Die ID ist für jede neue Anforderung eindeutig und gilt nur für die Dauer der Anforderung. Ein Windows-Fehler hingegen zeigt eine 80xxxxxx-Nummer an, die das Problem genau identifiziert. Es ist nicht hilfreich, im Web nach einer bestimmten Korrelations-ID zu suchen, da jede einzelne zu diesem Zeitpunkt anders und für Ihren Server eindeutig ist.

Dabei ist eine Korrelations-ID bei der Ablaufverfolgung durch einen Prozess nützlich. SharePoint erstellt ein Protokoll (ULS) aller Vorgänge, die beim Verarbeiten von Anforderungen ausgeführt werden, und die Korrelations-ID ist im Grunde der Thread, der die einzelnen Schritte miteinander verbindet. Da SharePoint Tausende von Anfragen gleichzeitig bearbeitet, kann die Korrelations-ID verwendet werden, um nur die Schritte herauszufiltern, die SharePoint für eine bestimmte Anforderung durchgeführt hat.

Ein Admin kann eine Korrelations-ID verwenden, um Fehler sowie Leistungsprobleme und andere Probleme zu verfolgen. Anhand der Korrelations-IDs für Anforderungen, bei denen die Probleme aufgetreten sind, lässt sich eingehender untersuchen, was geschehen ist. Wenn kein Fehler auftritt und keine Fehlermeldung generiert wird, kann die von den Prozessen generierte Korrelations-ID im Entwicklerdashboard angezeigt werden.

Wenn Sie ein Endbenutzer sind, haben Sie wahrscheinlich keinen Zugriff auf die Protokolle, die die Informationen enthalten, bei denen eine Korrelations-ID hilfreich sein kann. In diesem Fall bleibt Ihnen nichts anderes übrig, als sich an den Helpdesk oder den Administrator zu wenden. Legen Sie Ihr Problem dar, und helfen Sie Ihrem Ansprechpartner, zu einer Diagnose zu gelangen. Geben Sie ihnen die Korrelations-ID an, die in Ihrer Fehlermeldung angezeigt wird, da sie sie möglicherweise benötigt.

Um herauszufinden, was passiert ist, müssen Sie als IT-Experte oder Admin die ULS-Protokolle für den Zeitpunkt des Auftretens des Ereignisses suchen und in diesen Protokollen nach der Korrelations-ID suchen. Möglicherweise müssen Sie sich mehrere der Web-Front-Ends ansehen, um das Front-Ends zu finden, das die von Ihnen gesuchte Korrelations-ID enthält. Die Korrelations-ID löst Ihren Fehler nicht, aber sie kann Ihnen helfen, eine Anforderung nachzuverfolgen, um zu sehen, was schiefgelaufen ist. Möglicherweise erfahren Sie, was unmittelbar vor dem Auftreten des Fehlers geschah, welche Fehlermeldungen angezeigt wurden oder welche Ereignisse aufgrund dieses Fehlers ausgelöst wurden (falls vorhanden). Sie können ein Tool wie ULSViewer verwenden, um das Anzeigen dieser Daten zu erleichtern und die Anforderungen herauszufiltern, die Sie nicht sehen müssen. Weitere Ideen und Tipps finden Sie im Blogbeitrag SharePoint-Protokollierung und Problembehandlung mit ULSViewer.

So sieht ein typisches Szenario aus, in dem ein Administrator eine Korrelations-ID verwendet:

  • Einem Benutzer wird beim Öffnen einer Datei in Excel ein Fehler angezeigt, dem der Administrator die Korrelations-ID und das Datum/die Uhrzeit des Vorfalls entnehmen kann:

  • Suchen Sie das Protokollverzeichnis und das gesuchte Datum, und öffnen Sie diese Datei in Excel:

  • Suchen Sie die Korrelations-ID, die Sie suchen. Sie können auch nach der Ebene der Ereignisse filtern, um eine Vorstellung davon zu erhalten, was vor sich geht:

  • Wenn Sie die Korrelations-ID nicht finden, versuchen Sie es mit einem anderen Webserver, der sich zum Zeitpunkt der Meldung des Problems in Rotation befand.

Die folgenden Ressourcen für Administratoren helfen beim Debuggen von SharePoint-Fehlern. Zusätzlich zu diesen Links empfiehlt es sich, das Web zu durchsuchen, denn es gibt zahlreiche Websites und Communitys von Drittanbietern, die Unterstützung und Tools für die Arbeit mit SharePoint bereitstellen. Da SharePoint eine Plattform ist, gibt es eine Community von Tausenden von Entwicklern, IT-Profis und Benutzern, die Tools, Anwendungen und Dokumentationen entwickeln, um sich gegenseitig zu helfen.

Benötigen Sie weitere Hilfe?

Möchten Sie weitere Optionen?

Erkunden Sie die Abonnementvorteile, durchsuchen Sie Trainingskurse, erfahren Sie, wie Sie Ihr Gerät schützen und vieles mehr.