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

[アーティクル]
07/25/2023

Grafana は、データのクエリと視覚化を行い、視覚化に基づいてダッシュボードを作成して共有できる分析プラットフォームです。 Grafana には Azure Data Explorer プラグインが用意されており、Azure Data Explorerからデータに接続して視覚化できます。このプラグインは、Azure Managed Grafana とセルフホステッド Grafana の両方で動作します。

この記事では、クラスターを Grafana のデータソースとして構成し、Grafana for Azure Managed Grafana とセルフホステッド Grafana でデータを視覚化する方法について説明します。この記事の例を確認するには、 StormEvents サンプルデータを取り込みます。 StormEvents サンプルデータセットには、国立環境情報センターの気象関連データが含まれています。

前提条件

Azure Managed Grafana の場合、Azure アカウントと Azure Managed Grafana インスタンス。
セルフホステッド Grafana の場合は、オペレーティングシステム用の Grafana バージョン 5.3.0 以降と Grafana 用の Azure Data Explorer プラグイン。 Grafana クエリビルダーを使用するには、プラグインバージョン 3.0.5 以降が必要です。
Azure Data Explorer クラスターとデータベース。無料のクラスターを作成することも、完全なクラスターを作成することもできます。どちらが最適かを判断するには、機能の比較をチェックします。

データソースの構成

Azure Data Explorerをデータソースとして構成するには、Grafana 環境の手順に従います。

Azure Managed Grafana
セルフホステッド Grafana

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

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

Azure portal で、Azure Data Explorer クラスターに移動します。
[ 概要 ] セクションで、 StormEvents サンプルデータを含むデータベースを選択します。
[アクセス許可]> [ビューアーの追加] の順に選択>します。
検索ボックスに、Managed Grafana ワークスペース名を入力します。
検索結果で、ワークスペース名と一致する結果を選択し、[選択] を選択 します。

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

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

Azure portalで、Managed Grafana ワークスペースに移動します。
[ 概要] で、[ エンドポイント ] リンクを選択して Grafana UI を開きます。
Grafana の左側のメニューで、歯車アイコンを選択します。次 に、[データソース] を選択します。
[Azure Data Explorer データソース] を選択します。
[接続の詳細] に、Azure Data Explorer クラスターの URL を入力します。
[Save & Test]\(保存してテスト\) を選択します。

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

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

Azure Portal

Azure portalドキュメントの手順に従います。次の特定の情報を使用します。
1. 「アプリケーションをロールに割り当てる」で、Azure Data Explorer クラスターに閲覧者ロールを割り当てます。
2. [ サインインの値を取得する ] セクションで、手順で説明されている 3 つのプロパティ ( ディレクトリ ID (テナント ID)、アプリケーション ID、パスワード) の値をコピー します。
Azure Portal で、 [サブスクリプション] を選びます。次に、サービスプリンシパルを作成したサブスクリプションの ID をコピーします。

Azure CLI

次のコマンドを使用して、サービスプリンシパルを作成します。適切なスコープを設定し、ロールの種類として reader を設定します。
```
az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                         --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
```
詳細については、「 Azure CLI を使用して Azure サービスプリンシパルを作成する」を参照してください。

コマンドは、次の例のような結果セットを返します。、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"
}

サブスクリプションの一覧を取得します。
```
az account list --output table
```
適切なサブスクリプション ID をコピーします。

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

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

Azure portal: アクセス許可

Azure portal で、Azure Data Explorer クラスターに移動します。
[ 概要 ] セクションで、StormEvents サンプルデータを含むデータベースを選択します。
[アクセス許可]>[追加] の順に選択します。
[ データベースのアクセス許可の追加] で、 ビューアー ロールを選択し、[ プリンシパルの選択] を選択します。
作成したサービスプリンシパルを検索します。プリンシパルを選択し、[選択] を 選択します。
[保存] を選択します。

管理コマンド: クエリ

Azure portalで、Azure Data Explorer クラスターに移動し、[クエリ] を選択します。
クエリウィンドウで次のコマンドを実行します。 Azure portalまたは Azure CLI のアプリケーション ID とテナント ID を使用します。
```
.add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
```
コマンドは結果セットを返します。次の例では、最初の行はデータベース内の既存のユーザー用です。 2 番目の行は、先ほど追加したサービスプリンシパル用です。

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

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

