若要充分利用通话质量仪表板 (CQD) 和其他呼叫报告工具，建议上传生成和终结点数据。 可以使用生成文件来自定义 Teams 呼叫报告，其中包含托管网络特有的信息，例如网络名称和物理位置详细信息。 可以使用终结点文件提供有关托管设备群的信息，例如制造、型号和资产标记。
访问“生成和终结点数据”页
若要访问“生成和终结点数据”页，请执行以下步骤：
- 转到 Microsoft Teams 管理中心。
- 从导航窗格中 选择“分析”& 报表 > “”生成和终结点数据 ”。
- 在此页中，可以上传新文件并查看已上传的文件列表。 还可以从列表中选择任何上传的文件来下载、删除文件或编辑其有效时间段。
上传生成和终结点文件
若要上传生成或终结点文件，必须先创建文件。 可以下载 示例租户数据模板 以开始使用示例文件。 有关生成映射的帮助，请参阅 创建用于报告的构建图 ，并查看有关生成和终结点文件结构的以下部分。
准备好生成文件或终结点文件后，请执行以下步骤：
在 Teams 管理中心，导航到 “分析”& 报表>生成和终结点数据 ，然后选择“ 上传”。
从 “上传建筑物或终结点数据 ”菜单中，为要上传的文件类型选择 “生成 ”或“ 终结点 ”，然后选择“ 上传 ”以选择文件。
选择数据文件后，指定 开始日期。 还可以选择“ 指定结束日期 ”以提供可选的结束日期。 仅在指定开始日期之后和指定结束日期之前发生的调用 (（如果提供) ）才会包含文件的信息。
指定开始日期和可选结束日期后，选择“ 应用 ”以上传文件。 在上传文件之前，会对其进行验证。 如果验证失败，将显示一条错误消息，要求更正文件。
如果在验证过程中未发生错误，则上传的文件将开始处理。 然后，可以在主页面上的表中看到已上传的数据文件，其中显示了当前租户的所有已上传文件的完整列表。
注意
完成处理生成文件最多可能需要 4 小时。
如果已上传生成文件，并且需要添加可能已错过或排除的子网，请通过添加新子网来修改原始文件，删除当前文件，然后重新上传新编辑的文件。
生成数据文件
第一种类型的租户数据文件是 生成 数据文件。 此文件中的信息为呼叫报告提供了重要的上下文，例如托管网络的网络名称和物理位置详细信息。 上传文件后，将使用 “网络 IP ”和“ 网络范围 ”列来处理该文件，以生成扩展的子网列表。 通话质量仪表板等工具使用此子网列表，使用每个参与者的子网信息将文件信息填充到呼叫数据中。
上传的数据文件的格式必须满足以下条件才能在上传之前通过验证检查：
该文件必须是 .tsv 文件， (列由 TAB) 分隔，或者 .csv 文件 (列用逗号) 分隔。
数据文件不包含表标题行。 数据文件的第一行应是真实数据，而不是像“网络”这样的标题标签。
文件中的数据类型只能为字符串、整数或布尔值。 对于 Integer 数据类型，该值必须是数值。 布尔值必须为 0 或 1。
如果列使用 String 数据类型，则数据字段可以为空，但仍必须使用制表符或逗号分隔这些字段。 空数据字段仅分配一个空的 String 值。
每个租户数据文件有 1,000,000 个扩展行限制。
每行必须有 15 列，每列必须具有适当的数据类型，并且列必须按下表中列出的顺序 (逗号或制表符分隔) ：
生成数据文件格式
| 列名称 | 数据类型 | 示例 | 指引 |
|---|---|---|---|
| NetworkIP | String | 192.168.1.0 | 必需 |
| NetworkName | String | USA/Seattle/SEATTLE-SEA-1 | 必需 |
| NetworkRange | 数字 | 26 | 必需 |
| BuildingName | String | SEATTLE-SEA-1 | 必需 |
| OwnershipType | String | Contoso | 可选1 |
| BuildingType | String | IT 终止 | 可选1 |
| BuildingOfficeType | String | 工程 | 可选1 |
| 城市 | String | 西雅图 | 推荐 |
| ZipCode | String | 98001 | 推荐 |
| 国家 | String | 我们 | 推荐 |
| 省/市/自治区 | String | WA | 推荐 |
| 区域 | String | MSUS | 推荐 |
| InsideCorp | Bool | 1 | 必需 |
| ExpressRoute2 | Bool | 0 | 必需 |
| VPN | Bool | 0 | 可选 |
1 虽然这些可选列的命名是为了建议你可能需要使用哪些值来填充它们，但你可以自定义用法以用于其他目的，例如：网络优先级 - Tier 1, Tier 2, Tier 3。
2 此设置可用于反映网络是否使用 Azure ExpressRoute。 可以出于其他目的自定义使用情况。
示例行：
192.168.1.0,USA/Seattle/SEATTLE-SEA-1,26,SEATTLE-SEA-1,Contoso,IT Termination,Engineering,Seattle,98001,US,WA,MSUS,1,0,0
重要
网络范围可用于表示一个超级网络，或者表示具有单个路由前缀的多个子网的组合。 检查所有新的生成上传是否存在任何重叠范围。 如果之前已上传生成文件，则应下载当前文件并重新上传，以识别任何重叠并修复问题，然后再再次上传。 以前上传的文件中的任何重叠都可能导致在报表中错误地将子网映射到建筑物。 某些 VPN 实现不会准确报告子网信息。
VPN 列是可选的，默认为 0。 如果 VPN 列的值设置为 1，则由该行表示的子网将完全展开，以匹配子网中的所有 IP 地址。 请谨慎且仅对 VPN 子网使用此值，因为完全扩展这些子网会对涉及生成数据的查询的查询时间产生负面影响。 如果子网的扩展导致超过 1,000,000 行限制的行计数，则不接受生成文件。
Supernetting
可以使用超级网络（通常称为无类 Inter-Domain 路由 (CIDR) ）来代替定义每个子网。 超级网络是共享单个路由前缀的多个子网的组合。 可以使用超网地址，而不是为每个子网添加条目。 支持超网络，但我们不建议使用它。
例如，Contoso 的营销构建由以下子网组成：
- 10.1.0.0/24 - 一楼
- 10.1.1.0/24- 二楼
- 10.1.2.0/24-三楼
- 10.1.3.0/24 - 四楼
可以使用超网地址（在此示例中为 10.1.0.0/22），而不是为每个子网添加条目。
- 网络 = 10.1.0.0
- 网络范围 = 22
以下是在实现超网之前需要考虑的一些事项：
超网络只能在具有 8 位到 28 位掩码的子网映射中使用。
超网络预先花费的时间更少，但代价是降低数据的丰富性。 假设子网 10.1.2.0 存在质量问题。 如果实现了超网络，则不知道子网在生成中的哪个位置，也不知道子网 (的网络类型，例如实验室) 。 如果为建筑物定义了所有子网并上传了楼层位置信息，则可以看到该区别。
请务必确保超网地址正确且不会捕获不需要的子网。
在数据中找到 192.168.0.0 很常见。 对于许多组织，子网指示用户在家中。 对于其他子网，此子网是附属办公室的 IP 地址方案。 如果组织确实有使用此配置的办公室，请不要将其包含在生成文件中，因为很难通过使用 通用子网来区分家庭网络和内部网络。
重要
网络范围可用于表示超级网络。 将检查所有新的生成数据文件上传是否存在任何重叠范围。 如果之前已上传生成文件，则应下载当前文件并再次上传，以识别任何重叠并修复问题。 以前上传的文件中的任何重叠都可能导致在报表中错误地将子网映射到建筑物。
VPN
客户端发送到 Microsoft 365 或 Office 365（CQD 数据的来源） (QoE) 数据的体验质量包括 VPN 标志。 CQD 将此数据视为第一个 VPN 和第二个 VPN 维度。 但是，此标志依赖于 VPN 供应商向 Windows 报告注册的 VPN 网络适配器是远程访问适配器。 并非所有 VPN 供应商都正确注册远程访问适配器。 因此，可能无法使用内置 VPN 查询筛选器。 使用上面讨论的 VPN 列准确标记和标识 VPN 子网。 最好是标记 VPN 网络，以便在报表中轻松识别。
如何标记 VPN 子网的示例：
通过在此字段中为 VPN 子网输入“VPN”来定义 网络名称 。
通过在此字段中为 VPN 子网输入“VPN”来定义 建筑物名称 。
注意
已知当基础连接为无线时，VPN 连接错误地将网络连接类型视为有线连接。 通过 VPN 连接查看质量时，无法假设已准确识别连接类型。
终结点数据文件
另一种类型的数据文件是 终结点 数据文件。 此文件允许你为 Teams 通话和会议中使用的设备定义用户终结点“制造”、“型号”和“类型”信息。 文件中的 EndpointName 列应反映设备名称，并且与呼叫质量仪表板列“第一个客户端终结点名称”和“第二个客户端终结点名称”匹配，以填充 CQD 报表中的数据。
上传的数据文件的格式必须满足以下条件才能在上传之前通过验证检查：
该文件必须是 .tsv 文件， (列由 TAB) 分隔，或者 .csv 文件 (列用逗号) 分隔。
数据文件的内容不包括表标题。 数据文件的第一行应为真实数据，而不是“EndpointName”等标头标签。
所有七列仅使用字符串数据类型。 允许的最大长度为 64 个字符。
条目区分大小写。 例如，EndpointName ABC123 被视为与 EndpointName abc123 唯一。
数据字段可以为空，但仍必须用制表符或逗号分隔。 空数据字段仅分配一个空的 String 值。
EndpointName 必须是唯一的，否则上传失败。 如果有重复的行或两行使用相同的 EndpointName，则冲突将导致不正确的联接。
EndpointLabel1、EndpointLabel2 和 EndpointLabel3 是可自定义的标签。 它们可以是空字符串或值，例如“IT 部门指定的 2018 笔记本电脑”或“资产标记 5678”。
每行必须有七列，列必须按以下顺序排列：
终结点数据文件格式
| 列名称 | 数据类型 | 示例 | 指引 |
|---|---|---|---|
| EndpointName | String | 1409W3534 | 必需 |
| EndpointMake | String | Fabrikam | 可选 |
| EndpointModel | String | 型号 123 | 可选 |
| EndpointType | String | 笔记本 | 可选 |
| EndpointLabel1 | String | IT 指定 2018 笔记本电脑 | 可选 |
| EndpointLabel2 | String | 资产标记 5678 | 可选 |
| EndpointLabel3 | String | 购买 2018 | 可选 |
示例行：
1409W3534,Fabrikam,Model 123,Laptop,IT designated 2018 Laptop,Asset Tag 5678,Purchase 2018
更新生成文件
在收集生成和子网信息时，管理员通常会在多次迭代中上传生成文件，并在可用时添加新子网及其生成信息。 发生这种情况时，需要重新上传生成文件。 为了确保呼叫报告在一段时间内准确表示网络，可以上传具有单独开始日期和结束日期的多个文件，以反映不同时间的网络状态。 每个文件都适用于在文件的开始和结束时间内发生的调用。
重要
虽然可以具有适用于不同时间段的不同开始时间和结束时间的多个生成文件，但不能在同一时间段内合并来自多个文件的信息。
随时间推移添加新子网
可以添加最初不属于网络拓扑的新子网。 若要添加新子网，请执行以下步骤：
从“ 生成和终结点数据 ”页上的列表中选择最新的生成文件，然后选择“ 下载 ”按钮。 确认文件下载成功。
在选择最新生成文件后，选择“ 编辑 ”，并提供至少在获取净新子网前一天的结束日期。
将新子网信息追加到下载的本地生成文件。
上传新修改的生成文件，并设置上一个生成文件结束后一天的开始日期。
查找缺少的子网
上传托管网络的生成信息后，每个托管网络都应具有建筑物关联。 但是，情况可能并非总是如此。 通常，会丢失一些子网。 若要查找这些缺失的网络，请查看 CQD 中“体验质量报告”页上的“缺失子网报告”。 “缺失子网报告”显示所有子网，其中包含 10 个或更多音频流，这些音频流在生成数据文件中未定义。 此报表中排除了常见的主子网。 确保此列表中没有托管网络。
重要
若要筛选报表以仅查看组织的租户数据，需要向此报表添加租户 ID 作为查询筛选器，以用于 第二个租户 ID 。 否则，报表会显示联合子网。
注意
请务必将“月份年”报表筛选器调整为当前月份。 选择 “编辑”，然后调整“ 月份年份 ”报表筛选器以保存新的默认月份。
添加缺少的子网
如果缺少子网，请使用以下步骤更新原始生成数据文件并重新上传：
从“ 生成和终结点数据 ”页上的列表中选择最新的生成文件，然后选择“ 下载 ”按钮。 确认文件下载成功。
在最新生成文件仍处于选中状态的情况下，选择“ 删除 ”将其删除。
将新子网信息追加到下载的本地生成文件。
上传新修改的生成文件。 请务必适当地设置开始日期，以便将其应用于历史数据。