Project Server ULS Logs – Mit PowerShell alle Logs auf einen Streich zusammenführen

  • Article

 

Wenn im ProjectServer Umfeld ein Problem auftritt, das nicht eindeutig beschrieben ist oder beispielsweise eine nichtssagende Fehlermeldung in der Project Server Queue auftaucht, ist man als Administrator einer solchen Umgebung oft gezwungen die ULS Logs (Unified Logging Service) auszuwerten. Um das auftretende Problem auch detailliert darin sehen zu können, kann der Log-Level auf Verbose gestellt werden (mehr dazu später).

Nun ist es aber recht aufwändig, die einzelnen ULS Logfiles auf den verschiedenen Servern nach den auftretenden Fehlern zu durchsuchen Um dies zu vereinfachen gibt es den Powershell Befehl Merge-SPLogFile.

Folgendes Szenario:

Auf einer Server Farm mit mehreren Web-Frontend und Application Servern soll nach Fehlern in den ULS Logs gesucht werden die die dem Error Level "High" entsprechen und in einem bestimmten Zeitraum auftraten.

Vorgehensweise:

Nutzen Sie die SharePoint Management Shell für Ihre Abfrage:

Aufruf: Alles zu Project Server am 30.08.2013 mit Error Level "High"

 

Wartemeldung während des Merge-Vorgangs:

 

Log Events mit Servernamen:

 

Ausgabe aller Meldungen mit Level "High" oder höher.

 

Präzisere Ausgabe der Logs:

Bei speziellen Problemen ist es sinnvoll den Verbose Mode der ULS Logs zu nutzen um den maximal-möglichen Informationsgehalt aus dem Log zu erhalten.

  • Vergewissern Sie sich zunächst das sie genügend Speicherplatz auf der Festplatte haben, auf der die ULS Logs gespeichert werden.

  • Verändern Sie den Trace- und Log-Level entweder in der SharePoint Central Administration unter Monitoring / Configure Diagnostic Logging und aktivieren Sie den "Verbose Mode" für bspw. Project Server oder nutzen Sie die SharePoint Administration Powershell.

    Set-SPLogLevel –TraceLevel Verbose –EventSeverity Verbose –Identity "Project Server:*","SharePoint Server:*"

  • Reproduzieren Sie Ihr Problem bzw. versuchen Sie den auftretenden Fehler erneut herbei zu führen.

  • Führen Sie die ULS Logs aus den relevanten Bereichen mittels Merge-SPLogFile zusammen zu einer Datei an einem von Ihnen vordefinierten Ort wie oben beschrieben.

    Merge-SPLogFile –Path "C:\temp\MyMergedLog.log" –Overwrite –Area "Project Server","SharePoint Server"

Weiterführende Informationen zu Merge-SPLogFile auf Technet: https://technet.microsoft.com/en-us/library/ff607721.aspx