C++ Build Insights 工具可從 Visual Studio 2019 和更新版本開始取得。 若要查看該版本的檔,請將本文的Visual Studio 版本 選取器控件設定為Visual Studio 2019或更新版本。 其位於此頁面目錄頂端。
本文列出並描述 中 vcperf.exe可用的命令,以及如何使用這些命令。
啟動和停止追蹤的命令
重要
除非您指定 /noadmin,否則下列命令需要系統管理許可權。
| 選項 | 參數和描述 |
|---|---|
/start |
[/noadmin] [/nocpusampling] [/enableSilos] [ | /level1/level2 | /level3]<sessionName> |
| 在指定的工作階段名稱下啟動追蹤。 選項 /noadmin讓vcperf.exe執行時不需要系統管理員權限,並且會忽略/nocpusampling選項。 當您在沒有系統管理員許可權的情況下執行 vcperf 時,某台計算機上可能會有多個使用中的會話。 選項 /nocpusampling 指定 vcperf.exe 不會收集CPU樣本。 它會防止在 Windows 效能分析器中使用 CPU 使用量(取樣)檢視,但會減少收集的追蹤檔案大小。 /level1、 /level2或 /level3 選項會指定要收集哪些 MSVC 事件,以增加資訊層級。 層級 3 包含所有事件。 層級 2 包含範本具現化事件以外的所有事件。 層級 1 包含範本具現化、函式和檔案事件以外的所有事件。 如果未指定, /level2 預設會選取 。 若要使用 /templates 分析所收集的範本具現化事件,請使用 /level3。 一旦 vcperf.exe 啟動追蹤,就會立即傳回。 追蹤會收集整個系統中各個處理程序的事件。 這表示您不需要在與用來執行 vcperf.exe相同的命令提示字元視窗中建置專案。 例如,您可以在 Visual Studio 中建置專案。 |
|
/enableSilos此選項(如有提供)允許主機追蹤工作階段從Windows伺服器孤島收集 MSVC 事件,包括程序隔離的 Windows 容器(非採用 Hyper-V 隔離的容器)。 Silo 收集預設為停用。 它只影響 MSVC 提供者,且不會改變系統事件或 CPU 取樣設定。 |
|
/stop |
(1) [/templates] <sessionName> <outputFile.etl> (2) [ /templates] <sessionName> /timetrace <outputFile.json> |
停止指定工作階段名稱所識別的追蹤。 在追蹤上執行一個後處理步驟,以產生由參數<outputFile>指定的檔案。 若追蹤是以 /templates 啟動,該 /level3 選項會在檔案中包含範本實例化事件。 (1) 在 Windows 效能分析器 (WPA) 中產生可檢視的檔案。 輸出檔案需要擴展名 .etl 。(2) 在 Microsoft Edge 追蹤查看器中產生可檢視的檔案( edge://tracing)。 輸出檔案需要擴展名 .json 。 |
|
/stopnoanalyze |
<sessionName> <rawOutputFile.etl> |
| 停止指定工作階段名稱所識別的追蹤,並在指定的輸出檔中寫入未經處理的原始資料。 產生的檔案不適用於在 WPA 中檢視。 命令中 /stop 涉及的後續處理步驟有時可能相當冗長。 您可以使用 /stopnoanalyze 命令來延遲這個後續處理步驟。
/analyze當您準備好在 Windows 效能分析器 或 Microsoft Edge 追蹤查看器中產生可檢視的檔案時,請使用 命令。 |
其他命令
| 選項 | 參數和描述 |
|---|---|
/analyze |
(1) [/templates] <rawInputFile.etl> <outputFile.etl> (2) [ /templates] <rawInputFile.etl> /timetrace <outputFile.json> |
接受命令所產生的 /stopnoanalyze 原始追蹤檔案。 在此追蹤上執行後續處理步驟,以產生由 <outputFile> 參數所指定的檔案。 若追蹤是以 /templates 啟動,該 /level3 選項會在檔案中包含範本實例化事件。 (1) 在 Windows 效能分析器 (WPA) 中產生可檢視的檔案。 輸出檔案需要擴展名 .etl 。 (2) 在 Microsoft Edge 追蹤查看器中產生可檢視的檔案( edge://tracing)。 輸出檔案需要擴展名 .json 。 |
|
/grantusercontrol |
沒有爭論。 |
授予目前使用者啟動及停止 vcperf 追蹤工作階段的權限,這些工作階段可使用 /noadmin 且不需提高權限。 每台機器上,每位使用者都需從提升權限的命令提示字元執行 vcperf /grantusercontrol 一次。 CPU 取樣仍需以提升權限執行的追蹤,且不含 /noadmin。 此指令於 vcperf 版本 2.5.25121101 中新增。 |
無需管理員權限進行追蹤
在提高權限的命令提示字元中,授予目前使用者控制追蹤工作階段的權限:
vcperf /grantusercontrol
在沒有提升權限的命令提示字元中,啟動追蹤:
vcperf /start /noadmin MySession
建置您的專案,然後從未提高權限的命令提示字元停止追蹤:
vcperf /stop MySession output.etl
另請參閱
開始使用 C++ 建置洞察
教學:Windows 效能分析器基礎
參考資料:Windows 效能分析器檢視
Windows 效能分析器