Sicherheitsstufen der Ablauf- und Ereignisprotokollierung
Letzte Änderung: Mittwoch, 25. Mai 2011
Gilt für: SharePoint Foundation 2010
Wenn die ULS-API (Unified Logging System, Vereinheitlichter Protokollierungsdienst) zum Definieren von Ereignissen oder Ablaufprotokollen verwendet wird, ist die ULS-Ebene einer der Werte, die angegeben werden müssen. Ebenen sind Einstellungen, mit denen der Schweregrad eines Ereignisses oder eines Ablaufs angegeben wird. Sie werden auch zur Drosselung verwendet, damit verhindert wird, dass sich wiederholende Informationen die Protokolldateien überschwemmen. Mithilfe der folgenden Richtlinien können Sie die für Ihr Szenario geeignete Ebene bestimmen.
Richtlinien für Ereignisebenen
Wenn Sie ein Ereignis in der Manifest.xml-Datei definieren, müssen Sie eine entsprechende Sicherheitsebene auswählen. Die Sicherheitsebene eines Ereignisses wird im Windows-Ereignisprotokoll angezeigt und von Administratoren verwendet sowie von Überwachungstools registriert, um den Schweregrad oder die Bedeutung eines Ereignisses anzugeben. Die Auswahl einer entsprechenden Ebene ist ein wichtiger Teil des Integritäts- und Überwachungsentwurfs Ihrer Komponente oder Ihres Systems.
Weitere Informationen zum Ereignismanifestschema finden Sie unter Ereignisschema
ULS-Ebenenname |
Ebenen-ID |
Im Ereignisprotokoll angezeigt als… |
Beschreibung |
Kritischer Fehler |
30 |
Kritisch |
Ereignisse, die der sofortigen Aufmerksamkeit des Systemadministrators bedürfen. Sie werden in der Regel an die globale (systemweite) Ebene weitergeleitet, z. B. System oder Anwendung. Sie kann auch verwendet werden, um den Fehler oder das Anhalten einer Anwendung oder des Systems anzuzeigen. |
Fehler |
40 |
Fehler |
Ereignisse, die Probleme angeben, dies jedoch in einer Kategorie, die kein sofortiges Eingreifen erfordert. |
Warnung |
50 |
Warnung |
Ereignisse, die vor möglichen Problemen warnen. Es handelt sich zwar nicht um eine Antwort auf einen tatsächlichen Fehler, durch eine Warnung wird jedoch angegeben, dass sich eine Komponente oder Anwendung nicht im idealen Status befindet und dass einige weitere Aktionen zu einem kritischen Fehler führen können. |
Information |
80 |
Information |
Ereignisse, die nicht kritische Informationen an den Administrator weitergeben, ähnlich einem Hinweis vom Typ "Zu Ihrer Information". |
Ausführlich |
100 |
Information |
Ausführlicher Status, z. B. Fortschritts- oder Erfolgsmeldungen. |
Richtlinien für Ablaufebenen
Beim Schreiben eines Ablaufprotokolls mithilfe der ULS-API müssen Sie eine Sicherheitsebene angeben. Die Sicherheitsebene wird im ULS-Ablaufprotokoll angezeigt und von Berichterstellungs- oder Filtertools häufig verwendet. Aus diesem Grund muss eine entsprechende Ebene ausgewählt werden.
ULS-Ebenenname |
Ebenen-ID |
Beschreibung |
Unerwartet |
10 |
Ähnlich einer Assertion (eine Annahme im Code, dass eine Bedingung zu einem bestimmten Zeitpunkt true ergibt) gibt diese Meldung an, dass bei einer Logiküberprüfung ein Fehler aufgetreten ist, was atypisch ist, oder von der Meldung wird ein unerwarteter Fehlercode zurückgegeben. Diese Meldungen stellen in der Regel Fehler im Code dar, die untersucht und repariert werden sollten. |
Überwachbar |
15 |
Abläufe, die ein Problem angeben, das jedoch keine sofortige Untersuchung erfordert. Der Zweck liegt darin, Daten über einen längeren Zeitraum zu erfassen und zu analysieren, wobei nach Problemtendenzen gesucht wird. |
Hoch |
20 |
Detail zur allgemeinen Funktionalität, die Ereignisse mit hoher Priorität, die in der Umgebung auftreten. Beispiele schließen globale Konfigurationsänderungen, das Starten und Anhalten von Diensten, den Abschluss von Zeitgeberaufträgen usw. ein. |
Mittel |
50 |
Unterstützt Support- oder Testteams beim Debuggen von Kunden- oder Umgebungsproblemen. Diese schließen Meldungen ein, die den Erfolg oder Fehler einzelner Features angeben, z. B. das Erstellen einer neuen Liste, das Ändern einer Seite usw. |
Ausführlich |
100 |
Hauptsächlich hilfreich für Entwickler, die Codefehler auf niedrigen Ebenen debuggen. Im Allgemeinen nur nützlich für Benutzer, die Zugriff auf Quellcode oder Symbole besitzen. Ein Großteil der Ereignisnachverfolgung, die nicht die ganze Zeit aktiviert sein muss, sollte auf die Ebene Ausführlich festgelegt sein. |
VerboseEx |
200 |
Nützlich für Abläufe, die sehr wahrscheinlich sehr umfangreich sind, dies gilt besonders für Informationen, die nicht für alle Debugszenarien erforderlich sind. Beispiel für Situationen, in denen die Einstellung VerboseEx verwendet werden sollte, sind Eintritt- und Austrittereignisse für Methoden, Abläufe in Schleifen oder das Weiterleiten von Informationen, die für Entwickler außerhalb des Teams nicht von Interesse sind. |