Azure Data Explorer ダッシュボードを使用してデータを視覚化する

[アーティクル]
03/03/2024

Azure Data Explorer は、ログと利用統計情報データのための高速で拡張性に優れたデータ探索サービスです。 Azure Data Explorer Web アプリケーションでエンドツーエンドでデータを探索し、データインジェストから始め、クエリを実行し、最終的にダッシュボードを構築します。

ダッシュボードはタイルのコレクションであり、必要に応じてページに整理され、各タイルには基になるクエリと視覚的表現があります。 Web UI を使用すると、Kusto 照会言語 (KQL) クエリをビジュアルとしてダッシュボードにネイティブにエクスポートし、後で基になるクエリとビジュアルの書式設定を必要に応じて変更できます。データ探索の容易さに加えて、この完全に統合された Azure Data Explorer ダッシュボードエクスペリエンスにより、クエリと視覚化のパフォーマンスが向上します。

重要

データのセキュリティが確保されます。ユーザーに関するダッシュボードとダッシュボード関連のメタデータは、Microsoft マネージドキーを使用して保存時に暗号化されます。

次の図は、Azure Data Explorer ダッシュボードのサンプルを示しています。

サンプルダッシュボードを対話的に探索するには、「クイックスタート: サンプルデータダッシュボードを視覚化する」を参照してください。

前提条件

Microsoft アカウントまたはMicrosoft Entraユーザー ID。 Azure サブスクリプションは不要です。
Azure Data Explorer クラスターとデータベースを作成します。
Azure Data Explorer Web UI にサインインして、クラスターへの接続を追加します。

新しいダッシュボードを作成する

ナビゲーションバーで、[ダッシュボード] [新しいダッシュボード] を>選択します。
ダッシュボード名を入力し、[ 作成] を選択します。

データソースを追加する

1 つのダッシュボードで、1 つ以上のクラスターのビジュアルを表示できます。

[ その他] メニュー [...] を選択します >データソース
[ データソース ] ペインで、[ + 新しいデータソース] を選択します。
[新しいデータソースの作成] ペインで、次のようにします。
1. データソース名を入力します。
2. [クラスター URL] リージョンを入力して、 [接続] を選択します。
3. ドロップダウンリストから [データベース] を選択します。
4. [クエリ結果のキャッシュの最長有効期間] の値を入力して、このデータソースのすべてのクエリでクエリ結果のキャッシュを有効にします。最長有効期間は、秒、時間、または日の単位で指定できます。
5. ［作成］ を選択します

タイルの追加

ダッシュボードタイルでは、Kusto 照会言語スニペットを使用してデータを取得し、ビジュアルをレンダリングします。各タイルとクエリは 1 つのビジュアルをサポートできます。

ダッシュボードキャンバスまたは上部のメニューバーから [タイルの追加] を選択します。
[クエリ] ペインで、
1. ドロップダウンメニューからデータソースを選択します。
2. クエリを入力し、 [実行] を選択します。パラメーターを使用するクエリの生成方法の詳細については、「クエリでパラメーターを使用する」を参照してください。
3. [ビジュアル] を選択します。
[ビジュアル] タブで[ ビジュアルの種類 ] を選択して、ビジュアルの種類を選択します。
[変更の適用] を選択して、ビジュアルをダッシュボードにピン留めします。
ビジュアルのサイズを変更し、[ 保存 ] アイコンを選択できます。

クエリからタイルをピン留めする

Web UI の [クエリ] タブからクエリをピン留めすることもできます。

クエリをピン留めするには:

ダッシュボードで視覚化する出力を含むクエリを作成して実行します。
[ダッシュボードにピン留めする]> を選択します。
[ダッシュボードにピン留めする] ペインで、次のようにします。
1. タイル名を指定します。
2. データソース名は、クエリデータソースから自動的に設定されます。
3. 可能であれば、[既存のデータソースを使用する] を選択します。
4. [新規作成] を選択します。
5. 「ダッシュボード名」と入力します。
6. [View dashboard after creation](作成後にダッシュボードを表示する) チェックボックスをオンにします (新しいダッシュボードの場合)。
7. [ピン留め] の選択

