Usar arquivos de log para monitorar e solucionar problemas Microsoft Teams
Há três tipos de arquivos de log produzidos automaticamente pelo cliente, que podem ser aproveitados para auxiliar no monitoramento e na solução de problemas Teams:
Este artigo descreve esses logs e como eles são usados. Para obter informações sobre como solucionar problemas específicos, consulte: Teams solução de problemas. Para obter informações sobre como entrar em contato com o suporte, consulte Obter suporte. 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ó serão necessários se solicitados pela Microsoft.
Observação
Neste artigo, o termo Logs de depuração se refere 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.
Coletar e habilitar o registro em log
É importante coletar logs assim que ocorrer um problema. Os logs podem ser coletados com apenas alguns cliques.
Windows: clique com o botão direito do mouse no ícone Teams na bandeja do sistema e escolha Coletar arquivos de suporte.
Mac: selecione o menu Ajuda e escolha Coletar arquivos de suporte.
Os logs de depuração, área de trabalho e mídia serão coletados em uma pasta com o nome Log de Diagnóstico do MSTeams <local date and time>. 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). Você pode coletar os arquivos usando os seguintes atalhos de teclado:
Windows: Ctrl + Alt + Shift + 1
Mac: Option + Command + Shift + 1
O log de mídia é ativado por padrão apenas para algumas CPUs, descritas nos logs de mídia. Caso contrário, ele está desativado por padrão. Para habilitar o log de mídia, os usuários devem ativar a opção no Teams cliente. Vá para Configurações > General e selecione Habilitar registro em log para diagnóstico de reunião (requer a reinicialização Teams). O Teams cliente deve ser reiniciado para que o log seja iniciado (reinicie-o clicando com o botão direito do mouse no ícone no dock (Mac) ou na barra de tarefas (Windows) e selecionando Sair. Depois de sair, basta clicar no ícone do aplicativo para abri-lo novamente).
Se ocorrer um problema com uma reunião ou evento ao vivo específico, será útil ter a URL associada à reunião. Isso 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 de uma reunião ou do apresentador ou produtor de um evento ao vivo. Essa URL pode ser capturada passando o mouse sobre a URL de junção e escolhendo Copiar Hiperlink.
Observação
Se o log de mídia estiver habilitado, haverá arquivos adicionais incluídos na pasta Reunião que são necessários para investigar problemas de áudio e vídeo. Se o log de mídia não estiver habilitado, haverá um número limitado de logs disponíveis.
Observação
Os logs de depuração foram coletados anteriormente usando os atalhos de teclado abaixo. Eles ainda funcionam e concluirão a mesma captura de log que a opção Coletar arquivos de suporte .
Windows: Crtl + Alt + Shift + 1
Mac: Option + Command + Shift + 1
A tabela a seguir descreve os vários clientes e seus logs associados. Os arquivos de registro são armazenados os locais específicos do cliente e do sistema operacional.
| Cliente | Depuração | Desktop | Mídia |
|---|---|---|---|
| Web | X | - | - |
| Windows | X | X | X |
| Mac OSX | X | X | X |
| Linux | 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
Consulte a seção Coletar e habilitar o registro em log para Windows e instruções do Mac. Os logs de depuração são produzidos pelos clientes de desktop 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
Para coletar logs para Linux:
- Atalho de teclado: Ctrl + Alt + Shift + 1
- Os arquivos estarão disponíveis em
~/Downloads
Para coletar logs para Navegador e Windows:
- Atalho de teclado: Ctrl + Alt + Shift + 1
- Os arquivos estarão disponíveis em
%userprofile%\Downloads
Para coletar logs para Mac:
- Atalho de teclado: Opção + Comando + Shift + 1
- Os arquivos estarão disponíveis em
~/Downloads
Registros de mídia
Consulte a seção Coletar e habilitar o registro em log para Windows e instruções do Mac. 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 é ativado por padrão para computadores se a CPU for:
- qualquer Apple M1
- qualquer Intel Xeon
- qualquer Intel i9, exceto para as séries U, G7, M e MQ
- qualquer 6ª geração e posterior Intel i7, exceto para as séries U, G7, M e MQ
Caso contrário, ele será desativado por padrão. Para registrar dados de diagnóstico para reuniões do Teams, os usuários devem ativar a opção no cliente Teams. Vá para Configurações > Gerais, marque a caixa de seleção Habilitar registro para diagnóstico de reunião (requer a reinicialização do Teams), reinicie o Teams e reproduza o problema.
Observação
Quando você sai do Teams, o log de mídia é redefinido para seu padrão.
Ao enviar os arquivos de log para o suporte da Microsoft, verifique a data e hora dos arquivos de log para garantir que os logs abrangem o período de tempo em que você reproduziu o problema.
Para coletar logs para Linux:
- Os arquivos estarão disponíveis nos seguintes locais:
~/.config/Microsoft/Microsoft Teams/media-stack/\*\.blog~/.config/Microsoft/Microsoft Teams/skylib/\*\.blog
Para coletar logs para Windows:
- Os arquivos estarão disponíveis nos seguintes locais:
%appdata%\Microsoft\Teams\media-stack\\\*\.blog%appdata%\Microsoft\Teams\skylib\\\*\.blog
Para coletar logs para Mac:
- Os arquivos estarão disponíveis nos seguintes locais:
~/Library/Application Support/Microsoft/Teams/media-stack\\\*\.blog~/Library/Application Support/Microsoft/Teams/skylib\\\*\.blog
Aqui está uma lista dos arquivos de log gerados e as informações que eles contêm.
| Nome do arquivo de log | Descrição |
|---|---|
Teams.msrtc-0-s1039525249.blog |
Contém informações relacionadas à pilha de mídia. Isso inclui o status do canal, como resolução, decodificadores e codificadores usados e o número de quadros enviados e recebidos, além do status da sessão de compartilhamento de tela com base em vídeo e câmera (VBSS). |
rtmcontrol.msrtc-0-2415069487.blog |
Registra informações relacionadas a ações de controle remoto, como o carimbo de hora quando o controle é fornecido e informações do ponteiro do mouse. |
Teams_MediaStackETW-2-U-xr-U.etl |
Registra eventos de rastreamento de pilha de mídia. |
Debug-0-s2790420889.blog |
Contém informações relacionadas ao agente de mídia, incluindo qualidade de renderização. |
tscalling-0-2061129496.blog |
Registra eventos na API de chamada de ts. |
Registros de desktop
Consulte a seção Coletar e habilitar o registro em log para Windows e instruções do Mac. 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.
Para coletar logs para Linux:
- Clique no ícone do Microsoft Teams na bandeja do sistema e selecione Obter Logs.
- Os arquivos estarão disponíveis em
~/.config/Microsoft/Microsoft Teams/logs.txt.
Para coletar logs para Mac:
- Clique no menu Ajuda no Microsoft Teams e selecione Coletar arquivos de suporte.
- O
logs.txtarquivo estará na pasta Área de Trabalho dentro da pasta Log <local date and time>de Diagnóstico do MSTeams.
Para coletar logs para Windows:
- Clique no ícone Microsoft Teams na bandeja do sistema e selecione Coletar arquivos de suporte.
- O
logs.txtarquivo será aberto em Bloco de notas automaticamente.
Ao investigar problemas ao entrar no Teams, talvez seja necessário coletar manualmente os logs da área de trabalho. Esses arquivos de log estão localizados em %appdata%\Microsoft\Teams no Windows.
Rastreamento do navegador
Para algumas categorias de erros, Suporte da Microsoft exigir que você colete um rastreamento do navegador. Essas informações podem fornecer detalhes importantes sobre o estado do Teams cliente quando o erro ocorre.
Antes de iniciar o rastreamento do navegador, verifique se você está conectado ao Teams. É importante fazer isso antes de iniciar o rastreamento para que o rastreamento não contenha informações confidenciais de entrada.
Depois de entrar, selecione um dos links a seguir, conforme apropriado para seu navegador, e siga as etapas fornecidas.
Observação
Nas etapas, substitua todas as referências ao portal do Azure pelo Teams cliente.
Logs do WebRTC em navegadores
Os logs do WebRTC podem ajudar Suporte da Microsoft fornecendo detalhes de conexão para chamadas de áudio e vídeo. Siga as etapas para acessar os logs do WebRTC no Edge (Chromium) ou chrome:
Abra uma nova guia e vá para uma das seguintes URLs:
- Borda (Chromium):
edge://webrtc-internals/ - Chrome:
chrome://webrtc-internals/
- Borda (Chromium):
Abra o Teams web e reproduza o problema.
Voltar à guia que foi acessada na etapa 1 e você verá pelo menos duas guias:
- Solicitações GetUserMedia
https://teams.microsoft.com/url
Escolha a guia com o nome do aplicativo Teams e salve o conteúdo da página.