Use log files in troubleshooting Microsoft Teams
There are three types of log files automatically produced by the client that can be leveraged to assist in troubleshooting Microsoft Teams.
When creating a support request with Microsoft Support, the support engineer will require the debug logs. Having these logs on hand before creating the support request will allow Microsoft to quickly start troubleshooting the problem. Media or desktop logs are only required if requested by Microsoft.
The following table outlines the various clients, and their associated logs. Log files are stored in locations specific to the client and operating system.
For a complete list of supported operating systems and browsers, see Get clients for Microsoft Teams.
These are the most common logs and are required for all Microsoft support cases. Debug logs are produced by the Windows and Mac desktop clients, as well as browser based clients. The logs are text based and are read from the bottom up. They can be read using any text based editor and new logs are created when logging into the client.
Debug logs show the following data flows:
Connection requests to middle tier services
The debug logs are produced using the following OS specific methods:
Keyboard shortcut: Ctrl + Alt + Shift + 1
Keyboard shortcut: Option + Command + Shift+1
The debug logs are automatically downloaded to the following folders.
Mac OSX: Downloads
Browser: You will be prompted to save the debug log to default save location
Media logs contain diagnostic data about audio, video and screen sharing. They are required for support cases only upon request and can only be inspected by Microsoft. The following table outlines the log location.
|Mac OSX||~/Library/Application Support/Microsoft/Teams/media-stack*.blog|
Desktop logs, also known as bootstrapper logs, contains log data that occurs between the desktop client and the browser. Like media logs, these logs are only needed if requested by Microsoft. The logs are text based and can be read using any text based editor in a top down format.
- Right-click the Microsoft Teams icon in your application tray, select Get Logs
- Choosing Get Logs from the Help pull-down menu
|Mac OSX||~/Library/Application Support/Microsoft/Teams/logs.txt|
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.