交易搜尋和診斷

Azure 監視器的 Application Insights 會提供交易搜尋，用於找出特定的遙測項目和交易診斷，以進行完整的端對端交易分析。

交易搜尋：此體驗可讓使用者尋找及檢查個別的遙測項目，例如頁面檢視、例外狀況和 Web 要求。 此外也可讓您檢視編碼至應用程式中的記錄追蹤和事件。 這可用來識別應用程式內的效能問題和錯誤。

交易診斷：透過全面深入解析端對端交易詳細資料，包括相依性和例外狀況，快速識別元件中的問題。 透過搜尋介面並從搜尋結果中選擇項目，以存取這項功能。

交易搜尋

交易搜尋是 Application Insights 的一項功能，可用來尋找及探索個別遙測項目，例如頁面檢視、例外狀況或 Web 要求。 您也可以檢視您編碼的記錄追蹤和事件。

若要對您的資料執行更複雜的查詢，請使用 Log Analytics。

「搜尋」在哪裡？

您可以在 Azure 入口網站或 Visual Studio 中找到 [搜尋]。

在 Azure 入口網站中

您可以從應用程式的 Application Insights [概觀] 索引標籤中開啟交易搜尋。 您也可以選取左側功能表上 [調查] 下的 [搜尋]。

移至 [事件類型] 下拉式功能表，以查看遙測項目的清單，例如伺服器要求、頁面檢視，以及您已編碼的自訂事件。 [結果] 清單頂端有摘要圖表，其中顯示一段時間的事件計數。

退出下拉式功能表，或選取 [重新整理] 以取得新的事件。

在 Visual Studio 中

在 Visual Studio 中，也有 [Application Insights 搜尋] 視窗。 它最適合顯示您偵錯的應用程式所產生的遙測事件。 還可以顯示 Azure 入口網站上從您已發佈的應用程式收集的事件。

在 Visual Studio 中，開啟 [Application Insights 搜尋] 視窗：

[Application Insights 搜尋] 視窗有與 Web 入口網站類似的功能：

當您開啟要求或頁面檢視時，可以看到 [追蹤作業] 索引標籤。 「作業」是與單一要求或頁面檢視相關聯的一連串事件。 例如，相依性呼叫、例外狀況、追蹤記錄和自訂事件可能都是單一作業的一部分。 針對要求或頁面檢視，[追蹤作業] 索引標籤會以圖形顯示這些事件的時刻和持續時間。

檢查個別項目

選取任何遙測項目來查看重要欄位和相關項目。

端對端交易詳細資料檢視隨即開啟。

篩選事件類型

開啟 [事件類型] 下拉式功能表，然後選擇您想要查看的事件類型。 如果您想要稍後還原篩選，則請選取 [重設]。

事件類型包括：

• 追蹤：診斷記錄，包括 TrackTrace、log4Net、NLog 和 System.Diagnostic.Trace 呼叫。
• 要求：伺服器應用程式收到的 HTTP 要求，包括頁面、指令碼、影像、樣式檔案和資料。 這些事件是用來建立要求和回應概觀圖表。
• 頁面檢視：遙測是由 Web 用戶端傳送，用來建立頁面檢視報表。
• 自訂事件：如果您已插入 TrackEvent() 呼叫來監視使用量，則可以在這裡進行搜尋。
• 例外狀況：未捕捉到伺服器中的例外狀況，以及您使用 TrackException() 所記錄的例外狀況。
• 相依性：從伺服器應用程式呼叫其他服務 (例如 REST API 或資料庫)，以及來自用戶端程式碼的 AJAX 呼叫。
• 可用性：可用性測試的結果

依據屬性值篩選

您可以依屬性的值篩選事件。 可用的屬性因您所選取的事件類型而定。 選取 [篩選] 以啟動。

如果未針對特定屬性選擇任何值，則相當於選擇全部的值。 這樣會關掉該屬性的篩選功能。

篩選器值右側的計數顯示目前篩選的集合中有多少個出現次數。

尋找具有相同屬性的事件

若要尋找具有相同屬性值的所有項目，請在 [搜尋] 方塊中輸入屬性，或在 [篩選] 索引標籤上查看屬性時選取此核取方塊。

搜尋資料

注意

若要撰寫更複雜的查詢，請開啟 [搜尋] 窗格頂端的記錄 (分析)。

您可以搜尋任何屬性值中的字詞。 如果您撰寫具有屬性值的自訂事件，則此功能十分有用。

您可能想要設定時間範圍，因為對一小段範圍進行的搜尋較為快速。

請搜尋完整單字，而不是子字串。 使用引號來括住的特殊字元。

String	未找到	已找到
HomeController.About	home controller out	homecontroller about "homecontroller.about"
美國	Uni ted	united states united AND states "united states"

您可以使用下列搜尋運算式：

