Grafana で Azure Data Explorer のデータを視覚化する

ビューアー ロールにマネージド ID を追加する

Managed Grafana では、新しいワークスペースごとにシステム割り当てマネージド ID が既定で作成されます。 これを使用して、Azure Data Explorer クラスターにアクセスできます。

1. Azure portal で、Azure Data Explorer クラスターに移動します。

2. [ 概要 ] セクションで、 StormEvents サンプル データを含むデータベースを選択します。

   

3. [アクセス許可]> [ビューアーの追加] の順に選択>します。

   

4. 検索ボックスに、Managed Grafana ワークスペース名を入力します。

5. 検索結果で、ワークスペース名と一致する結果を選択し、[選択] を選択 します。

   

Azure Data Explorerを Grafana データ ソースとして設定する

マネージド Grafana ワークスペースには、Azure Data Explorer プラグインがプレインストールされています。

1. Azure portalで、Managed Grafana ワークスペースに移動します。

2. [ 概要] で、[ エンドポイント ] リンクを選択して Grafana UI を開きます。

3. Grafana の左側のメニューで、歯車アイコンを選択します。 次 に、[データ ソース] を選択します。

   

4. [Azure Data Explorer データソース] を選択します。

   

5. [接続の詳細] に、Azure Data Explorer クラスターの URL を入力します。

   

6. [Save & Test]\(保存してテスト\) を選択します。

サービス プリンシパルの作成

サービス プリンシパルは、Azure portalで作成することも、Azure CLI コマンド ライン エクスペリエンスを使用して作成することもできます。 サービス プリンシパルを作成すると、後の手順で使用する 4 つの接続プロパティの値が取得されます。

Azure Portal

1. Azure portalドキュメントの手順に従います。 次の特定の情報を使用します。

   1. 「アプリケーションをロールに割り当てる」で、Azure Data Explorer クラスターに閲覧者ロールを割り当てます。

   2. [ サインインの値を取得する ] セクションで、手順で説明されている 3 つのプロパティ ( ディレクトリ ID (テナント ID)、アプリケーション ID、パスワード) の値 をコピー します。

2. Azure Portal で、 [サブスクリプション] を選びます。 次に、サービス プリンシパルを作成したサブスクリプションの ID をコピーします。

   

Azure CLI

1. 次のコマンドを使用して、サービス プリンシパルを作成します。 適切なスコープを設定し、ロールの種類として reader を設定します。

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   詳細については、「 Azure CLI を使用して Azure サービス プリンシパルを作成する」を参照してください。

2. コマンドは、次の例のような結果セットを返します。 、password、および プロパティのappId値をtenantコピーします。

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. サブスクリプションの一覧を取得します。

   az account list --output table
   

   適切なサブスクリプション ID をコピーします。

   

サービス プリンシパルをビューアー ロールに追加する

サービス プリンシパルが作成されたので、それを Azure Data Explorer データベースのビューアー ロールに追加します。 この作業は、Azure portal の [アクセス許可] で実行することも、 [クエリ] で管理コマンドを使用して実行することもできます。

Azure portal: アクセス許可

1. Azure portal で、Azure Data Explorer クラスターに移動します。

2. [ 概要 ] セクションで、StormEvents サンプル データを含むデータベースを選択します。

   

3. [アクセス許可]>[追加] の順に選択します。

   

4. [ データベースのアクセス許可の追加] で、 ビューアー ロールを選択し、[ プリンシパルの選択] を選択します。

   

5. 作成したサービス プリンシパルを検索します。 プリンシパルを選択し、[選択] を 選択します。

   

6. [保存] を選択します。

   

管理コマンド: クエリ

1. Azure portalで、Azure Data Explorer クラスターに移動し、[クエリ] を選択します。

   

2. クエリ ウィンドウで次のコマンドを実行します。 Azure portalまたは Azure CLI のアプリケーション ID とテナント ID を使用します。

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   コマンドは結果セットを返します。 次の例では、最初の行はデータベース内の既存のユーザー用です。 2 番目の行は、先ほど追加したサービス プリンシパル用です。

   

プロパティを指定し、接続をテストする

サービス プリンシパルがビューアー ロールに割り当てられているので、Grafana のインスタンスでプロパティを指定し、Azure Data Explorerへの接続をテストします。

1. Grafana の左側のメニューで、歯車アイコンを選択します。 次 に、[データ ソース] を選択します。

   

2. [Add data source (データ ソースの追加)]を選択します。

3. [データ ソース/ 新規] ページで、データ ソースの名前を入力し、Azure Data Explorer データソースの種類を選択します。

   

4. [設定] [接続の詳細]> で、 という形式https://{ClusterName}.{Region}.kusto.windows.netでクラスターの名前を入力します。 Azure portalまたは Azure CLI のその他の値を入力します。 ガイドとして、次のマッピング情報を使用します。

   Grafana UI	Azure portal	Azure CLI
   サブスクリプション ID	サブスクリプション ID	SubscriptionId
   テナント ID	ディレクトリ ID	tenant
   クライアント ID	アプリケーション ID	appId
   クライアント シークレット	パスワード	password

   

5. [Save & Test]\(保存してテスト\) を選択します。

   テストが成功した場合は、次のセクションに進みます。 問題が発生した場合は、Grafana で指定した値をチェックし、前の手順を確認します。

クエリの最適化

クエリの最適化には、次の 2 つの機能を使用できます。

• ダッシュボードのクエリ レンダリングのパフォーマンスを最適化する
• 弱い整合性を有効にする

最適化を実行するには、 [データ ソース]>[設定]>[Query Optimizations](クエリ最適化) で、必要な変更を行います。

ダッシュボードのクエリ レンダリングのパフォーマンスを最適化する

ダッシュボードまたはビジュアルが 1 人以上のユーザーによって複数回レンダリングされると、Grafana は既定で少なくとも 1 つのクエリを Azure Data Explorerに送信します。 クエリ結果のキャッシュを有効にして、ダッシュボードのレンダリング パフォーマンスを向上させ、Azure Data Explorer クラスターの負荷を軽減します。

Azure Data Explorer は、指定された時間範囲内で、結果キャッシュを使用して前の結果を取得し、不要なクエリを実行しません。 この機能は、複数のユーザーが同じダッシュボードを使用している場合に、リソースの負荷を軽減し、パフォーマンスを向上させるために特に有効です。

結果キャッシュのレンダリングを有効にするには、[クエリの最適化] ペインで次 の操作を 行います。

1. [ 動的キャッシュを使用する] をオフにします。
2. [Cache Max Age](最大キャッシュ時間) に、キャッシュされた結果を使用する時間を分単位で入力します。

弱い整合性を有効にする

クラスターは、強い整合性を使用して構成されます。 この既定の構成では、クエリ結果がクラスター内のすべての変更で最新の状態であることを保証します。

弱い整合性を有効にすると、クエリ結果のラグがクラスターの変更後 1 分から 2 分になる可能性があります。 ただし、一貫性が弱いと、ビジュアルのレンダリング時間が長くなることがあります。 即時整合性が重要ではなく、パフォーマンスが限界である場合は、弱い整合性を有効にしてパフォーマンスを向上させます。 詳細については、「 クエリの整合性」を参照してください。

弱い一貫性を有効にするには、[ クエリの最適化 ] ペインで [ データ整合性>の弱い] を選択します。