Verwalten der Buildinformationen und des Steuerelement-Ausführlichkeitsgrads

Sie können ausführliche Informationen über einen abgeschlossenen Build abrufen:

• Wie wurde der Build ausgeführt? War der Build erfolgreich?Wann wurde er gestartet?Wie lange dauerte der Build?Wie ist die Ausführung dieses Builds relativ zum vorherigen Build zu bewerten?

• Was wurde erstellt? Welche Projektmappen, Changesets und Fehlerkorrekturen hat dieser Build umfasst?

• Was lief falsch? Welche Warnungen oder Fehler traten auf?Welche Tests sind fehlgeschlagen?

Beim Definieren des Buildvorgangs können systematisch den Ausführlichkeitsgrad der Informationen steuern, die zu jedem abgeschlossenen Build gespeichert werden.Alternativ können Sie diesen Ausführlichkeitsgrad für eine einzelne Ausführung eines Builds steuern, wenn Sie diesen manuell in die Warteschlange stellen.

In diesem Thema

• So werden Buildinformationen generiert und so funktioniert der Informationsfluss

  • Definieren des Buildprozesses

  • Der Buildprozess wird in die Warteschlange gestellt und ausgeführt

  • Die Buildinformationen werden erzeugt, gefiltert und gespeichert

  • Abrufen von Buildinformationen

• Festlegen des Buildprozessparameters für die Protokollierungsausführlichkeit

• Best Practice: Festlegen eines möglichst geringen Ausführlichkeitsgrads

  • Verwenden von minimaler Ausführlichkeit bei Ausführung eines Builds

  • Verwenden von minimaler Ausführlichkeit beim Entwerfen einer benutzerdefinierten Buildprozessvorlage

• Weitere Informationen

So werden Buildinformationen generiert und so funktioniert der Informationsfluss

Definieren des Buildprozesses

Beim Entwickeln des Buildprozesses können Sie die Informationsausführlichkeit systematisch steuern.Zeigen Sie die Registerkarte Prozess an, wenn Sie eine Builddefinition erstellen oder bearbeiten, die auf der Standardvorlage oder der Upgradevorlage basiert.Unter dem Knoten Standard können Sie in der Liste Protokollierungsausführlichkeit einen Wert auswählen, um diesen Buildprozessparameter anzugeben.

Falls die integrierten Vorlagen Ihren Anforderungen nicht entsprechen, können Sie eine benutzerdefinierte Buildprozessvorlage entwickeln.Wenn Sie eine derartige Vorlage erstellen, sollten Sie die Buildinformationen sorgfältig schreiben.Weitere Informationen finden Sie unter Verwenden von minimaler Ausführlichkeit beim Entwerfen einer benutzerdefinierten Buildprozessvorlage.

Der Buildprozess wird in die Warteschlange gestellt und ausgeführt

Sie können die Einstellung Protokollierungsausführlichkeit manuell überschreiben, wenn Sie eine Builddefinition in die Warteschlange stellen, die auf der Standardvorlage oder der Upgradevorlage basiert.Klicken Sie im Dialogfeld Build zur Warteschlange hinzufügen auf die Registerkarte Parameter, erweitern Sie den Knoten Standard, und wählen Sie dann in der Liste Protokollierungsausführlichkeit einen Wert aus, um diesen Buildprozessparameter anzugeben.Dieser Wert wird auf eine einzelne Ausführung des Builds angewendet.

Die Buildinformationen werden erzeugt, gefiltert und gespeichert

Das Buildsystem übergibt den Wert des Buildprozessparameters Ausführlichkeit an Verbosity.Diese Eigenschaft wird verwendet, um die Buildinformationen zu filtern, die im Team Foundation Server über Information aus den folgenden Quellen protokolliert und gespeichert werden:

• Workflowaktivitäten: Einige Workflowaktivitäten generieren eine Meldung, wenn ein Vorgang erfolgreich ausgeführt wurde, oder eine Warnung bzw. einen Fehler, wenn ein Vorgang fehlgeschlagen ist.Beispielsweise generiert die Aktivität SyncWorkspace Meldungen von geringer Wichtigkeit, wenn Quellcode und andere Dateien vom Server in den Build-Agent heruntergeladen werden.Diese Aktivität generiert Fehler, wenn die Dateien nicht heruntergeladen werden können.Ein weiteres Beispiel ist die Aktivität OpenWorkItem, die eine Warnung generiert, wenn das Erstellen einer Arbeitsaufgabe fehlschlägt.

  Sie können andere Workflowaktivitäten verwenden, um direkt eigene Buildinformationen zu schreiben.Weitere Informationen finden Sie unter Entwerfen einer benutzerdefinierten Buildprozessvorlage, die nur die nötigsten Informationen aufzeichnet.

• Kompiliercode: Der Buildprozess verwendet die Aktivität MSBuild, um MSBuild zum Kompilieren der Binärdateien und Ausführen anderer wichtiger Aufgaben zu nutzen.Die Eigenschaft Ausführlichkeit dieser Aktivität steuert die Ausführlichkeit der Informationen, die von diesem Prozess generiert und an folgenden Speicherorten veröffentlicht werden:

  • Das Team Foundation Server speichert die Ergebnisse der Kompilierung, Fehler und Warnungen.

  • In einem Protokoll im Ablageordner speichert die gleichen Informationen wie das Team Foundation Server zusammen mit allen anderen Meldungen, die MSBuild erzeugt.