範例查詢	影響
apple	在時間範圍中尋找欄位含有 apple 這個字的所有事件。
apple AND banana apple banana	尋找同時含有這兩個字的事件。 使用大寫 AND，而非 and。 簡短格式。
apple OR banana	尋找含有任一單字的事件。 使用 OR，而不是 or。
apple NOT banana	尋找含有一個字但不含另一個字的事件。

取樣

如果您的應用程式產生大量遙測，並使用 ASP.NET SDK 2.0.0-beta3 版或更新版本，則會自動透過調適型取樣來減少傳送至入口網站的資料量。 此模組只會傳送代表性的小部分事件。 其會選取或取消選取與群組相同要求相關的事件，讓您在相關事件之間瀏覽。

了解取樣。

建立工作項目

您可以利用來自任何遙測項目的詳細資料，在 GitHub 或 Azure DevOps 中建立 Bug。

選取任何遙測項目，以移至端對端交易詳細資料檢視。 然後選取 [建立工作項目]。

當您第一次執行此步驟時，系統會要求您設定與 Azure DevOps 組織和專案的連結。 您也可以在 [工作項目] 索引標籤上設定連結。

傳送更多遙測到 Application Insights

除了 Application Insights SDK 傳送的內建遙測，您可以：

• 在 .NET 或 Java 中，從您最喜愛的紀錄架構擷取記錄追蹤。 這表示您可以搜尋您的記錄追蹤，並將它們與頁面檢視、例外狀況和其他事件相互關聯。

• 編寫程式碼以傳送自訂事件、頁面檢視和例外狀況。

了解如何將記錄和自訂遙測傳送至 Application Insights。

常見問題集

尋找常見問題的解答。

保留多少資料？

請參閱限制摘要。

我如何查看我的伺服器要求中的 POST 資料？

我們不會自動記錄 POST 資料，但您可以使用 TrackTrace 或記錄呼叫。 將 POST 資料放在訊息參數中。 您無法像篩選屬性一樣來篩選訊息，但大小限制比較長。

為什麼我的 Azure 函式搜尋不會傳回任何結果？

Azure Functions 不會記錄 URL 查詢字串。

交易診斷

整合診斷體驗會自動地將所有 Application Insights 監視元件的伺服器端遙測資料相互關聯為單一檢視。 就算您有多個資源也無妨。 Application Insights 能偵測基礎關聯性，讓您輕鬆診斷出導致交易緩慢或失敗的應用程式元件、相依性或例外狀況。

什麼是元件？

元件是分散式或微服務應用程式中可獨立部署的組件。 開發人員和作業小組可在程式碼層級查看或存取這些應用程式元件所產生的遙測。

• 元件不同於小組或組織可能無法存取 (程式碼或遙測) 的「已觀察」外部相依性，例如 SQL 和事件中樞。
• 元件能在任何數量的伺服器、角色或容器執行個體上執行。
• 元件可以是個別的 Application Insights 檢測金鑰，即使訂閱不同也一樣。 元件也可以是向單一 Application Insights 檢測金鑰的不同角色。 新體驗能顯示所有元件的詳細資料，不論設定方式為何。

注意

是否遺失相關項目連結？ 所有相關遙測都位於左側的頂端和底部區段中。

交易診斷體驗

此檢視有四個主要部分：

• 結果清單
• 跨元件交易圖表
• 與此作業相關的所有遙測的時間序列清單
• 任何所選遙測項目的詳細資料窗格

跨元件交易圖表

該圖表提供時間軸 (於要求期間以水平橫條呈現) 以及元件之間的相依性。 所有收集到的例外狀況也會標示在時間軸上。

• 此圖表上的頂端資料列代表進入點。 這是對於此交易中內送的第一個元件所發出的傳入要求。 持續時間是交易完成所需的總時間。
• 所有外部相依性的呼叫都是不可折疊的簡單資料列，並以圖示代表相依性類型。
• 其他元件的呼叫是可折疊的資料列。 每個資料列都會對應到在元件叫用的特定作業。
• 依據預設，您選取的要求、相依性或例外狀況會顯示在側邊。 選取任何資料列即可查看詳細資料。

注意

其他元件的呼叫有兩個資料列。 一個資料列代表來自呼叫端元件的輸出呼叫 (相依性)。 另一個資料列對應至所呼叫元件上的輸入要求。 主要圖示和樣式分明的持續時間橫條有助於區分兩者。

此作業識別碼的所有遙測

此區段會以此交易所有相關遙測的時間序列顯示一般清單檢視。 此外，也會顯示交易圖表中未顯示的自訂事件和追蹤。 您可以篩選這份清單，以顯示由特定元件或呼叫產生的遙測。 您可以選取清單中的任何遙測項目，並在側邊查看對應的詳細資料。

所選遙測的詳細資料

