Configurare i file di log per il monitoraggio e la risoluzione dei problemi in Teams

  • Articolo
  • Si applica a:
    Microsoft Teams

Esistono tre tipi di file di log prodotti automaticamente dal client, che possono essere usati per assistere nel monitoraggio e nella risoluzione dei problemi di Teams:

Questo articolo descrive questi log e come vengono usati. Per informazioni sulla risoluzione di problemi specifici, vedere: Risoluzione dei problemi di Teams.

Per informazioni sulla raccolta di log da Microsoft Teams Rooms dispositivi, vedere Scaricare i log dei dispositivi.

Per informazioni su come contattare il supporto tecnico, vedere Ottenere supporto.

Nota

In questo articolo, il termine Log di debug,denominato anche log Web, fa riferimento ai log usati per la risoluzione dei problemi. Tuttavia, i file generati per questi log conterranno i termini log diagnostici nei loro nomi.

Panoramica dei log

È importante raccogliere i log non appena si verifica un problema.

Quando si crea una richiesta di supporto con supporto tecnico Microsoft, il tecnico del supporto richiederà i log di debug. Avere a portata di mano i log di debug prima di creare la richiesta di supporto consentirà a Microsoft di avviare rapidamente la risoluzione del problema. I log multimediali o desktop sono necessari solo se richiesto da Microsoft.

Raccolta log

I log di debug/Web, desktop e multimediali verranno raccolti in un'unica cartella con il nome data e ora> locali del log <di diagnostica MSTeams, che verranno inserite nella directory Download. Questa cartella può essere compressa e condivisa quando apri una richiesta di supporto con supporto tecnico Microsoft. La cartella conterrà le cartelle Desktop, Riunione (elementi multimediali) e Debug (Web).

Per raccogliere i log per Windows:

  • Selezionare l'icona Di Microsoft Teams sulla barra delle applicazioni e quindi selezionare Raccogli file di supporto.

Per raccogliere i log per Mac:

  • Selezionare il menu ? in Microsoft Teams e quindi selezionare Raccogli file di supporto.

Per raccogliere i log per Linux:

  • Selezionare l'icona Di Microsoft Teams sulla barra delle applicazioni e quindi scegliere Ottieni log.

Puoi anche raccogliere i file usando i seguenti tasti di scelta rapida: Windows e Linux: CTRL + ALT + MAIUSC + 1 Mac: Opzione + Comando + MAIUSC + 1

Se si verifica un problema con una riunione o un evento live specifico, è utile avere l'URL associato alla riunione. L'URL fornisce informazioni aggiuntive per identificare la riunione esatta o l'evento live nei log. Queste informazioni possono essere raccolte da qualsiasi partecipante per una riunione o dal relatore o produttore per un evento live. Questo URL può essere acquisito passando il puntatore sull'URL del join e scegliendo Copia collegamento ipertestuale.

La tabella seguente illustra i vari client e i relativi log associati. Prima di essere raccolti, i file di log vengono archiviati nella cartella dell'app Teams e la posizione della cartella è specifica per il client e il sistema operativo.

  • Finestre: %appdata%\Microsoft\Teams\
  • Mac: ~/Library/Application Support/Microsoft/Teams/
  • Linux: ~/.config/Microsoft/Microsoft Teams/
Client Eseguire il debug Debug continuo Desktop Elementi multimediali
Web X - - -
Windows X X X X
Mac OSX X X X X
iOS - - - -
Android - - - -

Per un elenco completo dei browser e dei sistemi operativi supportati, vedere Ottenere client per Microsoft Teams.

Eseguire il debug dei log

I log di debug (detti anche log Web) vengono prodotti dai client desktop di Windows e Mac, nonché dai client basati su browser. I log sono basati su testo e vengono letti dal basso verso l'alto. Possono essere letti usando qualsiasi editor basato su testo e vengono creati nuovi log quando si accede al client.

I log di debug mostrano i flussi di dati seguenti:

  • Login
  • Richieste di connessione ai servizi di livello intermedio
  • Chiamata/conversazione