パラメーターを使用する

パラメーターを使用すると、ダッシュボードのレンダリングパフォーマンスが大幅に向上し、クエリのなるべく早い段階でフィルター値を使用できるようになります。タイルに関連付けられているクエリにパラメーターが含まれていると、フィルターが有効になります。さまざまな種類のパラメーターを設定して使用する方法の詳細については、「Azure Data Explorer ダッシュボードでパラメーターを使用する」を参照してください。

クエリの表示

クエリは、編集モードまたは表示モードで表示できます。タイルの基になるクエリの編集は、編集モードでのみ可能です。表示モードでは、ダッシュボードタイルの基になるクエリを変更せずに、新しいクエリタブでクエリを変更できます。

ダッシュボードを参照します。
探索するタイルで、[その他] メニュー [...] を選択します>。クエリを表示します。

クエリと結果のテーブルが表示されたペインが開きます。
[新しいクエリ] タブを選択します。Azure Data Explorer Web UI クエリペインでクエリを編集します。

ビュークエリペインのスクリーンショット。画面の上半分にクエリが表示され、結果は下半分に表示されます。

注意

このフローを使用してクエリに加えられた編集は、元のダッシュボードには反映されません。

[共有] メニューを使用して、Microsoft EntraユーザーまたはMicrosoft Entra グループにアクセス許可を付与し、ダッシュボードにアクセスし、ユーザーのアクセス許可レベルを変更し、ダッシュボードリンクを共有します。

重要

ダッシュボードにアクセスするには、ダッシュボードの閲覧者には次のものが必要です。

アクセスのためのダッシュボードリンク
ダッシュボードのアクセス許可
Azure Data Explorer クラスター内の基になるデータベースへのアクセス

アクセス許可の管理

ダッシュボードの上部バーにある [共有] メニュー項目を選択します。
ドロップダウンから [アクセス許可の管理] を選択します。

[アクセス許可の付与]

[Dashboard permissions](ダッシュボードのアクセス許可) ペインでユーザーにアクセス許可を付与するには、次のようにします。

[新しいメンバーの追加] にMicrosoft EntraユーザーまたはMicrosoft Entra グループを入力します。
[アクセス許可] レベルとして [Can view](表示可能) または [Can edit](編集可能) のいずれかの値を選択します。
[追加] を選択します。

ダッシュボードのアクセス許可を管理する。

ユーザーのアクセス許可レベルを変更する

[Dashboard permissions](ダッシュボードのアクセス許可) ペインでユーザーのアクセス許可レベルを変更するには、次のようにします。

検索ボックスを使用するか、ユーザー一覧をスクロールしてユーザーを見つけます。
必要に応じて、 [アクセス許可] レベルを変更します。

ダッシュボードのリンクを共有するには、次のいずれかの操作を行います。

[共有] を選択し、[リンクのコピー] を選択します。
[Dashboard permissions](ダッシュボードのアクセス許可) ウィンドウで、 [リンクのコピー] を選択します。

ダッシュボードのエクスポート

ファイルメニューを使用して、ダッシュボードを JSON ファイルにエクスポートできます。ダッシュボードのエクスポートは、次のシナリオで役に立ちます。

バージョン管理: ファイルを使用して、ダッシュボードを以前のバージョンに復元することができます。
ダッシュボードテンプレート: 新しいダッシュボードを作成するためのテンプレートとしてファイルを使用できます。
手動編集: ファイルを編集して、ダッシュボードを変更できます。ファイルは、ダッシュボードにインポートし直すことができます。

ダッシュボードをエクスポートするには、ダッシュボードで [ファイル]>[ファイルにエクスポート] を選択します。

[ファイルにエクスポート] オプションが表示されたダッシュボードのスクリーンショット。

ファイルには、次のスニペットに示されているような、JSON 形式のダッシュボードデータが含まれています。

