Configurar arquivos de log para monitoramento e solução de problemas no Teams

  • Artigo
  • Aplica-se a:
    Microsoft Teams

Há três tipos de arquivos de log produzidos automaticamente pelo cliente, que podem ser aproveitados para ajudar no monitoramento e na solução de problemas do Teams:

Este artigo descreve esses logs e como eles são usados. Para obter informações sobre como solucionar problemas específicos, consulte: Solução de problemas do Teams.

Para obter informações sobre como coletar logs de dispositivos Salas do Microsoft Teams, consulte Baixar logs do dispositivo.

Para obter informações sobre como contatar o suporte, consulte Obter suporte.

Nota

Neste artigo, o termo Logs de depuração (também chamados de logs da Web) refere-se aos logs usados para solução de problemas. No entanto, os arquivos gerados para esses logs conterão o termo logs de diagnóstico em seus nomes.

Visão geral dos logs

É importante coletar logs assim que ocorrer um problema.

Ao criar uma solicitação de suporte com o Suporte da Microsoft, o engenheiro de suporte precisará dos registros de depuração. Ter os logs de depuração em mãos antes de criar a solicitação de suporte permitirá que a Microsoft comece a solucionar o problema rapidamente. Os logs de mídia ou área de trabalho só são necessários se solicitados pela Microsoft.

Coleção de logs

Os logs de depuração/Web, Área de Trabalho e Mídia serão coletados em uma pasta com o nome MSTeams Diagnostics Log <local date and time> que será colocado em seu diretório Downloads. Essa pasta pode ser compactada e compartilhada quando você abre uma solicitação de suporte com Suporte da Microsoft. A pasta conterá pastas para Área de Trabalho, Reunião (Mídia) e Depuração (Web).

Para coletar logs para Windows:

  • Selecione o ícone do Microsoft Teams na bandeja do sistema e selecione Coletar arquivos de suporte.

Para coletar logs para Mac:

  • Selecione o menu Ajuda no Microsoft Teams e selecione Coletar arquivos de suporte.

Para coletar logs para Linux:

  • Selecione o ícone do Microsoft Teams na bandeja do sistema e selecione Obter Logs.

Você também pode coletar os arquivos usando os seguintes atalhos de teclado: Windows e Linux: Ctrl + Alt + Shift + 1 Mac: Option + Command + Shift + 1

Se ocorrer um problema com uma reunião específica ou evento ao vivo, é útil ter a URL associada à reunião. A URL fornece informações adicionais para ajudar a identificar a reunião exata ou o evento ao vivo nos logs. Essas informações podem ser coletadas de qualquer participante para uma reunião ou de apresentador ou produtor para um evento ao vivo. Essa URL pode ser capturada pairando sobre a URL de junção e escolhendo Copiar Hiperlink.

A tabela a seguir descreve os vários clientes e seus logs associados. Antes de serem coletados, os arquivos de log são armazenados na pasta de aplicativo do Teams, com o local da pasta sendo específico para o cliente e o sistema operacional.

  • Windows: %appdata%\Microsoft\Teams\
  • Mac: ~/Library/Application Support/Microsoft/Teams/
  • Linux: ~/.config/Microsoft/Microsoft Teams/
Cliente Depuração Depuração contínua Desktop Mídia
Web X - - -
Windows X X X X
Mac OSX X X X X
iOS - - - -
Android - - - -

Para obter uma lista completa dos sistemas operacionais e navegadores compatíveis, consulte Obter clientes para o Microsoft Teams.

Registros de depuração

Os logs de depuração (também chamados de logs da Web) são produzidos pelos clientes da área de trabalho do Windows e mac, bem como por clientes baseados em navegador. Os logs são baseados em texto e são lidos de baixo para cima. Eles podem ser lidos usando qualquer editor baseado em texto, e novos logs são criados ao efetuar o registro em log no cliente.

Os registros de depuração mostram os seguintes fluxos de dados:

  • Login
  • Solicitações de conexão para serviços de nível intermediário
  • Chamada/conversa