Log di debug continui

La registrazione di debug continua (detta anche registrazione Web continua) è una funzionalità che consente di acquisire i dati del log trasferendo automaticamente i log dalla memoria al file system in modo continuo. In media, i dati di log sono disponibili per un'intera giornata se abilitati. I log vengono letti dall'alto verso il basso.

La registrazione di debug/Web continua è attivata per impostazione predefinita su Teams desktop per i computer se la CPU è:

  • Intel Core i3 e Core i5 (generazione 10 o successiva), Core i7 e Core i9 (qualsiasi generazione), esclusi i suffissi seguenti: U, Y, G1-G7, UE, UL, M e QM
  • Intel Xeon
  • SERIE AMD Ryzen 5, 7, 9 e TR, escluso il suffisso U
  • Apple Silicon

In caso contrario, è disattivato per impostazione predefinita.

Configurazione Amministrazione

La gestione della registrazione di debug/Web continua per gli utenti finali offre un'esperienza di risoluzione dei problemi senza problemi, soprattutto quando i problemi sono intermittenti. Gli amministratori possono usare il cmdlet TeamsMediaLoggingPolicy per abilitare e gestire la registrazione di debug/Web continua per gli utenti.

Vedere Grant-CsTeamsMediaLoggingPolicy per i cmdlet di PowerShell e altre informazioni.

Registri multimediali

I log multimediali contengono dati diagnostici su audio, video e condivisione dello schermo nelle riunioni di Teams. Sono necessari per i casi di supporto collegati a problemi relativi alle chiamate.

La registrazione multimediale è attivata per impostazione predefinita per i computer in cui la CPU è:

  • qualsiasi Apple M1
  • qualsiasi Intel Xeon
  • qualsiasi Intel i9, ad eccezione delle serie U, G7, M e MQ
  • qualsiasi 6a generazione e successive Intel i7, ad eccezione delle serie U, G7, M e MQ

In caso contrario, è disattivato per impostazione predefinita. Esistono due modi per registrare i dati di diagnostica per le riunioni di Teams:

  • configurazione Amministrazione: è possibile gestire i log multimediali per gli utenti finali
  • Configurazione dell'utente finale: gli utenti finali possono attivare i log multimediali

Nota

I log multimediali non sono disponibili nelle piattaforme basate su WebRTC (client Browser di Teams e Teams classico per VDI con supporti ottimizzati). Per istruzioni sulla raccolta di log WebRTC aggiuntivi nei client browser, vedere Log del browser e traccia per Teams . Contattare il provider VDI per istruzioni sulla raccolta di log WebRTC quando si usa Teams per VDI.

configurazione Amministrazione

La gestione dei log multimediali per gli utenti finali offre un'esperienza di risoluzione dei problemi senza problemi, soprattutto quando i problemi sono intermittenti. Gli amministratori possono usare il cmdlet TeamsMediaLoggingPolicy per abilitare e gestire la registrazione dei file multimediali per gli utenti.

Vedere Grant-CsTeamsMediaLoggingPolicy per i cmdlet di PowerShell e altre informazioni.

Configurazione dell'utente finale

Per consentire agli utenti finali di registrare i dati di diagnostica per le riunioni di Teams, devono attivare l'opzione nel client Teams. Passeranno a Impostazioni>generali, selezioneranno la casella di controllo Abilita log multimediali (dati di diagnostica per audio, video e condivisione dello schermo) e riprodurranno il problema.

Nota

Quando gli utenti si disconnetteno da Teams, la registrazione multimediale viene reimpostata come predefinita.

Log desktop

I log desktop, noti anche come log del bootstrapper, contengono dati di log che si verificano tra il client desktop e il browser. Analogamente ai log multimediali, questi log sono necessari solo se richiesti da Microsoft. I log sono basati su testo e possono essere letti usando qualsiasi editor basato su testo in un formato dall'alto verso il basso.

Risoluzione dei problemi di Teams

Log del browser e traccia per Teams