IntelliTrace for Visual Studio Enterprise (C#、Visual Basic、C++)
當您使用 IntelliTrace 記錄和追蹤程式碼的執行歷程時，可以縮短對應用程式進行偵錯的時間。 您可以輕鬆地找到錯誤，因為 IntelliTrace 可讓您：
記錄特定事件
請檢查相關的程式碼、發生偵錯工具事件時出現在 [區域變數] 視窗中的資料，以及函式呼叫資訊
偵錯難以重現或在部署中所發生的錯誤
您可以在 Visual Studio Enterprise 版本 (而非 Professional 或 Community 版本) 中使用 IntelliTrace。
您想要做什麼事？
| 案例 | 標題 |
|---|---|
| 使用 IntelliTrace 偵錯我的應用程式： - 顯示過去的事件。 - 顯示過去事件的呼叫資訊。 - 儲存 IntelliTrace 工作階段。 - 控制 IntelliTrace 收集的資料。 |
- 使用 IntelliTrace 檢查先前的應用程式狀態 - 逐步解說：使用 IntelliTrace - IntelliTrace 功能 - 歷程偵錯 |
| 從部署的應用程式中收集 IntelliTrace 資料 | - 使用 IntelliTrace 獨立收集器 |
| 從 IntelliTrace 記錄檔 (.iTrace 檔案) 開始偵錯。 | - 使用儲存的 IntelliTrace 資料 |
我可以使用 IntelliTrace 對哪些應用程式進行偵錯？
| 支援層級 | 應用程式類型 |
|---|---|
| 完整支援 | - 使用 .NET Framework 2.0 或更高版本的 Visual Basic 和 Visual C# 應用程式。 您可以偵錯大部分應用程式，包括 ASP.NET、Microsoft Azure、Windows Form、WCF、WPF、Windows Workflow、SharePoint 2010、SharePoint 2013 和 64 位元應用程式。 若要使用 IntelliTrace 對 SharePoint 應用程式進行偵錯，請參閱逐步解說：使用 IntelliTrace 對 SharePoint 應用程式進行偵錯。 若要使用 IntelliTrace 對 Microsoft Azure 應用程式進行偵錯，請參閱使用 IntelliTrace 和 Visual Studio 對已發佈的雲端服務進行偵錯。 |
| 有限支援 | - 對於以 Windows 為目標的 C++ 應用程式，可支援使用 IntelliTrace 回溯來檢視快照。 僅支援偵錯工具和例外狀況事件。 - 對於 .NET Core 和 ASP.NET Core 應用程式，僅在本機偵錯時支援特定的事件 (MVC 控制器、ADO.NET 和 HTTPClient 事件)。 對於 .NET Core 或 ASP.NET Core 應用程式，不支援獨立收集器。 - 實驗基礎的 F# 應用程式 - 對於 UWP 應用程式，僅支援事件 |
| 不支援 | - 其他語言和指令碼 - Windows 服務、Silverlight、Xbox 或 Windows 行動應用程式 |
注意
如果您要對已在執行中的處理程序進行偵錯，則僅能收集 IntelliTrace 事件 (無呼叫資訊)。 您只能附加到本機上的 32 位元或 64 位元的處理程序。 不會收集附加到處理程序之前發生的事件。
為什麼要使用 IntelliTrace 進行偵錯？
傳統或「即時」(Live) 偵錯只會顯示應用程式的目前狀態，並只包含有關過去事件的有限資料。 您必須根據應用程式的目前狀態來推斷這些事件，或者必須透過重新執行應用程式來重新建立這些事件。
IntelliTrace 透過記錄在這些時間點的特定事件和資料，擴展了這個傳統的偵錯經驗。 這可讓您查看應用程式中發生的事件，而不需要重新啟動它，特別是如果您已逐步執行超過 Bug 的位置時。 在傳統偵錯期間，IntelliTrace 預設會開啟並以隱藏的方式自動收集資料。 這可讓您輕易地切換傳統偵錯和 IntelliTrace 偵錯，以查看所記錄的資訊。 請參閱 IntelliTrace 功能和 IntelliTrace 收集哪些資料？
IntelliTrace 也可協助您偵錯難以重現或在部署中發生的錯誤。 您可以收集 IntelliTrace 資料並將其儲存至 IntelliTrace 記錄檔 (.iTrace 檔案)。 .iTrace 檔案包含有關例外狀況、效能事件、Web 要求、測試資料、執行緒、模組和其他系統資訊的詳細資料。 您可以在 Visual Studio Enterprise 中開啟這個檔案，並選取某個項目，然後使用 IntelliTrace 開始偵錯。 這可讓您移至檔案中的任何事件，並查看應用程式在該時間點的特定詳細資料。
您可以儲存來自下面這些來源的 IntelliTrace 資料：
Visual Studio 2015 Enterprise 或更新版本，或舊版 Visual Studio Ultimate 中的 IntelliTrace 工作階段。
如果是使用 Microsoft Monitoring Agent (獨立執行或搭配 System Center 2012 運作)，則為裝載於 IIS 上的 ASP.NET Web 應用程式或是在部署中執行的 SharePoint 應用程式。 請參閱使用 IntelliTrace 獨立收集器和使用 Microsoft Monitoring Agent 來進行監視。
重要
當 Microsoft Monitoring Agent (MMA) 的生命週期於 2024 年 8 月 31 日到期時，將不再支援將 Microsoft Monitoring Agent 與 IntelliTrace 結合使用。 如需詳細資訊，請參閱從 Log Analytics 代理程式移轉至 Azure 監視器代理程式。
下面是一些 IntelliTrace 如何協助您偵錯的範例：
您的應用程式含有損毀的資料檔，但您不知道此事件在何處發生。
如果沒有 IntelliTrace，您就必須逐一查看程式碼來尋找所有可能的檔案存取、在這些存取上放置中斷點，然後重新執行應用程式來找出發生問題的位置。 如果有 IntelliTrace，您就可以看到所有收集的檔案存取事件，以及在每個事件發生時應用程式的特定詳細資訊。
發生例外狀況。
如果沒有 IntelliTrace，您會收到有關例外狀況的訊息，但沒有很多關於造成例外狀況之事件的資訊。 雖然您可以檢查呼叫堆疊來查看導致例外狀況的呼叫鏈結，但是卻看不到在這些呼叫期間所發生的事件順序。 如果有 IntelliTrace，您就可以查看在例外狀況之前所發生的事件。
在部署的應用程式中發生 Bug 或當機。
如果是 Microsoft Azure 架構的應用程式，您可以在發行應用程式之前先設定 IntelliTrace 資料收集。 在應用程式執行的同時，IntelliTrace 會將資料儲存到 .iTrace 檔案。 請參閱使用 IntelliTrace 和 Visual Studio 對已發佈的雲端服務進行偵錯。
如果是裝載於 IIS 7.0、7.5 和 8.0 上的 ASP.NET Web 應用程式，以及 SharePoint 2010 或 SharePoint 2013 應用程式，請使用 Microsoft Monitoring Agent (獨立執行或搭配 System Center 2012 運作) 來將 IntelliTrace 資料儲存到 .iTrace 檔案。
如果要診斷部署中的應用程式的問題時，這十分有用。 請參閱使用 IntelliTrace 獨立收集器。
IntelliTrace 會收集哪些資料？
收集事件資訊
IntelliTrace 預設只會記錄 IntelliTrace 事件：偵錯工具事件、例外狀況、.NET Framework 事件，以及有助於偵錯的其他系統事件。 您可以選擇要收集的 IntelliTrace 事件種類 (除了偵錯工具事件和例外狀況外，這些項目一律會收集)。 請參閱 IntelliTrace 功能。
偵錯工具事件
IntelliTrace 一律會記錄在 Visual Studio Debugger 中發生的事件。 例如，啟動您的應用程式就是一個偵錯工具事件。 其他偵錯工具事件包括停止事件，也就是導致應用程式中斷執行的事件。 例如，您的程式遇到了中斷點、遇到了追蹤點或執行 [逐步執行] 命令時。
根據預設，為了協助提高效能，IntelliTrace 不會記錄偵錯工具事件的每個可能的值。 相反地，它會記錄下面這些值：
[區域變數] 視窗中的值。 讓 [區域變數] 視窗保持開啟來查看這些值。
[自動變數] 視窗中的值 (只有當 [自動變數] 視窗開啟時)
在您將滑鼠指標放置在來源視窗中的變數上方以查看它的值時，所出現的 DataTips 中的值。 IntelliTrace 不會收集固定的 DataTips 中的值。
啟用 IntelliTrace 事件和快照模式時，IntelliTrace 將在每個偵錯工具中斷點和步驟事件處擷取應用程式處理程序的快照。 這將記錄 [區域變數]、[自動] 和 [監看] 視窗中的值，不論視窗是否開啟。 也會收集任何鎖定資料提示中的值。
例外狀況
IntelliTrace 會記錄下列例外狀況種類的例外狀況類型和訊息：
已處理的例外狀況 (例外狀況已擲回並已攔截)
未處理的例外狀況
.NET Framework 事件
根據預設，IntelliTrace 會記錄最常見的 .NET Framework 事件。 例如，對於 CheckBox.CheckedChanged 事件，IntelliTrace 會收集核取方塊的狀態和文字。
SharePoint 2010 和 SharePoint 2013 應用程式事件
您可以記錄在 Visual Studio 外部執行之 SharePoint 2010 和 2013 應用程式的使用者設定檔事件以及統一登入系統 (ULS) 事件的子集。 您可以將這些事件儲存成 .iTrace 檔案。 需要 Visual Studio Enterprise 2015 或更新版本、舊版的 Visual Studio Ultimate，或在追蹤模式下執行的 Microsoft Monitoring Agent。
當您開啟 .iTrace 檔案時，請輸入 SharePoint 相互關聯識別碼以尋找其相符的 Web 要求、檢視記錄的事件，並從特定事件開始偵錯。 如果檔案包含未處理的例外狀況，您可以選擇某個相互關聯識別碼，開始偵錯例外狀況。
請參閱：
擷取快照
您可以設定 IntelliTrace，以在每個中斷點和偵錯工具步驟事件擷取快照。 IntelliTrace 會記錄每個快照的完整應用程式狀態，這可讓您檢視複雜的變數並評估運算式。
注意
IntelliTrace 獨立收集器不支援擷取快照。
請參閱使用 IntelliTrace 檢查先前的應用程式狀態。
收集函式呼叫資訊
您可以設定讓 IntelliTrace 收集函式呼叫資訊。 這項資訊可讓您查看呼叫堆疊記錄，並讓您向後和向前逐步執行程式碼中的呼叫。 IntelliTrace 會針對每個函式呼叫記錄下列資料：
- 函式名稱
- 在函式進入點做為參數傳遞且在函式結束點傳回的基本資料類型值
- 讀取或變更時的自動屬性的值
- 第一層子物件的指標，但不含是否為 null 以外的值
注意
IntelliTrace 只會收集陣列中的前 256 個物件以及字串的前 256 個字元。
請參閱使用歷程偵錯檢查您的應用程式。
收集模組資訊
若要控制 IntelliTrace 收集呼叫資訊的數量，請僅指定您關心的模組。 這有助於改善應用程式在收集期間的效能。 請參閱 IntelliTrace 功能中的控制 IntelliTrace 所收集的資訊量一節。
IntelliTrace 是否會讓應用程式變慢？
根據預設，IntelliTrace 只會針對選取的 IntelliTrace 事件收集資料。 根據程式碼的結構和組織，這不一定會讓您的應用程式變慢。 例如，如果 IntelliTrace 時常記錄某個事件，這可能會讓應用程式變慢。 它也可能會讓您考慮重構應用程式。
收集呼叫資訊可能會使應用程式明顯變慢， 也可能會增加要儲存至磁碟之任何 IntelliTrace 記錄檔 (.iTrace 檔案) 的大小。 若要將這些影響降至最低，請只針對您關注的那些模組收集呼叫資訊。 若要變更 .iTrace 檔案的大小上限，請移至 [工具]、[選項]、[IntelliTrace]、[進階]。
部落格
論壇
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應