如何：從命令列使用程式碼剖析工具以檢測獨立的 .NET Framework 元件並收集記憶體資料
本主題說明如何使用 Visual Studio 程式碼剖析工具命令列工具檢測獨立應用程式的 .NET Framework 元件 (例如 .exe 或 .dll 檔案)，以及使用程式碼剖析工具收集記憶體資訊。
.gif "注意事項") 注意事項 |
|---|
程式碼剖析工具的命令列工具位於Visual Studio安裝目錄的 \Team Tools\Performance Tools 子目錄中。 在 64 位元電腦上，64 位元和 32 位元版本的工具都可以使用。若要使用分析工具命令列工具，您必須將工具路徑加入至 [命令提示字元] 視窗的 PATH 環境變數，或將它加入至命令本身。如需詳細資訊，請參閱指定程式碼剖析工具命令列工具的路徑。 |
若要使用檢測方法來收集 .NET Framework 元件中詳細的記憶體資料，您可以使用 VSInstr.exe 工具來產生元件的已檢測版本，以及 VSPerfCLREnv.cmd 工具來初始化程式碼剖析環境變數。接著使用 VSPerfCmd.exe 工具來啟動程式碼剖析工具。
當已檢測的元件執行時，記憶體資料會自動收集至資料檔案。您可以在程式碼剖析工作階段期間暫停和繼續資料收集。
若要結束程式碼剖析工作階段，請關閉目標應用程式，然後明確地關閉程式碼剖析工具。在許多情況下，我們建議在工作階段結尾清除程式碼剖析環境變數。
以程式碼剖析工具啟動應用程式
若要將程式碼剖析工具附加至執行中的 .NET Framework 應用程式
開啟 [命令提示字元] 視窗。
使用 VSInstr 工具產生目標應用程式的檢測版本。
初始化 .NET Framework 程式碼剖析的環境變數。型別：
VSPerfClrEnv {/tracegc | /tracegclife}
/tracegc 和 /tracegclife 選項會初始化環境變數，以便只收集記憶體配置資料，或收集記憶體配置和物件存留期資料。
選項
描述
/tracegc
只啟用記憶體配置資料的收集功能。
/tracegclife
啟用記憶體配置資料和物件存留期資料的收集功能。
啟動程式碼剖析工具。型別：
**VSPerfCmd /start:trace /output:**OutputFile [Options]
/start:trace 選項會初始化程式碼剖析工具。
/output**:**OutputFile 選項必須搭配 /start 使用。OutputFile 指定程式碼剖析資料 (.vsp) 檔案的名稱和位置。
下列任何選項都可以搭配 /start:trace 選項使用。
選項
描述
/user:[Domain\]UserName
指定擁有已進行程式碼剖析處理序之帳戶的網域和使用者名稱。只有在處理序是以非登入使用者的身分執行時，才需要這個選項。處理序擁有人列於 [Windows 工作管理員] 的 [處理程序] 索引標籤上的 [使用者名稱] 資料行。
對其他工作階段中的處理序啟用程式碼剖析。如果應用程式在不同的工作階段中執行，就必須有這個選項。工作階段識別項列於 [Windows 工作管理員] 之 [處理程序] 索引標籤上的 [工作階段識別碼] 資料行。/CS 可以當做 /crosssession 的縮寫來指定。
若要在暫停資料收集的情況下啟動程式碼剖析工具，請將 /globaloff 選項加入至 /start 命令列。使用 /globalon 繼續程式碼剖析。
/wincounter:WinCounterPath
指定程式碼剖析期間要收集的 Windows 效能計數器。
/automark:Interval
僅能與 /wincounter 搭配使用。指定 Windows 效能計數器收集事件之間的毫秒數。預設為 500 毫秒。
/counter:Config
從 Config 中指定的處理器效能計數器收集資訊。計數器資訊會加入至每個程式碼剖析事件收集的資料中。
events:Config
指定程式碼剖析期間要收集的 Windows 事件追蹤 (ETW) 事件。ETW 事件是在不同的 (.etl) 檔案中收集的。
從 [命令提示字元] 視窗啟動目標應用程式。
控制資料收集
當目標應用程式正在執行時，您可以使用 VSPerfCmd.exe 選項啟動及停止將資料寫入檔案，以控制資料收集。資料收集控制可讓您收集程式執行中特定組件的資料，例如應用程式的開始與結束。
若要啟動和停止資料收集
下列 VSPerfCmd 選項配對會啟動和停止資料收集。在不同的命令列上指定每個選項。您可以多次開啟或關閉資料收集。
選項
描述
啟動 (/globalon) 或停止 (/globaloff) 所有處理序的資料收集。
/processon:PID/processoff:PID
啟動 (/processon) 或停止 (/processoff) 對處理序 ID (PID) 所指定的處理序進行資料收集。
/threadon:TID/threadoff:TID
啟動 (/threadon) 或停止 (/threadoff) 對執行緒 ID (TID) 所指定的執行緒進行資料收集。
結束程式碼剖析工作階段
若要結束程式碼剖析工作階段，請關閉執行檢測元件的應用程式，然後呼叫 VSPerfCmd /shutdown 選項以關閉分析工具，並關閉程式碼剖析資料檔案。VSPerfClrEnv /off 命令會清除程式碼剖析環境變數。
若要結束程式碼剖析工作階段
關閉目標應用程式。
關閉程式碼剖析工具。型別：
VSPerfCmd /shutdown
(選擇項) 清除程式碼剖析環境變數。型別：
VSPerfCmd /off