Konfigurieren der Diagnoseprotokollierung in SharePoint Server
GILT FÜR:
2013 2016 2019 Subscription Edition 
SharePoint in Microsoft 365
Voraussetzungen
Das Benutzerkonto, mit dem Verfahren in der Zentraladministration ausgeführt werden, muss Mitglied der SharePoint-Gruppe „Farmadministratoren" sein.
Bewährte Methoden bei der Einstellung für die Diagnoseprotokollierung
Nach der Erstbereitstellung, nach einem Upgrade und bei einer Änderung an der Umgebung wie z. B. dem Hinzufügen oder Entfernen eines Servers kann die Konfiguration der Einstellungen für die Diagnoseprotokollierung in der SharePoint Server-Umgebung erforderlich sein. Die Richtlinien in der folgenden Liste können Ihnen helfen, bewährte Methoden für eine konkrete Umgebung zu entwickeln.
Ändern des Laufwerks, auf das der Server Protokolle schreibt
SharePoint Server schreibt Diagnoseprotokolle standardmäßig auf dasselbe Laufwerk und dieselbe Partition, auf der es installiert wurde. Da die Diagnoseprotokollierung eine große Speicherplatzmenge erfordern und somit die Leistung des Laufwerks beeinträchtigen kann, sollten Sie SharePoint Server so konfigurieren, dass auf ein anderes Laufwerk ohne SharePoint Server-Installation geschrieben wird. Sie sollten außerdem die Geschwindigkeit der Verbindung zu dem Laufwerk berücksichtigen, auf das SharePoint Server die Protokolle schreibt. Wenn die ausführlichen Protokollierung konfiguriert ist, zeichnet der Server große Datenmengen auf. Eine langsame Verbindung kann daher zu einer schlechten Protokollierungsleistung führen.
Beschränken der Speicherplatzverwendung durch das Protokoll
Standardmäßig ist der Speicherplatz, den die Diagnoseprotokollierung verwenden kann, unbegrenzt. Schränken Sie daher den von der Protokollierung belegten Speicherplatz ein, insbesondere wenn Sie die Protokollierung so konfigurieren, dass Ereignisse auf ausführlicher Ebene geschrieben werden. Wenn der Datenträger die Einschränkung erreicht, entfernt SharePoint Server die ältesten Protokolle, bevor neue Protokollierungsdaten aufgezeichnet werden.
Sparsame Verwendung der Einstellung "Ausführlich"
Sie können die Diagnoseprotokollierung konfigurieren, um Ausführliche Ereignisse aufzuzeichnen. Dies bedeutet, dass SharePoint Server jede Ausgeführte Aktion aufzeichnet. Die Protokollierung auf ausführlicher Ebene kann schnell den Speicherplatz auf dem Laufwerk verbrauchen und sich auf die Leistung von Laufwerken und Servern auswirken. Sie können die Protokollierung auf ausführlicher Ebene verwenden, um mehr Details aufzuzeichnen, wenn Sie kritische Änderungen vornehmen, und dann die Protokollierung neu konfigurieren, um nur Ereignisse auf höherer Ebene aufzuzeichnen, nachdem Sie die Änderung vorgenommen haben.
Regelmäßiges Sichern von Protokollen
Diagnoseprotokolle enthalten wichtige Daten. Aus diesem Grund sollten Sie diese regelmäßig sichern, um sicherzustellen, dass diese Daten erhalten bleiben. Wenn Sie die Speicherplatzverwendung durch die Protokollierung beschränken oder Protokolle nur für wenige Tage beibehalten, werden die Protokolldateien automatisch von SharePoint Server gelöscht, sobald der Schwellenwert erreicht ist, wobei die ältesten Dateien zuerst gelöscht werden.
Aktivieren des Ereignisprotokoll-Flutschutzes
Durch Aktivieren dieser Einstellung erkennt SharePoint Server wiederkehrende Ereignisse im Windows-Ereignisprotokoll und unterdrückt diese, bis der Normalzustand wiederhergestellt ist.
Sie können den Diagnoseprotokolliergrad für das Ereignisprotokoll und das Ablaufprotokoll festlegen. Dadurch werden die in die einzelnen Protokolle geschriebenen Informationstypen und -mengen begrenzt. In den folgenden Tabellen werden die verfügbaren Protokolliergrade für das Ereignisprotokoll und das Ablaufprotokoll beschrieben:
Ereignisprotokolliergrade
| Grad | Definition |
|---|---|
| Keine |
Es findet keine Protokollierung statt. |
| Kritisch |
Dieser Meldungstyp gibt einen schwerwiegenden Fehler an, durch den ein schwerwiegender Fehler in der Lösung verursacht wurde. |
| Fehler |
Dieser Meldungstyp gibt eine Bedingung mit hoher Dringlichkeit an. Sie sollte alle Fehlerereignisse untersuchen. |
| Warnung |
Dieser Meldungstyp weist auf ein potenzielles Problem oder Problem hin, das möglicherweise Aufmerksamkeit erfordert. Sie sollten Warnmeldungen für Muster im Laufe der Zeit überprüfen und nachverfolgen. |
| Informationen |
Informationsmeldungen erfordern keine Benutzeraktion. Sie können jedoch wichtige Daten für die Überwachung des Lösungsstatus innerhalb eines bestimmten Zeitraums enthalten. |
| Ausführlich |
Dieser Ereignisprotokolliergrad entspricht längeren Ereignissen oder Meldungen. |
Ablaufprotokolliergrade
| Grad | Definition |
|---|---|
| Keine |
Es werden keine Ablaufprotokolle geschrieben. |
| Unexpected |
Mit diesem Grad werden Meldungen über Ereignisse aufgezeichnet, die dazu führen, dass Lösungen nicht weiter verarbeitet werden. Wenn dieser Grad festgelegt ist, enthält das Protokoll Ereignisse der Stufen "Unerwartet", "Ausnahme", "Assertion" und "Kritisch". |
| Monitorable |
Mit diesem Grad werden Meldungen über alle nicht behebbaren Ereignissen aufgezeichnet, durch die zwar die Funktionalität der Lösung eingeschränkt wird, die Anwendung jedoch nicht angehalten wird. Wenn dieser Grad festgelegt ist, enthält das Protokoll auch Ereignisse, die mit der Einstellung Unexpected aufgezeichnet werden. |
| Hoch |
Mit diesem Grad werden alle unerwarteten Ereignisse aufgezeichnet, durch die die Verarbeitung einer Lösung jedoch nicht angehalten wird. Wenn dieser Protokollgrad festgelegt ist, enthält das Protokoll auch alle Ereignisse, die mit der Einstellung Monitorable aufgezeichnet werden. |
| Medium |
Bei der Einstellung dieses Grads enthält das Ablaufverfolgungsprotokoll alle Meldungen außer Meldungen vom Typ Verbose und VerboseEx. Mit diesem Grad werden alle allgemeine Informationen zu ausgeführten Vorgängen aufgezeichnet. Mit diesem Grad werden genug Details protokolliert, um den Datenfluss und die Reihenfolge der Vorgänge zu erfassen. Administratoren oder Supportspezialisten können diesen Protokollgrad für die Problembehandlung verwenden. Wenn dieser Grad festgelegt ist, enthält das Protokoll auch alle Ereignisse, die mit der Einstellung High aufgezeichnet werden. |
| Verbose |
Bei der Einstellung dieses Grads enthält das Protokoll die meisten Aktionen. Durch die ausführliche Ablaufverfolgung werden zahlreiche Protokollmeldungen erzeugt. Dieser Grad wird normalerweise nur zum Debuggen in einer Entwicklungsumgebung verwendet. Wenn dieser Protokollgrad festgelegt ist, enthält das Protokoll auch alle Ereignisse, die mit der Einstellung Medium aufgezeichnet werden. |
| VerboseEx |
Dieser Grad wir nur vom PowerShell-Cmdlet Set-SPLogLevel unterstützt und enthält Diagnosedaten auf sehr niedriger Ebene. Dieser Grad sollte nur in einer Entwicklungsumgebung verwendet werden. Wenn dieser Grad festgelegt ist, enthält das Protokoll alle Ereignisse, die mit der Einstellung Unexpected aufgezeichnet werden. |
Konfigurieren der Diagnoseprotokollierung mithilfe der Zentraladministration
Sie können die Diagnoseprotokollierung über die Website für die SharePoint-Zentraladministration konfigurieren.
So konfigurieren Sie die Diagnoseprotokollierung mithilfe der Zentraladministration
Klicken Sie auf der Homepage der Zentraladministration auf Überwachung.
Klicken Sie auf der Seite Überwachung im Abschnitt Fehlerberichterstattung auf Diagnoseprotokollierung konfigurieren.
Konfigurieren Sie auf der Seite Diagnoseprotokollierung im Abschnitt Ereignissteuerung die Ereignissteuerung folgendermaßen:
So konfigurieren Sie die Ereignissteuerung für alle Kategorien
Aktivieren Sie das Kontrollkästchen Alle Kategorien.
Wählen Sie in der Liste Unwichtigstes, im Ereignisprotokoll aufzuzeichnendes Ereignis den gewünschten Protokolliergrad für das Ereignisprotokoll aus.
Wählen Sie in der Liste Unwichtigstes, im Ablaufverfolgungsprotokoll aufzuzeichnendes Ereignis den gewünschten Protokolliergrad für das Ablaufverfolgungsprotokoll aus.
So konfigurieren Sie die Ereignissteuerung für eine oder mehrere Kategorien
Aktivieren Sie die Kontrollkästchen der gewünschten Kategorien.
Wählen Sie in der Liste Unwichtigstes, im Ereignisprotokoll aufzuzeichnendes Ereignis den gewünschten Protokolliergrad für das Ereignisprotokoll aus.
Wählen Sie in der Liste Unwichtigstes, im Ablaufverfolgungsprotokoll aufzuzeichnendes Ereignis den gewünschten Protokolliergrad für das Ablaufverfolgungsprotokoll aus.
So konfigurieren Sie die Ereignissteuerung für eine oder mehrere Unterkategorien (Sie können eine oder mehrere Kategorien erweitern und eine Unterkategorie auswählen)
Klicken Sie neben der Kategorie auf das Pluszeichen (+), um die Kategorie zu erweitern.
Aktivieren Sie das Kontrollkästchen der Unterkategorie.
Wählen Sie in der Liste Unwichtigstes, im Ereignisprotokoll aufzuzeichnendes Ereignis den gewünschten Protokolliergrad für das Ereignisprotokoll aus.
Wählen Sie in der Liste Unwichtigstes, im Ablaufverfolgungsprotokoll aufzuzeichnendes Ereignis den gewünschten Protokolliergrad für das Ablaufverfolgungsprotokoll aus.
So setzen Sie die Ereignissteuerung für alle Kategorien auf die Standardeinstellungen zurück
Aktivieren Sie das Kontrollkästchen Alle Kategorien.
Wählen Sie in der Liste Unwichtigstes, im Ereignisprotokoll aufzuzeichnendes Ereignis die Option Auf Standardeinstellung zurücksetzen aus.
Wählen Sie in der Liste Unwichtigstes, im Ablaufverfolgungsprotokoll aufzuzeichnendes Ereignis die Option Auf Standardeinstellung zurücksetzen aus.
Aktivieren Sie im Abschnitt Ereignisprotokoll-Flutschutz das Kontrollkästchen Ereignisprotokoll-Flutschutz aktivieren.
Geben Sie den Pfad des Ordners, in den die Protokolle geschrieben werden sollen, im Abschnitt Ablaufverfolgungsprotokoll im Feld Pfad ein.
Geben Sie im Feld Anzahl der Tage, die Protokolldateien gespeichert werden die Anzahl der Tage (1-366) für die Aufbewahrung der Protokolle ein. Nach dieser Zeit werden Protokolle automatisch gelöscht.
Aktivieren Sie zum Einschränken des Speicherplatzes, den Protokolle verwenden können, das Kontrollkästchen Speicherplatznutzung im Ablaufverfolgungsprotokoll einschränken , und geben Sie dann die Anzahl gigabytes (GB) ein, auf die Protokolldateien beschränkt werden sollen. Wenn Protokolle diesen Wert erreichen, werden ältere Protokolle automatisch gelöscht.
Klicken Sie auf OK, nachdem Sie die gewünschten Änderungen auf der Seite Diagnoseprotokollierung vorgenommen haben.
Konfigurieren der Diagnoseprotokollierung mithilfe von PowerShell
Sie können die Diagnoseprotokollierung mithilfe von PowerShell konfigurieren.
So konfigurieren Sie die Diagnoseprotokollierung mithilfe von PowerShell
Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
Feste Serverrolle securityadmin auf der SQL Server-Instanz.
Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.
Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
Ein Administrator kann mithilfe des Add-SPShellAdmin -Cmdlets Berechtigungen zur Verwendung des PowerShell-Cmdlets gewähren.
Hinweis
[!HINWEIS] Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen über PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Ändern Sie in der SharePoint-Verwaltungsshell das Laufwerk, auf das der Server Protokolle schreibt.
Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:
Set-SPDiagnosticConfig -LogLocation D:\DiagnosticLogsZum Beschränken der Speicherplatzverwendung durch das Protokoll geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:
Set-SPDiagnosticConfig -LogMaxDiskSpaceUsageEnabled
Oder geben Sie den maximalen Speicherplatz für Protokolle an:
Set-SPDiagnosticConfig -LogDiskSpaceUsageGB 500
Zum Anzeigen des derzeitigen Protokolliergrads geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:
Get-SPLogLevelZum Ändern des Protokolliergrads geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:
Set-SPLogLevel -TraceSeverity Monitorable
Zum Zurücksetzen aller Kategorien auf ihre Standardwerte geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein und drücken dann die EINGABETASTE:
Clear-SPLogLevel
Zum Aktivieren des Ereignisprotokoll-Flutschutzes geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:
Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled
Weitere Informationen finden Sie unter Set-SPDiagnosticConfig, Set-SPLogLevel und Get-SPLogLevel.