翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Grafana バージョン 9 のダッシュボード
<a name="v9-dashboards"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボードは、1 つ以上の行に編成および配置された 1 つ以上の[パネル](v9-panels.md)のセットです。Grafana にはさまざまなパネルが付属しているため、適切なクエリを簡単に作成し、必要に応じて最適なダッシュボードを作成できるように視覚化をカスタマイズできます。各パネルは、設定された任意の [データソースに接続する](AMG-data-sources.md) からのデータを操作できます。

ダッシュボードスナップショットは静的です。クエリと式をスナップショットから再実行することはできません。そのため、クエリまたは式内の変数を更新しても、ダッシュボードデータは変更されません。

**Topics**
+ [ダッシュボードの使用](v9-dash-using-dashboards.md)
+ [ダッシュボードの構築](v9-dash-building-dashboards.md)
+ [ダッシュボードの管理](v9-dash-managing-dashboards.md)
+ [ダッシュボードとパネルの共有](v9-dash-sharing.md)
+ [プレイリストの管理](v9-dash-managing-playlists.md)
+ [ダッシュボード変数の追加と管理](v9-dash-variables.md)
+ [ダッシュボード使用状況の評価](v9-dash-assess-dashboard-usage.md)
+ [Grafana バージョン 9 でのダッシュボードの検索](v9-search.md)

# ダッシュボードの使用
<a name="v9-dash-using-dashboards"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

このトピックでは、ダッシュボード機能、ショートカットの概要、およびダッシュボード検索の使用方法について説明します。

## 機能
<a name="v9-dash-features"></a>

ダッシュボードを使用して、次の方法でデータの表示をカスタマイズできます。


