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

[アーティクル]
08/02/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 ダッシュボードでパラメーターを使用する」を参照してください。

タイルの凡例

タイル内の凡例の位置を変更し、凡例を使用してデータを操作できます。

凡例の場所を変更する

ダッシュボードに対する編集権限がある場合は、タイル内の凡例の場所を変更できます。 [編集] モードに切り替え、[タイルの編集] 鉛筆アイコンを選択します。 [ビジュアルの書式設定] ウィンドウの [凡例] で、場所の設定を選択できます。

データと対話する

凡例を使用して、タイル内のデータを操作できます。凡例の特定の項目を選択すると、表示するデータを変更できます。 Ctrl キーを使用して選択範囲に項目を追加または削除し、Shift キーを押したまま範囲を選択します。選択されていない項目は灰色で表示されます。

[検索] ボタンを使用すると、項目を検索およびフィルター処理できます。

[反転] ボタンを使用して、選択範囲を反転します。

[上へ] 矢印と [下へ] 矢印を使用して、次の方法で一覧内を移動します。

1 つの項目を選択すると、上下の矢印で前の項目または次の項目が選択されます。
複数の項目を選択すると、上下の矢印でタイル上の強調表示されている項目が変更されます。

凡例を使用してデータを操作するボタンを示すスクリーンショット。

クエリを表示する

クエリは、編集モードまたは表示モードで表示できます。タイルの基になるクエリの編集は、編集モードでのみ可能です。表示モードでは、新しいクエリタブでクエリに変更を加えることができるので、ダッシュボードタイルの基になるクエリが変更されることはありません。

ブラウザーでダッシュボードにアクセスします。
探索するタイルで、[その他] メニュー [...]> を選択します。クエリを表示します。

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

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

Note

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

同じ共有メニューを使用して、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]\(既定の更新頻度\) の値を選択します。
[適用] を選択してから、ダッシュボードを保存します。