教程:将 Kusto Explorer 连接到 Insights

本指南可帮助你开始使用 Kusto 资源管理器和见解。 连接后,可以使用 Kusto 资源管理器查询和浏览游戏数据。 要深入了解可用于连接 Insights 的其他工具,请参阅 将外部工具连接到 Insights

注意

PlayFab Insights 管理将从 2023 年 12 月 11 日起弃用。 我们建议使用 Azure 数据资源管理器 (ADX) 连接 来管理未来性能和成本。 如果你的游戏仍在使用 Insights,请继续查看本文以了解实现详细信息。 有关详细信息,请参阅 Insights 弃用博客

先决条件

通过 AAD 进行身份验证的 PlayFab 帐户

需要一个身份验证提供程序设置为 Microsoft 的 PlayFab 帐户或用户。 Microsoft 身份验证提供程序使用 Azure Active Directory (AAD) 进行身份验证,这是使用 Azure 服务所必需的。 有关创建经过 AAD 身份验证的帐户或用户的说明,请参阅 Game Manager 的 Azure Active Directory 身份验证

验证帐户或用户是否设置为使用 Microsoft 身份验证提供程序。

如果可以登录,则该帐户设置为使用 Microsoft 身份验证提供程序。

Insights 的 Game Manager 权限

需要向帐户分配已启用以下 Game Manager 权限的用户角色

  • 管理员状态。
  • 访问资源管理器选项卡和关联的数据。
  • 对分析数据进行读取和写入访问。

可创建新的用户角色或向现有角色添加这些权限。

其他先决条件

重要

Insights 仅支持 V1 查询响应架构。 可以使用以下步骤在 Kusto 资源管理器中更新响应架构。

在本地计算机上,打开 Kusto.Explorer。

  1. 选择“工具”选项卡,然后选择“选项...

  2. 在“连接”类别下,更改以下两个属性。

    • 查询结果协议 设置为从下拉列表选项 V1
    • 在下拉列表选项中将 KQL 分析器版本 设置为 V1

    Kusto.Explorer 使用 V1 查询架构

使用 Kusto 资源管理器连接

在本地计算机上,打开 Kusto.Explorer。

  1. 添加连接。 可以通过两种不同的方式执行此操作:

    • 选择"连接"选项卡,然后选择添加连接
    • 右键单击左侧导航面板中的 连接 文件夹,然后选择 添加连接
  2. 添加连接 对话框中:

    • 群集连接 输入 PlayFab API 终结点,该终结点 https://insights.playfab.com
    • 安全下,确保已选择 AAD 联合
    • 展开“高级: 连接字符串”框,并将“初始目录”的值从“NetDefaultDB”更改为 <titleID>。 请注意,此处 <titleID> 必须全部大写。 在下面的示例中,此更改在字符串中突出显示。

    Kusto.Explorer 添加连接

  3. 选择“确定”。 现在应该能够直观显示查询结果。

其他资源