|  機能  |  説明  | 
| --- | --- | 
| **1. ホーム** | Grafana インスタンスで設定されたホームページにリダイレクトする Grafana ホームアイコンをクリックします。 | 
| **2. タイトル** | ダッシュボードタイトルをクリックすると、現在のフォルダに含まれるダッシュボードを検索できます。 | 
| **3. ダッシュボードの共有** | このオプションを使用して、リンクまたはスナップショットで現在のダッシュボードを共有します。ダッシュボード定義を共有モーダルからエクスポートすることもできます。 | 
| **4. 新しいパネルの追加** | このオプションを使用して、パネル、ダッシュボード行、またはライブラリパネルを現在のダッシュボードに追加します。 | 
| **5。ダッシュボード設定** | このオプションを使用して、ダッシュボード名、フォルダ、タグを変更し、変数と注釈クエリを管理します。ダッシュボードのセットアップ方法の詳細については、「[ダッシュボード設定の変更](v9-dash-modify-settings.md)」を参照してください。 | 
| **6。タイムピッカーのドロップダウン** |  このオプションをクリックして、相対時間範囲オプションを選択し、カスタム絶対時間範囲を設定します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **7。時間範囲のズームアウト**  | クリックして時間範囲をズームアウトします。時間範囲の制御方法の詳細については、「[ダッシュボードの時間範囲の設定](#v9-dash-setting-dashboard-time-range)」を参照してください。  | 
| **8。[ダッシュボードの更新]** | クリックすると、クエリをすぐにトリガーし、ダッシュボードデータを更新します。 | 
| **9。ダッシュボードの時間間隔の更新** | クリックして、ダッシュボードの自動更新時間間隔を選択します。 | 
| **10。表示モード**  | このオプションを使用して、テレビやキオスクなどの大きな画面にダッシュボードを表示します。表示モードでは、ナビゲーションメニューなどの無関係な情報が非表示になります。  | 
| **11。ダッシュボードパネル** |  ダッシュボードの主な構成要素はパネルです。新しいパネル、ダッシュボード行、またはライブラリパネルを追加するには、**[パネルの追加]** を選択します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **12。グラフ凡例** | シリーズの色、y 軸、およびシリーズの可視性を凡例から直接変更します。 | 
| **13。ダッシュボードの検索** | **[検索]** をクリックして、名前またはパネルタイトルでダッシュボードを検索します。 | 
| **14。ダッシュボード行** | ダッシュボード行は、パネルをグループ化するダッシュボード内の論理的なディバイダーです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 

## キーボードショートカット
<a name="v9-dash-keyboard-shortcuts"></a>

Grafana では多数のキーボードショートカットを利用できます。使用可能なすべてのキーボードショートカットを表示するには、キーボードで **?** または **h** を押します。
+ `Ctrl+S` は、現在のダッシュボードを保存します。
+ `f` は、ダッシュボードファインダー/検索を開きます。
+  `d+k` は、キオスクモードを切り替えます (メニューを非表示にします）。
+ `d+e` は、すべての行を展開します。
+ `d+s` は、ダッシュボード設定を開きます。
+ `Ctrl+K` は、コマンドパレットを開きます。
+ `Esc` は、全画面表示または編集モードのときにパネルを終了します。また、ダッシュボード設定からダッシュボードに戻ります。

**フォーカスされたパネル**

特定のパネルをターゲットとするショートカットを使用するには、ポインターでパネルにカーソルを合わせます。
+ `e` は、パネル編集ビューを切り替えます 
+ `v` は、パネル全画面表示を切り替えます 
+ `ps` は、パネル共有機能を開きます 
+ `pd` は、パネルを複製します 
+ `pr` は、パネルを削除します 
+ `pl` は、パネル凡例を切り替えます 

## ダッシュボードの時間範囲の設定
<a name="v9-dash-setting-dashboard-time-range"></a>

Grafana では、ダッシュボード、パネル、アラートなど、視覚化されるデータの時間範囲を管理する方法がいくつか用意されています。

このセクションでは、サポートされている時間単位と相対範囲、一般的な時間コントロール、ダッシュボード全体の時間設定、パネル固有の時間設定について説明します。

**時間単位と相対範囲**

Grafana は、次の時間単位に対応しています: `s (seconds)`、`m (minutes)`、`h (hours)`、`d (days)`、`w (weeks)`、`M (months)`、`Q (quarters)`、`y (years)`。

マイナス演算子を使用すると、現在の時間を基準に過去を指定することができます。単位の全期間 (日、週、月など) を表示するには、末尾に `/<time unit>` を追加します。会計期間を表示するには、`fQ (fiscal quarter)` と `fy (fiscal year)` の時間単位を使用します。

プラス演算子を使用すると、現在の時間を基準に未来を指定することができます。例えば、この機能を使用して、将来の予測データを確認できます。

次の表に、相対範囲の例を示します。


| 相対範囲の例 | から | To | 
| --- | --- | --- | 
| 過去 5 分間 |  `now-5m`  |  `now`  | 
| 今日のこれまでのところ |  `now/d`  |  `now`  | 
| 今週 |  `now/w`  |  `now/w`  | 
| 今週始めから現在まで |  `now/w`  |  `now`  | 
| 今月 |  `now/M`  |  `now/M`  | 
| 今月始めから現在まで |  `now/M`  |  `now`  | 
| 前月 |  `now-1M/M`  |  `now-1M/M`  | 
| 今年のこれまでのところ |  `now/Y`  |  `now`  | 
| 今年 |  `now/Y`  |  `now/Y`  | 
| 前会計年度 |  `now-1y/fy`  |  `now-1y/fy`  | 

**注記**  
 Grafana アラートは、将来のタイムスタンプについて `now+n` をサポートしておらず、*n の開始から n の終了まで*のタイプスタンプについて `now-1n/n` をサポートしていません。

**一般的な時間範囲コントロール**

ダッシュボードとパネルの時間コントロールには、共通のユーザーインターフェイスがあります。一般的な時間範囲コントロールを以下に示します。
+ 現在の時間範囲 (別名*タイムピッカー*)は、そのダッシュボードまたはパネルに現在表示されている時間範囲を示します。フィールドにカーソルを合わせると、範囲内の正確なタイムスタンプとそのソース (ローカルブラウザなど) が表示されます。*現在の時間範囲*をクリックして変更します。現在の時間は、過去 15 分などの*相対時間範囲*や、 のような `2020-05-14 00:00:00`～`2020-05-15 23:59:59` などの絶対時間範囲で変更できます。
+ **[相対時間範囲]**は、**[相対時間範囲]** リストから選択できます。上部の入力フィールドを使用してリストをフィルタリングできます。時間範囲の例には、*[過去 30 分]*、*[過去 12 時間]*、*[過去 7 日間]*、*[過去 2 年間]* 、*[昨日]*、*[昨日の前日]*、*[先週のこの曜日]*、*[今日のこれまでのところ]*、*[今週始めから現在まで]*、*[今月始めから現在まで]*などがあります。
+ **絶対時間範囲**は、**[開始]** フィールドと **[終了]** フィールドに正確な時間値または相対時間値を入力して **[時間範囲を適用]** をクリックするか、**[開始]** フィールドまたは **[終了]** フィールドをクリックしたときに表示されるカレンダーから日付または日付範囲をクリックするという 2 つの方法で設定できます。選択を適用するには、**[時間範囲の適用]** をクリックします。

*その他の時間範囲機能*

1. ズームアウトするには、**Cmd\$1Z** または **Ctrl\$1Z** をクリックします。 アイコンをクリックして、ダッシュボードまたはパネルの視覚化でより広い時間範囲を表示します。

1. ズームイン機能を使用するには、表示したい視覚化の時間範囲をクリックしてドラッグします。

**注記**  
ズームインはグラフの視覚化にのみ適用されます。

*[ダッシュボードの更新]*

**[ダッシュボードの更新]** アイコンをクリックすると、ダッシュボード上のすべてのクエリが即座に実行され、視覚化が更新されます。更新をトリガーすると、Grafana は保留中のリクエストをすべてキャンセルします。

デフォルトでは、Grafana はダッシュボードを自動的に更新しません。クエリは、パネル設定に従って独自のスケジュールで実行されます。**[ダッシュボードの更新]** アイコンの横にある下矢印をクリックし、更新間隔を選択することで、ダッシュボードを定期的に更新することができます。

**URL の使用による時間範囲の制御**

ダッシュボード URL に次のクエリパラメータを指定すると、ダッシュボードの時間範囲を制御できます。
+ `from` は、エポックミリ秒で指定された時間範囲の下限、または[相対時間](#v9-dash-setting-dashboard-time-range)を定義します。
+ `to` は、エポックミリ秒で指定された時間範囲の上限、または相対時間を定義します。
+ `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータはミリ秒で指定する必要があります。たとえば、`?time=1500000000000&time.window=10000` は、1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。

# ダッシュボードの構築
<a name="v9-dash-building-dashboards"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana ワークスペースを作成してサインインすると、ダッシュボードを作成し、ニーズに合わせて設定を変更できます。

**Topics**
+ [ダッシュボードの作成](v9-dash-creating.md)
+ [パネルの追加または編集](v9-dash-edit-panels.md)
+ [ダッシュボード設定の変更](v9-dash-modify-settings.md)
+ [ダッシュボード URL 変数](v9-dash-dashboard-url-variables.md)
+ [ダッシュボードへのライブラリパネルの追加](v9-dash-manage-library-panels.md)
+ [ダッシュボードのバージョン履歴の管理](v9-dash-manage-version-history.md)
+ [ダッシュボードリンクの管理](v9-dash-manage-dashboard-links.md)
+ [ダッシュボード JSON モデル](v9-dash-dashboard-json-model.md)

# ダッシュボードの作成
<a name="v9-dash-creating"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

**ダッシュボードの作成**

ダッシュボードとパネルを使用すると、Grafana を使用してデータを視覚的に表示できます。各パネルには、視覚化を表示するために少なくとも 1 つのクエリが必要です。開始する前に、前提条件として次の作業を完了します。
+ 適切なアクセス許可を持っていることを確認してください。権限の詳細については、「[ユーザー、チーム、およびアクセス許可](Grafana-administration-authorization.md)」を参照してください。
+ パネルを追加するダッシュボードを特定します。
+ ターゲットデータソースのクエリ言語を理解します。
+ クエリを記述するデータソースが追加されていることを確認します。

 ダッシュボードを作成するには:

1. Grafana にサインインし、**[ダッシュボード]**にカーソルを合わせ、 **[\$1 新しいダッシュボード]** をクリックします。

1. **[新しいパネルの追加]** をクリックします。

1. **[クエリ]** タブの最初の行で、ドロップダウンリストをクリックしてデータソースを選択します。

1. データソースのクエリ言語でクエリを記述または作成します。

1. **[視覚化]** リストで、視覚化タイプを選択します。Grafana は、視覚化が適用されたクエリ結果のプレビューを表示します。詳細については、「[視覚化のオプション](v9-panels-viz.md)」を参照してください。

1. 次の方法でパネル設定を調整します。
   + [値マッピングを設定する](v9-panels-configure-value-mappings.md)
   + [視覚化固有のオプション](v9-panels-viz.md)
   + [フィールド値を上書きする](v9-panels-configure-overrides.md)
   + [しきい値を設定する](v9-panels-configure-thresholds.md)
   + [標準オプションを設定する](v9-panels-configure-standard-options.md)
**注記**  
ほとんどの視覚化では、情報を適切に表示する前にある程度の調整が必要です。

1. 視覚化を記述する (または変更を記述する) メモを追加し、ページの右上にある **[保存]** をクリックします。
**注記**  
ダッシュボードを以前のバージョンに戻す必要が生じた際、このメモが役に立ちます。

**繰り返し行の設定**

変数の値に基づいてダッシュボードにパネルまたは行を動的に追加するように Grafana を設定できます。変数は、ダッシュボード内のすべての行にわたってクエリを動的に変更します。パネルの繰り返しの詳細については、「[繰り返しパネルの設定]()」を参照してください。

`Multi-value` [または]`Include all values` が選択された変数セットがある場合は、行を繰り返すこともできます。

開始する前に、クエリに複数値変数が含まれていることを確認し、次のステップを実行します。

1. ダッシュボードのホームページで、**[パネルの追加]** をクリックします。

1. **[パネルの追加]** ダイアログボックスで、**[新しい行の追加]** をクリックします。

1. 行タイトルにカーソルを合わせ、歯車アイコンをクリックします。

1. **[行オプション]** ダイアログボックスで、タイトルを追加し、繰り返し行を追加する変数を選択します。
**注記**  
 ダッシュボードユーザーにコンテキストを提供するには、行タイトルに変数を追加します。

**パネルを移動するには**

1. ダッシュボードを開きます。

1. パネルタイトルをクリックし、パネルを新しい場所にドラッグします。パネルは、任意の場所のダッシュボードに配置することができます。

**パネルのサイズを変更するには**

1. ダッシュボードを開きます。

1. パネルのサイズを調整するには、パネルの右下隅をクリックしてドラッグします。ダッシュボードパネルは、ニーズに合わせてサイズ調整できます。

# パネルの追加または編集
<a name="v9-dash-edit-panels"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボードを作成したら、パネルをいつでも追加、編集、または削除できます。
+ **ダッシュボードの表示**: ダッシュボードを表示するには、**[ホーム]**メニューから **[ダッシュボード]** を選択し、表示するダッシュボードを選択します。ダッシュボードを含むフォルダを展開する必要がある場合があります。
+ **パネルの追加**: ダッシュボードにパネルを追加するには、ページの上部にあるメニューバーで **[パネルの追加]** アイコンを選択します。
+ **パネルの編集**: ダッシュボード上の既存のパネルを編集するには、パネルにカーソルを合わせたときに表示されるメニューアイコンを選択し、**[編集]** を選択します。
+ **パネルの削除**: ダッシュボード上の既存のパネルを削除するには、パネルにカーソルを合わせたときに表示されるメニューアイコンを選択し、**[削除]** を選択します。

# ダッシュボード設定の変更
<a name="v9-dash-modify-settings"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボード設定ページでは、次の操作を実行できます。
+ 時間設定を含む一般的なダッシュボードプロパティを編集する。
+ 注釈クエリを追加する。
+ ダッシュボード変数を追加する。
+ リンクを追加する。
+ ダッシュボードの JSON モデルを表示する

ダッシュボード設定ページにアクセスするには

1. ダッシュボードを編集モードで開きます。

1. ページの上部にある **[ダッシュボード設定]** (歯車アイコン) をクリックします。

**ダッシュボードの時間設定の変更**

ダッシュボードのタイムゾーン、ローカルブラウザの時刻を変更するときにダッシュボードの時刻設定を調整し、自動更新の時間間隔を指定します。

**ダッシュボードの時間設定を変更するには**

1. **[ダッシュボード]** 設定ページで、**[全般]** を選択します。

1. **[時間オプション]** セクションに移動します。

1. 以下の説明に従って時間設定を指定します。

1. タイムゾーンは、モニタリングするサービスまたはシステムのローカルタイムゾーンを指定します。これは、複数のタイムゾーンで動作するシステムまたはサービスを監視する場合に役立ちます。
   + Grafana は、ユーザープロファイル、チーム、または組織に*デフォルト*で選択されたタイムゾーンを使用します。ユーザープロファイル、ユーザーが所属するチーム、または組織にタイムゾーンが指定されていない場合、Grafana はローカルブラウザの時間を使用します。
   + ユーザーブラウザの表示用に設定されたタイムゾーン、*ローカルブラウザ時間*が使用されます。これは通常、コンピュータに設定されているタイムゾーンと同じです。
   + UTC を含む標準の [ISO 8601 タイムゾーン ](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)を使用します。
+ **[自動更新]** は、相対時間に表示されるオプションをカスタマイズし、自動更新オプションエントリはカンマ区切りで、有効な時間単位を受け入れます。
+ **[遅延時間の指定]** は、遅延時間を入力して `now` 時間を上書きします。このオプションを使用して、null 値を避けるために、データ集約の既知の遅延に対応します。
+ **[タイムピッカーを非表示]** は、Grafana タイムピッカーの表示を非表示にします。

**注記**  
時間コントロールの使用には、データに時間列が含まれている必要があります。時間列を含める方法の詳細については、特定の「[データソース](AMG-data-sources.md)」のドキュメントを参照してください。

**[注釈クエリの追加]**

注釈クエリは、イベントをクエリするクエリです。これらのイベントは、カーソルを合わせるとイベント情報を表示できる小さなアイコンとともに、ダッシュボード全体のグラフで垂直線として視覚化できます。

**n 注釈クエリを追加するには**

1. **[ダッシュボード設定]** ページで、**[注釈]** を選択します。

1. **[注釈クエリの追加]** を選択します。

1. 名前を入力し、データソースを選択します。

1. フォームの残りの部分に入力して、クエリと注釈を作成します。

クエリエディタの UI は、選択したデータソースに基づいて変わります。クエリの作成方法の詳細については、「[データソース](AMG-data-sources.md)」ドキュメントを参照してください。

**変数の追加**

変数を使用すると、よりインタラクティブで動的なダッシュボードを作成できます。メトリクスクエリでサーバー、アプリケーション、センサー名などをハードコーディングする代わりに変数を使用できます。変数は、ダッシュボードの上部にドロップダウンリストとして表示されます。これらのドロップダウンを使用すると、ダッシュボード内に表示されるデータを簡単に変更できます。

変数の詳細については、「[変数](v9-dash-variables.md)」を参照してください。

1. **[ダッシュボード設定]** ページで、左側のセクションメニューの **[変数]**、**[変数を追加]** ボタンを続けてクリックします。

1. **[全般]** セクションで、変数の名前を追加します。これは、後でクエリで使用する名前です。

1. 変数**タイプ**を選択します。
**注記**  
選択した変数タイプは、ページに入力するフィールドに影響します。

1. 変数を定義し、**[更新]** をクリックします。

**リンクの追加**

ダッシュボードリンクを使用すると、他のダッシュボードやウェブサイトへのリンクをダッシュボードヘッダーの直下に配置できます。リンクを使用すると、他の関連するダッシュボードやコンテンツに簡単に移動できます。

1.  **[ダッシュボード設定]** ページで、左側のセクションメニューから **[リンク]** をクリックし、次に **[リンクを追加]** ボタンをクリックします。

1.  タイトルを入力し、**[タイプ]** フィールドに **[ダッシュボード]** または **[リンク]** を選択します。

1.  ダッシュボードリンクを追加するには、オプションのタグを追加し、ダッシュボードリンクのオプションを選択して、**[適用]** をクリックします。
**注記**  
タグは、すべてが特定のタグを持つダッシュボードの動的なドロップダウンを作成するのに役立ちます。

1.  リンクを追加するには、ユーザーがリンクの上にカーソルを置いたときに表示される URL とツールヒントテキストを追加し、リンクの横に表示されるアイコンを選択して、ダッシュボードのリンクオプションを選択します。

**ダッシュボードの JSON モデルを表示する ** 

Grafana のダッシュボードは、ダッシュボードのメタデータを保存する JSON オブジェクトによって表されます。ダッシュボードメタデータには、ダッシュボードプロパティ、パネルからのメタデータ、テンプレート変数、パネルクエリなどが含まれます。

ダッシュボード JSON モデルを表示するには、**[ダッシュボード設定]** ページで **[JSON]** をクリックします。

JSON フィールドの詳細については、「[JSON フィールド](v9-dash-dashboard-json-model.md)」を参照してください。

# ダッシュボード URL 変数
<a name="v9-dash-dashboard-url-variables"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana は、ダッシュボード URL でクエリパラメータとして渡された変数値を適用できます。詳細については、「[ダッシュボードリンクの管理](v9-dash-manage-dashboard-links.md)」と「[テンプレートおよび変数の管理](v9-dash-variables.md)」を参照してください。

**変数をクエリパラメータとして渡す**

Grafana は、`var-` のプレフィックスが付加されたクエリ文字列パラメータを、特定のダッシュボードの変数として解釈します。

例えば、この URL では、次のようになります。

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

クエリパラメータ `var-example=value` は、ダッシュボード変数の例を表し、値は `value` です。

**変数に複数の値を渡す**

複数の値を渡すには、値ごとに変数パラメータを 1 回繰り返します。

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana は、 `var-example=value1&var-example=value2` を `value1` と `value2` の 2 つの値を持つダッシュボード変数の例として解釈します。

**ダッシュボードリンクへの変数の追加**

Grafana は、ダッシュボードの設定から変数を生成するときに、ダッシュボードリンクに変数を追加できます。変数を追加する方法と手順の詳細については、「[ダッシュボードリンクの管理](v9-dash-manage-dashboard-links.md)」を参照してください。

**アドホックフィルターを渡す**

アドホックフィルターは、指定されたデータソースを使用するすべてのメトリクスクエリにキーまたは値フィルターを適用します。詳細については、「[アドホックフィルター]()」を参照してください。

アドホックフィルターをクエリパラメータとして渡すには、変数構文を使用してアドホックフィルター変数を渡し、キー、演算子を値、値をパイプ区切りリストとして指定します。

例えば、この URL では、次のようになります。

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

クエリパラメータ `var-adhoc=key|=|value` は、 `example_key` キー、 `=` 演算子、および `example_value` 値を使用して、アドホックダッシュボード変数として設定されたアドホックフィルターを適用します。

**注記**  
アドホックフィルターを使用して URL を共有する場合は、必ず URL をエンコードしてください。上記の例では、パイプ `(|)` を `%7C`に、等価演算子 `(=)` を ` %3D` に置き換えます。

**URL の使用による時間範囲の制御**

ダッシュボードの時間範囲を設定するには、`from`、`to`、`time`、および `time.window` クエリパラメータを使用します。これらは変数ではないため、`var-` プレフィックスは必要ありません。

# ダッシュボードへのライブラリパネルの追加
<a name="v9-dash-manage-library-panels"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ライブラリパネルは、任意のダッシュボードで使用できる再利用可能なパネルです。ライブラリパネルを変更すると、その変更はパネルが使用されているすべてのインスタンスに反映されます。ライブラリパネルは、複数のダッシュボード間でパネルの再利用を合理化します。

ライブラリパネルは、保存されたダッシュボードとともにフォルダに保存できます。

**ライブラリパネルの作成**

ライブラリパネルを作成すると、ソースダッシュボードのパネルもライブラリパネルに変換されます。パネルが変換されたら、元のダッシュボードを保存する必要があります。

1. 編集モードでパネルを開きます。

1. パネル表示オプションで、下矢印オプションをクリックして、視覚化に変更を加えます。

1. **[作成]** ダイアログボックスを開くには、**[ライブラリパネル]** オプションをクリックし、**[ライブラリパネルの作成]** をクリックします。

1. **[ライブラリパネル名]** に名前を入力します。

1. **[フォルダに保存]** で、ライブラリパネルを保存するフォルダを選択します。

1. **[ライブラリパネルの作成]** をクリックして変更を保存します。

1. ダッシュボードを保存するには、 **[保存]** をクリックします。

ライブラリパネルの作成後、そのパネルは、パネルが表示される任意のダッシュボードを使用して変更することができます。変更を保存すると、ライブラリパネルのすべてのインスタンスにこれらの変更が反映されます。

**ダッシュボードへのライブラリパネルの追加**

他のダッシュボードユーザーに視覚化を提供する場合は、Grafana ライブラリパネルをダッシュボードに追加します。

1. 左のメニューの **[ダッシュボード]** オプションにカーソルを合わせ、ドロップダウンオプションから **[新しいダッシュボード]** を選択します。**[パネルの追加]** ダイアログボックスが開きます。

1. [パネルライブラリ] オプションから **[パネルの追加]** をクリックします。ライブラリパネルのリストが表示されます。

1. リストを検索またはフィルタリングして、追加するパネルを見つけます。

1. パネルをクリックしてダッシュボードに追加します。

**ライブラリパネルのリンク解除**

ライブラリパネルに変更を加える必要があるときにライブラリパネルの他のインスタンスに影響を与えたくない場合は、ライブラリパネルのリンクを解除します。

1. 左側のメニューの **[ダッシュボード]** にカーソルを合わせ、**[ライブラリパネル]** をクリックします。

1. さまざまなダッシュボードで使用されているライブラリパネルを選択します。

1. リンクを解除するパネルを選択します。

1. パネルのタイトルをクリックし、**[編集]** をクリックします。パネルは編集モードで開きます。

1. ページの右上隅にある **[リンク解除]** オプションをクリックします。

**ライブラリパネルのリストの表示**

ライブラリパネルに変更を加える必要があるときにライブラリパネルの他のインスタンスに影響を与えたくない場合は、ライブラリパネルのリンクを解除します。

1. 左側のメニューの **[ダッシュボード]** オプションにカーソルを合わせ、**[ライブラリパネル]** をクリックします。以前に定義したライブラリパネルのリストが表示されます。

1. 名前がわかっている場合は、特定のライブラリパネルを検索します。パネルをフォルダまたはタイプでフィルタリングすることもできます。

**ライブラリパネルの削除**

不要になったライブラリパネルを削除します。

1. 左側のメニューの **[ダッシュボード]** にカーソルを合わせ、**[ライブラリパネル]** を選択します。

1. 削除するパネルを選択します。

1. ライブラリ名の横にある [削除] アイコンをクリックします。

# ダッシュボードのバージョン履歴の管理
<a name="v9-dash-manage-version-history"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボードのバージョンを保存するたびに、以前のバージョンのダッシュボードが失われないように、そのバージョンのコピーが保存されます。これらのバージョンのリストは、ダッシュボード設定に進み、左側のメニューで **[バージョン]** を選択することで確認できます。

ダッシュボードのバージョン履歴機能では、以前に保存したダッシュボードバージョンを比較して復元できます。

**2 つのダッシュボードバージョンの比較**

2 つのダッシュボードバージョンを比較するには、比較するリストから 2 つのバージョンを選択します。**[バージョンの比較]** をクリックして、2 つのバージョン間の差分を表示します。

ボタンをクリックすると、差分ビューが表示されます。デフォルトでは、変更の概要がテキストで表示されます。

また、下部の **[JSON 差分の表示]** ボタンをクリックすることで、ダッシュボードを表す raw JSON の差分を表示できます。

差分対象のバージョンに復元する場合は、右上の **[バージョン <x> に復元]** ボタンをクリックして復元できます。

**以前に保存したダッシュボードバージョンへの復元**

以前に保存したダッシュボードバージョンに復元する必要がある場合は、ダッシュボードバージョンリストの行の右側にある**[復元**] ボタンを選択するか、差分ビューで **[バージョン <x> に復元]** ボタンを選択します。ボタンをクリックすると、復元の確認を求める次のポップアップが表示されます。

以前のバージョンに復元すると、バージョン番号が異なるだけで、以前のバージョンとまったく同じデータを含む新しいバージョンが作成されます。これは、新しいダッシュボードバージョンの行の **[メモ列]** に表示されます。これは、以前のダッシュボードバージョンが変更の影響を受けないようにするためにのみ行われます。

# ダッシュボードリンクの管理
<a name="v9-dash-manage-dashboard-links"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

リンクを使用すると、よく使用されるダッシュボード間を移動、または他のユーザーを視覚化に接続できます。リンクでは、他のダッシュボード、パネル、さらには外部ウェブサイトへのショートカットを作成できます。

Grafana では、ダッシュボードリンク、パネルリンク、データリンクをサポートしています。ダッシュボードリンクはダッシュボードの上部に表示されます。パネルリンクにアクセスするためには、パネルの左上隅にあるアイコンを選択します。

**使用するリンクの選択**

最初にダッシュボード間の現在の移動方法を確認します。頻繁に一連のダッシュボード間でジャンプし、各ダッシュボードで同じコンテキストを見つけるのに苦労している場合、ワークフローの最適化にリンクが役立ちます。

次のステップでは、ご使用のワークフローに適したリンクタイプを特定します。Grafana のすべてのリンクタイプは他のダッシュボードや外部ウェブサイトへのショートカットの作成に使用されますが、それらはさまざまなコンテキストで動作します。
+ リンクがダッシュボード内のほとんどのパネルに関連する場合は、ダッシュボードリンクを使用します。
+ 特定のパネルにドリルダウンする場合は、パネルリンクを使用します。
+ 外部サイトへのリンクには、ダッシュボードリンクまたはパネルリンクのいずれかを使用できます。
+ 特定のシリーズ、または 1 つの測定までドリルダウンするには、データリンクを使用します。

**URL の使用による時間範囲の制御**

ダッシュボード URL に次のクエリパラメータを指定すると、パネルまたはダッシュボードの時間範囲を制御できます。
+ `from` は、エポックミリ秒で指定した、時間範囲の下限を定義します。
+ `to` は、エポックミリ秒で指定された時間範囲の上限を定義します。
+ `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータをミリ秒で指定する必要があります。たとえば、`?time=1500000000000&time.window=10000` は、1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。

**ダッシュボードリンク**

ダッシュボードリンクを作成するときに、時間範囲と現在のテンプレート変数を含めることで、別のダッシュボードの同じコンテキストに直接ジャンプできます。これにより、リンクの送信先が適切なデータを表示しているかどうかを心配する必要がなくなります。他のタイプのリンクについては、「[データリンク変数]()」を参照してください。

ダッシュボードリンクは、[現在のダッシュボード名で GitHub の問題](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests)を送信するなど、外部システムへのショートカットとしても使用できます。

ダッシュボードリンクを追加すると、ダッシュボードの右上隅に表示されます。

**ダッシュボードへのリンクの追加**

現在のダッシュボードの上部にある他のダッシュボードへのリンクを追加します。

1. リンクするダッシュボードを表示しながら、画面上部の歯車をクリックして **[ダッシュボード設定]** を開きます。

1. **[リンク]** をクリックし、**[ダッシュボードリンクを追加]** または **[新規]** をクリックします。

1. **[タイプ]** で、**[ダッシュボード]** を選択します。

1. 以下からリンクオプションを選択します。
   + **[タグあり]**: タグを入力して、リンクされたダッシュボードを、入力したタグを持つダッシュボードのみに制限します。それ以外の場合、Grafana には他のすべてのダッシュボードへのリンクが含まれます。
   + **[ドロップダウン]**: 多くのダッシュボードにリンクしている場合は、このオプションを選択し、ドロップダウンにオプションのタイトルを追加することをお勧めします。それ以外の場合、Grafana はダッシュボードのリンクをダッシュボードの上部に並べて表示します。
   + **[時間範囲]**: リンクにダッシュボードの時間範囲を含めるには、このオプションを選択します。ユーザーがリンクをクリックすると、リンクされたダッシュボードが開き、指定された時間範囲が既に設定されています。
   + **[変数値]**: このオプションを選択すると、リンクにクエリパラメータとして現在使用されているテンプレート変数を含めることができます。ユーザーがリンクをクリックすると、リンクされたダッシュボード内の一致するテンプレートがリンクの値に設定されます。詳細については、「[ダッシュボード URL 変数](v9-dash-dashboard-url-variables.md)」を参照してください。
   + **[新しいタブで開く]**: ダッシュボードリンクを新しいタブまたはウィンドウで開く場合は、このオプションを選択します。

1. **[追加]** をクリックします。

**ダッシュボードへの URL リンクの追加**

現在のダッシュボードの上部にある URL へのリンクを追加します。ダッシュボード、パネル、外部サイトなど、使用可能なあらゆる URL にリンクできます。時間範囲を制御して、ユーザーが Grafana の適切なデータを重点的に確認できるようにすることもできます。

1. リンクするダッシュボードを表示しながら、画面上部の歯車をクリックして **[ダッシュボード設定]** を開きます。

1. **[リンク]** をクリックし、**[ダッシュボードリンクを追加]** または **[新規]** をクリックします。

1. [タイプ] で **[リンク]** を選択します。

1. 以下からリンクオプションを選択します。
   + **URL**: リンク先の URL を入力します。ターゲットによっては、フィールド値を含めることもできます。詳細については、[この Github の例](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests)を参照してください。
   + **タイトル**: リンクを表示するタイトルを入力します。
   + **ツールヒント**: リンクを表示するツールヒントを入力します。
   + **アイコン**: リンクとともに表示するアイコンを選択します。
   + **[時間範囲]**: リンクにダッシュボードの時間範囲を含めるには、このオプションを選択します。ユーザーがリンクをクリックすると、リンクされたダッシュボードが開き、指定された時間範囲が設定されます。
     + `from` は、エポックミリ秒で指定した、時間範囲の下限を定義します。
     + `to` は、エポックミリ秒で指定された時間範囲の上限を定義します。
     + `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータをミリ秒で指定する必要があります。たとえば、`?time=1500000000000&time.window=10000` は、1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。
   + **[変数値]**: このオプションを選択すると、リンクにクエリパラメータとして現在使用されているテンプレート変数を含めることができます。ユーザーがリンクをクリックすると、リンクされたダッシュボード内の一致するテンプレートがリンクの値に設定されます。

     変数の形式は次のとおりです。

     `https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2`
   + **[新しいタブで開く]**: ダッシュボードリンクを新しいタブまたはウィンドウで開く場合は、このオプションを選択します。

1. **[追加]** をクリックします。

**ダッシュボードリンクの更新**

既存のダッシュボードリンクを変更または更新するには、次のステップに従います。

1. **[ダッシュボード設定]**, の **[リンク]** タブで、編集する既存のリンクをクリックします。

1. 設定を変更し、**[更新]** をクリックします。

**ダッシュボードリンクの複製**

既存のダッシュボードリンクを複製するには、複製する既存のリンクの横にある複製アイコンをクリックします。

**ダッシュボードリンクの削除**

既存のダッシュボードリンクを削除するには、削除する複製アイコンの横にあるゴミ箱アイコンをクリックします。

**パネルリンク**

各パネルには、パネルの左上隅に表示する一連の独自のリンクを含めることができます。ダッシュボード、パネル、外部サイトなど、使用可能なあらゆる URL にリンクできます。時間範囲を制御して、ユーザーが Grafana の適切なデータを重点的に確認できるようにすることもできます。

使用可能なパネルリンクを表示するには、パネルの左上隅にあるアイコンをクリックします。
+ **パネルリンクの追加**: 各パネルには、パネルの左上隅に表示される独自のリンクセットを指定できます。ダッシュボード、パネル、外部サイトなど、使用可能なあらゆる URL にリンクできます。時間範囲を制御して、ユーザーが Grafana の適切なデータを重点的に確認できるようにすることもできます。パネルの左上隅にあるアイコンをクリックすると、使用可能なパネルリンクが表示されます。

  1. リンクを追加するパネルにカーソルを合わせ、`e` を押すか、または、パネルタイトルの横にあるドロップダウン矢印をクリックし、**[編集]** をクリックします。

  1. **[パネル]** タブで、**[リンク]** セクションまでスクロールダウンします。

  1. **[リンク]**を展開し、**[リンクの追加]** をクリックします。

  1. **[タイトル]** を入力します。**[タイトル]**は、UI に表示されるリンクの判読可能なラベルです。

  1. リンク先の **URL** を入力します。ダッシュボードで定義済みのテンプレート変数のいずれかを追加することもできます。`Ctrl+Space` または `Cmd+Space` を押して URL フィールドをクリックし、使用可能な変数を表示します。パネルリンクにテンプレート変数を追加することで、関連する変数がすでに設定されている適切なコンテキストをリンクからユーザーに送信します。

     時間変数も使用できます。
     + `from` は、エポックミリ秒で指定した、時間範囲の下限を定義します。
     + `to` は、エポックミリ秒で指定した、時間範囲の上限を定義します。
     + `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータはミリ秒で指定する必要があります。たとえば、`?time=1500000000000&time.window=10000` は、1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。
+ **パネルリンクの更新**

  1. **[パネル]** タブで、変更するリンクを見つけます。

  1. **[編集]** (鉛筆) アイコンをクリックして、[リンクの編集] ウィンドウを開きます。

  1. 必要に応じて変更します。

  1. **[保存]** をクリックして変更を保存し、ウィンドウを閉じます。

  1. 右上の **[保存]** をクリックして、ダッシュボードに変更を保存します。
+ **パネルリンクの削除**

  1. **[パネル]** タブで、変更するリンクを見つけます。

  1. 削除するリンクの横にある **[X]** アイコンをクリックします。

  1. 右上の **[保存]** をクリックして、ダッシュボードに変更を保存します。

# ダッシュボード JSON モデル
<a name="v9-dash-dashboard-json-model"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana のダッシュボードは、ダッシュボードのメタデータを保存する JSON オブジェクトによって表されます。ダッシュボードメタデータには、ダッシュボードプロパティ、パネルからのメタデータ、テンプレート変数、パネルクエリが含まれます。

ダッシュボードの JSON を表示する方法。

1. ダッシュボードに移動します。

1. 上部のナビゲーションメニューで、**[ダッシュボード設定]** (歯車) アイコンをクリックします。

1. **[JSON モデル]** をクリックします。

**JSON フィールド**

ユーザーが新しいダッシュボードを作成すると、新しいダッシュボード JSON オブジェクトが次のフィールドで初期化されます。

**注記**  
次の JSON では、id は null として表示されます。これは、ダッシュボードが保存されるまで割り当てられるデフォルト値です。ダッシュボードを保存すると、整数値が `id` フィールドに割り当てられます。

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

以下は、ダッシュボード JSON の各フィールドについて説明します。


| 名前 | 使用方法 | 
| --- | --- | 
| **id** | ダッシュボードの一意の数値識別子 (db によって生成） | 
| **uid** | 誰でも生成できる一意のダッシュボード識別子。 文字列 (8～40) | 
| **title** | ダッシュボードの現在のタイトル | 
| **[タグ]** | ダッシュボードに関連付けられたタグ、文字列の配列 | 
| **Style** | *ダーク*や*ライト*などのダッシュボードのテーマ | 
| **timezone** | *utc* や*ブラウザ*などのダッシュボードのタイムゾーン | 
| **editable** | ダッシュボードが編集可能かどうか | 
| **graphTooltip** | 共有十字線またはツールチップなしの場合は 0 (デフォルト）、共有十字線の場合は 1、共有十字線と共有ツールチップの場合は 2 | 
| **time** | *過去 6 時間*や*過去 7 日*など、ダッシュボードの時間範囲 | 
| **timepicker** | timepicker メタデータ。詳細については「[timepicker セクション](#v9-dash-dashboard-json-model)」を参照してください。 | 
| **[テンプレート作成‭]** | メタデータのテンプレート作成。詳細については[[テンプレート作成セクション](#v9-dash-dashboard-json-model)を参照してください。 | 
| **annotations** | 注釈メタデータ。追加方法については「[注釈](v9-panels-annotate-visualizations.md)」を参照してください。 | 
| **[更新]** | 自動更新間隔 | 
| **schemaVersion** | JSON スキーマのバージョン (整数)。Grafana 更新がこのスキーマに変更を加えるたびに増加します。 | 
| **version** | ダッシュボードのバージョン (整数）。ダッシュボードが更新されるたびに増加します。 | 
| **panels** | パネル配列 (詳細については、以下を参照） | 

**パネル**

パネルはダッシュボードの構成要素であり、データソースクエリ、グラフのタイプ、エイリアスなどで構成されます。パネル JSON は、JSON オブジェクトの配列で構成され、それぞれが異なるパネルを表します。ほとんどのフィールドはすべてのパネルで共通ですが、一部のフィールドはパネルタイプによって異なります。以下は、テキストパネルのパネル JSON の例です。

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**パネルのサイズと位置**

gridPos プロパティは、グリッド座標のパネルサイズと位置を記述します。
+ `w`: 1～24 (ダッシュボードの幅は 24 列に分割されます)
+ `h`: グリッドの高さの単位では、それぞれ 30 ピクセルを表します。
+ `x`: `w` と同じ単位の x 位置。
+ `y`: `h` と同じ単位の y 位置。

グリッドには負の重力があり、パネルの上に空のスペースがある場合にパネルを上に移動します。

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**[テンプレート作成‭]**

`templating` フィールドには、保存された値を含むテンプレート変数の配列と、他のメタデータが含まれています。

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

# ダッシュボードの管理
<a name="v9-dash-managing-dashboards"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボードは、データを 1 つ以上の行に視覚的に表示する 1 つ以上の[パネル](v9-panels.md)のセットです。

ダッシュボードの作成の詳細については、[[パネルの追加と整理]]()を参照してください。

## ダッシュボードフォルダの作成
<a name="v9-dash-create-dashboard-folder"></a>

フォルダはダッシュボードの整理とグループ化に役立ちます。これは、同じGrafanaインスタンスを使用する多くのダッシュボードや複数のチームがある場合に便利です。

**前提条件**

Grafana 管理者のアクセス許可があることを確認します。ダッシュボードのアクセス許可の詳細については、[「ダッシュボードのアクセス許可](Grafana-administration-authorization.md)」を参照してください。

**ダッシュボードフォルダを作成するには**

1. Grafana にサインインし、サイドメニューで **[ダッシュボード] > [新しいフォルダ]** をクリックします。

1. 一意の名前を入力し、**[作成]** をクリックします。

**注記**  
ダッシュボードを保存するときは、ダッシュボードを保存するフォルダを選択するか、新しいフォルダを作成するかを選択できます。

## ダッシュボードとフォルダの管理
<a name="v9-dash-manage-dashboard-folder"></a>

**ダッシュボードとフォルダの管理**ページで、次のことができます。
+ フォルダを作成する
+ ダッシュボードを作成する
+ ダッシュボードをフォルダに移動する
+ 複数のダッシュボードを削除する
+ フォルダとダッシュボードのアクセス許可を割り当てることができるフォルダページに移動する

**ダッシュボードフォルダページ**

**[ダッシュボードフォルダ]** ページで、以下の操作を行うことができます。
+ フォルダ内のダッシュボードを移動または削除する。
+ フォルダの名前を変更する (**[設定]** タブで使用可能)。
+ フォルダ (フォルダ内のダッシュボードによって継承される) にアクセス許可を割り当てる。

[ダッシュボードフォルダ] ページに移動するには、ダッシュボード検索結果リストのフォルダまたは **[ダッシュボードとフォルダの管理]** ページにカーソルを合わせると、歯車が表示されます。

**ダッシュボードのアクセス許可**

フォルダにアクセス許可を割り当てることができます。割り当てたアクセス許可は、フォルダ内のダッシュボードによって継承されます。アクセスコントロールリスト (ACL) は、**組織ロール **、**チーム**、**ユーザー**に権限を割り当てるために使用します。

詳細については、「[アクセス許可](Grafana-permissions.md)」を参照してください。

## ダッシュボードのエクスポートとインポート
<a name="v9-dash-export-import-dashboards"></a>

Grafana UI または HTTP API を使用してダッシュボードをエクスポートおよびインポートできます。

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

ダッシュボードのエクスポートアクションは、レイアウト、変数、スタイル、データソース、クエリなど、必要なすべてを含む Grafana JSON ファイルを作成し、後でダッシュボードをインポートできるようにします。

**注記**  
Grafana は JSON ファイルをローカルマシンにダウンロードします。

1. エクスポートするダッシュボードを開きます。

1. 共有アイコンを選択します。

1. **[エクスポート]** をクリックします。

1. **[ファイルに保存]** を選択します。

**ダッシュボードをポータブルにする**

他のユーザーが使用するためにダッシュボードをエクスポートする場合は、メトリクスプレフィックス (定数変数を使用) やサーバー名などのテンプレート変数を追加できます。

タイプ `Constant` のテンプレート変数はダッシュボードで自動的に非表示になり、ダッシュボードのインポート時に必要な入力として追加されます。

**ダッシュボードのインポート**

1. サイドメニューで **[ダッシュボード]** を選択します。

1. **[新規]** を選択し、ドロップダウンメニューから **[インポート]** を選択します。

1. 次のいずれかのステップを実行します。
   + ダッシュボード JSON ファイルをアップロードします。
   + [Grafana.com](https://grafana.com/) ダッシュボード URL を貼り付けます。
   + ダッシュボードの JSON テキストをテキストエリアに直接貼り付けます。

   インポートプロセスでは、ダッシュボードの名前を変更し、ダッシュボードで使用するデータソースを選択し、メトリクスプレフィックス (ダッシュボードが使用している場合) を指定できます。

## ダッシュボードのトラブルシューティング
<a name="v9-dash-troubleshooting"></a>

このセクションでは、一般的なダッシュボードの問題を解決するのに役立つ情報を提供します。

**ダッシュボードが遅い**

ダッシュボードが遅い場合は、次の点を考慮してください。
+ グラフに数十 (または数百または数千) の時系列をレンダリングしようとしていますか？ これにより、ブラウザが遅延する可能性があります。highestMax (Graphite 内) などの関数を使用して、返されるシリーズを減らします。
+ 場合によっては、シリーズ名が非常に大きくなることがあります。これにより、レスポンスサイズが大きくなります。エイリアスを使用して、返されるシリーズ名のサイズを小さくしてみてください。
+ 多くの時系列または長い時間範囲をクエリしていますか？ これらの両方の条件により、Grafana またはデータソースが大量のデータを取得し、ダッシュボードの速度が低下する可能性があります。
+ ネットワークインフラストラクチャに高負荷が発生している場合があり、特に速度が一貫していない場合は、これが問題である可能性があります。

**ダッシュボードの更新レートの問題**

デフォルトでは、Grafana は 30 秒ごとにデータソースをクエリします。ダッシュボードの更新率を低く設定すると、バックエンドに不要なストレスがかかります。多くの場合、変更が表示されるようにデータがシステムに送信されることはないため、頻繁にクエリを実行する必要はありません。

この問題が発生した場合は、次の解決策をお勧めします。
+ ダッシュボード、パネル、変数の自動更新は、必要でない限り有効にしないでください。ユーザーはブラウザを手動で更新するか、妥当な期間 (10 分または 1 時間ごとなど) の更新レートを設定することができます。
+ 必要に応じて、更新レートを 1 分に 1 回に設定します。ユーザーはいつでもダッシュボードを手動で更新できます。
+ ダッシュボードの期間が長い場合 (1 週間など）、自動更新は必要ない場合があります。

**null データの処理またはレンダリングが間違っている、または混乱している**

一部のアプリケーションは断続的にデータを発行します。例えば、イベントが発生した場合にのみメトリクスを投稿します。デフォルトでは、Grafana グラフはデータポイント間の線を接続します。

# ダッシュボードとパネルの共有
<a name="v9-dash-sharing"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana を使用すると、組織内の他のユーザーとダッシュボードやパネルを共有したり、特定の状況でウェブ上で公開したりできます。以下を使用して共有できます。
+ 直接リンク
+ スナップショット
+ エクスポートリンク (ダッシュボードのみ）

直接リンクによってレンダリングされた画像を表示するには、許可されたビューワーアクセス許可が必要です。

Grafana インスタンスに対して匿名アクセス許可が有効になっていない限り、埋め込みリンクを表示するには同じアクセス許可も必要です。

パネルまたはダッシュボードをスナップショットとして共有すると、スナップショット (スナップショットを作成した時点のパネルまたはダッシュボード) がウェブ上で公開されます。リンクを持つユーザーは誰でもアクセスできます。スナップショットは表示に許可を必要としないため、Grafana は、取得したアカウントに関する情報と機密データをスナップショットから削除します。

## ダッシュボードの共有
<a name="v9-dash-share-dashboard"></a>

ダッシュボードは、直接リンクまたはスナップショットとして共有できます。ダッシュボードをエクスポートすることもできます。

**注記**  
ダッシュボードを変更する場合は、共有する前に変更を保存してください。

1. Grafana インスタンスのホームページに移動します。

1. 上部ナビゲーションの共有アイコンをクリックします。

   共有ダイアログボックスが開き、**[リンク]** タブが表示されます。

**ダイレクトリンクの共有**

**[リンク]** タブには、現在の時間範囲、テンプレート変数、デフォルトのテーマが表示されます。短縮 URL を共有することもできます。

1. **[コピー]** をクリックします。このアクションにより、デフォルトまたは短縮 URL がクリップボードにコピーされます。

1. コピーした URL を、リンクを表示する権限を持つ Grafana ユーザーに送信します。

**スナップショットの公開**

ダッシュボードスナップショットは、インタラクティブダッシュボードをパブリックに共有します。Grafana はクエリ (メトリクス、テンプレート、注釈) やパネルリンクなどの機密データを消去し、ダッシュボードに埋め込まれた可視メトリクスデータとシリーズ名のみが残されます。ダッシュボードスナップショットには、リンクを持つすべてのユーザーがアクセスできます。

スナップショットはローカルインスタンスに発行できます。

1. **[ローカルスナップショット]** をクリックします。

1. Grafana がスナップショットのリンクを生成します。スナップショットリンクをコピーし、組織内またはウェブ上で公開します。

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

Grafana ダッシュボードは簡単にエクスポートおよびインポートできます。詳細については、「[インポートとエクスポート](v9-dash-managing-dashboards.md#v9-dash-export-import-dashboards)」を参照してください。

## パネルの共有
<a name="v9-dash-share-panel"></a>

パネルは、直接リンクまたはスナップショットとして共有できます。任意のパネルで **[共有]** オプションを使用してライブラリパネルを作成することもできます。

1. パネルタイトルをクリックして、パネルメニューを開きます。

1. **[共有]** をクリックします。共有ダイアログボックスが開き、**[リンク]** タブが表示されます。

**直接リンクの使用**

**[リンク]** タブには、現在の時間範囲、テンプレート変数、デフォルトのテーマが表示されます。必要に応じて、短縮 URL を有効にして共有できます。

1. **[コピー]** をクリックして、デフォルトまたは短縮 URL をクリップボードにコピーします。

1. コピーした URL を、リンクを表示する権限を持つ Grafana ユーザーに送信します。

1. オプションで **[レンダリングイメージを直接リンク]** をクリックして、パネルのイメージを共有することもできます。

**サーバー側のレンダリングされたイメージの文字列パラメータのクエリ**
+ **幅**: ピクセル単位での幅。デフォルトは 800 です。
+ **高さ**: ピクセル単位での高さ。デフォルトは 400 です。
+ **tz**: HH と MM が UTC の後に時間と分でオフセットされる `UTC%2BHH%3AMM` 形式のタイムゾーン。
+ **タイムアウト**: 秒数。パネルのクエリがデフォルトの 30 秒を超える場合、タイムアウトを延長できます。
+ **スケール**: デバイススケール係数を設定する数値。デフォルトは 1 です。値を大きくすると、より詳細な画像 (DPI が高くなる) が生成されます。Grafana v7.0 以降でサポートされています。

**スナップショットの公開**

パネルスナップショットは、インタラクティブパネルをパブリックで共有します。Grafana は機密データを取り除き、ダッシュボードに埋め込まれた可視メトリクスデータとシリーズ名のみを残します。パネルスナップショットには、リンクを持つすべてのユーザーがアクセスできます。

スナップショットはローカルインスタンスに発行できます。

1. **[パネルの共有]** ダイアログボックスで、**[スナップショット]** タブを選択します。

1. **[ローカルスナップショット]** をクリックします。Grafana はスナップショットのリンクを生成します。

1. スナップショットリンクをコピーし、組織内またはウェブ上で公開します。

誤ってスナップショットを作成した場合は、**[スナップショットの削除]** をクリックして、Grafana インスタンスからスナップショットを削除します。

**ライブラリパネルの作成**

**[パネルの共有]** ダイアログボックスからライブラリパネルを作成できます。

1. **[ライブラリパネル]** をクリックします。

1. **[ライブラリパネル名]** に名前を入力します。

1. **[フォルダに保存]**、ライブラリパネルを保存するフォルダを選択します。デフォルトでは、**[一般]** フォルダが選択されています。

1. **[ライブラリパネルの作成]** を選択して変更を保存します。

1. **[保存]**をクリックしてダッシュボードを保存します。

# プレイリストの管理
<a name="v9-dash-managing-playlists"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

*プレイリスト*は、順番に表示されるダッシュボードのリストです。プレイリストを使用して状況認識を構築したり、チームや訪問者にメトリクスを提示したりできます。Grafana はダッシュボードを任意の解像度に自動的にスケーリングするため、大きな画面に最適です。**[ダッシュボード]** サブメニューの Grafana のサイドメニューからプレイリスト機能にアクセスできます。

## プレイリストへのアクセス、共有、制御
<a name="v9-dash-access-share-control-playlist"></a>

このセクションの情報を参照して、既存のプレイリストにアクセスします。5 つの使用可能なモードのいずれかを使用して、プレイリストの表示を開始して制御します。

**プレイリストにアクセスするには**

1. Grafana のサイドメニューにカーソルを合わせます。

1. **[プレイリスト]** をクリックします。

   既存のプレイリストのリストが表示されます。

**プレイリストの開始**

プレイリストの開始は 5 種類のビューモードから選択できます。表示モードによって、ダッシュボードへのメニューとナビゲーションバーの表示方法が異なります。

デフォルトでは、各ダッシュボードは**間隔**フィールド (プレイリストの作成時または編集時に設定可能) に入力された時間表示されます。プレイリストを開始したら、ページ上部のナビゲーションバーを使用してプレイリストを制御できます。

プレイリストには、プレイリストの作成時または編集時に設定された `Interval` フィールドで指定された時間の間、各ダッシュボードが表示されます。プレイリスト開始後は、画面上部のナビゲーションバーで制御します。

1. プレイリストページにアクセスして、既存のプレイリストのリストを表示します。

1. 開始するプレイリストを検索し、**[プレイリストの開始]** をクリックします。

   プレイリストの開始ダイアログボックスが開きます。

1. 次の表の情報に基づいて、使用可能な 5 つのプレイリストモードのいずれかを選択します。

1. [開始] をクリックします。


| モード | 説明 | 
| --- | --- | 
| 通常モード |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| TV モード |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| TV モード (自動フィットパネル付き) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| キオスクモード |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| キオスクモード (自動フィットパネル付き) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 

**プレイリストの制御**

プレイリストの開始後は、画面上部のナビゲーションバーを使用して、**[普通]**モードまたは**[テレビ]**モードでプレイリストを制御できます。キーボードの `Esc` キーを押して、プレイリストを停止します。


| ボタン | Action | 
| --- | --- | 
| 次へ (二重右矢印) | 次のダッシュボードに進みます。 | 
| 戻る (左矢印） | 前のダッシュボードに戻ります。 | 
| 停止 (四角) | プレイリストを終了し、現在のダッシュボードに戻ります。 | 
| サイクルビューモード (モニターアイコン) | ダッシュボードの表示をさまざまなビューモードでローテーションします。 | 
| [時間範囲] | 指定した時間範囲内のデータを表示します。下矢印を使用して、過去 5 分から 5 年前、または表示するカスタム時間範囲を設定します。 | 
| 更新 (円矢印) | ダッシュボードを再読み込みして、最新のデータを表示します。ドロップダウン矢印を使用して、5 秒から 1 日ごとに自動的にリロードするように設定することもできます。 | 

## プレイリストの作成
<a name="v9-dash-create-playlist"></a>

プレイリストを作成して、ダッシュボード間の順序と時間間隔を設定して、ダッシュボードを順番に表示できます。

1. プレイリストページの **[新規プレイリスト]** をクリックします。

1. **[名前]** テキストボックスにわかりやすい名前を入力します。

1. **[間隔]** テキストボックスに時間間隔を入力します。
**注記**  
追加したダッシュボードは、順番に表示されます。

1. **[ダッシュボード]** で、**[タイトルで追加]** および **[タグで追加]** ドロップダウンオプションを使用して、既存のダッシュボードをプレイリストに追加します。

1. オプションで次のことが可能です:
   + ダッシュボードの名前、正規表現、またはタグでダッシュボードを検索します。
   + スター付きのステータスやタグで結果をフィルタリングします。
   + 上下矢印アイコンを使用して、追加したダッシュボードの順序を変更します。
   + ダッシュボードの横にある **X **アイコンをクリックして、プレイリストからダッシュボードを削除します。

1. **[保存]** をクリックして変更を保存します。

## プレイリストの保存
<a name="v9-dash-save-playlist"></a>

プレイリストを保存して**プレイリスト**ページに追加し、そこでプレイリストを開始できます。

**重要**  
プレイリストを保存する前かつプレイリストを作成または編集するときに、プレイリストに表示するすべてのダッシュボードが追加されていることを確認します。

1. プレイリスト機能にアクセスするには、Grafana のサイドメニューにカーソルを合わせます。

1. **[プレイリスト]** をクリックして、利用可能なプレイリストを表示します。

1. 選択したプレイリストをクリックします。

1. プレイリストを編集します。

1. プレイリストに **[名前]**、**[間隔]** が設定されており、少なくとも 1 つの**[ダッシュボード]**が追加されていることを確認します。

1. **[保存]** をクリックして変更を保存します。

## プレイリストの編集または削除
<a name="v9-dash-edit-delete-playlist"></a>

プレイリストを編集するには、名前、間隔時間を更新し、ダッシュボードの順序を追加、削除、再配置します。

**プレイリストの編集**

1. プレイリストページの **[プレイリストの編集]** をクリックします。

1. 上記の「プレイリストの作成」のステップに従って、名前と時間間隔を更新し、プレイリストからダッシュボードを追加または削除します。

1. **[保存]** をクリックして変更を保存します。

**プレイリストの削除**

1. **[プレイリスト]** をクリックします。

1. 削除するプレイリストの横にある **[削除]** をクリックします。

**ダッシュボードの順序の並べ替え**

1. 順序を変更するダッシュボードの横にある上矢印または下矢印をクリックします。

1. **[保存]** をクリックして変更を保存します。

**ダッシュボードの削除**

1. **[削除]** をクリックして、プレイリストからダッシュボードを削除します。

1. **[保存]** をクリックして変更を保存します。

## ビューモードでプレイリストを共有する
<a name="v9-dash-share-playlist-view-mode"></a>

お好みのビューモードで URL をコピーし、宛先に URL を貼り付けることで、プレイリストを共有できます。

1. **[ダッシュボード]** サブメニューで、**[プレイリスト] ** をクリックします。

1. 共有するプレイリストの横にある **[プレイリストの開始]** をクリックします。

1. ドロップダウンで、目的のビューモードを右クリックします。

1. **[リンクアドレスをコピー]** をクリックすると、URL がクリップボードにコピーされます。

1. 送信先に URL を貼り付けます。

# ダッシュボード変数の追加と管理
<a name="v9-dash-variables"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

変数は、値のプレースホルダーです。メトリクスクエリとパネルタイトルで変数を使用できます。したがって、ダッシュボードの上部にあるドロップダウンを使用して値を変更すると、パネルのメトリッククエリが変更され、新しい値が反映されます。

変数を使用すると、よりインタラクティブで動的なダッシュボードを作成できます。メトリクスクエリでサーバー、アプリケーション、センサー名などをハードコーディングする代わりに変数を使用できます。変数は、ダッシュボードの上部にドロップダウンリストとして表示されます。これらのドロップダウンを使用すると、ダッシュボード内に表示されるデータを簡単に変更できます。

これらは、Grafana ビューワーが視覚化をすばやく調整できるようにしたいが、完全な編集権限を付与したくない管理者にとって特に便利です。Grafana ビューワーは変数を使用できます。

変数とテンプレートを使用すると、単一ソースのダッシュボードを使用することもできます。同じデータソースまたはサーバーが複数ある場合は、1 つのダッシュボードを作成し、変数を使用して表示内容を変更できます。これにより、メンテナンスと維持が大幅に簡素化されます。

**テンプレート**

テンプレートは、変数を含むすべてのクエリです。たとえば、複数のサーバーを監視するダッシュボードを管理する場合は、サーバーごとにダッシュボードを作成するか、1 つのダッシュボードを作成して、次のようなテンプレートクエリを含むパネルを使用できます。

```
wmi_system_threads{instance=~"$server"}
```

変数値は、常に var-<varname>=value という構文を使用して URL に同期されます。

**例**

変数は、画面上部のドロップダウンリストに表示されます。さまざまな変数を選択して、視覚化がどのように変化するかを確認します。

変数設定を表示するには、**[ダッシュボード設定] > [変数]** に移動します。リスト内の変数をクリックすると、その設定が表示されます。


変数は、タイトル、説明、テキストパネル、クエリで使用できます。`$` で始まるテキストを含むクエリはテンプレートです。すべてのパネルにテンプレートクエリがあるわけではありません。

**変数のベストプラクティス**
+ 変数のドロップダウンリストは、**[ダッシュボード設定]** の変数リストに一覧されている順序で表示されます。
+ 頻繁に変更する変数を一番上に置くと、ダッシュボードの左端に最初に表示されるようになります。

# 変数の追加と管理
<a name="v9-dash-variable-add"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

次の表に、Grafana に組み込まれる変数タイプ一覧を示します。


| 変数タイプ | 説明 | 
| --- | --- | 
|  クエリ  |  メトリクス名、サーバー名、センサー ID、データセンターなど、クエリによって生成された値のリストです。クエリ変数を追加します。  | 
|  カスタム  |  カンマ区切りリストを使用して変数オプションを手動で定義します。カスタム変数を追加します。  | 
|  テキストボックス  |  オプションのデフォルト値を使用して、フリーテキスト入力フィールドを表示します。テキストボックス変数を追加します。  | 
|  定数  |  非表示の定数を定義します。定数変数を追加します。  | 
|  データソース  |  ダッシュボード全体のデータソースをすばやく変更します。データソース変数を追加します。  | 
|  間隔  |  間隔変数は時間範囲を表します。間隔変数を追加します。  | 
|  アドホックフィルター  |  データソースのすべてのメトリクスクエリに自動的に追加されるキー-値のフィルターを指します (Prometheus、Loki、InfluxDB、Elasticsearch のみ)。アドホックフィルターを追加します。  | 
|  グローバル変数  |  クエリエディタの式で使用できる組み込み変数です。「グローバル変数」を参照してください。  | 
|  連鎖変数  |  変数クエリには、他の変数を含めることができます。「連鎖変数」を参照してください。  | 

## 一般的なオプションの入力
<a name="v9-dash-variable-options"></a>

作成する変数のタイプには、一般的なオプションを入力する必要があります。

**一般的なオプションを入力するには**

1. 変数を作成するダッシュボードに移動し、ページ上部の **[ダッシュボード設定]** (歯車) アイコンを選択します。

1. **[変数]** タブで、**[新規]** を選択します。

1. 変数の **[名前]** を入力します。

1. **[タイプ]** 一覧で、**[クエリ]** を選択します。

1. （オプション) **[ラベル]** に、変数ドロップダウンの表示名を入力します。

   表示名を入力しない場合、ドロップダウンラベルは変数名です。

1. **[非表示]** オプションを次から選択します。
   + **[選択なし (空白)]:** 変数ドロップダウンには、変数の**名前**または**ラベル**値が表示されます。
   + **[ラベル]:** 変数ドロップダウンには、選択した変数値と下矢印のみが表示されます。
   + **[変数]:** ダッシュボードには変数ドロップダウンは表示されません。

## クエリ変数の追加
<a name="v9-dash-variable-add-query"></a>

クエリ変数を使用すると、メトリクス名、タグ値、またはキーのリストを返すデータソースクエリを記述できます。例えば、クエリ変数は、サーバー名、センサー ID、またはデータセンターのリストを返す場合があります。変数値は、データソースクエリでオプションを動的に取得するにつれて変化します。

クエリ変数は通常、文字列でのみサポートされます。クエリが数値またはその他のデータ型を返す場合は、変数として使用するために文字列に変換する必要があります。例えば、Azure データソースの場合、この目的のために [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) 関数を使用できます。

クエリ式には、他の変数への参照を含めることができ、実際にはリンクされた変数を作成できます。Grafana はこれを検出し、リンクされた変数のいずれかが変更されると変数を自動的に更新します。

**注記**  
クエリ式はデータソースごとに異なります。詳細については、ご使用の[データソース](AMG-data-sources.md)のドキュメントを参照してください。

**クエリ変数を追加するには**

1. 上記のように、一般的なオプションを入力します。

1. **[データソース]** リストで、クエリのターゲットデータソースを選択します。

1. **[更新]** リストで、変数がオプションを更新するタイミングを選択します。
   + **[ダッシュボード読み込み時]:** ダッシュボードが読み込まれるたびにデータソースにクエリを実行します。これにより、ダッシュボードの読み込みが遅くなります。ダッシュボードを初期化する前に変数クエリを完了する必要があるためです。
   + **[時間範囲の変更時]:** ダッシュボードの時間範囲が変更されたときにデータソースにクエリを実行します。このオプションは、可変オプションクエリに時間範囲フィルターが含まれているか、ダッシュボードの時間範囲に依存している場合にのみ使用します。

1. **[クエリ]** フィールドにクエリを入力します。
   + クエリフィールドはデータソースによって異なります。一部のデータソースには、カスタムクエリエディタがあります。
   + 1 つの入力フィールドクエリエディタにより多くのスペースが必要な場合は、フィールドの右下隅にある線上にカーソルを合わせ、下にドラッグして展開します。

1. (オプション) **[正規表現]** フィールドに正規表現を入力して、データソースクエリによって返される名前の特定部分をフィルタリングまたはキャプチャします。例については、「[正規表現での変数のフィルタリング](#v9-dash-variable-add-filter)」を参照してください。

1. **[ソート]** リストで、ドロップダウンリストに表示される値のソート順序を選択します。デフォルトのオプション **[無効]** では、データソースクエリによって返されるオプションの順序が使用されます。

1. (オプション) [[選択オプション]](#v9-dash-variable-add-selection) を入力します。

1. **[値のプレビュー]** には現在の変数値の一覧が表示されます。これらを確認して、期待どおりであることを確認します。

1. **[追加]** を選択してダッシュボードに変数を追加します。

## カスタム変数の追加
<a name="v9-dash-variable-add-custom"></a>

数値や文字列など、変更されない値には*カスタム*変数を使用します。

例えば、サーバー名やリージョン名が変更されない場合は、クエリ変数ではなくカスタム変数として作成できます。これらは変更されないため、他のクエリ変数ではなく、[連鎖変数](#v9-dash-variable-add-chained)で使用できます。これにより、連鎖変数が更新されたときに Grafana が送信する必要があるクエリの数が減少します。

**カスタム変数を追加するには**

1. 上記のように、一般的なオプションを入力します。

1. [ 

   **カンマで区切られた値]** リストで、この変数の値をカンマ区切りリストに入力します。スペースおよびコロンで区切られた数値、文字列、またはキーと値のペアを含めることができます。例えば、`key1 : value1,key2 : value2`。

1. (オプション) [[選択オプション]](#v9-dash-variable-add-selection) を入力します。

1. **[値のプレビュー]** には現在の変数値の一覧が表示されます。これらを確認して、期待どおりであることを確認します。

1. **[追加]** を選択してダッシュボードに変数を追加します。

## テキストボックス変数の追加
<a name="v9-dash-variable-add-text"></a>

*テキストボックス*変数は、任意のデフォルト値を使用して自由テキスト入力フィールドを表示します。これは、任意の値を入力できるため、最も柔軟な変数です。カーディナリティの高いメトリクスがある場合や、ダッシュボード内の複数のパネルを同時に更新する場合は、このタイプの変数を使用します。

**テキストボックス変数を追加するには**

1. 上記のように、一般的なオプションを入力します。

1. (オプション) **[デフォルト値]** フィールドで、変数のデフォルト値を選択します。このフィールドに何も入力しない場合、Grafana はユーザーがテキストを入力するための空のテキストボックスを表示します。

1. **[値のプレビュー]** には現在の変数値の一覧が表示されます。これらを確認して、期待どおりであることを確認します。

1. **[追加]** を選択してダッシュボードに変数を追加します。

## 定数変数の追加
<a name="v9-dash-variable-add-constant"></a>

*定数*変数を使用すると、非表示の定数を定義できます。定数変数は、共有するダッシュボードに対するメトリックパスの接頭辞に有用です。ダッシュボードをエクスポートすると、定数変数がインポートオプションに変換されます。

定数変数は複数設定*できません*。各定数変数は 1 つの値のみを保持し、変数設定を更新しない限り更新できません。

定数変数は、クエリに含める必要がある複素数値があっても、クエリすべてに再入力したくない場合に便利です。例えば、「`i-0b6a61efe2ab843gg`」というサーバーパスがある場合、それを「`$path_gg`」という変数に置き換えることができます。

**定数変数を追加するには**

1. 上記のように、一般的なオプションを入力します。

1. **[値]** フィールドに変数値を入力します。英数字と記号を入力できます。[raw 形式](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw) を使用している場合は、ワイルドカードを使用することもできます。

1. **[値のプレビュー]** には現在の変数値の一覧が表示されます。これらを確認して、期待どおりであることを確認します。

1. **[追加]** を選択してダッシュボードに変数を追加します。

## データソース変数の追加
<a name="v9-dash-variable-add-datasource"></a>

*データソース*変数を使用すると、ダッシュボード全体のデータソースをすばやく変更できます。データソースのインスタンスが複数ある場合、おそらく異なる環境にある場合に便利です。

**データソース変数を追加するには**

1. 上記のように、一般的なオプションを入力します。

1. **[タイプ]** リストで、変数のターゲットデータソースを選択します。

1. (オプション) **[インスタンス名フィルター]** には、変数値のドロップダウンリストからデータソースインスタンスを選択する正規表現フィルターを入力します。このフィールドは空のままにして、すべてのインスタンスを表示します。

1. (オプション) [[選択オプション]](#v9-dash-variable-add-selection) を入力します。

1. **[値のプレビュー]** には現在の変数値の一覧が表示されます。これらを確認して、期待どおりであることを確認します。

1. **[追加]** を選択してダッシュボードに変数を追加します。

## 間隔変数の追加
<a name="v9-dash-variable-add-internal"></a>

*間隔*変数を使用して、`1m`、`1h`、`1d`などの時間範囲を表します。これらはダッシュボード全体の *group by time* コマンドと考えることができます。間隔変数は、視覚化でのデータのグループ化方法を変更します。また、[自動] オプションを使用して、時間範囲ごとに複数のデータポイントを返すこともできます。

間隔変数を時間 (InfluxDB の場合)、日付ヒストグラム間隔 (Elasticsearch の場合) でグループ化するパラメータとして、または要約関数パラメータ (Graphite の場合) として使用できます。

**間隔変数を追加するには**

1. 上記のように、一般的なオプションを入力します。

1. **[値]** フィールドに、変数ドロップダウンリストに表示する時間間隔を入力します。次の時間単位に対応しています: `s (seconds)`、`m (minutes)`、`h (hours)`、`d (days)`、`w (weeks)`、`M (months)`、`y (years)`。次のデフォルト値を使用または編集することもできます: `1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`。

1. (オプション) `auto`オプションをリストに追加する場合は、**[自動オプション]** をオンにします。このオプションを使用すると、現在の時間範囲を分割して現在の `auto` 時間範囲を計算する回数を指定できます。オンにすると、さらに次の 2 つのオプションが表示されます。
   + **[ステップ数]** – **[最大データポイント数]**クエリオプションと同様に、現在の時間範囲を分類して値を計算する回数を選択します。例えば、現在の表示時間範囲が 30 分の場合、`auto` 間隔はデータを 1 分単位× 30 でグループ化します。デフォルト値は 30 ステップです。
   + **[最小間隔]** – ステップ数の間隔が時間を分類しない最小しきい値です。引き続き 30 分の例を挙げる場合、最小間隔をに設定すると、Grafana はデータを 2 分単位× 15 でグループ化します。

1. **[値のプレビュー]** には現在の変数値の一覧が表示されます。これらを確認して、期待どおりであることを確認します。

1. **[追加]** を選択してダッシュボードに変数を追加します。

**間隔変数の例**

Graphite 関数でテンプレート変数 `myinterval` を使用する例:

```
summarize($myinterval, sum, false)
```

## アドホックフィルターの追加
<a name="v9-dash-variable-add-adhoc"></a>

*アドホックフィルター*を使用して、指定されたデータソースを使用するすべてのメトリクスクエリに自動的に追加されるキー/値フィルターを追加できます。他の変数とは異なり、クエリではアドホックフィルターを使用しません。代わりに、アドホックフィルターを使用して既存のクエリのフィルターを書き込みます。

**注記**  
アドホックフィルター変数は、Prometheus、Loki、InfluxDB、および Elasticsearch データソースでのみ機能します。

1. 上記のように、一般的なオプションを入力します。

1. **[データソース]** リストで、ターゲットデータソースを選択します。

1. **[追加]** を選択してダッシュボードに変数を追加します。

**アドホックフィルターの作成**

アドホックフィルターは、利用可能な最も複雑で変更可能な変数オプションの 1 つです。変数オプションの通常リストの代わりに、この変数によりダッシュボード全体のアドホッククエリを構築できます。この方法で適用するフィルターは、ダッシュボード上のすべてのパネルに適用されます。

## 変数選択オプションを設定する
<a name="v9-dash-variable-add-selection"></a>

**選択オプション**は、可変オプションの選択を管理するために使用できる機能です。すべての選択オプションは任意で使用でき、デフォルトではオフになっています。

### 複数値の変数
<a name="v9-dash-variable-add-selection-multi"></a>

複数値が選択された変数を補間するのは、変数が使用されている特定のコンテキストで有効な文字列に複数の値をフォーマットする方法が単純ではないため、難しくなります。Grafana は、各データソースプラグインがテンプレート補間エンジンに、複数値に使用する形式を通知できるようにすることで、この問題を解決しようと試みます。

**注記**  
Grafana がすべての値を 1 つの文字列にフォーマットするには、 変数の **[すべての値をカスタム化]** オプションを空白にする必要があります。空白のままにすると、Grafana はクエリ内のすべての値を連結 (一緒につなげる) します。例えば、`value1,value2,value3`。カスタム `all` 値を使用する場合は、値は代わりに `*` または `all` になります。

**Graphite データソースを使用した複数値変数**

Graphite は glob 式を使用します。この場合、複数の値を持つ変数は、現在の変数値が *host1*、*host2*、*host3* であった場合は、`{host1,host2,host3}` として補間されます。

**Prometheus または InfluxDB データソースを使用した複数値変数**

InfluxDB と Prometheus は正規表現を使用するため、同じ変数は `(host1|host2|host3)` として補間されます。すべての値も正規表現エスケープされます。そうでない場合、正規表現コントロール文字を持つ値は正規表現を破ります。

**Elastic データソースを使用した複数値変数**

Elasticsearch は Lucene クエリ構文を使用するため、同じ変数は `("host1" OR "host2" OR "host3")` としてフォーマットされます。この場合、すべての値がエスケープされ、値には lucene 制御語と引用符のみが含まれます。

**複数値変数のトラブルシューティング**

自動エスケープとフォーマットは問題を引き起こす可能性があり、その背後にあるロジックを理解するのは難しい場合があります。特に InfluxDB と Prometheus では、正規表現構文を使用するために、変数を正規表現演算子コンテキストで使用する必要があります。

Grafana でこの自動正規表現エスケープとフォーマットを実行したくない場合は、次のいずれかを実行する必要があります。
+ **[複数値]** をオフにするか、**[すべて含めるオプション]** オプションを使用します。
+ [raw 変数形式](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw)を使用します。

### すべてを含めるオプション
<a name="v9-dash-variable-add-multi-all"></a>

Grafana は、変数ドロップダウンリストに `All` オプションを追加します。ユーザーがこのオプションを選択すると、すべての変数オプションが選択されます。

### すべての値のカスタム化
<a name="v9-dash-variable-add-multi-custom"></a>

このオプションは、**[すべてを含めるオプション]** が選択されている場合にのみ表示されます。

**[すべての値のカスタム化]** フィールドに 正規表現、globs、または lucene 構文を入力して、 `All` オプションの値を定義します。

デフォルトでは、`All` 値は結合式内のすべてのオプションを含みます。これは非常に長くなり、パフォーマンスの問題が発生する可能性があります。ワイルドカード正規表現など、すべての値のカスタム化を指定する方がよい場合があります。

**[すべての値のカスタム化]** オプションにカスタム正規表現、globs、または lucene 構文を含めるには、エスケープされないため、データソースに有効な値は何かを検討する必要があります。

## グローバル変数
<a name="v9-dash-variable-add-global"></a>

Grafana には、クエリエディタの式で使用できるグローバル組み込み変数があります。このトピックでは、それらをアルファベット順に一覧表示し、定義します。これらの変数は、クエリ、ダッシュボードリンク、パネルリンク、データリンクに役立ちます。

**\$1\$1\$1dashboard**

この変数は、現在のダッシュボードの名前です。

**\$1\$1\$1from および \$1\$1\$1to**

Grafana には、「`$__from`」と「`$__to`」の 2 つの組み込み時間範囲変数があります。これらは現在、デフォルトでは常にエポックミリ秒として補間されていますが、日付の書式設定をユーザーが管理できます。


| 構文 | 結果の例 | 説明 | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Unix エポックミリ秒  | 
|  `${__from:date}`  |  2020-07-13T20:19:09.254Z  |  引数なし、デフォルトは ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T20:19:09.254Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Unix エポック秒  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  文字を含まないあらゆるカスタム日付形式  | 

上記の構文は、`${__to}` としても機能します。

**\$1\$1\$1interval**

`$__interval` 変数を時間 (InfluxDB 、MySQL、Postgres、MSSQL の場合)、日付ヒストグラム間隔 (Elasticsearch の場合) でグループ化するパラメータとして、または*[要約]*関数パラメータ (Graphite の場合) として使用できます。

Grafana は、クエリで時間別にグループ化するために使用できる間隔を自動的に計算します。グラフに表示されるデータポイントよりも多い場合、クエリはより長い間隔でグループ化することで、より効率的になります。例えば、3 か月分のデータのグラフを見ている場合、分レベルで詳細を表示できない場合があります。時間別または日別にグループ化すると、グラフの表示内容に影響を与えることなく、クエリの効率が向上します。`$__interval` は、時間範囲とグラフの幅 (ピクセル数) を使用して計算されます。

概算: `(to - from) / resolution`

例えば、時間範囲が 1 時間でグラフが全画面表示の場合、間隔は `2m` で計算され、ポイントは 2 分間隔でグループ化されます。時間範囲が 6 か月で、グラフが全画面表示の場合、間隔は `1d` (1 日) で、ポイントは日ごとにグループ化されます。

InfluxDB データソースでは、レガシー変数 `$interval` は同じ変数であり、`$__interval` を代わりに使用すべきです。

InfluxDB データソースと Elasticsearch データソースには、間隔をハードコード化したり、`$__interval` 変数の最小制限 (`Group by time interval` など、`>` 構文を使用して) を設定したりするために使用される `>10m` フィールドがあります。

**\$1\$1\$1interval\$1ms**

この変数はミリ秒単位の `$__interval` 変数であり、時間間隔形式の文字列ではありません。例えば、`$__interval` が `20m` の場合、`$__interval_ms` は `1200000` です。

**\$1\$1\$1org**

この変数は現在の組織の ID です。 `${__org.name}` は現在の組織の名前を表します。

**\$1\$1\$1user**

`${__user.id}` は現在のユーザーの ID です。 `${__user.login}` は現在のユーザーのログインハンドルです。 `${__user.email}`は現在のユーザーの E メールです。

**\$1\$1\$1range**

現在、Prometheus および Loki データソースでのみサポートされています。この変数は、現在のダッシュボードの範囲を表します。`to - from` で計算されます。ミリ秒は `$__range_ms`、秒は `$__range_s` で表示されます。

**\$1\$1\$1rate\$1interval**

現在、Prometheus データソースでのみサポートされています。`$__rate_interval` 変数は、レート関数で使用することを目的としています。

**\$1timeFilter または \$1\$1\$1timeFilter**

`$timeFilter` 変数は、現在選択されている時間範囲を式として返します。例えば、時間間隔「`Last 7 days`」の式は `time > now() - 7d` です。

これは、次のようないくつかの場所で使用されます。
+ InfluxDB データソースの WHERE 句。クエリエディタ では、Grafana は InfluxDB クエリに自動的に追加します。テキストエディタモードでは、`WHERE $timeFilter` を手動で追加できます。
+ Log Analytics は、Azure Monitor データソースでクエリを実行します。
+ SQL は、MySQL 、Postgres、MSSQL でクエリを実行します。
+ `$__timeFilter` 変数は MySQL データソースで使用されます。

## 連鎖変数
<a name="v9-dash-variable-add-chained"></a>

*連鎖変数*は、*リンクされた変数*または*ネストされた変数*とも呼ばれ、変数クエリ内において 1 つ以上の他の変数を持つクエリ変数です。このセクションでは、連鎖変数がどのように機能するかを説明し、連鎖変数を使用するダッシュボード例へのリンクを共有します。

連鎖変数クエリはデータソースごとに異なりますが、前提はすべてのデータソースで同じです。連鎖変数クエリは、それらを使用できる任意のデータソースで使用できます。

非常に複雑なリンクされたテンプレート化されたダッシュボードは、5 または 10 レベルの深さで作成できます。技術的には、どれだけ深く、複雑にできるかに制限はありませんが、リンクが多いほどクエリの負荷が大きくなります。

**ベストプラクティスとヒント**

以下のプラクティスにより、ダッシュボードと変数の使用が容易になります。

**新しいリンクされた変数の作成**
+ 連鎖変数は親/子の依存関係を作成します。ラダーまたはツリー構造として想定できます。
+ 新しい連鎖変数を作成する最も簡単な方法は、新しい変数の基盤となる変数をコピーすることです。変数リストで、変数エントリの右側にある**変数の複製**アイコンをクリックしてコピーを作成します。その後、親変数のクエリに追加できます。
+ この方法で作成した新しい変数は、リストの下部に表示されます。論理的な順序にするには、リスト内の別の位置にドラッグする必要がある場合があります。

**変数の順序**

ダッシュボード変数リストの変数の順序は、各エントリの右側にある上下の矢印をクリックして変更できます。Grafana は、このリストに従って左から右に変数のドロップダウンを一覧表示し、一番上の変数を左端に表示します。
+ 子変数の前に、親変数と依存関係のない変数のリストを作成します。
+ 各変数は、依存している変数に従う必要があります。
+ UI には、どの変数に依存関係があるのかを示すものがありません。変数を論理的な順序で一覧表示して、他のユーザー (および自分自身) に明確にします。

**複雑さに関する考慮事項**

変数の依存関係のレイヤーが多いほど、変数を変更した後にダッシュボードを更新するのに時間がかかります。

例えば、4 項目がリンクされた一連の変数 (国、地域、サーバー、メトリック) があり、ルート変数値 (国) を変更する場合、Grafana はダッシュボード内の視覚化を更新する前に、すべての従属変数に対してクエリを実行する必要があります。

## 変数の管理
<a name="v9-dash-variable-add-manage"></a>

変数ページでは、変数を[追加](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/)し、既存の変数を管理できます。また、変数を[検査](https://grafana.com/docs/grafana/latest/dashboards/variables/inspect-variable/)し、変数が他の変数またはダッシュボードで参照 (または使用されている) されているかどうかを識別することもできます。

**[移動]** ドラッグアンドドロップを使用して、変数をリストの上または下に移動できます。

**[クローン]** 変数をクローン (コピー) するには、右側の一連のアイコンからクローンアイコンをクリックします。これにより、元の変数の名前に `copy_of_` というプレフィックスが付いた変数のコピーが作成されます。

**削除：** 変数を削除するには、右側の一連のアイコンからごみ箱アイコンをクリックします。

## 正規表現での変数のフィルタリング
<a name="v9-dash-variable-add-filter"></a>

[正規表現クエリ] オプションを使用して、変数クエリによって返されるオプションの一覧をフィルタリングするか、返されるオプションを変更します。

このページでは、正規表現を使用して変数ドロップダウンの値をフィルタリング/変更する方法を説明します。

[正規表現クエリ] オプションを使用して、変数クエリによって返されるオプションの一覧をフィルタリングするか、返されるオプションを変更します。詳細については、[[正規表現]](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions)に関する Mozilla ガイドを参照してください。

次の例は、次のオプションリストのフィルタリングを示しています。

```
backend_01
backend_02
backend_03
backend_04
```

**`01` または `02` で終わるオプションのみが返されるようにフィルタリングする**

正規表現:

```
/
(
01|02 
) 
$/
```

結果:

```
backend_01
backend_02
```

**正規表現キャプチャグループを使用してテキストの一部を返すオプションのフィルタリングおよび変更**

正規表現:

```
/.* 
(
01|02 
)
/
```

結果:

```
01
02
```

**フィルタリングと変更 - Prometheus の例**

オプションのリスト:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

正規表現:

```
/. *instance="
(
[^"]*
)
.*/
```

結果:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**名前付きテキストおよび値キャプチャグループを使用してフィルタリングおよび変更する**

名前付きキャプチャグループを使用すると、変数クエリによって返されるオプションから「テキスト」部分と「値」部分を別々にキャプチャできます。これにより、変数ドロップダウンリストに、選択できる各値に対するわかりやすい名前を含めることができます。

例えば、`node_hwmon_chip_names` Prometheus メトリクスをクエリする場合、 `chip_name`は `chip` 値よりもはるかにわかりやすくなります。したがって、次の変数クエリの結果は以下のとおりになります。

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

次の正規表現を渡す:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

次のドロップダウンリストを生成:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

`text` および `value` キャプチャグループ名のみがサポートされています。

## 
<a name="v9-dash-variable-add-inspect"></a>

変数ページでは、変数が他の変数またはダッシュボードで参照 (または使用) されているかどうかを簡単に識別できます。

参照または使用される変数の横には緑色のチェックマークが付き、参照されていない変数の横にはオレンジ色の注意アイコンが付きます。さらに、参照されるすべての変数には、緑色のチェックマークの横にある依存関係アイコンがあります。アイコンを選択すると、依存関係マップが表示されます。依存関係マップは移動できます。マウスホイールまたは同等の機能を使用してズームインまたはズームアウトできます。

# 変数構文
<a name="v9-dash-variable-syntax"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

パネルタイトルとメトリクスクエリは、2 つの異なる構文を使用して変数を参照できます。
+ `$varname` – この構文は参照しやすいですが、単語の途中で変数を使用することは許可されません。

  **例:** `apps.frontend.$server.requests.count`
+ `${var_name}` – 式の中央で変数を使用する場合は、この構文を使用します。
+ `${var_name:<format>}` – この形式により、Grafana が値を解釈する方法をより細かく制御できます。詳細については、「*高度な変数フォーマットオプション*」を参照してください。
+ `[[varname]]` – 使用しないでください。この構文は古く、廃止されました。これは、今後のリリースで削除されます。

クエリがデータソースに送信される前に、クエリは*[補間されます]*。つまり、変数は現在の値に置き換えられます。補間中、変数値は、クエリ言語の構文と使用される場所に準拠するために*エスケープ*される可能性があります。例えば、InfluxDB または Prometheus クエリの正規表現で使用される変数は、正規表現がエスケープされます。

**高度な変数フォーマットオプション**

変数補間のフォーマットはデータソースによって異なりますが、デフォルトの形式を変更する場合があります。

例えば、MySQL データソースのデフォルトは、`'server01','server02'` などのように、複数の値を引用符でカンマ区切りで結合することです。場合によっては、`server01,server02` など、引用符なしでカンマ区切りの文字列を指定することもできます。これを行うには、以下にリストされている高度な変数フォーマットオプションを使用します。

**一般的な構文**

構文: `${var_name:option}`

無効なフォーマットオプションが指定されている場合、`glob` がデフォルト/フォールバックオプションです。

**CSV**

複数の値をカンマ区切り文字列として変数をフォーマットします。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**分散 - OpenTSDB**

OpenTSDB のカスタム形式の複数の値を持つ変数をフォーマットします。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**二重引用符**

単一値変数と複数値の変数をカンマ区切り文字列にフォーマットし、`\"` によって各値の `"` をエスケープし、`"` で各値を引用符で囲みます。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Graphite**

複数の値を持つ変数を glob にフォーマットします (Graphite クエリの場合)。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

複数の値をカンマ区切り文字列として変数をフォーマットします。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Elasticsearch の Lucene 形式で複数の値を持つ変数をフォーマットします。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Percentencode**

URL パラメータで使用する単一値変数と複数値変数をフォーマットします。

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**パイプ**

複数の値を持つ変数をパイプ区切り文字列にフォーマットします。

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Raw**

SQL クエリにおける単一引用符など、データソース固有のフォーマットをオフにします。

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**[正規表現]**

複数の値を持つ変数を正規表現文字列にフォーマットします。

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**一重引用符**

単一値変数と複数値の変数をカンマ区切り文字列にフォーマットし、`\'` によって各値の `'` をエスケープし、`'` で各値を引用符で囲みます。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

単一値変数と複数値の変数をカンマ区切り文字列にフォーマットし、`''` によって各値の `'` をエスケープし、`'` で各値を引用符で囲みます。

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**[テキスト]**

単一値変数と複数値変数をテキスト表現にフォーマットします。単一値の変数の場合、テキスト表現のみを返します。複数値変数の場合、テキスト表現は `+` と組み合わせて返されます。

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**クエリパラメータ**

単一値変数と複数値変数をクエリパラメータ表現にフォーマットします。例: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# ダッシュボード使用状況の評価
<a name="v9-dash-assess-dashboard-usage"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

使用状況のインサイトにより、Grafana インスタンスの使用方法をより深く理解できます。

使用状況のインサイト機能は、多数の集計データを収集し、データベースに保存します。
+ ダッシュボードビュー (集計およびユーザーごと）
+ データソースエラー
+ データソースクエリ

集計データを使用すると、ダッシュボードとデータソースのインサイト、プレゼンスインジケータ、インサイトデータを使用したダッシュボードのソート、ダッシュボード内の使用状況インサイトデータの視覚化など、様々な機能にアクセスできます。

この機能を使用すると、Loki にエクスポートできる詳細なログも生成できます。

## ダッシュボードインサイトとデータソースインサイト
<a name="v9-dash-insights"></a>

すべてのダッシュボードとデータソースで、使用状況情報にアクセスできます。

**ダッシュボードインサイト**

ダッシュボードの使用状況情報を表示するには、上部のバーで **[ダッシュボードインサイト]** をクリックします。

ダッシュボードには以下の情報が表示されます。
+ **統計**: 過去 30 日間の毎日のクエリとエラーの数。
+ **ユーザーとアクティビティ**: 過去 30 日間の日次ビュー数。ダッシュボードと最近のユーザー (制限は 20) に対する最後のアクティビティ。

**データソースインサイト**

データソースインサイトは、過去 30 日間にデータソースがどのように使用されたかに関する情報を提供します。
+ 1 日あたりのクエリ
+ 1 日あたりのエラー
+ 1 日あたりのクエリロード時間 (平均ミリ秒）

データソースインサイトを検索するには:

1. **データソース**リストビューに移動します。

1. **[データソース]** をクリックします。

1. **[インサイト]** タブをクリックします。

## プレゼンスインジケータ
<a name="v9-dash-presence-indicator"></a>

サインインしてダッシュボードを表示すると、プレゼンスインジケーターによって、自分と同じダッシュボードを表示しているユーザーを知ることができます。プレゼンスインジケーターには、ダッシュボードを最近操作したユーザーのアバターが表示されます。デフォルトの時間枠は 10 分です。ユーザー名を表示するには、ユーザーのアバターにカーソルを合わせます。アバターは、ユーザーの E メールに基づいて [Gravatar](https://gravatar.com/) から取得されます。

ダッシュボードにプレゼンスインジケータに収まるユーザーよりもアクティブなユーザーがいる場合は、**[\$1X]** アイコンをクリックします。これを行うと、ダッシュボードインサイトが開きます。ダッシュボードインサイトには、最近のユーザーアクティビティに関する詳細が含まれます。

## インサイトデータを使用したダッシュボードのソート
<a name="v9-dash-sort-dashboards"></a>

検索ビューでは、インサイトデータを使用して、最も使用されているダッシュボード、壊れているダッシュボード、未使用のダッシュボードを見つけることができます。
+ エラー総数
+ 30 日間のエラー
+ ビューの合計
+ 30 日間のビュー

# Grafana バージョン 9 でのダッシュボードの検索
<a name="v9-search"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボード名とパネルタイトルでダッシュボードを検索できます。ダッシュボードを検索すると、ダッシュボードの内容を表示するアクセス許可がない場合でも、システムは Grafana インスタンス内で使用可能なすべてのダッシュボードを返します。

## ダッシュボード名を使用してダッシュボードを検索する
<a name="v9-search-by-name"></a>

検索バーにダッシュボード名の一部を入力します。検索では、入力すると、文字列の部分一致の結果がリアルタイムで返されます。

ダッシュボード検索は次のとおりです。
+ リアルタイム
+ 大文字と小文字は*区別されません*。
+ 保存済みダッシュボードとファイルベースのダッシュボード全体で機能します。

**ヒント**  
キーボードの矢印キーを使用して結果を移動し、`Enter` を押して選択したダッシュボードを開くことができます。

## パネルタイトルを使用してダッシュボードを検索する
<a name="v9-search-by-title"></a>

ダッシュボードに表示されるパネルのタイトルでダッシュボードを検索できます。パネルのタイトルが検索クエリと一致すると、ダッシュボードが検索結果に表示されます。

## ダッシュボードの検索結果をタグでフィルタリングする
<a name="v9-search-by-tag"></a>

ダッシュボードの数が増えるほど、タグをつけることで効果的に整理することができます。ダッシュボード [**設定**] でタグを追加および管理できます。

複数のタグを選択すると、Grafana は選択したすべてのタグを含むダッシュボードを表示します。

タグでダッシュボード検索結果をフィルタリングするには、次のいずれかの手順を実行します。
+ ダッシュボードの検索結果をタグでフィルタリングするには、検索結果の右側の列に表示されるタグを選択します。

  追加のタグを選択して、フィルタリングを続行できます。
+ 使用可能なすべてのタグのリストを表示するには、**[タグでフィルタリング]**ドロップダウンメニューをクリックし、タグを選択します。

  すべてのタグが表示され、タグを選択すると、ダッシュボード検索が即座にフィルタリングされます。

**ヒント**  
キーボードのみを使用する場合は、`tab` キーを押して **[タグでフィルタリング]** ドロップダウンメニューに移動し、下矢印キーを押してメニューをアクティブ化し、タグを見つけ、`Enter` を押してタグを選択します。