Citrix Virtual Apps and Desktops

Microsoft Teams

Il dashboard di Microsoft Teams in Citrix Director offre visibilità sulle chiamate di Microsoft Teams tra gli utenti, insieme ai dettagli sui partecipanti e alle metriche che indicano le prestazioni delle chiamate. Il dashboard offre la possibilità di:

  • Valutare il riepilogo dell’utilizzo di Microsoft Teams
  • Filtrare e visualizzare i dettagli delle chiamate di Microsoft Teams per la durata selezionata
  • Valutare le singole chiamate utilizzando le metriche delle prestazioni

Dashboard di Microsoft Teams

Prerequisiti

Aggiungere l’API (Application Programming Interface) di Microsoft Graph all’elenco consentiti in Citrix Director:

  • Affinché Director possa accedere ai record delle chiamate, assicurarsi che l’accesso a Internet in uscita sia disponibile su tutte le macchine in cui è installato Director. In particolare, assicurarsi che l’URL https://graph.microsoft.com sia accessibile
  • Se si utilizza un server proxy, assicurarsi che l’API Microsoft Graph: https://graph.microsoft.com sia accessibile.

Per iniziare

Connessione all’API Microsoft Graph

I dettagli delle chiamate Microsoft vengono recuperati dall’API Microsoft Graph. Affinché Citrix Director possa accedere all’API, è necessario creare un’app in Microsoft Entra ID con le autorizzazioni richieste. L’URL dell’API Graph deve essere aggiunto anche all’elenco consentiti in Director.

Eseguire i passaggi seguenti per completare la connessione:

Passaggio 1: Registrazione dell’applicazione in Microsoft Entra ID

  1. Accedere a Registrazioni app -> Nuova registrazione in Microsoft Entra ID.

    Nuova registrazione

  2. Eseguire i passaggi richiesti per la registrazione dell’app.
  3. Dopo la registrazione, copiare l’ID client e l’ID tenant dell’applicazione.

Passaggio 2: Aggiunta delle autorizzazioni di Microsoft Graph in Microsoft Entra ID

  1. Accedere a Autorizzazioni API -> Aggiungi un’autorizzazione.
  2. Selezionare Microsoft Graph e quindi Autorizzazioni applicazione.

    Microsoft Graph

  3. Aggiungere le autorizzazioni a CallRecords.Read.All e User.Read.All.

    Autorizzazioni di Microsoft Graph

  4. Fare clic su Concedi consenso amministratore per MSFT. Questa azione richiede un amministratore globale di Entra ID.

    Concedi consenso amministratore

Passaggio 3: Creazione di un segreto client

  1. In Microsoft Entra ID, accedere a Certificati e segreti -> Segreti client -> Nuovo segreto client. È anche possibile riutilizzare un segreto esistente.

    Nuovo segreto client

  2. Fornire un nome e una data di scadenza per il segreto. Assicurarsi che il segreto venga rinnovato prima della scadenza per mantenere la connessione.
  3. Copiare il segreto client per l’utilizzo nell’interfaccia utente di Director.

Per maggiori informazioni, consultare la documentazione ufficiale di Azure in caso di problemi.

Passaggio 4: Completare la connessione su Director

  1. In Director, accedere a Impostazioni -> Connetti app di comunicazione in tempo reale.

    Impostazioni

  2. Fare clic su Crea connessione e immettere l’ID applicazione, l’ID directory e il segreto client copiati dalla registrazione dell’app.

    Crea connessione

    La connessione viene stabilita correttamente se sono disponibili credenziali valide e autorizzazioni per recuperare i dettagli delle chiamate.

    Recupera dettagli

  3. È possibile Modificare ed Eliminare la connessione facendo clic sull’ellissi alla fine della riga.

Dashboard di Microsoft Teams

Accedere alla scheda Comunicazioni in tempo reale nell’interfaccia utente di Director. Il dashboard di Microsoft Teams viene popolato con i dati raccolti dalla connessione Microsoft Graph stabilita. I dettagli delle chiamate sono disponibili circa 15 minuti dopo la fine della chiamata.

Cronologia chiamate

La visualizzazione tabella fornisce i seguenti dettagli per tutte le chiamate.

Nome colonna Descrizione
ID chiamata Un identificatore univoco per ogni chiamata.
Tipo di chiamata Indica se la chiamata è peer-to-peer o una chiamata di gruppo.
Modalità Indica le modalità utilizzate durante la chiamata, come audio, video o condivisione schermo.
Ora di inizio La data e l’ora di inizio della chiamata.
Ora di fine La data e l’ora di fine della chiamata.
Durata (mm: ss) Durata della chiamata in minuti e secondi.

Fare clic sulle singole chiamate nella tabella per visualizzare i dettagli di errore e prestazioni per utente.

Chiamata individuale

In una chiamata di gruppo, quando un utente si disconnette e si ricollega, viene considerata come una sessione separata. Questa considerazione aiuta a identificare problemi specifici, come una latenza più elevata quando si è connessi a una rete particolare.

Ogni riga nella tabella dei dettagli delle chiamate contiene le seguenti informazioni:

Nome colonna Descrizione
Ora di inizio La data e l’ora di inizio della chiamata o del segmento del partecipante.
Tempo di andata e ritorno (media) Tempo medio di andata e ritorno per i pacchetti di dati.
Tasso di perdita pacchetti (media) Percentuale media di pacchetti persi durante la chiamata.
Jitter (media) Variazione media nel ritardo dei pacchetti ricevuti.
Fase di errore Indica la fase in cui si è verificato un errore di chiamata, ad esempio durante la configurazione o nel mezzo della chiamata.
Ora di fine Data e ora di fine della chiamata o del segmento del partecipante.
Chiamante Nome del partecipante alla chiamata.
Stima larghezza di banda (media) Larghezza di banda media stimata utilizzata durante la chiamata.

È possibile filtrare gli utenti in due modi: per nome utente Citrix o per nome utente di Microsoft Teams. È possibile passare da un’opzione all’altra utilizzando i pulsanti di opzione nella parte superiore della pagina.

  • Nome utente Citrix: quando si inizia a digitare un nome utente, il sistema suggerisce gli utenti corrispondenti. È quindi possibile selezionare l’account specifico per visualizzare i dettagli.
  • Nome utente di Microsoft Teams: utilizzare questa opzione se l’e-mail o il nome dell’entità utente (UPN) associato all’account Microsoft Teams è diverso dall’ID account Citrix. Quando si utilizza questo metodo, è necessario immettere l’indirizzo e-mail completo e valido.

Nome utente

Risoluzione dei problemi

  • Perché l’onboarding non è riuscito con l’errore “API di Azure bloccata. Per creare una connessione, aggiungere l’API di Azure all’elenco consentiti”?

    API di Azure bloccata

    Soluzione: assicurarsi di aver seguito i prerequisiti e di aver aggiunto l’endpoint dell’API Microsoft Graph all’elenco consentiti.

  • Perché visualizzo l’errore “API Microsoft Graph bloccata” durante la visualizzazione delle chiamate?

    API Microsoft bloccata

    Soluzione: assicurarsi di aver seguito i prerequisiti e di aver aggiunto l’endpoint dell’API Microsoft Graph all’elenco consentiti.

  • Perché la schermata Connessioni mostra “Autorizzazioni applicazione richieste mancanti in Microsoft Entra ID”?

    Autorizzazioni mancanti

    Soluzione: Verificare che le autorizzazioni dell’applicazione CallRecords.Read.All e User.Read.All siano assegnate all’applicazione Entra ID.

Microsoft Teams