A extensão MSBuild Binlog Analyzer for VS Code está disponível em versão de pré-lançamento no Visual Studio Marketplace, levando a análise de logs binários do MSBuild para dentro do editor do Visual Studio Code, em vez de exigir um visualizador separado. A extensão usa o GitHub Copilot para ajudar os desenvolvedores a entender as causas de falhas nas compilações, analisar lentidão, comparar várias compilações e detectar regressões.
Os arquivos .binlog registram detalhes dos projetos, destinos, tarefas, propriedades e diagnósticos do MSBuild. No entanto, extrair deles a informação importante pode exigir a abertura de outra ferramenta e o conhecimento do local onde procurar. A extensão pretende resolver esse problema transformando o conteúdo do log em respostas compreensíveis dentro do próprio ambiente de desenvolvimento.
Análise das causas de falhas e do desempenho
O desenvolvedor pode perguntar ao Copilot por que uma compilação falhou, e a extensão fornece uma explicação em linguagem clara, em vez de exigir uma busca manual entre mensagens de restauração de pacotes NuGet e outras saídas. Também é possível executar a correção com um clique; o Copilot lê o projeto com problemas, aplica a correção, recompila e carrega os logs de antes e depois da correção para verificar o resultado. Também é possível corrigir os problemas um a um clicando com o botão direito do mouse no diagnóstico e escolhendo Auto-fix with Copilot.
Em casos de compilações lentas, a extensão exibe os destinos e as tarefas mais lentos em ordem, destacando o caminho crítico que determina o tempo real da compilação. Ela também pode explicar quais destinos foram recompilados e por quê, ajudando a verificar se a compilação incremental está funcionando, em vez de depender de suposições.
Comparação e detecção de regressões
Qualquer arquivo binlog carregado pode ser definido como linha de base, para que a extensão compare automaticamente com ele as compilações posteriores. O indicador exibido na barra de status mostra a porcentagem de alteração em relação à linha de base, enquanto o nó Regressions exibe detalhes das mudanças, incluindo os destinos que ficaram mais lentos, os diagnósticos adicionados ou removidos, as diferenças nas propriedades do MSBuild e as alterações nas versões dos pacotes NuGet.
A interface Build Comparison oferece uma comparação visual entre dois logs no nível dos destinos, mostrando as diferenças e destacando o caminho crítico calculado pelo servidor MCP. A fonte menciona um exemplo no qual o Copilot rastreou um aumento de 473% até uma operação CoreCompile iniciada a partir de um estado frio, explicando que se tratava do custo da primeira compilação, e não de um problema no código.
Servidor e instalação
A extensão funciona em conjunto com a ferramenta global .NET Microsoft.AITools.BinlogMcp, que expõe dezenas de ferramentas de análise de compilação por meio do Model Context Protocol. O Copilot chama essas ferramentas para se basear nos dados reais presentes no log, e o servidor é instalado automaticamente no primeiro uso, sem configuração manual.
Para usar a extensão, o desenvolvedor precisa do VS Code versão 1.99 ou posterior, do GitHub Copilot e do .NET SDK. É possível abrir um arquivo binlog usando o comando Binlog: Load File na Paleta de Comandos, com o atalho Ctrl+Shift+P, ou criar o log durante a compilação usando a opção Build & Collect Binlog, ou ainda abri-lo no Structured Log Viewer.
Depois de carregar o log, é possível interagir com o participante @binlog no Copilot Chat usando perguntas como o motivo da falha da compilação ou quais são os destinos mais lentos, além de comandos como /errors, /perf, /timeline, /compare, /summary, /incremental e /buildcheck.
Ferramentas adicionais e integração com CI/CD
A extensão inclui um explorador de Binlog que exibe projetos, erros, avisos e seções de desempenho. Ela também mostra os diagnósticos no painel Problems nativo do VS Code, com CodeLens para cada projeto e uma opção para solicitar uma explicação ao Copilot. Outros recursos incluem uma linha do tempo das durações, a possibilidade de sugerir melhorias e aplicá-las, verificando-as em seguida por meio de uma comparação automática entre dois testes, além de pesquisa em eventos de compilação, tarefas, mensagens e propriedades.
Também é possível baixar arquivos binlog do Azure DevOps Pipelines e do GitHub Actions, filtrando-os por branch ou pull request, para analisar compilações de CI com falha sem sair do VS Code. Estão disponíveis ferramentas de linguagem para definir o modo do agente e os padrões de conversa personalizados, além do modo Build Analysis pronto para uso.
A extensão ainda está em fase de pré-visualização e passa por desenvolvimento ativo. Para quem deseja trabalhar sem uma interface de edição, a fonte menciona o Microsoft Binlog MCP Server, que usa o mesmo mecanismo de análise de forma headless, sendo adequado para investigações não interativas em ambientes de CI. Relatos e sugestões são recebidos por meio do repositório dotnet/skills.