Erhalten von Buildprotokollen mit MSBuild

  • Artikel

Indem Sie Befehlszeilenoptionen mit MSBuild verwenden, können Sie angeben, wie viele Builddaten zu überprüfen sind und ob Sie Builddaten in eine oder mehrere Dateien speichern möchten. Sie können auch eine benutzerdefinierte Protokollierung zum Sammeln von Builddaten angeben. Weitere Informationen zu MSBuild-Befehlszeilenoptionen, die in diesem Thema nicht behandelt werden, finden Sie unter Befehlszeilenreferenz.

Hinweis

Wenn Sie Projekte mithilfe von Visual Studio-IDE erstellen, können Sie die Probleme diese Builds beheben, indem Sie Buildprotokolle überprüfen. Weitere Informationen finden Sie unter Vorgehensweise: Anzeigen, Speichern und Konfigurieren von Buildprotokolldateien.

Festlegen des Detailgrads

Wenn Sie ein Projekt mithilfe von MSBuild ohne Angabe einer Detailebene erstellen, werden die folgenden Informationen im Ausgabeprotokoll angezeigt:

  • Fehler, Warnungen und Nachrichten, die als äußerst wichtig eingestuft werden.

  • Einige Statusereignisse.

  • Eine Übersicht des Build.

Mithilfe des Schalters -verbosity ( -v) können Sie steuern, wie viele Daten im Ausgabeprotokoll angezeigt werden. Verwenden Sie für die Problembehandlung entweder den Ausführlichkeitsgrad detailed (d) oder diagnostic (diag), der die meisten Informationen bietet.

Der Buildprozess ist möglicherweise langsamer, wenn Sie -verbosity auf detailed festlegen, und sogar noch langsamer, wenn Sie -verbosity auf diagnostic festlegen.

msbuild MyProject.proj -t:go -v:diag

Einstellungen für die Ausführlichkeit

In der folgenden Tabelle wird gezeigt, wie sich die Ausführlichkeit der Protokolle (Spaltenwerte) darauf auswirkt, welche Nachrichtentypen (Zeilenwerte) protokolliert werden.

Nachrichtentyp/Ausführlichkeit Quiet Minimal Normal Detailliert Diagnose
Fehler ✅ ✅ ✅ ✅ ✅
Warnungen ✅ ✅ ✅ ✅ ✅
Nachrichten mit hoher Priorität ✅ ✅ ✅ ✅
Nachrichten mit normaler Priorität ✅ ✅ ✅
Nachrichten mit niedriger Priorität ✅ ✅
Zusätzliche Informationen zur MSBuild-Engine ✅

Speichern des Buildprotokolls in einer Datei

Sie können den Schalter -fileLogger (fl) verwenden, um Builddaten in einer Datei zu speichern. Im folgenden Beispiel werden die Builddaten in einer Datei mit dem Namen msbuild.log gespeichert.

msbuild MyProject.proj -t:go -fileLogger

Im folgenden Beispiel heißt die Protokolldatei MyProjectOutput.log, und der Ausführlichkeitsgrad der Protokollausgabe ist auf diagnostic festgelegt. Geben Sie diese beiden Einstellungen mithilfe des Schalters -fileLoggerParameters (flp) an.

msbuild MyProject.proj -t:go -fl -flp:logfile=MyProjectOutput.log;verbosity=diagnostic

Weitere Informationen finden Sie unter Befehlszeilenreferenz.

Speichern der Protokollausgabe in mehreren Dateien

Im folgenden Beispiel wird das gesamte Protokoll in msbuild1.log, nur die Fehler in JustErrors.log und nur die Warnungen in JustWarnings.log gespeichert. Im Beispiel werden Dateinummern für jede der drei Dateien verwendet. Die Dateinummern werden nach den Schaltern -fl und -flp angegeben (z.B. -fl1 und -flp1).

Die Schalter -fileLoggerParameters (flp) für die Dateien 2 und 3 gibt an, wie jede Datei benannt werden und was sie enthalten soll. Es wird kein Name für die Datei 1 angegeben, deshalb wird der Standardname msbuild1.log verwendet.

msbuild MyProject.proj -t:go -fl1 -fl2 -fl3 -flp2:logfile=JustErrors.log;errorsonly -flp3:logfile=JustWarnings.log;warningsonly

Weitere Informationen finden Sie unter Befehlszeilenreferenz.

Speichern eines binären Protokolls

Sie können das Protokoll mit dem Parameter -binaryLogger (bl) in einem komprimierten, binären Format speichern. Dieses Protokoll enthält eine ausführliche Beschreibung vom Buildprozess und kann mithilfe von bestimmten Protokollanalysetools gelesen werden.

Im folgenden Beispiel wird eine binäre Protokolldatei mit dem Namen binarylogfilename erstellt.

-bl:binarylogfilename.binlog

Sie können die Anzeige für strukturierte Protokolle verwenden, um binäre Protokolle so anzuzeigen, dass sich die Situation viel einfacher beobachten lässt.

Weitere Informationen finden Sie unter Befehlszeilenreferenz.

Verwenden einer benutzerdefinierten Protokollierung

Sie können eine eigene Protokollierung schreiben, indem Sie einen verwalteten Typ erstellen, der die ILogger-Schnittstelle implementiert. Sie können eine benutzerdefinierte Protokollierung verwenden, um z.B. Buildfehler per E-Mail zu versenden, sie in einer Datenbank oder einer XML-Datei zu protokollieren. Weitere Informationen finden Sie unter Buildprotokollierungen.

In der MSBuild-Befehlszeile geben Sie die benutzerdefinierte Protokollierung mithilfe des Schalters -logger an. Sie können auch den Schalter -noconsolelogger verwenden, um die Standardkonsole zu deaktivieren.

Zugehöriger Inhalt