> ## 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

本指南可協助您開始搭配 Insights 使用 Grafana。連線之後，您可以使用 Grafana 對來自 Insights 的遊戲資料執行分析和監視系統。若要深入了解可與 Insights 連線的其他工具，請參閱[將外部工具連線至 Insights](/zh-TW/services/playfab/data-analytics/legacy/connectivity)。

在本教學課程中，您將了解如何：

<Note>
  \[!div class="checklist"] \* 為 Insights 設定 Grafana \* 在 Grafana 中建立資料來源 \* 在 Grafana 中建立儀表板 \* 使用儀表板執行 Kusto 查詢和命令
</Note>

<Note>
  PlayFab Insights 管理已於 3/31/2026 淘汰。我們建議日後使用 [Azure Data Explorer (ADX) 連線](/zh-TW/services/playfab/data-analytics/export-data/data-connection-adx)來管理您的效能和成本。如果您的遊戲仍在使用 **Insights**，請繼續參閱本文以了解實作詳細資料。如需詳細資訊，請參閱 [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/)。
</Note>

## 必要條件

### 使用 Microsoft Entra ID 驗證的 PlayFab 帳戶

您需要一個驗證提供者設定為 Microsoft 的 PlayFab 帳戶或使用者。Microsoft 驗證提供者使用 Microsoft Entra ID (先前稱為 Azure Active Directory (AAD)) 進行驗證，這是使用 Azure 服務的必要條件。如需建立 Microsoft Entra ID 驗證帳戶或使用者的指示，請參閱 [Game Manager 的 Azure Active Directory 驗證](/zh-TW/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 權限的[使用者角色](/zh-TW/services/playfab/identity/dev-identity/permissions/playfab-user-roles)：

* 系統管理員狀態。
* 存取 Explorer 索引標籤及相關資料。
* Analytics 資料的讀取和寫入權限。

您可以建立新的使用者角色，或將這些權限新增至現有角色。

### 其他必要條件

* [建立 Microsoft Entra ID 應用程式並將其連線至您的遊戲資料庫](/zh-TW/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** 選項，則需要安裝 Azure Data Explorer Datasource For Grafana 外掛程式。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-add-datasource.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=308a78625124cecfa0190ffa2a6d902f" alt="Grafana 新增資料來源" width="1465" height="615" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-add-datasource.png" />
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) 或資料庫名稱。成功儲存並測試資料來源後，此欄位會自動填入。如果在連線成功後未顯示，請嘗試結束並重新開啟設定頁面。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-datasource-configuration.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=7fe6afaa1c39f94ac85d74cddaab1fb3" alt="Grafana 資料來源設定" width="1586" height="707" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-datasource-configuration.png" />

## 建立儀表板

我們將從 Grafana 首頁建立新的儀表板。若要建立儀表板：

1. 選取 **New dashboard**。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-dashboard.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=ee1ccd38c312c481a7e6d1e3853814e3" alt="Grafana 新增儀表板" width="1534" height="333" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-dashboard.png" />
2. 在 **New Panel** 對話方塊中，選取 **Add Query**。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-panel.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=0ce9eb2fe67f337040ec2ec4d003d3c5" alt="Grafana 新增面板" width="829" height="503" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-panel.png" />
3. 在 **Query** 面板中 **Database** 旁，從下拉式功能表選取您的資料庫。在此範例中，資料庫名稱為 **Unicorn Battle**。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-query.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=6e1cc311d6f82ec40188249d889ac2f2" alt="Grafana 新增查詢" width="1623" height="549" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-query.png" />

## 執行 Kusto 查詢和命令

現在您要使用新建立的儀表板，在資料庫上執行 Kusto 查詢和命令。若要執行查詢：

1. 在 **Query** 面板中 **Format As** 旁，從下拉式功能表選取 **Table**。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-table-format.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=15b7b1dc9f43ee66429f41189838af0e" alt="Grafana 表格格式" width="2200" height="751" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-table-format.png" />
2. 使用左側的圖示切換至 Visualization 面板。選取 **Visualization** 右側的下拉式功能表，然後選取 **Table** 選項。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-table-visualization.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=3de1502c1bf2f8673833c3a2345be6e7" alt="Grafana 表格視覺效果" width="2011" height="672" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-table-visualization.png" />
3. 返回 **Query** 索引標籤。輸入查詢並選取 **Run**。結果會出現在 **Query** 索引標籤上方的表格中。在此範例中，我們執行了查詢 `['events.all'] | limit 100`。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-run-query.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=fd1c90e47b834a11c7d7cb4c6e9c0540" alt="Grafana 執行查詢" width="2253" height="1005" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-run-query.png" /> 執行 Kusto 命令遵循相同的流程。在 **Query** 索引標籤中輸入命令並選取 **Run**。結果會顯示在上方。在此範例中，我們執行了命令 `.show tables`。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-run-command.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=8aa9b399068f41b749546d148fead7bc" alt="Grafana 執行命令" width="2254" height="1057" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-run-command.png" />

## 更多資源

* [Grafana 文件](https://grafana.com/docs/grafana/latest/)
* 若要了解可連線至 Insights 的其他工具，請參閱[將外部工具連線至 Insights](/zh-TW/services/playfab/data-analytics/legacy/connectivity)。


## Related topics

- [將外部工具與 Insights 連線](/zh-TW/services/playfab/data-analytics/legacy/connectivity/index.md)
- [將 Python 連線至 Insights](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights.md)
- [將 Kusto C# SDK 連線至 Insights](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)
- [將 Kusto Explorer 連線至 Insights](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [將 Power BI 連線至 Insights](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)