Microsoft Teams
-
Citrix Director 中的 Microsoft Teams 控制面板可显示所有用户的 Microsoft Teams 呼叫情况，以及参与者详细信息和指示呼叫性能的指标。此控制面板提供以下功能：
- 评估 Microsoft Teams 使用情况摘要
- 筛选并查看选定持续时间内的 Microsoft Teams 呼叫详细信息
-
使用性能指标评估单个呼叫
先决条件
将 Microsoft Graph 应用程序编程接口 (API) 添加到 Citrix Director 中的允许列表：
- 为使 Director 能够访问呼叫记录，请确保安装 Director 的所有计算机上都可进行出站 Internet 访问。具体而言，请确保可访问 https://graph.microsoft.com URL。
- 如果使用代理服务器，请确保可访问 Microsoft Graph API：https://graph.microsoft.com URL。
入门
连接到 Microsoft Graph API
Microsoft 呼叫详细信息是从 Microsoft Graph API 中获取的。为使 Citrix Director 能够访问该 API，需要在 Microsoft Entra ID 中创建具有所需权限的应用程序。Graph API URL 也需要添加到 Director 中的允许列表。
执行以下步骤以完成连接：
步骤 1：在 Microsoft Entra ID 中注册应用程序
-
在 Microsoft Entra ID 中，导航到 App registrations（应用注册）-> New registration（新建注册）。
- 执行应用程序注册所需的步骤。
- 注册后，复制应用程序的客户端 ID 和租户 ID。
步骤 2：在 Microsoft Entra ID 中添加 Microsoft Graph 权限
- 导航到 API permissions（API 权限）-> Add a permission（添加权限）。
-
选择 Microsoft Graph，然后选择 Application permissions（应用程序权限）。
-
添加 CallRecords.Read.All 和 User.Read.All 权限。
-
单击 Grant admin consent for MSFT（授予 MSFT 管理员同意）。此操作需要 Entra ID 全局管理员。
步骤 3：创建客户端机密
-
在 Microsoft Entra ID 中，导航到 Certificates & secrets（证书和机密）-> Client secrets（客户端机密）-> New client secret（新建客户端机密）。您也可以重复使用现有机密。
- 为机密提供名称和过期日期。确保在过期前续订机密以保持连接。
- 复制客户端机密以在 Director UI 中使用。
有关详细信息，如果遇到任何问题，请参阅官方 Azure 文档。
步骤 4：在 Director 上完成连接
-
在 Director 中，导航到 Settings（设置）-> Connect real-time communications apps（连接实时通信应用）。
-
单击 Create connection（创建连接），然后输入从应用程序注册中复制的应用程序 ID、目录 ID 和客户端机密。
-
如果提供了有效的凭据和权限以获取呼叫详细信息，则连接成功建立。
-
- 您可以通过单击行末尾的省略号来编辑和删除连接。
Microsoft Teams 控制面板
- 导航到 Director UI 中的 Real time Communications（实时通信）选项卡。Microsoft Teams 控制面板将填充从已建立的 Microsoft Graph 连接收集的数据。呼叫详细信息在呼叫结束后大约 15 分钟内可用。
表格视图提供所有呼叫的以下详细信息。
| 列名称 | 描述 |
|---|---|
| 呼叫 ID | 每个呼叫的唯一标识符。 |
| 呼叫类型 | 指示呼叫是点对点呼叫还是群组呼叫。 |
| 模式 | 指示呼叫期间使用的模式，例如音频、视频或屏幕共享。 |
| 开始时间 | 呼叫开始的日期和时间。 |
| 结束时间 | 呼叫结束的日期和时间。 |
| 持续时间（分:秒） | 呼叫的持续时间（以分钟和秒为单位）。 |
单击表格中的单个呼叫以查看每个用户的故障和性能详细信息。
在群组呼叫中，当用户断开连接并重新加入时，这被视为一个单独的会话。此考量有助于识别特定问题，例如连接到特定网络时延迟较高。
呼叫详细信息表中的每一行都包含以下信息：
| 列名称 | 描述 |
|---|---|
| 开始时间 | 呼叫或参与者会话开始的日期和时间。 |
| 往返时间（平均） | 数据包的平均往返时间。 |
| 数据包丢失率（平均） | 呼叫期间丢失的数据包的平均百分比。 |
| 抖动（平均） | 接收数据包延迟的平均变化。 |
| 故障阶段 | 指示呼叫发生故障的阶段，例如在设置期间或呼叫过程中。 |
| 结束时间 | 呼叫或参与者会话结束的日期和时间。 |
| 呼叫方 | 呼叫中参与者的姓名。 |
| 带宽估算（平均） | 呼叫期间使用的估计平均带宽。 |
您可以通过两种方式筛选用户：按 Citrix 用户名或按 Microsoft Teams 用户名。您可以使用页面顶部的单选按钮在这两个选项之间切换。
- Citrix 用户名：当您开始键入用户名时，系统会建议匹配的用户。然后，您可以选择特定帐户以查看详细信息。
- Microsoft Teams 用户名：如果与 Microsoft Teams 帐户关联的电子邮件或用户主体名称 (UPN) 与 Citrix 帐户 ID 不同，请使用此选项。使用此方法时，您必须输入完整且有效的电子邮件地址。
故障排除
-
为什么载入失败并显示错误“Azure API blocked. To create a connection, add Azure API to your allow list”（Azure API 已阻止。要创建连接，请将 Azure API 添加到允许列表）？
解决方案：确保您已遵循先决条件并将 Microsoft Graph API 终结点添加到允许列表。
-
为什么在查看呼叫时会看到错误“Microsoft Graph API blocked”（Microsoft Graph API 已阻止）？
解决方案：确保您已遵循先决条件并将 Microsoft Graph API 终结点添加到允许列表。
-
为什么“Connections”（连接）屏幕显示“Missing required application permissions in Microsoft Entra ID”（Microsoft Entra ID 中缺少所需的应用程序权限）？
解决方案：验证是否已将应用程序权限 CallRecords.Read.All 和 User.Read.All 分配给 Entra ID 应用程序。