這個可摺疊的窗格會顯示交易圖表或清單中任何選取項目的詳細資料。 [全部顯示] 能列出所有收集到的標準屬性。 任何自訂屬性都會分別列在標準集合下方。 選取 [呼叫堆疊追蹤] 視窗下的省略號按鈕 (...)，以取得複製追蹤的選項。 [開啟分析工具追蹤] 和 [開啟偵錯快照集] 會在對應的詳細資料窗格中顯示程式碼等級的診斷資料。

搜尋結果

這個可摺疊的窗格會顯示符合篩選準則的其他結果。 選取任何結果，即可更新先前三個區段的個別詳細資料。 我們試著找出最可能具有所有元件可用詳細資料的範例 (即使任何一個已有生效的取樣功能)。 這些範例會顯示為建議。

分析工具和快照集偵錯工具

Application Insights 分析工具或快照集偵錯工具能協助您從程式碼等級診斷效能和失敗問題。 透過這項體驗，只須選取單一項目，您就可以查看任何元件的分析工具追蹤或快照集。

如果無法使用分析工具，請連絡 serviceprofilerhelp@microsoft.com。

如果無法使用快照偵錯工具，請連絡 snapshothelp@microsoft.com。

常見問題集

本節提供常見問題的答案。

為什麼我在圖表上看到單一元件，而其他元件只會顯示為外部相依性，而沒有任何詳細資料？

可能的原因：

• 您是否曾使用 Application Insights 檢測其他元件？
• 使用的是否為最新的穩定版 Application Insights SDK？
• 如果這些元件是個別的 Application Insights 資源，請確認您有存取權。 如果您擁有存取權，而且元件是由最新的 Application Insights SDK 進行檢測，請透過右上角的意見反應管道告訴我們。

我看到重複的相依性資料列。 這是不是預期行為？

目前，我們會分別顯示輸出相依性呼叫和輸入要求。 這兩項呼叫看起來通常會一樣，唯一的差異在於持續時間值會因網路來回時間而有所不同。 主要圖示和樣式分明的持續時間橫條有助於區分兩者。 用這樣的方法呈現資料是否會混淆？ 請提供意見給我們！

不同的元件執行個體之間有時鐘誤差嗎？

交易圖表中的時間軸已調整過時鐘誤差。 您可以在 [詳細資料] 窗格中或使用 Analytics 來查看確切的時間戳記。

為什麼新體驗遺漏大部分的相關項目查詢？

這是依照設計的行為。 左側 (上方和下方區段) 已有全部元件的所有相關項目。 新體驗的左側未涵蓋兩項相關項目：此事件前後五分鐘的所有遙測資料和使用者時間軸。

當我使用 Application Insights JavaScript SDK 時，是否有辦法查看每個交易的事件較少？

交易診斷體驗會顯示單一作業中共用作業識別碼的所有遙測。 根據預設，Application Insights SDK for JavaScript 會為每個唯一的頁面檢視建立新作業。 在單頁應用程式 (SPA) 中，只會產生一個頁面檢視事件，且單一作業識別碼將用於產生的所有遙測。 因此，許多事件可能會與相同的作業相互關聯。

在這些案例中，您可以使用自動路由追蹤，在您的 SPA 中自動建立用於瀏覽的新作業。 您必須開啟 enableAutoRouteTracking，以便在每次更新 URL 路由時產生頁面檢視 (會發生邏輯頁面檢視)。 如果您想要手動重新整理作業識別碼，請呼叫 appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId()。 手動觸發 PageView 事件也會重設作業識別碼。

為什麼交易詳細資料持續時間不會新增至最高要求持續時間？

甘特圖中未說明的時間為追蹤相依性未涵蓋的時間。 此問題可能是因為未自動或手動檢測外部呼叫。 也可能是因為所花費的時間是在處理中，而不是因為外部呼叫所花費的時間。

如果已檢測所有呼叫，則同處理序很可能是花費時間的根本原因。 Application Insights 分析工具為診斷程序的實用工具。

如果我在瀏覽 Azure 入口網站中的 Application Insights 時看到錯誤擷取資料訊息，該怎麼辦？

此錯誤表示瀏覽器無法呼叫所需的 API，或 API 傳回失敗回應。 若要針對此行為進行疑難排解：請開啟瀏覽器的 InPrivate 視窗，並停用正在執行的任何瀏覽器延伸模組，然後確認您是否仍然可以重現入口網站行為。 如果入口網站仍會發生錯誤，請嘗試使用其他瀏覽器或其他機器進行測試，並從 API 呼叫會失敗的用戶端機器來調查 DNS 或其他網路相關問題。 如果入口網站錯誤持續發生且需要更多調查，請在重現非預期的入口網站行為時收集瀏覽器網路追蹤，然後從 Azure 入口網站建立支援案例。

另請參閱

• 在分析中撰寫複雜的查詢
• 將記錄和自訂遙測傳送至 Application Insights
• 可用性概觀