Logs de depuração contínua

O registro em log de depuração contínua (também chamado de log contínuo da Web) é um recurso que ajuda a capturar dados de log transferindo automaticamente logs da memória para o sistema de arquivos de forma contínua. Em média, haverá um dia inteiro de dados de log disponíveis quando habilitados. Os logs são lidos de cima para baixo.

O log de Depuração/Web contínuo será ativado por padrão na área de trabalho do Teams para computadores se sua CPU for:

  • Intel Core i3 e Core i5 (geração 10 ou superior), Core i7 e Core i9 (qualquer geração), excluindo os seguintes sufixos: U, Y, G1-G7, UE, UL, M e QM
  • Intel Xeon
  • Séries AMD Ryzen 5, 7, 9 e TR, excluindo o sufixo U
  • Apple Silicon

Caso contrário, ele será desativado por padrão.

Configuração de Administração

O gerenciamento de depuração contínua/registro em log da Web para seus usuários finais fornece uma experiência de solução de problemas contínua, especialmente quando os problemas são intermitentes. Os administradores podem usar o cmdlet TeamsMediaLoggingPolicy para habilitar e gerenciar o log de Depuração/Web Contínua para usuários.

Consulte Grant-CsTeamsMediaLoggingPolicy para cmdlets do PowerShell e mais informações.

Registros de mídia

Os registros de mídia contêm dados de diagnóstico sobre áudio, vídeo e compartilhamento de tela nas reuniões do Teams. Eles são necessários para casos de suporte vinculados a problemas relacionados a chamadas.

O log de mídia será ativado por padrão para computadores se sua CPU for:

  • qualquer Apple M1
  • qualquer Intel Xeon
  • qualquer Intel i9, exceto para as séries U, G7, M e MQ
  • qualquer Intel i7 de 6ª geração e posterior, com exceção das séries U, G7, M e MQ

Caso contrário, ele será desativado por padrão. Há duas maneiras de registrar dados de diagnóstico para reuniões do Teams:

  • Administração configuração – você pode gerenciar logs de mídia para seus usuários finais
  • Configuração do usuário final – seus usuários finais podem ativar logs de mídia

Nota

Os logs de mídia não estão disponíveis em plataformas baseadas em WebRTC (clientes do Teams Browser e Equipes Clássicas para VDI com mídia otimizada). Consulte Logs do Navegador e rastreamento do Teams para obter instruções sobre como coletar logs webRTC adicionais em clientes do Navegador. Entre em contato com seu provedor de VDI para obter instruções sobre como coletar logs WebRTC ao usar o Teams para VDI.

Administração configuração

O gerenciamento de logs de mídia para seus usuários finais fornece uma experiência de solução de problemas contínua, especialmente quando os problemas são intermitentes. Os administradores podem usar o cmdlet TeamsMediaLoggingPolicy para habilitar e gerenciar o registro em log de mídia para usuários.

Consulte Grant-CsTeamsMediaLoggingPolicy para cmdlets do PowerShell e mais informações.

Configuração do usuário final

Para que os usuários finais façam log de dados de diagnóstico para reuniões do Teams, eles devem ativar a opção no cliente do Teams. Eles irão para Configurações>Gerais, selecionarão a caixa Habilitar logs de mídia (dados de diagnóstico para áudio, vídeo e compartilhamento de tela marcar) e reproduzirão o problema.

Nota

Quando seus usuários saem do Teams, o registro em log de mídia é redefinido para o padrão.

Registros de desktop

Os logs da área de trabalho, também conhecidos como logs de bootstrapper, contêm dados de log que ocorrem entre o cliente da área de trabalho e o navegador. Como os logs de mídia, esses logs só são necessários se solicitados pela Microsoft. Os logs são baseados em texto e podem ser lidos usando qualquer editor baseado em texto em um formato de cima para baixo.

Solução de problemas do Teams

Logs do navegador e rastreamento do Teams