共用方式為

HOW TO：使用命令列將程式碼剖析工具附加至 .NET 服務以收集應用程式統計資料

  • 發行項

本主題說明如何使用 Visual Studio 程式碼剖析工具命令列工具將分析工具附加至 .NET Framework 服務，以及使用取樣方法收集效能統計資料。

注意事項注意事項

程式碼剖析工具的命令列工具位於 Visual Studio 安裝目錄的 \Team Tools\Performance Tools 子目錄中。 在 64 位元電腦上，64 位元和 32 位元版本的工具都可以使用。 若要使用程式碼剖析工具的命令列工具，必須將工具路徑加入至命令提示字元視窗的 PATH 環境變數，或將它加入至命令本身。 如需詳細資訊，請參閱指定程式碼剖析工具命令列工具的路徑。

若要從 .NET Framework 服務收集效能資料，您必須使用 VSPerfCLREnv.cmd 工具初始化適當的環境變數。 然後必須重新啟動裝載服務的電腦，並設定電腦進行程式碼剖析。 接著，將程式碼剖析工具附加至服務處理序。 當程式碼剖析工具附加至服務時，您可以暫停和繼續資料收集。

若要結束程式碼剖析工作階段，程式碼剖析工具必須從服務中斷連結，而且程式碼剖析工具必須明確關閉。 在許多情況下，我們建議在工作階段結尾清除程式碼剖析環境變數。

附加程式碼剖析工具

若要將程式碼剖析工具附加至 .NET Framework 服務

  1. 安裝服務。

  2. 開啟命令提示字元視窗。

  3. 初始化程式碼剖析環境變數。 型別：

    VSPerfClrEnv /globalsampleon [/samplelineoff]

    • /globalsampleon 啟用取樣。

    • /samplelineoff 會停用將收集的資料指派到特定原始碼程式行。 已指定這個選項時，資料只會指派給函式。

  4. 重新啟動電腦。

  5. 開啟命令提示字元視窗。

  6. 啟動程式碼剖析工具。 輸入：

    VSPerfCmd /start:sample /output**:**OutputFile[Options]

    • /start:sample 選項會初始化此分析工具。

    • **/output:**OutputFile 選項必須搭配 /start 使用。 OutputFile 指定程式碼剖析資料 (.vsp) 檔案的名稱和位置。

    下列任何選項都可以搭配 /start:sample 選項使用。

    注意事項注意事項

    服務通常需要 /user 和 /crosssession 選項。

    選項

    說明

    /user:[Domain\]UserName

    指定擁有已進行程式碼剖析處理序之帳戶的網域和使用者名稱。 只有在處理序是以非登入使用者的身分執行時，才需要這個選項。 處理序擁有人列於 [Windows 工作管理員] 的 [處理程序] 索引標籤上的 [使用者名稱] 資料行。

    /crosssession

    對其他工作階段中的處理序啟用程式碼剖析。 如果服務在不同的工作階段中執行，則需要這個選項。 工作階段 ID 列於 [Windows 工作管理員] 之 [處理程序] 索引標籤上的 [工作階段識別碼] 資料行。 /CS 可以當做 /crosssession 的縮寫來指定。

    /wincounter:WinCounterPath

    指定程式碼剖析期間要收集的 Windows 效能計數器。

    /automark:Interval

    僅能與 /wincounter 搭配使用。 指定 Windows 效能計數器收集事件之間的毫秒數。 預設為 500 毫秒。

    /events:Config

    指定程式碼剖析期間要收集的 Windows 事件追蹤 (ETW) 事件。 ETW 事件是在不同的 (.etl) 檔案中收集的。

  7. 如有必要，請啟動服務。

  8. 將程式碼剖析工具附加到服務。 輸入：

    VSPerfCmd /attach: {PID|ProcName} [Sample Event] [/targetclr**:**Version]

    • 指定服務的處理序 ID (PID) 或處理序名稱 (ProcName)。 您可以在 [Windows 工作管理員] 中檢視所有執行中處理序的處理序 ID 和名稱。

    根據預設，效能資料為每 10,000,000 個未暫止處理器時脈循環取樣一次。 在 1GHz 的處理器上，大約每秒鐘 100 個樣本。 您可以指定下列其中一項，變更時脈循環間隔或指定不同的取樣事件。

    取樣事件

    說明

    /timer:Interval

    將取樣間隔變更為 Interval 所指定的未暫止時脈循環數目。

    /pf[:Interval]

    將取樣事件變更為分頁錯誤。 如果已指定 Interval，則會設定樣本之間的分頁錯誤數目。 預設值為 10。

    /sys[:Interval]

    將取樣事件變更為從處理序對作業系統核心的系統呼叫 (syscall)。 如果已指定 Interval，則會設定樣本之間的呼叫數目。 預設值為 10。

    /counter:Config

    將取樣事件和間隔變更為 Config 中指定的處理器效能計數器和間隔。
    • 如果有多個 Common Language Runtime (CLR) 版本載入到某一種應用程式中，則 **targetclr:**Version 會指定要進行程式碼剖析的 Runtime 版本。 選擇項。

控制資料收集

當服務執行時，您可以使用 VSPerfCmd.exe 選項，啟動及停止將資料寫入程式碼剖析工具資料檔案。 資料收集控制可讓您收集程式執行中特定組件的資料，例如應用程式的開始與結束。

若要啟動和停止資料收集

  • 下列 VSPerfCmd 選項配對會啟動和停止資料收集。 在不同的命令列上指定每個選項。 您可以多次開啟或關閉資料收集。

    選項

    說明

    /globalon /globaloff

    啟動 (/globalon) 或停止 (/globaloff) 所有處理序的資料收集。

    /processon:PID/processoff:PID

    啟動 (/processon) 或停止 (/processoff) 對處理序 ID (PID) 所指定的處理序進行資料收集。

    /attach:{PID|ProcName} /detach[:{PID|ProcName}]

    /attach 會開始針對處理序 ID 或處理序名稱指定的處理序來收集資料。 /detach 會停止對指定的處理序收集資料，如果沒有指定特定的處理序，則停止所有處理序的資料收集。

  • 您也可以使用 VSPerfCmd.exe /mark 選項，將程式碼剖析標記插入資料檔案。 /mark 命令會加入識別項、時間戳記和選擇性使用者定義的文字字串。 標記可用來篩選程式碼剖析工具報告和資料檢視中的資料。

結束程式碼剖析工作階段

若要結束程式碼剖析工作階段，程式碼剖析工具必須從所有已進行程式碼剖析的處理序中斷連結，而且程式碼剖析工具必須明確關閉。 您可以藉由關閉應用程式或呼叫 VSPerfCmd /detach 選項，將程式碼剖析工具從已使用取樣方法進行程式碼剖析的應用程式中斷連結。 接著呼叫 VSPerfCmd /shutdown 選項，關閉程式碼剖析工具並關閉程式碼剖析資料檔案。

VSPerfClrEnv /globaloff 命令會清除程式碼剖析環境變數，但是系統組態在電腦重新啟動後才會重設。

若要結束程式碼剖析工作階段

  1. 請執行下列其中一個動作，從目標應用程式中斷連結程式碼剖析工具：

    • 停止服務。

      -或-

    • 輸入 VSPerfCmd /detach

  2. 關閉程式碼剖析工具。 輸入：

    VSPerfCmd /shutdown

  3. (選擇項) 清除程式碼剖析環境變數。 型別：

    VSPerfClrEnv /globaloff

  4. 重新啟動電腦。

請參閱

概念

服務的命令列分析

其他資源

程式碼剖析工具取樣方法資料檢視