​

チュートリアル: Grafana を Insights に接続する

このガイドは、Grafana を Insights とともに使い始めるのに役立ちます。接続後、Grafana を使用して Insights のゲーム データに対して分析および監視システムを実行できます。Insights に接続できる他のツールについては、外部ツールを Insights に接続する を参照してください。 このチュートリアルでは、次の方法について学びます:

​

前提条件

​

Microsoft Entra ID で認証された PlayFab アカウント

認証プロバイダーが Microsoft に設定されている PlayFab アカウントまたはユーザーが必要です。Microsoft 認証プロバイダーは、Azure サービスの使用に必要な認証に Microsoft Entra ID (旧称 Azure Active Directory (AAD)) を使用します。Microsoft Entra ID で認証されたアカウントまたはユーザーの作成手順については、Game Manager 用の Azure Active Directory 認証 を参照してください。 アカウントまたはユーザーが Microsoft 認証プロバイダーを使用するように設定されていることを確認するには:

• developer.playfab.com にアクセスします。
• [Sign in with Microsoft] を選択して PlayFab アカウントにアクセスします。

サインインできれば、そのアカウントは Microsoft 認証プロバイダーを使用するように設定されています。

​

Insights の Game Manager 権限

アカウントに、次の Game Manager 権限が有効になっている ユーザー ロール を割り当てる必要があります:

• 管理者ステータス。
• Explorer タブおよび関連データへのアクセス。
• Analytics データへの読み取りおよび書き込みアクセス。

新しいユーザー ロールを作成するか、既存のロールにこれらの権限を追加することができます。

​

その他の前提条件

• Microsoft Entra ID アプリケーションを作成し、タイトル データベースに接続する

​

Grafana のセットアップ

1. Grafana を入手する方法は 2 つあります。無料アカウントを作成 して Grafana をダウンロードし、コンピューターで実行できます。または、有料の Grafana Cloud サブスクリプションをお持ちの場合は、オンライン ホスト インスタンスを使用できます。
2. Grafana 用の Azure Data Explorer プラグインをインストールします。

​

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] の右にあるドロップダウン メニューを選択し、[Table] オプションを選択します。
3. [Query] タブに戻ります。クエリを入力し、[Run] を選択します。結果は [Query] タブの上のテーブルに表示されます。この例では、クエリ ['events.all'] | limit 100 を実行しました。 Kusto コマンドの実行も同じプロセスに従います。コマンドを [Query] タブに入力し、[Run] を選択します。結果が上に表示されます。この例では、コマンド .show tables を実行しました。

​

その他のリソース

• Grafana ドキュメント
• Insights に接続する他のツールについては、外部ツールを Insights に接続する を参照してください。