配置用于在 Teams 中监视和故障排除的日志文件
客户端自动生成了三种类型的日志文件,可用于帮助监视和排查 Teams 问题:
本文介绍这些日志及其使用方式。 有关排查特定问题的信息,请参阅: Teams 故障排除。
有关从Microsoft Teams 会议室设备收集日志的信息,请参阅下载设备日志。
有关如何联系支持人员的信息,请参阅 获取支持。
注意
在本文中,术语 调试日志 (也称为 Web 日志) 是指用于故障排除的日志。 但是,为这些日志生成的文件的名称中包含术语 诊断日志 。
日志概述
一旦出现问题,请务必立即收集日志。
通过 Microsoft 支持创建支持请求时,支持工程师需要调试日志。 在创建支持请求之前,让 Microsoft 能够快速开始排查问题。 仅当 Microsoft 请求时,才需要媒体或桌面日志。
日志收集
调试/Web、桌面和媒体日志将收集到名为 MSTeams Diagnostics Log <本地日期和时间的文件夹中,该日期和时间> 将放置在下载目录中。 使用 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 客户端。
调试日志
调试日志 (也称为 Web 日志) 由 Windows 和 Mac 桌面客户端以及基于浏览器的客户端生成。 日志基于文本,从下到上读取。 可以使用任何基于文本的编辑器读取它们,并在登录到客户端时创建新日志。
调试日志显示以下数据流:
- 登录
- 对中间层服务的连接请求
- 通话/对话
持续调试日志
连续调试日志记录 (也称为连续 Web 日志记录) 是一项功能,它通过连续自动将日志从内存传输到文件系统来帮助捕获日志数据。 启用后,平均有一整天的日志数据可用。 日志是从上到下读取的。
如果 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 日志记录。
请参阅 PowerShell cmdlet 的 Grant-CsTeamsMediaLoggingPolicy 和详细信息。
媒体日志
媒体日志包含有关 Teams 会议中音频、视频和屏幕共享的诊断数据。 与呼叫相关的问题相关的支持案例需要它们。
如果 CPU 为,则计算机默认启用媒体日志记录:
- 任何 Apple M1
- 任何 Intel Xeon
- 任何 Intel i9,U、G7、M 和 MQ 系列除外
- 任何第 6 代及更高版本的 Intel i7,U、G7、M 和 MQ 系列除外
否则,默认情况下会将其关闭。 有两种方法可以记录 Teams 会议的诊断数据:
- 管理员配置 - 可以为最终用户管理媒体日志
- 最终用户配置 - 最终用户可以打开媒体日志
注意
媒体日志在基于 WebRTC 的平台上不可用, (Teams 浏览器客户端和具有优化媒体) 的 VDI 经典 Teams。 有关在浏览器客户端上收集其他 WebRTC 日志的说明,请参阅 Teams 的浏览器日志 和跟踪 。 有关在使用 Teams for VDI 时收集 WebRTC 日志的说明,请联系 VDI 提供程序。
管理员配置
为最终用户管理媒体日志提供了无缝的故障排除体验,尤其是在间歇性问题时。 管理员可以使用 TeamsMediaLoggingPolicy cmdlet 为用户启用和管理媒体日志记录。
请参阅 PowerShell cmdlet 的 Grant-CsTeamsMediaLoggingPolicy 和详细信息。
最终用户配置
最终用户必须打开 Teams 客户端中的 选项,才能记录 Teams 会议的诊断数据。 他们将转到“设置常规”>,选中“为音频、视频和屏幕共享启用媒体日志 (诊断数据) 检查”框,然后重现问题。
注意
当用户注销 Teams 时,媒体日志记录会重置为其默认值。
桌面日志
桌面日志(也称为引导程序日志)包含桌面客户端和浏览器之间发生的日志数据。 与媒体日志一样,仅当 Microsoft 要求时,才需要这些日志。 日志是基于文本的,可以使用任何自上而下格式的基于文本的编辑器进行读取。
相关主题
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