在 Teams 中設定記錄檔以進行監視和疑難排解

  • 發行項
  • 適用於:
    Microsoft Teams

用戶端會自動產生三種類型的記錄檔，可用於協助監控和疑難排解 Teams：

本文將說明這些記錄檔及其使用方式。 如需疑難排解特定問題的相關資訊，請參閱： Teams 疑難排解。

如需從Microsoft Teams 會議室裝置收集記錄的相關資訊，請參閱下載裝置記錄。

如需如何連絡客戶支援的相關資訊，請參閱 取得支援。

注意事項

在本文中， 偵錯記錄 (也稱為網頁記錄) 是指用於疑難排解的記錄檔。 不過，針對這些記錄所產生的檔案名稱中會包含字詞 診斷記錄 檔。

記錄概觀

問題發生時，請務必立即收集記錄。

使用Microsoft 支援服務建立支援要求時，支援工程師將需要偵錯記錄檔。 建立支援要求之前，請先備有偵錯記錄檔，可讓 Microsoft 快速開始疑難排解問題。 只有 當 Microsoft 要求時，才需要媒體或 桌面 記錄。

記錄集合

偵錯/Web、桌面和媒體記錄檔會收集在一個資料夾中，名稱為MSTeams Diagnostics Log < local date and time，該日期和時間 >會放在您的下載目錄中。 當您使用Microsoft 支援服務開啟支援要求時，可以壓縮並共用此資料夾。 資料夾會包含桌面、會議 (媒體) 和偵錯 (Web) 的資料夾。

若要收集 Windows 的記錄：

  • 選取系統匣中的 Microsoft Teams 圖示，然後選取 [收集支援檔案]。

若要收集 Mac 的記錄：

  • 選取 Microsoft Teams 中的 [說明] 功能表，然後選取 [收集支援檔案]。

若要收集 Linux 的記錄：

  • 選取系統匣中的 Microsoft Teams 圖示，然後選取 [ 取得記錄]。

您也可以使用下列鍵盤快速鍵來收集檔案：Windows 和 Linux：Ctrl + Alt + Shift + 1 Mac：Option + Command + Shift + 1

如果特定會議或即時事件發生問題，將 URL 與會議相關聯會很有説明。 URL 會提供其他資訊，以協助找出記錄檔中的確切會議或即時事件。 您可以從會議的任何參與者或現場活動的簡報者或製作人收集這項資訊。 將游標暫留在聯結 URL 上並選擇 [複製超連結]，即可擷取此 URL。

下表概述各種用戶端及其相關聯的記錄。 在收集之前，記錄檔會儲存在 Teams 應用程式資料夾中，且該資料夾的位置是用戶端和作業系統的專屬位置。

  • 窗戶： %appdata%\Microsoft\Teams\
  • Mac： ~/Library/Application Support/Microsoft/Teams/
  • Linux： ~/.config/Microsoft/Microsoft Teams/
用戶端 調試 連續偵錯 桌面 媒體
Web X - - -
Windows X X X X
Mac OSX X X X X
iOS - - - -
Android - - - -

如需支援的作業系統和瀏覽器的完整清單，請參閱 取得 Microsoft Teams 的用戶端。

偵錯記錄

偵錯記錄 (也稱為網頁記錄) 是由 Windows 和 Mac 桌面用戶端以及瀏覽器型用戶端產生。 記錄檔是以文字為基礎，並從下往上朗讀。 您可以使用任何文字編輯器來讀取記錄，並在登入用戶端時建立新的記錄。

偵錯記錄會顯示下列資料流程：

  • 登錄
  • 對中介層服務的連線要求
  • 通話/交談

連續偵錯記錄

連續偵錯記錄 (也稱為持續網頁記錄) 是一項功能，可透過連續的方式自動將記錄檔從記憶體傳輸到檔案系統，以協助擷取記錄資料。 平均而言，啟用時會有一整天的記錄資料可用。 系統會從上到下朗讀記錄。

如果您的 CPU 為以下情況，Teams 電腦版的 [連續偵錯/Web 記錄] 預設為開啟：

  • Intel Core i3 和 Core i5 (第 10 代或更高) 、Core i7 和 Core i9 (任何一代) ，但下列尾碼除外：U、Y、G1-G7、UE、UL、M 和 QM
  • Intel Xeon
  • AMD Ryzen 5、7、9 和 TR 系列，不含 U 尾碼
  • Apple Silicon

否則，預設會關閉。

管理員設定]

為使用者管理持續偵錯/Web 記錄提供順暢的疑難排解體驗，尤其是當問題間歇性時。 系統管理員可以使用 TeamsMediaLoggingPolicy Cmdlet 來為使用者啟用和管理連續偵錯/Web 記錄。

如需詳細資訊，請參閱 Grant-CsTeamsMediaLoggingPolicy for PowerShell Cmdlet。

媒體記錄檔

媒體記錄檔包含 Teams 會議中音訊、視訊和螢幕共用的診斷資料。 連結到通話相關問題的支援案例是必要的。

如果您的 CPU 為：電腦的媒體記錄功能預設為開啟：

  • 任何 Apple M1
  • 任何 Intel Xeon
  • 任何 Intel i9，U、G7、M 和 MQ 系列除外
  • 除了 U、G7、M 和 MQ 系列之外，任何第 6 代及之後的 Intel i7

否則，預設會關閉。 有兩種方式可以記錄 Teams 會議的診斷資料：

  • 管理員設定 - 您可以管理使用者的媒體記錄
  • 使用者設定 - 您的使用者可以開啟媒體記錄

注意事項

在 WebRTC 平臺上無法使用媒體記錄， (Teams 瀏覽器用戶端，以及使用優化媒體) 的 VDI 版傳統版 Teams。 如需在瀏覽器用戶端上收集其他 WebRTC 記錄的相關指示，請參閱 Teams 的瀏覽器記錄和追蹤 。 使用 Teams for VDI 時，請連絡您的 VDI 提供者，取得收集 WebRTC 記錄檔的相關指示。

管理員設定

管理使用者的媒體記錄提供順暢的疑難排解體驗，尤其是當問題間歇性時。 系統管理員可以使用 TeamsMediaLoggingPolicy Cmdlet 為使用者啟用和管理媒體記錄。

如需詳細資訊，請參閱 Grant-CsTeamsMediaLoggingPolicy for PowerShell Cmdlet。

使用者設定

使用者必須開啟 Teams 用戶端中的選項，才能記錄 Teams 會議的診斷資料。 他們會移至 [一般設定> ]，選取 [啟用媒體記錄檔 (音訊、視訊和螢幕共用的診斷資料) 核取方塊，然後重現問題。

注意事項

當您的使用者登出 Teams 時，媒體記錄會重設為預設值。

桌面記錄檔

桌面記錄，也稱為啟動載入器記錄檔，包含會發生在桌面用戶端和瀏覽器之間的記錄資料。 這些記錄檔與媒體記錄一樣，只有在 Microsoft 要求時才需要。 記錄檔是以文字為基礎的，可以使用任何由上而下格式的文字編輯器來朗讀。

Teams 疑難排解

Teams 的瀏覽器記錄和追蹤