实时通信仪表板
Microsoft Teams
-
Citrix Director 中的 Microsoft Teams 仪表板可提供跨用户的 Microsoft Teams 通话可见性,以及有关参与者和指示通话性能的指标的详细信息。该仪表板提供以下功能:
- 评估 Microsoft Teams 使用情况摘要
- 筛选并查看所选持续时间的 Microsoft Teams 通话详细信息
-
使用性能指标评估单个通话

先决条件
将 Microsoft Graph 应用程序编程接口 (API) 添加到 Citrix Director 中的允许列表:
-
为了让 Director 访问通话记录,请确保在安装 Director 的所有计算机上都可进行出站 Internet 访问。具体而言,请确保
https://graph.microsoft.comURL 可访问 -
如果您使用代理服务器,请确保 Microsoft Graph API:
https://graph.microsoft.comURL 可访问。
入门
连接到 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。

- 执行应用程序注册所需的步骤。
- 注册后,复制应用程序的 Client ID 和 Tenant ID。
步骤 2:在 Microsoft Entra ID 中添加 Microsoft Graph 权限
- 导航到 API permissions -> Add a permission。
- 选择 Microsoft Graph,然后选择 Application permissions。

- 添加 CallRecords.Read.All 和 User.Read.All 的权限。

- 单击“Grant admin consent for MSFT”。此操作需要 Entra ID 全局管理员。

步骤 3:创建客户端密钥
- 在 Microsoft Entra ID 中,导航到 Certificates & secrets > New client secret。您也可以重复使用现有密钥。

-
为密钥提供名称和过期日期。请确保在密钥过期前续订,以保持连接。
-
复制客户端密钥以在 Director UI 中使用。
有关详细信息,如果您遇到任何问题,请参阅官方 Azure 文档。
步骤 4:在 Director 上完成连接
- 在 Director 中,导航到 Settings -> Connect real-time communications apps。

-
- 单击“Create connection”,然后输入从应用程序注册中复制的 Application ID、Directory ID 和 Client Secret。

如果存在有效的凭据和获取通话详细信息的权限,则连接成功建立。

- 您可以通过单击行末尾的省略号来“编辑”和“删除”连接。
Microsoft Teams 仪表板
在 Director UI 中导航到“Real time Communications”选项卡。Microsoft Teams 仪表板将填充从已建立的 Microsoft Graph 连接收集的数据。通话结束后大约 15 分钟即可获取通话详细信息。

表格视图提供所有通话的以下详细信息。
| 列名称 | 描述 |
|---|---|
| 通话 ID | 每个通话的唯一标识符。 |
| 通话类型 | 指示通话是点对点通话还是群组通话。 |
| 模式 | 指示通话期间使用的模式,例如音频、视频或屏幕共享。 |
| 开始时间 | 通话开始的日期和时间。 |
| 结束时间 | 通话结束的日期和时间。 |
| 持续时间(mm:ss) | 通话的持续时间(分钟和秒)。 |
单击表中的单个通话以查看每个用户的故障和性能详细信息。

在群组通话中,当用户断开连接并重新加入时,这被视为一个单独的会话。此考量有助于识别特定问题,例如连接到特定网络时延迟较高。
通话详细信息表中的每一行都包含以下信息:
| 列名称 | 描述 |
|---|---|
| 开始时间 | 通话或参与者会话开始的日期和时间。 |
| 往返时间(平均) | 数据包的平均往返时间。 |
| 数据包丢失率(平均) | 通话期间丢失的数据包的平均百分比。 |
| 抖动(平均) | 接收数据包延迟的平均变化。 |
| 故障阶段 | 指示通话故障发生的阶段,例如在设置期间或通话过程中。 |
| 结束时间 | 通话或参与者会话结束的日期和时间。 |
| 呼叫者 | 通话中参与者的姓名。 |
| 带宽估算(平均) | 通话期间使用的估计平均带宽。 |
您可以通过两种方式筛选用户:按 Citrix 用户名或按 Microsoft Teams 用户名。您可以使用页面顶部的单选按钮在这两个选项之间切换。
-
Citrix 用户名: 当您开始键入用户名时,系统会建议匹配的用户。然后,您可以选择特定帐户以查看详细信息。
-
Microsoft Teams 用户名: 如果与 Microsoft Teams 帐户关联的电子邮件或用户主体名称 (UPN) 与 Citrix 帐户 ID 不同,请使用此选项。使用此方法时,您必须输入完整且有效的电子邮件地址。
