Dela via


Referens: vcperf-kommandon

C++ Build Insights-verktygen är tillgängliga från och med Visual Studio 2019 och senare. Om du vill se dokumentationen för den versionen anger du väljaren för Visual Studio Version för den här artikeln till Visual Studio 2019 eller senare. Den finns överst i innehållsförteckningen på den här sidan.

Den här artikeln visar och beskriver de kommandon som är tillgängliga i vcperf.exeoch hur du använder dem.

Kommandon för att starta och stoppa spårningar

Viktigt!

Om du inte anger /noadminkräver följande kommandon administratörsbehörighet.

Alternativ Argument och beskrivning
/start [/noadmin] [/nocpusampling] [] [/level1 | /level2 | /level3]<sessionName>
Startar en spårning under det angivna sessionsnamnet.

Alternativet /noadmin körs vcperf.exe utan administratörsbehörighet och ignorerar /nocpusampling alternativet. När du kör vcperf utan administratörsbehörighet kan det finnas fler än en aktiv session på en viss dator.

Alternativet /nocpusampling anger att vcperf.exe inte samlar in CPU-prover. Det förhindrar användning av vyn CPU-användning (provbaserad) i Windows Performance Analyzer, men gör de uppsamlade spårningarna mindre.

Alternativen /level1, /level2, eller /level3 anger vilka MSVC-händelser som ska samlas in för att öka informationsnivån. Nivå 3 innehåller alla händelser. Nivå 2 innehåller alla händelser utom instansieringshändelser för mallar. Nivå 1 innehåller alla händelser utom mallinstansiering, funktions- och filhändelser. Om det är ospecificerat /level2 väljs det som standard.

När vcperf.exe startar spårningen returneras den omedelbart. Spårningen samlar in händelser systemomfattande för alla processer som körs på datorn. Det innebär att du inte behöver skapa projektet i samma kommandotolkfönster som det du använder för att köra vcperf.exe. Du kan till exempel skapa projektet i Visual Studio.
/stop (1) [/templates] <sessionName> <outputFile.etl>
(2) [/templates] <sessionName> /timetrace <outputFile.json>
Stoppar spårningen som identifieras med det angivna sessionsnamnet. Kör ett steg efter bearbetning på spårningen för att generera en fil som anges av parametern <outputFile> .

Alternativet /templates innehåller mallinstansieringshändelser i filen.

(1) Genererar en fil som kan visas i Windows Performance Analyzer (WPA). Utdatafilen kräver ett .etl tillägg.
(2) Genererar en fil som kan visas i Microsoft Edge-spårningsvisaren (edge://tracing). Utdatafilen kräver ett .json tillägg.
/stopnoanalyze <sessionName> <rawOutputFile.etl>
Stoppar spårningen som identifieras med det angivna sessionsnamnet och skriver rådata i den angivna utdatafilen. Den resulterande filen är inte avsedd för visning i WPA.

Det efterbearbetningssteg som ingår i /stop kommandot kan ibland vara långt. Du kan använda /stopnoanalyze kommandot för att fördröja det här efterbearbetningssteget. /analyze Använd kommandot när du är redo att skapa en fil som kan visas i Windows Performance Analyzer eller Microsoft Edge-spårningsvyn.

Diverse kommandon

Alternativ Argument och beskrivning
/analyze (1) [/templates] <rawInputFile.etl> <outputFile.etl>
(2) [/templates] <rawInputFile.etl> /timetrace <outputFile.json>
Accepterar en rå spårningsfil som skapas av /stopnoanalyze kommandot. Kör ett steg efter bearbetning på den här spårningen för att generera filen som anges av parametern <outputFile> .

Alternativet /templates innehåller mallinstansieringshändelser i filen.

(1) Genererar en fil som kan visas i Windows Performance Analyzer (WPA). Utdatafilen kräver ett .etl tillägg.

(2) Genererar en fil som kan visas i Microsoft Edge-spårningsvisaren (edge://tracing). Utdatafilen kräver ett .json tillägg.

Se även

Kom igång med C++ Build Insights
Självstudie: Grunderna i Windows Performance Analyzer
Referens: Windows Performance Analyzer-översikter
Prestandaanalys för Windows