> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 将 Grafana 连接到 Insights
> 将 Grafana 连接到旧版 PlayFab Insights，添加数据源，并构建仪表板，对你的游戏遥测数据运行 Kusto 查询以进行监控和告警。
# 教程：将 Grafana 连接到 Insights
本指南可帮助你开始将 Grafana 与 Insights 结合使用。连接后，你可以使用 Grafana 对来自 Insights 的游戏数据运行分析和监控系统。要了解可与 Insights 连接的其他工具，请参阅[将外部工具连接到 Insights](/services/playfab/data-analytics/legacy/connectivity)。
在本教程中，你将学习如何：
\[!div class="checklist"] \* 为 Insights 设置 Grafana \* 在 Grafana 中创建数据源 \* 在 Grafana 中创建仪表板 \* 使用仪表板运行 Kusto 查询和命令
PlayFab Insights Management 已于 2026 年 3 月 31 日退役。我们建议使用 [Azure Data Explorer (ADX) 连接](/services/playfab/data-analytics/export-data/data-connection-adx)以便今后管理你的性能和成本。如果你的标题仍在使用 **Insights**，请继续查看本文以了解实现详情。有关更多信息，请参阅 [PlayFab Digest：3 月功能更新](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/)。
## 先决条件
### 使用 Microsoft Entra ID 认证的 PlayFab 账户
你需要一个 PlayFab 账户或用户，其身份验证提供商设置为 Microsoft。Microsoft 身份验证提供商使用 Microsoft Entra ID（之前的 Azure Active Directory (AAD)）进行身份验证，这是使用 Azure 服务所必需的。有关创建 Microsoft Entra ID 认证账户或用户的说明，请参阅 [Game Manager 的 Azure Active Directory 身份验证](/services/playfab/identity/dev-identity/authentication/aad-authentication)。
要验证账户或用户是否设置为使用 Microsoft 身份验证提供商：
* 访问 [developer.playfab.com](https://developer.playfab.com)。
* 选择 **Sign in with Microsoft** 以访问你的 PlayFab 账户。
如果你可以登录，则该账户已设置为使用 Microsoft 身份验证提供商。
### Insights 的 Game Manager 权限
你需要为你的账户分配启用以下 Game Manager 权限的[用户角色](/services/playfab/identity/dev-identity/permissions/playfab-user-roles)：
* 管理员状态。
* 访问 Explorer 选项卡和关联数据。
* 对 Analytics 数据的读写访问。
你可以创建新的用户角色，也可以向现有角色添加这些权限。
### 其他先决条件
* [创建 Microsoft Entra ID 应用程序并将其连接到你的标题数据库](/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)
## 设置 Grafana
1. 有两种方式获取 Grafana。你可以[创建一个免费账户](https://grafana.com/login)并下载 Grafana 在你的电脑上运行。或者，如果你有付费的 Grafana Cloud 订阅，可以使用你的在线托管实例。
2. 为 Grafana 安装 [Azure Data Explorer](https://grafana.com/grafana/plugins/grafana-azure-data-explorer-datasource) 插件。
## 在 Grafana 中创建新的数据源
现在你的标题数据库已链接到一个 Azure 应用，你可以使用该应用与 Grafana 连接。要创建新的数据源：
1. 登录 Grafana。
2. 在 **Welcome to Grafana** 页面上，选择 **Add data source**。
3. 在 **Add Datasource** 页面上，选择 **Azure Data Explorer Datasource**。你可以使用搜索栏搜索它，或在 **Others** 部分找到它。如果你没有看到 **Azure Data Explorer Datasource** 选项，你需要安装 Grafana 的 Azure Data Explorer Datasource 插件。
4. 在 **Azure Data Explorer Datasource** 配置页面上：
* 对于 **Cluster URL**，输入 PlayFab API 端点，即 `https://insights.playfab.com`。
* 将 Microsoft Entra ID 应用程序中的 **Tenant Id**、**Client Id** 和 **Client secret** 输入到相应的字段中。
* 选择 **Save & Test**。你应看到 **Connection Successful** 返回消息。
* 从 **Default Database** 中选择你的 Title ID 或数据库名称。此字段会在你成功保存和测试数据源后自动填充。如果成功连接后仍未显示，请尝试退出并重新打开配置页面。
## 创建仪表板
在 Grafana 主页上，我们将创建一个新的仪表板。要创建仪表板：
1. 选择 **New dashboard**。
2. 在 **New Panel** 对话框中，选择 **Add Query**。
3. 在 **Query** 面板中 **Database** 旁边，从下拉菜单中选择你的数据库。在此示例中，数据库名称为 **Unicorn Battle**。
## 运行 Kusto 查询和命令
现在你将使用新创建的仪表板对你的数据库运行 Kusto 查询和命令。要运行查询：
1. 在 **Query** 面板中 **Format As** 旁边，从下拉菜单中选择 **Table**。
2. 使用左侧的图标切换到 Visualization 面板。选择 **Visualization** 右侧的下拉菜单，然后选择 **Table** 选项。
3. 返回 **Query** 选项卡。输入查询并选择 **Run**。结果显示在 **Query** 选项卡上方的表格中。在此示例中，我们运行了查询 `['events.all'] | limit 100`。
运行 Kusto 命令遵循相同的过程。在 **Query** 选项卡中输入你的命令并选择 **Run**。结果显示在上方。在此示例中，我们运行了命令 `.show tables`。
## 更多资源
* [Grafana 文档](https://grafana.com/docs/grafana/latest/)
* 要了解连接到 Insights 的其他工具，请参阅[将外部工具连接到 Insights](/services/playfab/data-analytics/legacy/connectivity)。
## Related topics
- [将外部工具与 Insights 连接](/zh-CN/services/playfab/data-analytics/legacy/connectivity/index.md)
- [将 Python 连接到 Insights](/zh-CN/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights.md)
- [将 Kusto C# SDK 连接到 Insights](/zh-CN/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)
- [将 Kusto Explorer 连接到 Insights](/zh-CN/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [将 Power BI 连接到 Insights](/zh-CN/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)