Übersicht über den vereinheitlichten Protokollierungsdienst (Unified Logging Service, ULS)

Letzte Änderung: Donnerstag, 15. April 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Welche Informationen liefert die ULS-Protokollierung?
Wann sollte die ULS-Protokollierung in der Entwicklung eingesetzt werden?
Wie kann ein Entwickler mit ULS-Protokollen arbeiten?

Eine wirkungsvolle Protokollierungsstrategie gilt unter Systemadministratoren schon lange als Möglichkeit, Probleme mit Komponenten und Anwendungen zu verwalten, quantifizierbare statistische Daten zur Geschichte einer Anwendung bereitzustellen, die Problembehandlung zu erleichtern und allgemein den Zustand der Systeme zu überwachen, für die die Administratoren zuständig sind.

In diesem Thema wird beschrieben, wie Sie als Entwickler die Protokollierungsmechanismen von Microsoft SharePoint Foundation nutzen können, um die Anwendungsentwicklung zu vereinfachen, ausführlichere Debuginformationen zu gewinnen und bei Problemen oder beim Erreichen eines Schwellenwerts mit den Systemadministratoren zu kommunizieren. Der wichtigste Mechanismus ist der vereinheitlichte Protokollierungsdienst (Unified Logging Service, ULS), von dem SharePoint Foundation-Ereignisse in das SharePoint-Ablaufverfolgungsprotokoll geschrieben und im Dateisystem gespeichert werden. (Hinweis: ULS-Protokolle werden gelegentlich auch als Ablaufverfolgungsprotokolle bezeichnet.)

Welche Informationen liefert die ULS-Protokollierung?

Die ULS-Protokollierung kann, sofern sie wirkungsvoll implementiert ist, folgenden Zielgruppen äußerst nützliche Informationen liefern.

Für Entwickler

Entwickler können das Ablaufverfolgungsprotokoll bei der Codeentwicklung nutzen. Verwenden Sie Ablaufverfolgungsprotokolle als Erweiterung Ihrer Entwicklungstools oder als zusätzliches Debugtool zur Untersuchung von Problemen. Sofern sichergestellt ist, dass im Ablaufverfolgungsprotokoll nützliche Informationen erfasst werden, können viele Probleme, die während der Entwicklung auftreten, sogar ohne Debugger gelöst werden. Zudem können beim Testen anhand der Ablaufverfolgungsprotokolle Probleme erkannt werden, die auf der Benutzeroberfläche möglicherweise gar nicht sichtbar sind. Ebenso kann anhand der Ablaufverfolgungsprotokolle überprüft werden, ob lang dauernde Vorgänge ohne zugehörige Benutzeroberfläche erfolgreich abgeschlossen wurden.

Ein weiterer Vorteil der ULS-Protokollierung für Entwickler ist die Tatsache, dass Probleme mit der Benutzeroberfläche oder Benachrichtigungen nicht auf der Benutzeroberfläche angezeigt werden müssen. Stattdessen können sie in die Datenbank geschrieben werden, wo sie von Administratoren und Entwicklern eingesehen und analysiert werden können.

Für Serveradministratoren

Damit ein Eintrag im Ereignisprotokoll für den Systemadministrator relevant ist, muss er genug Informationen und Metadaten enthalten, um die erforderlichen Maßnahmen, die entsprechende Position und den Grund für die erforderlichen Maßnahmen zu erkennen. Ebenfalls hilfreich können Kontextinformationen sein wie der Benutzer, der die Aktion initiiert hat. Es liegt auf der Hand, dass die Serverleistung und die Überwachung in Unternehmensumgebungen äußerst bedeutsam sind. Die ULS-Protokollierung kann Administratoren helfen, die Systemleistung nach der Bereitstellung zu optimieren.

Für Supportmitarbeiter

Bei Problemen, die möglichst schnell mithilfe des Microsoft-Kundensupports gelöst werden müssen, können ULS-Protokolle dem Supportteam Hintergrundinformationen liefern, die die Lösung beschleunigen.

Vorsicht
Im Allgemeinen erfolgt bei Protokolltext keine Einschränkung aus Sicherheitsgründen. Achten Sie daher beim Erstellen von Protokollmeldungen darauf, dass diese keine persönlichen oder vertraulichen Unternehmensinformationen enthalten, die in die Protokolle geschrieben würden.

Wann sollte die ULS-Protokollierung in der Entwicklung eingesetzt werden?

Im Allgemeinen ist es umso einfacher, mögliche Probleme zu lösen, je mehr Informationen der Entwickler über den entsprechenden Code bereitstellen kann.

Wie kann ein Entwickler mit ULS-Protokollen arbeiten?

In SharePoint Foundation werden vom vereinheitlichten Protokollierungsdienst konfigurierbare Einstellung auf zweierlei Weise verfügbar gemacht:

• Über das Objektmodell

• Über Windows PowerShell-Cmdlets

Das Objektmodell und ULS-Protokolle

In Windows SharePoint Services 3.0 erfolgte der Zugriff auf ULS-Protokolle über die IDiagnosticsManager-Schnittstelle. In SharePoint Foundation wird jedoch die Verwendung der SPDiagnosticsServiceBase-Klasse empfohlen. Die SPDiagnosticsServiceBase-Klasse bindet alle Aufrufe der IDiagnosticsManager-Klasse ein und erleichtert Entwicklern dadurch die Arbeit mit Ereignisprotokollen. Bei dieser Vorgehensweise können Sie direkt in den Ablaufverfolgungsdienst schreiben.

Weitere Informationen zur Arbeit mit ULS-Protokollen mithilfe des Objektmodells finden Sie unter Verwenden der Ablaufprotokollierungs-API

Windows PowerShell und ULS-Protokolle

Weitere Informationen zum Erstellen von Windows PowerShell-Cmdlets in SharePoint Foundation für die Arbeit mit ULS-Protokollen finden Sie unter Verwenden von Windows PowerShell-Cmdlets mit ULS-Protokollierung