{
  "id": "{GUID}",
  "eTag": "{TAG}",
  "title": "Dashboard title",
  "tiles": [
    {
      "id": "{GUID}",
      "title": "Tile title",
      "query": "{QUERY}",
      "layout": { "x": 0, "y": 7, "width": 6, "height": 5 },
      "pageId": "{GUID}",
      "visualType": "line",
      "dataSourceId": "{GUID}",
      "visualOptions": {
        "xColumn": { "type": "infer" },
        "yColumns": { "type": "infer" },
        "yAxisMinimumValue": { "type": "infer" },
        "yAxisMaximumValue": { "type": "infer" },
        "seriesColumns": { "type": "infer" },
        "hideLegend": false,
        "xColumnTitle": "",
        "yColumnTitle": "",
        "horizontalLine": "",
        "verticalLine": "",
        "xAxisScale": "linear",
        "yAxisScale": "linear",
        "crossFilterDisabled": false,
        "crossFilter": { "dimensionId": "dragX-timeRange", "parameterId": "{GUID}" },
        "multipleYAxes": {
          "base": { "id": "-1", "columns": [], "label": "", "yAxisMinimumValue": null, "yAxisMaximumValue": null, "yAxisScale": "linear", "horizontalLines": [] },
          "additional": []
        },
        "hideTileTitle": false
      },
      "usedParamVariables": [ "{PARAM}" ]
    }
  ],
  "dataSources": [ {} ],
  "$schema": "https://dataexplorer.azure.com/static/d/schema/20/dashboard.json",
  "autoRefresh": { "enabled": true, "defaultInterval": "15m", "minInterval": "5m" },
  "parameters": [ {} ],
  "pages": [ { "name": "Primary", "id": "{GUID}" } ],
  "schema_version": "20"
}

ファイルから新しいダッシュボードを作成する

ダッシュボードファイルを使用して、次のように新しいダッシュボードを作成できます。

メインのダッシュボードページで、[新しいダッシュボード]>[ファイルからインポート] を選択します。
インポートするファイルを選択します。
ダッシュボード名を入力して、[作成] を選択します。

ファイルから既存のダッシュボードを更新または復元する

次のように、既存のダッシュボードを更新したり、以前のバージョンを復元したりすることができます。

ダッシュボードで、[ファイル]>[Replace with file] (ファイルで置き換える) を選択します。
ダッシュボードを更新するファイルを選択します。
[変更の保存] を選択します。

ページの追加

ページは、タイル用の省略可能なコンテナーです。ページを使用して、データソースやサブジェクト領域など、タイルを論理グループに整理できます。ページを使用して、概要ページから詳細ページへのドリルスルーを含むダッシュボードなど、複数のビューを含むダッシュボードを作成することもできます。

左側の [ ページ ] ウィンドウで、[ + ページの追加] を選択します。
ページに名前を付けるには、垂直の [その他] メニュー [...] を選択します>。[名前の変更] ページ。
ページにタイルを追加します。

自動更新を有効にする

自動更新は、ページを手動で再読み込みしたり、更新ボタンをクリックしたりすることなく、ダッシュボード上のデータを自動的に更新できる機能です。

既定の自動更新レートは、データベースエディターで設定できます。エディターとビューアーの両方で、ダッシュボードの表示中に自動更新の実際の速度を変更できます。

ダッシュボードの自動更新で使用できるさまざまな時間間隔のスクリーンショット。

ただし、データベースエディターでは、クラスターの負荷を軽減するために、任意のビューアーで設定できる最小更新レートを制限する必要がある場合があります。最小更新レートが設定されている場合、データベースユーザーは最小よりも低い更新レートを設定できません。

[ その他] メニュー [...] を選択します>自動更新。
自動更新が [有効] になるようにオプションを切り替えます。
[Minimum time interval](最小時間間隔) と [Default refresh rate](既定の更新頻度) の値を選択します。
[適用] を選択してから、ダッシュボードを保存します。