Die Erweiterung MSBuild Binlog Analyzer for VS Code ist als Vorschauversion im Visual Studio Marketplace verfügbar. Sie bringt die Analyse binärer MSBuild-Protokolle in den Visual-Studio-Code-Editor, anstatt auf einen separaten Viewer angewiesen zu sein. Die Erweiterung nutzt GitHub Copilot, um Entwickler dabei zu unterstützen, die Ursachen fehlgeschlagener Builds zu verstehen, langsame Abläufe zu analysieren, mehrere Builds zu vergleichen und Regressionen zu erkennen.
.binlog-Dateien erfassen Details zu MSBuild-Projekten, ihren Zielen und Aufgaben, Eigenschaften und Diagnosen. Das Extrahieren der relevanten Informationen kann jedoch das Öffnen eines weiteren Tools und Kenntnisse darüber erfordern, wo gesucht werden muss. Die Erweiterung zielt darauf ab, dieses Problem zu lösen, indem sie den Protokollinhalt innerhalb derselben Entwicklungsumgebung in verständliche Antworten umwandelt.
Analyse von Fehlerursachen und Leistung
Entwickler können Copilot nach der Ursache eines fehlgeschlagenen Builds fragen. Die Erweiterung liefert dann eine verständliche Erklärung, statt dass manuell zwischen Meldungen zur Wiederherstellung von NuGet-Paketen und anderen Ausgaben gesucht werden muss. Außerdem lässt sich die Korrektur mit einem Klick ausführen: Copilot liest das fehlerhafte Projekt, wendet die Korrektur an, führt den Build erneut aus und lädt anschließend das Protokoll vor und nach der Korrektur, um das Ergebnis zu überprüfen. Probleme können auch einzeln behoben werden, indem mit der rechten Maustaste auf die Diagnose geklickt und Auto-fix with Copilot ausgewählt wird.
Bei langsamen Builds zeigt die Erweiterung die langsamsten Ziele und Aufgaben in ihrer Reihenfolge an und hebt den kritischen Pfad hervor, der die tatsächliche Dauer des Builds bestimmt. Sie kann außerdem erklären, welche Ziele erneut erstellt wurden und warum. Das hilft dabei, die korrekte Funktion inkrementeller Builds zu überprüfen, statt sich auf Vermutungen zu verlassen.
Vergleich und Erkennung von Regressionen
Jede geladene Binlog-Datei kann als Baseline festgelegt werden, mit der die Erweiterung nachfolgende Builds automatisch vergleicht. In der Statusleiste wird ein Kennzeichen angezeigt, das die prozentuale Änderung gegenüber der Baseline angibt. Der Knoten Regressions zeigt Details zu den Änderungen an, darunter langsamer gewordene Ziele, hinzugefügte oder entfernte Diagnosen, Unterschiede bei MSBuild-Eigenschaften und Änderungen an den Versionen von NuGet-Paketen.
Die Oberfläche Build Comparison bietet einen visuellen Vergleich zweier Protokolle auf Zielebene, zeigt die Unterschiede an und hebt den vom MCP-Server berechneten kritischen Pfad hervor. Die Quelle nennt ein Beispiel, in dem Copilot eine Steigerung um 473 % auf einen CoreCompile-Vorgang zurückführt, der aus einem kalten Zustand gestartet wurde, und erklärt, dass es sich um die Kosten der ersten Kompilierung und nicht um ein Problem im Code handelt.
Server und Installation
Die Erweiterung arbeitet zusammen mit dem globalen .NET-Tool Microsoft.AITools.BinlogMcp, das über das Model Context Protocol Dutzende Tools zur Build-Analyse bereitstellt. Copilot ruft diese Tools auf, um sich auf die tatsächlich im Protokoll enthaltenen Daten zu stützen. Der Server wird bei der ersten Verwendung automatisch installiert, ohne manuelle Konfiguration.
Für die Nutzung der Erweiterung benötigt der Entwickler VS Code Version 1.99 oder höher, GitHub Copilot und das .NET SDK. Eine Binlog-Datei kann über den Befehl Binlog: Load File in der Befehlspalette mit dem Tastenkürzel Ctrl+Shift+P geöffnet werden. Alternativ lässt sich das Protokoll während des Builds über die Option Build & Collect Binlog erstellen oder im Structured Log Viewer öffnen.
Nach dem Laden des Protokolls kann im Copilot Chat mit dem Teilnehmer @binlog interagiert werden. Möglich sind Fragen wie nach der Ursache eines fehlgeschlagenen Builds oder den langsamsten Zielen sowie Befehle wie /errors, /perf, /timeline, /compare, /summary, /incremental und /buildcheck.
Zusätzliche Tools und Integration in CI/CD
Die Erweiterung umfasst einen Binlog-Explorer, der Projekte, Fehler, Warnungen und Leistungsbereiche anzeigt. Diagnosen werden außerdem im nativen Problems-Panel von VS Code dargestellt, mit CodeLens für jedes Projekt und einer Option, Copilot um eine Erklärung zu bitten. Zu den weiteren Funktionen gehören ein Zeitdiagramm für Zeitspannen, die Möglichkeit, Verbesserungen vorzuschlagen und anzuwenden und sie anschließend durch einen automatischen Vergleich zwischen zwei Tests zu überprüfen, sowie die Suche in Build-Ereignissen, Aufgaben, Meldungen und Eigenschaften.
Außerdem können Binlog-Dateien aus Azure DevOps Pipelines und GitHub Actions heruntergeladen und nach Branch oder Pull Request gefiltert werden, um fehlgeschlagene CI-Builds zu analysieren, ohne VS Code zu verlassen. Verfügbar sind auch Sprachtools zum Festlegen des Agenten und benutzerdefinierter Chatmodi sowie der fertige Modus Build Analysis.
Die Erweiterung befindet sich weiterhin in der Vorschauphase und wird aktiv weiterentwickelt. Für Interessierte, die ohne Editor-Oberfläche arbeiten möchten, verweist die Quelle auf den Microsoft Binlog MCP Server. Er verwendet dieselbe Analyse-Engine auf eine Weise, die ohne Benutzeroberfläche funktioniert, und eignet sich damit für nicht interaktive Untersuchungen in CI-Umgebungen. Meldungen und Vorschläge werden über das Repository dotnet/skills entgegengenommen.