在 Teams 中設定記錄檔以進行監視和疑難解答
用戶端會自動產生三種類型的記錄檔,可用於協助監控和疑難解答 Teams:
本文將說明這些記錄檔及其使用方式。 如需疑難解答特定問題的相關信息,請參閱: Teams 疑難解答。
如需從 Microsoft Teams 會議室裝置收集記錄的相關信息,請參閱 下載裝置記錄檔。
如需如何連絡客戶支援的相關信息,請參閱 取得支援。
注意事項
在本文中, 偵錯記錄 (也稱為網頁記錄) 是指用於疑難解答的記錄檔。 不過,針對這些記錄所產生的檔案名稱中會包含字詞 診斷記錄 檔。
記錄概觀
問題發生時,請務必立即收集記錄。
使用Microsoft支援建立支援要求時,支持工程師將需要偵錯記錄檔。 建立支援要求之前,請先備有偵錯記錄檔,可讓Microsoft快速開始疑難解答問題。 只有Microsoft要求時,才需要媒體或桌面記錄。
記錄集合
偵錯/Web、桌面和媒體記錄檔會收集在一個資料夾中,名稱為 MSTeams Diagnostics Log <local date and time,該日期和時間> 會放在您的下載目錄中。 當您向Microsoft支援人員開啟支援要求時,可以壓縮並共用此資料夾。 資料夾會包含桌面、會議 (媒體) 和偵錯 (Web) 的資料夾。
- 若要收集 Windows 的記錄:
- 選取系統匣中的 [Microsoft Teams] 圖示,然後選取 [收集支持檔案]。
- 若要收集 Mac 的記錄:
- 選取 Teams Microsoft 的 [說明] 功能表,然後選取 [收集支援檔案]。
- 若要收集 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 會議中音訊、視訊和螢幕共用的診斷數據。 連結到通話相關問題的支援案例是必要的。
注意事項
在 [新增 Teams] 中,由於效能改進和優化,預設會啟用媒體記錄。 媒體記錄沒有使用者或系統管理員控制件。
如果您的 CPU 為:在傳統 Teams 中,電腦的媒體記錄預設為開啟:
- 任何 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要求時才需要這些記錄。 記錄檔是以文字為基礎的,可以使用任何由上而下格式的文字編輯器來朗讀。