Grafana の左側のメニューで、歯車アイコンを選択します。次 に、[データソース] を選択します。
[Add data source (データソースの追加)]を選択します。
[データソース/ 新規] ページで、データソースの名前を入力し、Azure Data Explorer データソースの種類を選択します。

[設定] [接続の詳細]> で、という形式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`

データソース接続プロパティのボックスのスクリーンショット。

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

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

クエリの最適化

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

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

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

クエリの最適化ペインで構成できるプロパティを示すスクリーンショット。

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

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

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

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

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

弱い整合性を有効にする

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

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

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

データの視覚化

Grafana のデータソースとして Azure Data Explorerの構成が完了しました。次に、データを視覚化します。

次の基本的な例では、クエリビルダーモードとクエリエディターの生モードの両方を使用します。データセットに対して実行する他のクエリの例については、Azure Data Explorerの書き込みクエリを表示することをお勧めします。

Grafana の左側のメニューで、プラスアイコンを選択します。次に、[ダッシュボード] を選択 します。
[Add]\(追加\) タブの [Graph]\(グラフ\) を選択します。
グラフペインで、[パネルタイトル>の編集] を選択します。
ペインの下部にある [ データソース] を選択し、構成したデータソースを選択します。

クエリビルダーモード

クエリビルダーモードを使用してクエリを定義します。

データソースの下にある [ データベース ] を選択し、ドロップダウンリストからデータベースを選択します。
[ 元] を選択し、ドロップダウンリストからテーブルを選択します。
テーブルが定義されたので、データをフィルター処理します。
1. [+場所] (フィルター) の右側にあるを選択して、テーブル内の 1 つ以上の列を選択します。
2. フィルターごとに、該当する演算子を使用して値を定義します。この選択は、Kusto 照会言語で where 演算子を使用するのと似ています。
表に表示する値を選択します。
1. [+値列] の右側を選択して、ペインに表示される値列を選択します。
2. 値の列ごとに、集計の種類を設定します。
  
  1 つ以上の値列を設定できます。この選択は、summarize 演算子を使用することと同じです。
[+グループ化 (集計)] の右側を選択して、値をグループに配置するために使用する 1 つ以上の列を選択します。この選択は、演算子のグループ式と summarize 同じです。
[クエリの実行] を選択します。

ヒント

クエリビルダーで設定を終了すると、Kusto 照会言語クエリが作成されます。このクエリは、グラフィカルクエリエディターを使用して構築したロジックを示します。
[ KQL の編集] を 選択して生モードに移行します。 Kusto 照会言語の柔軟性と能力を使用してクエリを編集します。

クエリビルダーの生クエリのスクリーンショット。

raw モード

raw モードを使用してクエリを編集します。

クエリウィンドウで、次のクエリを貼り付け、[ 実行] を選択します。このクエリでは、サンプルデータセットのイベント数を日単位でバケット化します。
```
StormEvents
| summarize event_count=count() by bin(StartTime, 1d)
```
グラフには、過去 6 時間のデータにスコープ (既定) があるため、結果は表示されません。上部のメニューで、[Last 6 hours](過去 6 時間) を選択します。
StormEvents サンプルデータセットに含まれる 2007 年を対象とするカスタム範囲を指定します。次に、[適用] を選択します。

これで、日単位でバケット処理された 2007 年のデータがグラフに表示されます。
上部のメニューで、保存アイコンを選択します。

クエリビルダーモードに切り替えるには、 [Switch to builder](ビルダーに切り替え) を選択します。 Grafana はクエリをクエリビルダーで使用可能なロジックに変換します。クエリビルダーのロジックは制限されているため、クエリに対して行った手動の変更が失われる可能性があります。

ビルダーに切り替えるためのボタンが強調表示されているクエリウィンドウのスクリーンショット。

アラートを作成する

[ホームダッシュボード] で、[通知>チャネル] を選択して新しい通知チャネルを作成します。
名前を入力し、[ 新しい通知チャネル] に「」と入力し、[保存] を選択 します。
ダッシュボードで、ドロップダウンリストから [編集] を選択します。
アラートベルアイコンを選択して、アラート ウィンドウを開きます。 [ アラートの作成] を選択し、アラートのプロパティを完了します。
ダッシュボードの保存アイコンを選択して、変更を保存します。

Azure Data Explorer のクエリを記述する

次の方法で共有

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

前提条件