Microsoft Teams
Das Microsoft Teams-Dashboard in Citrix Director bietet Einblick in Microsoft Teams-Anrufe über Benutzer hinweg, zusammen mit Details zu den Teilnehmern und Metriken, die die Anrufleistung anzeigen. Das Dashboard bietet die Möglichkeit, Folgendes zu tun:
- Zusammenfassung der Microsoft Teams-Nutzung bewerten
- Details zu Microsoft Teams-Anrufen für den ausgewählten Zeitraum filtern und anzeigen
- Einzelne Anrufe anhand von Leistungsmetriken bewerten
Voraussetzungen
Fügen Sie die Microsoft Graph Application Programming Interface (API) zur Zulassungsliste in Citrix Director hinzu:
- Damit Director auf Anrufaufzeichnungen zugreifen kann, stellen Sie sicher, dass auf allen Maschinen, auf denen Director installiert ist, ausgehender Internetzugang verfügbar ist. Stellen Sie insbesondere sicher, dass die URL https://graph.microsoft.com zugänglich ist.
- Wenn Sie einen Proxyserver verwenden, stellen Sie sicher, dass die Microsoft Graph API-URL: https://graph.microsoft.com zugänglich ist.
Erste Schritte
Verbindung zur Microsoft Graph API
Die Microsoft-Anrufdetails werden von der Microsoft Graph API abgerufen. Damit Citrix Director auf die API zugreifen kann, muss eine App in der Microsoft Entra ID mit den erforderlichen Berechtigungen erstellt werden. Die Graph API-URL muss ebenfalls zur Zulassungsliste in Director hinzugefügt werden.
Führen Sie die folgenden Schritte aus, um die Verbindung herzustellen:
Schritt 1: Anwendungsregistrierung in Microsoft Entra ID
-
Navigieren Sie in Microsoft Entra ID zu App registrations -> New registration.
- Führen Sie die erforderlichen Schritte für die App-Registrierung aus.
- Kopieren Sie nach der Registrierung die Client-ID und die Tenant-ID der Anwendung.
Schritt 2: Hinzufügen von Microsoft Graph-Berechtigungen in Microsoft Entra ID
- Navigieren Sie zu API permissions -> Add a permission.
-
Wählen Sie Microsoft Graph und dann Application permissions.
-
Fügen Sie Berechtigungen für CallRecords.Read.All und User.Read.All hinzu.
-
Klicken Sie auf Grant admin consent for MSFT. Diese Aktion erfordert einen globalen Entra ID-Administrator.
Schritt 3: Erstellen eines Client-Geheimnisses
-
Navigieren Sie in Microsoft Entra ID zu Certificates & secrets -> Client secrets -> New client secret. Sie können auch ein vorhandenes Geheimnis wiederverwenden.
- Geben Sie einen Namen und ein Ablaufdatum für das Geheimnis an. Stellen Sie sicher, dass das Geheimnis vor Ablauf erneuert wird, um die Verbindung aufrechtzuerhalten.
- Kopieren Sie das Client-Geheimnis zur Verwendung in der Director-Benutzeroberfläche.
Weitere Informationen finden Sie in der offiziellen Azure-Dokumentation, falls Probleme auftreten.
Schritt 4: Verbindung in Director abschließen
-
Navigieren Sie in Director zu Settings -> Connect real-time communications apps.
-
Klicken Sie auf Create connection und geben Sie die kopierte Anwendungs-ID, Verzeichnis-ID und das Client-Geheimnis aus der App-Registrierung ein.
Die Verbindung wird erfolgreich hergestellt, wenn gültige Anmeldeinformationen und Berechtigungen zum Abrufen von Anrufdetails verfügbar sind.
-
Sie können die Verbindung bearbeiten (Edit) und löschen (Delete), indem Sie auf die Ellipse am Ende der Zeile klicken.
Microsoft Teams-Dashboard
Navigieren Sie in der Director-Benutzeroberfläche zur Registerkarte Real time Communications. Das Microsoft Teams-Dashboard wird mit den Daten gefüllt, die über die hergestellte Microsoft Graph-Verbindung gesammelt wurden. Anrufdetails sind etwa 15 Minuten nach Beendigung des Anrufs verfügbar.
Die Tabellenansicht bietet die folgenden Details für alle Anrufe.
| Spaltenname | Beschreibung | |————-|————-| | Anruf-ID | Eine eindeutige Kennung für jeden Anruf. | | Anruftyp | Gibt an, ob der Anruf Peer-to-Peer oder ein Gruppenanruf ist. | | Modalität | Gibt an, welche Modi während des Anrufs verwendet werden, z. B. Audio, Video oder Bildschirmfreigabe. | | Startzeit | Datum und Uhrzeit des Anrufbeginns. | | Endzeit | Datum und Uhrzeit des Anrufendes. | | Dauer (mm: ss) | Dauer des Anrufs in Minuten und Sekunden. |
Klicken Sie in der Tabelle auf einzelne Anrufe, um die Fehler- und Leistungsdetails pro Benutzer anzuzeigen.
In einem Gruppenanruf wird es als separate Sitzung betrachtet, wenn ein Benutzer die Verbindung trennt und wieder beitritt. Diese Betrachtung hilft, spezifische Probleme zu identifizieren, wie z. B. eine höhere Latenz bei Verbindung mit einem bestimmten Netzwerk.
Jede Zeile in der Anrufdetails-Tabelle enthält die folgenden Informationen:
| Spaltenname | Beschreibung |
|---|---|
| Startzeit | Datum und Uhrzeit des Anruf- oder Teilnehmersegments. |
| Roundtrip-Zeit (Durchschnitt) | Durchschnittliche Roundtrip-Zeit für Datenpakete. |
| Paketverlustrate (Durchschnitt) | Durchschnittlicher Prozentsatz der während des Anrufs verlorenen Pakete. |
| Jitter (Durchschnitt) | Durchschnittliche Variation der Verzögerung empfangener Pakete. |
| Fehlerphase | Gibt die Phase an, in der ein Anruffehler aufgetreten ist, z. B. während der Einrichtung oder mitten im Anruf. |
| Endzeit | Datum und Uhrzeit des Anruf- oder Teilnehmersegments. |
| Anrufer | Name des Teilnehmers am Anruf. |
| Bandbreitenschätzung (Durchschnitt) | Geschätzte durchschnittliche Bandbreite, die während des Anrufs verwendet wurde. |
Sie können Benutzer auf zwei Arten filtern: nach Citrix-Benutzernamen oder nach Microsoft Teams-Benutzernamen. Sie können zwischen diesen Optionen mit den Optionsfeldern oben auf der Seite wechseln.
- Citrix-Benutzername: Wenn Sie einen Benutzernamen eingeben, schlägt das System passende Benutzer vor. Sie können dann das spezifische Konto auswählen, um Details anzuzeigen.
- Microsoft Teams-Benutzername: Verwenden Sie diese Option, wenn die E-Mail-Adresse oder der User Principal Name (UPN), der mit dem Microsoft Teams-Konto verknüpft ist, vom Citrix-Konto abweicht. Bei dieser Methode müssen Sie die vollständige und gültige E-Mail-Adresse eingeben.
Fehlerbehebung
-
Warum ist das Onboarding mit dem Fehler “Azure API blocked. To create a connection, add Azure API to your allow list” fehlgeschlagen?
Lösung: Stellen Sie sicher, dass Sie die Voraussetzungen erfüllt und den Microsoft Graph API-Endpunkt zu Ihrer Zulassungsliste hinzugefügt haben.
-
Warum wird der Fehler “Microsoft Graph API blocked” angezeigt, wenn ich Anrufe ansehe?
Lösung: Stellen Sie sicher, dass Sie die Voraussetzungen erfüllt und den Microsoft Graph API-Endpunkt zu Ihrer Zulassungsliste hinzugefügt haben.
-
Warum zeigt der Verbindungsbildschirm “Missing required application permissions in Microsoft Entra ID” an?
Lösung: Überprüfen Sie, ob die Anwendungsberechtigungen CallRecords.Read.All und User.Read.All der Entra ID-Anwendung zugewiesen sind.