• Testcode: Der Buildprozess verwendet die Aktivität RunTests oder MSTest, um Tests durchzuführen.Alle Meldungen, die diese Änderungsprotokoll mit einem hohen Wichtigkeitswert klassifiziert werden, wenn der Buildcontroller lokal ist oder nicht, wenn Sie Gehosteter Buildcontroller. verwenden.

Abrufen von Buildinformationen

Während der Ausführung und nach dem Abschluss des Builds können Sie sowohl die Zusammenfassung als auch ausführliche Informationen im Fenster für Buildergebnisse abrufen.Diese Informationen können Sie aus dem Fenster in die Zwischenablage kopieren.Außerdem können Sie eine direkte Verknüpfung mit dem Ablageordner erstellen, um Protokolle, Binärdateien und andere Daten abzurufen.

Der Buildprozessparameter für die Protokollierungsausführlichkeit

In einem Buildprozess, der auf der Standardvorlage oder der Upgradevorlage basiert, können Sie den Buildprozessparameter Protokollierungsausführlichkeit verwenden, um den Ausführlichkeitsgrad der protokollierten und gespeicherten Informationen zu verwalten.

In der folgenden Tabelle werden die Werte für die Protokollierungsausführlichkeit und ihre entsprechenden Auswirkungen aufgeführt:

Wert	Fehler	Warnungen	Buildmeldungen mit hoher Wichtigkeit	Meldungen mit normaler Wichtigkeit	Meldungen mit geringer Wichtigkeit	Workflowaktivitätseigenschaften (Eingaben und Ausgaben)
Minimal	J	N	N	N	N	N
Normal	J	J	J	N	N	N
Detailed	J	J	J	J	N	N
Diagnose (Tipp: In den meisten Fällen können Sie Diagnoseprotokolle stattdessen verwenden.Siehe Build-Problemdiagnose.)	J	J	J	J	Lokaler Buildcontroller: Y Gehosteter Buildcontroller: N	J

Best Practice: Festlegen eines möglichst geringen Ausführlichkeitsgrads

Obwohl Buildinformationen wichtig sind, kann ein Buildvorgang, der zu viele Informationen protokolliert, Probleme verursachen.Diese Probleme umfassten möglicherweise das Konsumieren zu vielen Speichers auf dem Team Foundation Server, durch Verringern von Visual Studio-Leistung und das Überladen der Teammitglieder mit mehr Informationen, als sie behandeln können.

Verwenden von minimaler Ausführlichkeit bei Ausführung eines Builds

Beim Ausführen eines Builds sollten Sie als empfohlene Vorgehensweise die niedrigste Einstellung für den Ausführlichkeitsgrad verwenden, mit der weiterhin die Informationen bereitgestellt werden, die Sie zum Erreichen Ihres Ziels benötigen.

Verwenden von minimaler Ausführlichkeit beim Entwerfen einer benutzerdefinierten Buildprozessvorlage

Benutzer des Buildprozesses können auf die Filter zur Reduktion des Ausführlichkeitsgrads zurückgreifen, um einen Informationsüberfluss zu vermeiden.Sie können den Filterungsvorgang effektiver gestalten, indem Sie wie folgt vorgehen:

• Achten Sie darauf, dass Sie zum Schreiben einer Meldung die am besten geeignete Aktivität auswählen: WriteBuildMessage-Aktivität, WriteBuildWarning-Aktivität, WriteBuildError-Aktivität oder WriteBuildTestError.

• Wenn Sie die Aktivität WriteBuildMessage-Aktivität zur Protokollierung von Informationen verwenden, gehen Sie beim Festlegen der Importance-Eigenschaft bewusst und konsistent vor.Falls Sie für die Meldung eine höhere Wichtigkeit verwenden, ist zu beachten, dass Sie möglicherweise die Datenmenge erhöhen, die gespeichert und den Teammitgliedern angezeigt wird.

Hinweis
Diese Entscheidungen können insbesondere dann erhebliche Auswirkungen haben, wenn Sie diese Aktivitäten in einer Schleifenstruktur wie DoWhile, ForEach<T> oder While verwenden.

Weitere Informationen

Build-Problemdiagnose wird beschrieben, wie Diagnoseprotokolle abruft.

Unter Team Foundation Build-Aktivitäten sind die in diesem Thema erwähnten Workflowaktivitäten für Buildprozesse beschrieben.

Unter Definieren eines auf der Standardvorlage basierenden Buildprozesses und Verwenden von Legacy-Buildprozessen finden Sie eine Anleitung dazu, wie Builddefinitionen erstellt und verwaltet werden, die auf der Standardvorlage und der Upgradevorlage basieren.

Anzeigen von Buildergebnissen enthalten eine Anleitung, wie Sie das Fenster für Buildergebnisse verwenden.

IBuildDetail, BuildMessageImportance und BuildVerbosity beschreiben einige Schlüsselelemente der Team Foundation Build-API, die Buildinformationsfunktionen bereitstellt.

In MSBuild-Befehlszeilenreferenz wird MSBuild erläutert.

Angeben der Buildtrigger und Gründe und Stellen eines Builds in die Warteschlange beschreiben, wie ein Build automatisch und manuell in eine Warteschlange gestellt wird.