使用 Azure SignalR Service 的即時追蹤工具

即時追蹤工具是單一 Web 應用程式，用於擷取和顯示 Azure SignalR Service 中的即時追蹤。 即時追蹤可以即時收集資料，無須相依於其他服務。

您可單獨選取以啟用和停用即時追蹤功能。 您也可以選擇感興趣的任何記錄類別。

注意

即時追蹤會計算為輸出訊息。

不支援使用 Microsoft Entra ID 存取即時追蹤工具。

開啟即時追蹤工具

當您啟用存取金鑰時，您可使用存取權杖來驗證即時追蹤工具。 否則，您會使用 Microsoft Entra ID 來驗證工具。

您可前往 Azure 入口網站中 Azure SignalR Service 的 [金鑰] 頁面，檢查您是否已啟用存取金鑰。

如果您啟用了存取金鑰，請執行以下步驟：

1. 移至 Azure 入口網站和 Azure SignalR Service 頁面。
2. 在左側功能表的 [監視] 下方，選取 [即時追蹤設定]。
3. 選取 [啟用即時追蹤]。
4. 選取 [儲存] 按鈕，然後等待變更生效。
5. 選取 [開啟即時追蹤工具]。

如果您未啟用存取金鑰，請執行下列步驟：

將即時追蹤工具 API 權限指派給自己

1. 移至 Azure 入口網站和 Azure SignalR Service 頁面。
2. 選取 [存取控制 (IAM)]。
3. 在新的頁面上，選取 [+新增]，然後選取 [角色指派]。
4. 在新的頁面上，選取 [作業函式角色] 索引標籤，選取 [SignalR Service 擁有者] 角色，然後選取 [下一步]。
5. 在 [成員] 頁面上，按一下 [+選取成員]。
6. 在新的面板上，搜尋並選取成員，然後按一下 [選取]。
7. 選取 [檢閱 + 指派]，然後等候完成通知。

開啟工具

1. 移至 Azure 入口網站和 Azure SignalR Service 頁面。
2. 在左側功能表的 [監視] 下方，選取 [即時追蹤設定]。
3. 選取 [啟用即時追蹤]。
4. 選取 [儲存] 按鈕，然後等待變更生效。
5. 選取 [開啟即時追蹤工具]。

使用您的 Microsoft 帳戶登入

1. 當 Microsoft 登入視窗在即時追蹤工具中開啟時，請輸入您的認證。 如果登入視窗沒有出現，請務必在瀏覽器中允許快顯視窗。
2. 等候 [就緒] 出現在狀態列上。

擷取即時追蹤

在即時追蹤工具中，您可以：

• 開始從 Azure SignalR Service 執行個體擷取即時追蹤。
• 清除所擷取的即時追蹤。
• 將即時追蹤匯出至檔案。 目前支援的檔案格式是 CSV。
• 使用一個特定關鍵字來篩選所擷取的即時追蹤。 如果有分隔符號 (例如空格、逗號或分號)，則會被視為關鍵字的一部分。

工具所擷取的即時追蹤包含疑難排解的詳細資訊。

名稱	描述
Time	記錄事件時間。
記錄層級	記錄事件層級：Trace、Debug、Informational、Warning 或 Error。
事件名稱	記錄事件的作業名稱。
訊息	記錄事件的詳細資訊。
例外狀況	Azure Web PubSub 服務的執行階段例外狀況。
中樞	使用者定義的中樞名稱。
連線識別碼	連線的身分識別。
連線類型	連線的類型。 允許的值為 Server (伺服器和服務間的連線)，以及 Client (用戶端和服務間的連線)。
使用者識別碼	使用者的身分識別。
IP	用戶端的 IP 位址。
伺服器黏性	用戶端的路由模式。 允許的值為 Disabled、Preferred 和 Required。 如需詳細資訊，請參閱 ServerStickyMode。
傳輸	用戶端可用來傳送 HTTP 要求的傳輸程序。 允許的值為 WebSockets、ServerSentEvents 和 LongPolling。 如需詳細資訊，請參閱 HttpTransportType。
訊息追蹤識別碼	訊息的唯一識別碼。
路由範本	API 的路由範本。
Http 方法	HTTP 方法：POST、GET、PUT 或 DELETE。
URL	統一資源定位器。
追蹤識別碼	表示要求的唯一識別碼。
狀態碼	HTTP 回應碼。
期間	接收和處理要求之間的持續時間。
標題	用戶端和伺服器使用 HTTP 要求或回應傳遞的其他資訊。
叫用識別碼	表示叫用的唯一識別碼 (僅適用於 ASP.NET SignalR)。
訊息類型	訊息類型。 範例包括 BroadcastDataMessage、JoinGroupMessage 和 LeaveGroupMessage。

下一步

了解如何使用即時追蹤工具來處理常見問題：

• 若要根據即時追蹤對一般問題進行疑難排解，請參閱疑難排解指南。
• 如需直接找出根本原因或縮小問題的自我診斷，請參閱疑難排解方法簡介。