Share via

Diagnostic logs for Teams Client

  • Applies to: Microsoft Teams

Important

This article describes a Microsoft Teams feature that isn't released, but is announced and coming soon. If you're an admin, you can find out when this feature is released in the Message Center (in the Microsoft 365 admin center). For more information, see: Remote log collection. This article provides an overview of the new tool for Teams admins to collect diagnostic logs for Teams clients from the Microsoft Teams admin center.

This feature is currently supported for Windows (non-VDI) and Mac Applications only.

Diagnostic data from clients is essential for triaging and mitigating problems. To streamline problem resolution, reduce overhead, and avoid end user interruptions, we're giving admins the ability to remotely gather diagnostic logs from Teams clients without end-user interruptions. Admins can now remotely collect diagnostic logs from users’ machines from the users page in the Microsoft Teams admin center.

Steps to gather diagnostic logs

  1. Go to the Users tab on the left-hand navigation menu, and then select Manage users. Once there, navigate to the specific user page of the user you need diagnostic logs collected from.
  2. On the user page, the Client health tab provides more information about client health for all client versions that user is running.
  3. This page also allows you to gather diagnostic logs from a specific device or multiple devices.
  4. Choose the client and version you want to collect diagnostic logs from and select the Request client logs option.
  5. Once log collection is started, the Client log status column on this page will be set to Pending.
  6. Once log collection is complete, you can download and share the logs with your team or Microsoft, and you can also view the collected logs. You can also view the status for all logs collected within your tenant.
  7. You can also view the status for all logs collected within your tenant.

A screenshot of the log collection page showing the steps to gather diagnostic logs outlined in this section of the article.

Devices that use a government cloud account

Client log collection isn't supported on devices that have both commercial and government cloud accounts added simultaneously to the Teams client.

A screenshot of the log collection page showing Ineligible under the Client log status column.

Manage Logs

  1. Selecting View client logs from the Teams client health page lets you view the status for all logs collected in your tenant.
  2. This page shows tabs for in-progress and ready to download log requests.
  3. You can also delete one or all logs collected using the Delete option.

A screenshot of logs download page showing logs that are ready for download, and another tab show logs with the request in progress

Supported Log Types

Remote log collection supports the following log types:

  1. Web logs which include diagnostics logs, calling logs, central data layer logs, Web Media log

  2. Desktop Logs that include Shell Diagnostics logs, Slimcore logs including media stack logs

Note

We do not collect procmon traces and OS Event Logs that require elevated user access.

Further Information

  • These logs are stored for 30 days.
  • Logs are stored in a Microsoft secure and compliant storage ___location.
  • User consent isn't required and no prompt or message is shown to users when logs are collected.
  • The types of logs collected are client logs and shell logs (media logs). There are no screenshots or heaps collected.
  • Provided Teams client is running, logs may take up to 8 hours before they are fully available for download in Teams Admin center. Please check back after some time to see the log status.  Future enhancements are planned to reduce this time.