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

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

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

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

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

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

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

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

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

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

ダッシュボードを使用して、データの表示をカスタマイズできます。次の図は、Amazon Managed Grafana ワークスペースのダッシュボードインターフェイスを示しています。

![\[Amazon Managed Grafanaワークスペースのダッシュボードのインターフェイスを示す画像。さまざまな機能のボタンが強調表示されています。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



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

## キーボードショートカット
<a name="v10-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="v10-dash-setting-dashboard-time-range"></a>

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

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

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

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

マイナス演算子を使用すると、現在の日付と時刻または `now` を基準にして、時間を戻すことができます。単位の全期間 (日、週、月など) を表示するには、末尾に `/<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`: 将来のタイムスタンプ。
`now-1n/n`: *n の開始から n の終了まで* (これは絶対タイムスタンプであるため)。

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

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

  半相対時間範囲を使用すると、時間が進むにつれて、ダッシュボードは自動的かつ段階的にズームアウトし、より多くの履歴とより少ない詳細を表示します。同時に、高いデータ解像度が低下するにつれて、全期間にわたる過去の傾向がより明確になります。
**注記**  
アラートは、半相対時間範囲をサポートしていません。
+ **[ズームアウト]** アイコンを選択してズームアウトします (またはキーボードショートカットとして Cmd\$1Z または Ctrl\$1Z を使用）。これにより、ビューが拡大され、ダッシュボードまたはパネルの視覚化の時間範囲が大きくなります。
+ **ズームイン**するには、視覚化でグラフに表示する時間範囲を選択します。
**注記**  
ズームインはグラフの視覚化にのみ適用されます。

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

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

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

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

ダッシュボード URL に次のクエリパラメータを指定すると、ダッシュボードの時間範囲を制御できます。
+ `from` は、エポックミリ秒で指定された時間範囲の下限、または[相対時間](#v10-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="v10-dash-building-dashboards"></a>

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

Grafana ワークスペースを作成してサインインすると、ダッシュボードを作成し、ニーズに合わせて設定を変更できます。ダッシュボードは、[視覚化を含むパネル](v10-panels-viz.md)で構成されます。各パネルには、いずれかの [データソースに接続する](AMG-data-sources.md) からデータを取得するためのクエリが関連付けられています。

[変数](v10-dash-variables.md)を追加して使用することで、よりインタラクティブで動的なダッシュボードを作成できます。メトリクスクエリでサーバー、アプリケーション、またはその他の名前をハードコーディングする代わりに、変数を使用できます。

**Topics**
+ [ダッシュボードの作成](v10-dash-creating.md)
+ [ダッシュボードのインポート](v10-dash-importing.md)
+ [ダッシュボードのエクスポート](v10-dash-exporting.md)
+ [ダッシュボード設定の変更](v10-dash-modify-settings.md)
+ [ダッシュボード URL 変数](v10-dash-dashboard-url-variables.md)
+ [ライブラリパネルの管理](v10-dash-manage-library-panels.md)
+ [ダッシュボードのバージョン履歴の管理](v10-dash-manage-version-history.md)
+ [ダッシュボードリンクの管理](v10-dash-manage-dashboard-links.md)
+ [視覚化に注釈を付ける](v10-dash-annotations.md)
+ [ダッシュボード JSON モデル](v10-dash-dashboard-json-model.md)
+ [ダッシュボードのベストプラクティス](v10-dash-bestpractices.md)

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

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

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

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

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

1. Grafana にサインインし、左側のメニューから **[ダッシュボード]** を選択します。

1. **[新規]** を選択し、次に **[新しいダッシュボード]** を選択します。

1. 空のダッシュボードで、**[\$1 視覚化の追加]** を選択します。これにより、新しい視覚化ダイアログボックスが開きます。

1. データソースの選択。既存のデータソース、Grafana の組み込みデータソースのいずれかをテスト用に選択するか、**[新しいデータソースを設定]** を選択して新しいデータソースを設定できます (管理者権限を持つユーザーのみが新しいデータソースを設定できます）。

   データソースが選択された **[編集パネル]** ビューが開きます。必要に応じて、パネルエディタの **[クエリ]** タブを使用して、後でパネルのデータソースを変更できます。

1. データソースのクエリ言語でクエリを記述または作成します。ダッシュボードの更新アイコンを選択すると、データソースでクエリが実行され、結果が表示されます。

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

1. **[パネルオプション]** で、パネルのタイトルと説明を入力できます。

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

1. パネルの設定が完了したら、**[保存]** を選択してダッシュボードを保存します。

   または、**[適用]** を選択して、パネルエディタを離れずに変更を表示します。

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

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

1. 必要に応じて、ダッシュボードヘッダーで **[追加]** を選択し、ドロップダウンから **[視覚化]** を選択して、ダッシュボードにパネルを追加できます。

**既存のダッシュボードのコピー**

既存のダッシュボードをすばやくコピーして、新しいダッシュボードの作成をすぐに開始できます。

**既存のダッシュボードをコピーするには**

1. 左側のメニューから **[ダッシュボード]** を選択します。

1. コピーするダッシュボードを選択して開きます。

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

1. ダッシュボードの右上隅にある **[名前を付けて保存]** を選択します。

1. （オプション) 名前、フォルダ、説明、およびコピーしたダッシュボードの元のダッシュボードタグをコピーするかどうかを指定します。

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

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

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

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

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

**繰り返し行を設定するには**

1. 左のメニューから **[ダッシュボード]** を選択し、変更するダッシュボードを選択します。

1. ダッシュボードの上部で、**[追加]** を選択し、ドロップダウンから **[Row]** (行) を選択します。

   ダッシュボードが空の場合は、ダッシュボードの中央にある **[\$1 行の追加]** ボタンを代替的に選択できます。

1. 行タイトルにカーソルを合わせ、表示される **[設定]** (歯車) アイコンを選択します。

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

1. **[更新]** を選択します。

**繰り返し行とダッシュボードの特別なデータソース**

行に、同じ[ダッシュボード](AMG-data-sources.md#AMG-data-sources-special)内の別のパネルの結果セットを使用するデータソースである特殊なダッシュボードデータソースを使用するパネルが含まれている場合、繰り返し行の対応するパネルは、繰り返し行のパネルではなく、元の行のパネルを参照します。

例えば、ダッシュボードでは:
+ `Row 1` には `Panel 1A` と `Panel 1B` が含まれます。
+ `Panel 1B` は、`Dashboard` データソースを使用して `Panel 1A` の結果を使用します。
+ 繰り返し `Row 2` には、`Panel 2A` と `Panel 2B` が含まれます。
+ `Panel 2B` は `Panel 2A` ではなく `Panel 1A` を参照します。

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

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

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

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

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

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

# ダッシュボードのインポート
<a name="v10-dash-importing"></a>

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

事前設定されたダッシュボードを Amazon Managed Grafana ワークスペースにインポートできます。

**ダッシュボードをインポートするには**

1. Amazon Managed Grafana ワークスペースにサインインします。

1. 左側のメニューから **[ダッシュボード]** を選択します。

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

1. 次に、インポートするダッシュボード JSON 定義を選択します。JSON をインポートする方法には、次の 3 つの選択肢があります。
   + ダッシュボード JSON を含むファイルをアップロードします。
   + JSON テキストをテキストエリアに直接コピーします。
   + フィールドに Grafana Labs ダッシュボードの URL または ID を貼り付けます。grafana.com ダッシュボード URL の詳細については、次のセクションを参照してください。
   + (オプション) 変更するダッシュボードの詳細を変更します。
   + 必要に応じてデータソースを選択します。
   + **[インポート]** を選択します。
   + ダッシュボードを保存します。

## grafana.com でのダッシュボードの検索
<a name="v10-dash-import-from-grafana"></a>

grafana.com の [[ダッシュボード]](https://grafana.com/grafana/dashboards/) ページには、一般的なサーバーアプリケーションのダッシュボードが用意されています。公式ダッシュボードとコミュニティ構築ダッシュボードのライブラリを参照してインポートし、すぐに起動して実行できるようにします。

**注記**  
grafana.com からダッシュボードをインポートするには、Amazon Managed Grafana ワークスペースがインターネットにアクセスできる必要があります。

# ダッシュボードのエクスポート
<a name="v10-dash-exporting"></a>

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

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

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

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

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

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

**ダッシュボードをエクスポートするには**

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

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

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

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

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

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

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.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 delay** (遅延時間の指定) – 遅延時間を入力して `now` 時間を上書きします。このオプションを使用して、null 値を避けるために、データ集約の既知の遅延に対応します。
   + **[タイムピッカーを非表示]** – このオプションを選択すると、ダッシュボードでタイムピッカーを非表示にできます。

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

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

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

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

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

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

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

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

クエリエディタの UI は、選択したデータソースに基づいて変わります。クエリの作成方法の詳細については、「[データソース](AMG-data-sources.md)」ドキュメントを参照してください。または、[プラグインカタログによるプラグインの検索](grafana-plugins.md#plugin-catalog) からインストールするデータソースプラグインについては、「[Grafana Labs ウェブサイト のドキュメント](https://grafana.com/docs/grafana/v10.3/datasources/)」を参照してください。

**変数の追加**

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

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

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

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

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

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

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

**リンクの追加**

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

**リンクを追加するには**

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

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

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

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

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

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

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

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

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

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

Grafana は、ダッシュボード URL でクエリパラメータとして渡された変数値を適用できます。詳細については、「[ダッシュボードリンクの管理](v10-dash-manage-dashboard-links.md)」と「[テンプレートおよび変数の管理](v10-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 は、ダッシュボードの設定から変数を生成するときに、ダッシュボードリンクに変数を追加できます。変数を追加する方法と手順の詳細については、「[ダッシュボードリンクの管理](v10-dash-manage-dashboard-links.md)」を参照してください。

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

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

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

例えば、この 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="v10-dash-manage-library-panels"></a>

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

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

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

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

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

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

1. 編集モードでライブラリパネルに変換するパネルを開きます。

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

1. **[ライブラリパネル]**、**[\$1 ライブラリパネルの作成]** を続けて選択します。これにより、作成ダイアログが開きます。

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

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

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

1. ダッシュボードを保存します。

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

また、**[(詳細...]**)、**[ライブラリパネルの作成]** を続けて選択して、任意のパネルの編集メニューからライブラリパネルを直接作成することもできます。

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

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

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

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

1. **[新規]** を選択し、ドロップダウンから **[新しいダッシュボード]** を選択します。

1. 空のダッシュボードで、**[\$1 ライブラリパネルをインポート]** を選択します。ライブラリパネルのリストが表示されます。

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

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

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

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

**ライブラリパネルのリンクを解除するには**

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

1. **[ライブラリパネルl]** を選択します。

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

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

1. パネルのタイトル (またはパネル上の任意の場所にカーソルを合わせる) を選択すると、パネルの右上隅にアクションメニューが表示されます。

1. **[Edit]** (編集) を選択します。パネルは編集モードで開きます。

1. ページの右上隅の **[リンク解除]** を選択します。

1. **[はい、リンク解除する]** を選択します。

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

使用可能なライブラリパネルのリストを表示し、ライブラリパネルを検索できます。

**ライブラリパネルのリストを表示するには**

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

1. **[ライブラリパネルl]** を選択します。以前に定義したライブラリパネルのリストが表示されます。

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

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

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

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

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

1. **[ライブラリパネルl]** を選択します。

1. 削除するパネルのライブラリパネル名の横にある [削除] アイコンを選択します。

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

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

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

**注記**  
ダッシュボードの最近のバージョンは 20 個まで保存されます。

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

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

2 つのダッシュボードバージョンを比較するには、比較するリストから 2 つのバージョンを選択します。**[Compare versions]** (バージョンの比較) をクリックして、2 つのバージョン間の差分を表示します。これにより、バージョン差分ビューが表示されます。デフォルトでは、変更の概要がテキストで表示されます。

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

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

以前に保存したダッシュボードバージョンに復元する必要がある場合は、ダッシュボードバージョンリストの行の右側にある **[Restore]** (復元) ボタンを選択するか、差分ビューで **[Restore to version *<x>*]** (バージョン <x> に復元) ボタンを選択します。これらのいずれかを選択すると、復元を確認するメッセージが表示されます。

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

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

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.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 の問題を送信するなど、外部システムへのショートカットとしても使用できます。

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

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

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

**ダッシュボードにリンクを追加するには**

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

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

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

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

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

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

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

**ダッシュボードに URL リンクを追加するには**

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

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

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

1. 以下からリンクオプションを選択します。
   + **URL** – リンク先の URL を入力します。ターゲットによっては、フィールド値を含めることもできます。
   + **[タイトル]** — リンクを表示するタイトルを入力します。
   + **[ツールヒント]** – リンクを表示するツールヒントを入力します。
   + **Icon** (アイコン) – リンクとともに表示するアイコンを選択します。
   + **[時間範囲]** – このオプションを選択すると、ダッシュボードの時間範囲がリンクに含まれます。ユーザーがリンクをクリックすると、リンクされたダッシュボードが開き、指定された時間範囲が設定されます。
     + `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. リンクを追加するパネルにカーソルを合わせます。

  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. メニューから、**[編集]** を選択します。

     キーボードショートカット `e` でも切り替えられます。

  1. **[パネルオプション]** セクションを展開し、**[パネルリンク]** までスクロールします。

  1. 変更するリンクを見つけ、その横の **[編集]** (鉛筆) アイコンを選択します。

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

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

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

  1. パネルを選択する (またはパネルの上にカーソルを合わせる) と、パネルの右上にアクションメニューが表示されます。

  1. メニューから、**[編集]** を選択します。

     キーボードショートカット `e` でも切り替えられます。

  1. **[パネルオプション]** セクションを展開し、**[パネルリンク]** までスクロールします。

  1. 削除するリンクを見つけ、その横の **X** アイコンを選択します。

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

# 視覚化に注釈を付ける
<a name="v10-dash-annotations"></a>

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

注釈は、リッチイベントで視覚化上のポイントをマークする方法を提供します。これらは、すべてのグラフパネル上に垂直線とアイコンとして視覚化されます。注釈にカーソルを合わせると、イベントの説明とイベントタグを取得できます。テキストフィールドには、より詳細な他のシステムへのリンクを含めることができます。

視覚化には 3 つの方法で注釈を付けることができます。
+ [組み込みの注釈クエリ](#v10-dash-built-in-query)を使用して、パネルで直接注釈を付ける。
+ Grafana HTTP API の使用。
+ ダッシュボード設定での注釈クエリの設定。

最初の 2 つのケースでは、新しい注釈を作成し、最後のケースでは、データソースから既存の注釈をクエリします。組み込みの注釈クエリもこれをサポートしています。

このセクションでは、1 番目と 3 番目のオプションについて説明します。Grafana HTTP API の使用については、「[注釈 API](Grafana-API-Annotations.md)」を参照してください。

注釈は、次の視覚化タイプでサポートされています。
+ 時系列 
+ 状態タイムライン
+ ローソク足チャート

## パネルで注釈を作成する
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana には、すべてのダッシュボードに存在する[組み込みの注釈クエリ](#v10-dash-built-in-query)を使用して、パネルから直接注釈イベントを追加する機能があります。この方法で作成した注釈は Grafana に保存されます。

パネルに直接注釈を追加するには：
+ ダッシュボードは既に保存されている必要があります。
+ ビルトインクエリクエリを有効にする必要があります。

**注釈を追加するには**

1. ダッシュボードで、注釈を追加するパネルを選択します。コンテキストメニューが表示されます。

1. コンテキストメニューで、**[注釈の追加]** を選択します。

1. （オプション) 注釈の説明とタグを追加します。

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

または、パネルを選択しながら `Ctrl` (ないしは `Cmd`) を押すと、**[注釈の追加]** のポップアップが表示されます。

**リージョン注釈**

視覚化でリージョンまたは期間をカバーする注釈を作成することもできます。

**リージョン注釈を追加するには**

1. ダッシュボードで `Ctrl` (または `Cmd`) を押して、パネルの領域を選択します。

1.  注釈の説明とタグを追加します (オプション）。

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

**注釈を編集するには**

1. ダッシュボードで、パネルの注釈インジケータにカーソルを合わせます。

1. 注釈ツールヒントで **[編集]** (鉛筆) アイコンを選択します。

1. 説明やタグを変更します。

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

**注釈を削除するには**

1. ダッシュボードで、パネルの注釈インジケータにカーソルを合わせます。

1. 注釈ツールヒントで **[削除]** (ゴミ箱) アイコンを選択します。

## ダッシュボード設定を使用して注釈を取得する
<a name="v10-dash-fetch-annotations"></a>

ダッシュボード設定の **[注釈]** で、新しいクエリを追加して、組み込みのデータ注釈データソースを含む任意のデータソースを使用して注釈を取得できます。注釈クエリは、ダッシュボード全体のグラフでイベントマーカーとして視覚化できるイベントを返します。

**新しい注釈クエリを追加するには**

1. ダッシュボードヘッダーの **[設定]** (歯車) アイコンを選択して、設定メニューを開きます。

1. **[注釈]** を選択します。

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

1. クエリの名前を入力します。

   この名前は、このクエリから注釈イベントを表示できるようにするトグル (チェックボックス) に付けられます。

1. 注釈のデータソースを選択します。

   また、**[高度なデータソースピッカーを開く]** を選択して、新しいデータソースの追加 (管理者のみ使用可能) など、その他のオプションを表示することもできます。

1. 注釈クエリをすぐに使用しない場合は、**[有効]** チェックボックスをオフにします。

1. ダッシュボードに注釈クエリの切り替えを表示しない場合は、**[非表示]** チェックボックスを選択します。

1. イベントマーカーの色を選択します。

1. **[表示対象]** ドロップダウンで、次のいずれかのオプションを選択します。
   + **[すべてのパネル]** – 注釈は、注釈をサポートするすべてのパネルに表示されます。
   + **[選択したパネル]** – 注釈は、選択したすべてのパネルに表示されます。
   + **[選択した対象を除くすべてのパネル]** – 注釈は、選択したパネルを除くすべてのパネルに表示されます。

1. クエリを設定します。

   注釈クエリオプションは、データソースごとに異なります。特定のデータソースの注釈の詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

## ビルトインクエリクエリ
<a name="v10-dash-built-in-query"></a>

注釈を追加すると、それらは引き続き表示されます。これは、すべてのダッシュボードに存在する組み込みの注釈クエリが原因です。この注釈クエリは、Grafana に保存されている現在のダッシュボードから発生するすべての注釈イベントを取得し、それらが作成されたパネルに表示されます。これには、アラート状態履歴の注釈が含まれます。

デフォルトでは、組み込みの注釈クエリは `Grafana` の特殊なデータソースを使用し、手動注釈はこのデータソースでのみサポートされます。組み込みの注釈クエリで別のデータソースを使用できますが、自動注釈を作成できるのは、そのデータソースのクエリエディタのみです。

ダッシュボードに直接注釈を追加するには、このクエリを有効にする必要があります。

**ビルトインクエリクエリが有効になっていることを確認するには**

1. ダッシュボードヘッダーのダッシュボードの **[設定]** (歯車) アイコンを選択して、ダッシュボード設定メニューを開きます。

1. **[注釈]** を選択します。

1. **[注釈とアラート (組み込み)]** クエリを検索します。

   クエリ名の前に **[無効]** と表示されている場合は、クエリ名を選択してクエリを開き、設定を更新する必要があります。

**注釈の取得と描画を停止するには**

1. ダッシュボードヘッダーのダッシュボードの **[設定]** (歯車) アイコンを選択して、ダッシュボード設定メニューを開きます。

1. **[注釈]** を選択します。

1. **[注釈とアラート (組み込み)]** クエリを検索します。

1. **[有効]** トグルを選択して、オフにします。

**[名前を付けて保存]** 機能を使用してダッシュボードをコピーすると、新しいダッシュボード ID が取得されるため、ソースダッシュボードで作成された注釈はコピーに表示されなくなります。新しい **[注釈クエリ]** を追加し、タグでフィルタリングしても、注釈を表示できます。ただし、これは、ソースダッシュボードの注釈にフィルタリングするタグがある場合にのみ機能します。

**タグによるクエリのフィルタリング**

**[～でフィルタリング]** を `Tags` に設定することで、`Grafana` データソースを使用して組み込みの注釈クエリから注釈を取得する新しいクエリを作成できます。

例えば、注釈クエリ名 `outages` を作成し、タグ `outage` を指定します。このクエリは、 `outage` タグを含むすべての注釈 (ダッシュボードまたは API 経由) を表示します。注釈クエリで複数のタグが定義されている場合、Grafana はすべてのタグに一致する注釈のみを表示します。動作を変更するには、**[任意の一致]** を有効にします。Grafana は、指定したタグのいずれかを含む注釈を表示します。

 タグクエリでテンプレート変数を使用することもできます。つまり、さまざまなサービスの統計を表示するダッシュボードと、表示するサービスを指定するテンプレート変数がある場合は、注釈クエリで同じテンプレート変数を使用して、それらのサービスの注釈のみを表示できます。

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

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

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

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

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

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

1. **[JSON モデル]**を選択します。

## JSON フィールド
<a name="v10-dash-json-fields"></a>

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

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

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "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` | ダッシュボードの現在のタイトル | 
| `tags` | ダッシュボードに関連付けられたタグ、文字列の配列 | 
| `style` | `dark` や `light` などのダッシュボードのテーマ | 
| `timezone` | `utc` や `browser` などのダッシュボードのタイムゾーン | 
| `editable` | ダッシュボードを編集可能かどうか | 
| `graphTooltip` | 共有十字線またはツールチップなしの場合は 0 (デフォルト）、共有十字線の場合は 1、共有十字線と共有ツールチップの場合は 2 | 
| `time` | `last 6 hours` や `last 7 days` などのダッシュボードの時間範囲 | 
| `timepicker` | timepicker メタデータ。詳細については「[timepicker](#v10-dash-json-panels)」を参照してください。 | 
| `templating` | メタデータのテンプレート作成。詳細については「[テンプレート作成セクション](#v10-dash-json-panels)」を参照してください。 | 
| `annotations` | 注釈メタデータ。追加方法については「[注釈](v10-dash-annotations.md)」を参照してください。 | 
| `refresh` | 自動更新間隔 | 
| `schemaVersion` | JSON スキーマのバージョン (整数）。Grafana 更新がこのスキーマに変更を加えるたびに増加します。 | 
| `version` | ダッシュボードのバージョン (整数）。ダッシュボードが更新されるたびに増加します。 | 
| `panels` | パネル配列 (詳細については、次のセクションを参照してください） | 

## パネル
<a name="v10-dash-json-panels"></a>

パネルはダッシュボードの構成要素であり、データソースクエリ、グラフのタイプ、エイリアスなどで構成されます。パネル 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"
      }
    ]
  }
```

以下の表では、 テーブルのフィールドについて説明しています。


| 名前 | 使用方法 | 
| --- | --- | 
|  `enable`  |  テンプレート作成機能が有効かどうか  | 
|  `list`  |  それぞれが 1 つのテンプレート変数を表すオブジェクトの配列  | 
|  `allFormat`  |  `wildcard`、`glob`、`regex`、`pipe` など、データソースからすべての値を取得するときに使用する形式。  | 
|  `current`  |  ダッシュボードに現在選択されている可変テキスト/値を表示します  | 
|  `datasource`  |  変数のデータソースを表示します  | 
|  `includeAll`  |  すべての値オプションが使用可能かどうか  | 
|  `multi`  |  変数値リストから複数の値を選択できるかどうか  | 
|  `multiFormat`  |  データソースから時系列を取得する際に使用する形式  | 
|  `name`  |  変数の名前  | 
|  `options`  |  ダッシュボードで選択できる可変テキスト/値のペアの配列  | 
|  `query`  |  変数の値の取得に使用されるデータソースクエリ  | 
|  `refresh`  |  変数を更新するタイミングを設定します  | 
|  `regex`  |  シリーズ名またはメトリクスノードセグメントの一部を抽出します  | 
|  `type`  |  変数、`custom`、`query`、または `interval` のタイプ  | 

# ダッシュボードのベストプラクティス
<a name="v10-dash-bestpractices"></a>

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

このセクションでは、Grafana ダッシュボードを構築および保守する方法について、Grafana 管理者およびユーザー向けのベストプラクティスに関する情報を提供します。

作成できるさまざまな種類のダッシュボードの詳細については、Grafana Labs ウェブサイトのブログ記事をの「[Grafana ダッシュボード: 作成できるさまざまなタイプの包括的ガイド](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1)」を参照してください。

**注記**  
このセクションでは、モニタリングとダッシュボードのメンテナンスの戦略を作成するのに役立ちます。お使いのシステムを一番理解しているのはユーザーです。このセクションを使用して理解を深めてください。最終的には、システムに最適な戦略を作成するのはユーザーの責任です。

## 一般的なオブザーバビリティ戦略
<a name="v10-dash-common-observability-strategies"></a>

サーバーファームなど、監視対象が多い場合は、監視するのに十分な重要性を判断する戦略が必要です。このページでは、監視対象を選択する一般的な方法をいくつか説明します。

論理戦略を使用すると、均一なダッシュボードを作成し、オブザーバビリティプラットフォームをより簡単に拡張できます。

**戦略のガイドライン**
+ USE メソッドはマシンの満足度を、RED メソッドはユーザーの満足度を示します。
+ USE は問題の原因を報告します。
+ RED はユーザーエクスペリエンスを報告し、問題の症状を報告する可能性が高くなります。
+ 両方を監視することは、システムを理解するために重要です。ベストプラクティスとして、原因ではなく症状に注意してください。通常、アラートは RED ダッシュボードで設定されます。

**USE メソッド**

USE は、以下を表します。
+ **[使用率]** — ノード CPU 使用率など、リソースがビジー状態である時間の割合。
+ **[飽和]** — リソースが実行する必要がある作業の量。多くの場合、キューの長さやノード負荷です。
+ **[エラー]** – エラーイベントの数。

この方法は、CPU、メモリ、ネットワークデバイスなどのインフラストラクチャのハードウェアリソースに最適です。詳細については、Brendan Gregg のブログ記事「[USE メソッド](http://www.brendangregg.com/usemethod.html)」を参照してください。

**RED メソッド**

RED は、以下を表します。
+ **[レート]** – 1 秒あたりのリクエスト数
+ **[エラー]** – 失敗したリクエスト数。
+ **[期間]** – これらのリクエストにかかる時間、レイテンシー測定値の分布。

この方法は、サービス、特にマイクロサービス環境に最も適しています。各サービスについて、コードを計測して、各コンポーネントのこれらのメトリクスを公開します。RED ダッシュボードは、アラートや SLA に適しています。適切に設計された RED ダッシュボードは、ユーザーエクスペリエンスのプロキシです。

詳細については、Tom Wilkie のブログ記事「[RED メソッド: サービスの計測方法](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services)」を参照してください。

**4 つのゴールデンシグナル**

[Google SRE ハンドブック](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals)によると、ユーザー向けシステムの 4 つのメトリクスしか測定できない場合は、この 4 つのメトリクスに重点を置いてください。

このメソッドは RED メソッドに似ていますが、飽和が含まれています。
+ **[レイテンシー]** – リクエストの処理にかかる時間。
+ **[トラフィック]** – システムにどれだけの需要があるか。
+ **[エラー]** – 失敗したリクエストのレート。
+ **[飽和]** — システムがどれだけ「飽和」状態であるか

## ダッシュボード管理成熟度モデル
<a name="v10-dash-management-maturity-model"></a>

*ダッシュボード管理の成熟度*とは、ダッシュボードエコシステムの設計と効率性を指します。ダッシュボードの設定を定期的に見直して、現在の状況と改善方法を判断することをお勧めします。

大まかに言うと、ダッシュボードの成熟度は低、中、高と定義できます。

 このトピックのコンテンツの多くは、KubeCon 2019 トーク「[スリープ配信オンコール用のフールプルーフ Kubernetes ダッシュボード](https://www.youtube.com/watch?v=YE2aQFiMGfY)」から取得されました。

**低 – デフォルト状態**

この段階では、一貫性のあるダッシュボード管理戦略はありません。ほぼすべてがここから開始します。

ここに位置しているとどのように認識できるのでしょうか？
+ 誰でもダッシュボードを変更できます。
+ 多くのダッシュボードがコピーされているが、ダッシュボードの再利用はほとんどまたはまったくありません。
+ 永久に残る 1 回限りのダッシュボード。
+ バージョンコントロールなし (バージョンコントロールのダッシュボード JSON)。
+ ダッシュボードのブラウジングが多く、適切なダッシュボードを検索します。つまり、必要なダッシュボードを探すために多くの時間を無駄にすることになります。
+ 適切なダッシュボードに誘導するアラートはありません。

**中 – 系統的なダッシュボード**

この段階では、系統的なダッシュボードでダッシュボードの使用を管理し始めます。戦略を立てたかもしれませんが、改善できる点がいくつかあります。

 ここに位置しているとどのように認識できるのでしょうか？ 
+ テンプレート変数を使用してスプロールを防止します。例えば、ノードごとに個別のダッシュボードは必要ありません。クエリ変数を使用できます。さらに、データソースをテンプレート変数にすることもできます。これにより、異なるクラスター間で同じダッシュボードを再利用したり、バックエンドを監視したりできます。

  アイデアについては、「[変数](v10-dash-variables.md)」の例のリストを参照してください。
+ [オブザーバビリティ戦略に従った系統的なダッシュボード](#v10-dash-common-observability-strategies)。
+ 次のレベルにドリルダウンした階層ダッシュボード。
+ ダッシュボードの設計には、サービス階層が反映されます。例えば、サービスごとに 1 行のRED メソッドを使用できます。ダッシュボードをスクロールダウンすると、行の順序にデータフローが反映される可能性があります。
+ 大きさが異なる場合にサービスダッシュボードを分割することで比較します。集約されたメトリクスが重要な情報を枯渇させないようにしてください。
+ 可能な場合は色を効果的に使用し、軸を正規化する表現豊かなグラフを作成します。
  + 効果的な色の例: 青は良好、赤は問題があることを意味します。[しきい値](v10-panels-configure-thresholds.md)はそれに役立ちます。
  + 軸の正規化の例: CPU 使用率を比較する場合は、マシンのコア数が異なる可能性があるため、生の数値ではなくパーセンテージで測定します。CPU 使用率をコア数で正規化すると、CPU の数を知らなくても、すべてのコアが 100% で使用されていることを信頼できるため、認識負荷が軽減されます。
+ 誘導ブラウジングは推測を減らします。
  + テンプレート変数を使用すると、ランダムにまたは目的なくブラウズするのが難しくなります。
  + ほとんどのダッシュボードは、アラートによってリンクする必要があります。
  + ブラウジングはリンクで指示されます。詳細については、「[ダッシュボードリンクの管理](v10-dash-manage-dashboard-links.md)」を参照してください。
+  バージョン管理されたダッシュボード JSON。

**高 – 最適化使用**

この段階では、一貫性のある思慮深い戦略でダッシュボード管理の使用を最適化できています。メンテナンスが必要ですが、結果には価値があります。
+ スプロールを積極的に減らします。
  + 既存のダッシュボードを定期的に確認し、関連性があることを確認します。
  + マスターダッシュボードリストに追加された承認済みダッシュボードのみが対象です。
  + ダッシュボードの使用を追跡します。[[使用率のインサイト]](v10-dash-assess-dashboard-usage.md) を活用できます。
+ 設計上の一貫性を確保します。
+ スクリプティングライブラリを使用してダッシュボードを生成し、パターンとスタイルの一貫性を確保します。
  + grafonnet (Jsonnet)
  + grafanalib (Python)
+ ブラウザでは編集機能を提供しません。ダッシュボードビューワーでは、変数を使用してビューを変更します。
+ ダッシュボードの閲覧は例外であり、ルールではありません。
+ 本番環境のインスタンスではなく、その目的専用の別の Grafana インスタンスで実験とテストを実行します。テスト環境のダッシュボードが有用であることが証明されたら、そのダッシュボードをメイン Grafana インスタンスに追加します。

## ダッシュボードを作成するためのベストプラクティス
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

このセクションでは、Grafana ダッシュボードを作成するときに従うべきいくつかのベストプラクティスについて説明します。

**[開始する前に]**

 ダッシュボードを作成する前に考慮すべき原則をいくつかご紹介します。

**ダッシュボードはストーリーを伝えたり、質問に答えたりするべきである**

ダッシュボードでどのようなストーリーを伝えようとしていますか？ 大規模から小規模、または一般的から特定まで、データの論理的な進行を作成してみてください。このダッシュボードの目標は何ですか？ (ヒント: ダッシュボードに目標がない場合は、ダッシュボードが本当に必要かどうかを自分に問いかけてみてください)

グラフはシンプルに保ち、尋ねる質問への回答に集中してください。例えば、質問が「どのサーバーに問題があるか」である場合、すべてのサーバーデータを表示する必要はありません。問題のあるデータのみを表示します。

**ダッシュボードは認知負荷を軽減し、付加すべきでない**

*認知負荷*とは、基本的には何かを理解するためにどれだけ多くのことを考える必要があるかということです。ダッシュボードの解釈を容易にします。他のユーザーと未来のあなた (午前 2 時に何が壊れたかを理解しようとしているとき) は、それを有用に思うでしょう。

 自分に問いかけてください。
+ 各グラフが正確に何を表すかわかりますか？ それは明白ですか、それともそれについて考える必要がありますか？
+ それを他の誰かに見せると、その人物がそれを理解するのにどのくらい時間がかかりますか？ わからなくなる場合があるでしょうか？

**監視戦略を持つ**

新しいダッシュボードを簡単に作成できます。ダッシュボードの作成を最適化し、計画に従うのは難しいですが、その価値はあります。この戦略は、ダッシュボードスキーム全体を管理し、個々のダッシュボード設計に一貫性を持たせるべきです。

詳細については、「[一般的なオブザーバビリティ戦略](#v10-dash-common-observability-strategies)」と「[ダッシュボード管理の成熟度レベル](#v10-dash-management-maturity-model)」を参照してください。

**書き留める**

戦略または設計ガイドラインを作成したら、時間の経過に伴う一貫性を維持するために書き留めます。

**従うべきベストプラクティス**
+ 新しいダッシュボードを作成するときは、意味のある名前をつけましょう。
  + 再生または実験目的でダッシュボードを作成する場合は、名前に `TEST`または `TMP`という単語を入力します。
  + ダッシュボード名に自分の名前またはイニシャルを含めるか、タグとして含めて、ダッシュボードの所有者を知らせることを検討してください。
  + 一時実験ダッシュボードは、完了したら削除するようにします。
+ 関連するダッシュボードを多数作成する場合は、ナビゲーションを容易にするためにそれらを相互参照する方法を検討してください。詳細については、このセクション後半の「[ダッシュボードを管理するためのベストプラクティス](#v10-dash-best-practices-for-managing-dashboards)」を参照してください。
+ Grafana はデータソースからデータを取得します。[データソースに接続する](AMG-data-sources.md) 全般、および特定のデータソースに関する基本的な理解が重要です。
+ 不要なダッシュボードの更新を避けて、ネットワークまたはバックエンドの負荷を軽減します。例えば、データが 1 時間ごとに変更される場合、ダッシュボードの更新レートを 30 秒に設定する必要はありません。
+ 異なる単位または範囲の時系列を表示するときは、左右の Y 軸を使用します。
+ ダッシュボードとパネルにドキュメントを追加します。
  + ダッシュボードにドキュメントを追加するには、[テキストパネルの視覚化](v10-panels-text.md)をダッシュボードに追加します。ダッシュボードの目的、便利なリソースリンク、ユーザーがダッシュボードを操作するために必要な手順などを記録します。
  + パネルにドキュメントを追加するには、パネル設定を編集し、説明を追加します。追加したテキストは、パネルの左上隅にある小さな `i` 部分にカーソルを合わせると表示されます。
+ [テンプレートと変数](v10-dash-variables.md)を使用して、ダッシュボードを再使用して一貫性を強化します。
+ グラフデータのスタックには注意してください。視覚化は誤解を招き、重要なデータを覆い隠す可能性があります。ほとんどの場合、オフにすることをお勧めします。

## ダッシュボードを管理するためのベストプラクティス
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 このページでは、Grafana ダッシュボードを管理するときに従うべきいくつかのベストプラクティスについて説明します。

**[開始する前に]**

ダッシュボードの管理を開始する前に考慮すべき原則をいくつかご紹介します。

**戦略的オブザーバビリティ**

[一般的なオブザーバビリティ戦略](#v10-dash-common-observability-strategies)はいくつかあります。これらを調査し、そのうちの 1 つを採用するか、自分で戦略を考えるかを決定すべきです。いずれにせよ、計画を立て、書き留めて、それに従います。

必要に応じて、変化するニーズに戦略を適応させます。

**成熟度レベル**

ダッシュボードの成熟度レベルは？ 現在のダッシュボード設定を分析し、[ダッシュボード管理成熟度モデル](#v10-dash-management-maturity-model)と比較します。現時点の状況を理解することは、希望する場所にたどり着く方法を決定するのに役立ちます。

**従うべきベストプラクティス**
+ ダッシュボードのスプロールは避けてください。つまり、ダッシュボードの制御されない成長は避けてください。ダッシュボードのスプロールは、適切なダッシュボードを見つける時間に悪影響を及ぼします。ダッシュボードの複製と「単一の項目」の変更 (元のタグを保持することが最悪のシナリオです) が最も簡単なスプロールです。
  + ダッシュボードを定期的に確認し、不要なダッシュボードを削除します。
  + 一時的なダッシュボードをテストなどの目的に作成する場合、名前のプレフィックスに `TEST:` を付けます。完了したらダッシュボードを削除します。
+ 大きな変更のないダッシュボードをコピーすることはお勧めしません。
  + ドキュメントの変更、バグ修正、メトリクスの追加など、元のダッシュボードの更新を見逃す可能性があります。
  + 多くの場合、テンプレートパラメータを設定してビューをカスタマイズするためにコピーが行われています。代わりに、マスターダッシュボードへのリンクを維持し、[URL パラメータ](v10-panels-configure-data-links.md#v10-panels-data-link-variables)を使用してビューをカスタマイズしてこれを行うべきです。
+ ダッシュボードをコピーする必要がある場合は、名前を明確に変更し、ダッシュボードタグをコピー*しないでください*。タグは、検索中に使用されるダッシュボードの重要なメタデータです。タグをコピーすると、誤一致が発生する可能性があります。
+ ダッシュボードまたは相互参照ダッシュボードのダッシュボードを維持します。これには、いくつかの方法があります。
  + ダッシュボードリンク、パネル、またはデータリンクを作成します。リンクは、他のダッシュボードまたは外部システムに移動できます。詳細については、「[ダッシュボードリンクの管理](v10-dash-manage-dashboard-links.md)」を参照してください。
  +  [ダッシュボードリストパネル](v10-panels-dashboard-list.md)を追加します。その後、タグまたはフォルダ検索を実行して、表示内容をカスタマイズできます。
  + [テキストパネル](v10-panels-dashboard-list.md)を追加し、マークダウンを使用して表示をカスタマイズします。

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

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

ワークスペースの **[ダッシュボード]** ページ (左側のメニューから **[ダッシュボード]** を選択して使用可能) で、ダッシュボードをフォルダに整理するなど、ダッシュボード管理タスクを実行できます。

ダッシュボードの作成の詳細については、「[ダッシュボードの構築](v10-dash-building-dashboards.md)」を参照してください。

## ダッシュボードの参照
<a name="v10-dash-browse-dashboards"></a>

**[ダッシュボード]** ページで、フォルダとダッシュボードを参照および管理できます。これには、以下のオプションが含まれます。
+ フォルダとダッシュボードを作成します。
+ ダッシュボードをフォルダ間で移動します。
+ 複数のダッシュボードとフォルダを削除します。
+ フォルダに移動します。
+ フォルダのアクセス許可を管理します」。詳細については、「[ダッシュボードおよびフォルダのアクセス権限](dashboard-and-folder-permissions.md)」を参照してください。

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

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

**前提条件**

Grafana 管理者のアクセス許可があることを確認します。ダッシュボードのアクセス許可の詳細については、「[ダッシュボードおよびフォルダのアクセス権限](dashboard-and-folder-permissions.md)」を参照してください。

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

1. Grafana にサインインします。

1. 左側のメニューで、**[ダッシュボード]** を選択します。

1. **[ダッシュボード]** ページで、**[新規]** を選択し、ドロップダウンで **[新しいフォルダ]** を選択します。

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

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

**フォルダの名前を編集するには**

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

1. 名前を変更するフォルダを選択する

1. ヘッダーで **[タイトルの編集]** (鉛筆) アイコンを選択し、フォルダの名前を更新します。

   新しいフォルダ名は自動的に保存されます。

**フォルダのアクセス許可**

フォルダにアクセス許可を割り当てることができます。フォルダ内のダッシュボードは、フォルダに割り当てたアクセス許可を継承します。組織のロール、チーム、ユーザーにアクセス許可を割り当てることができます。

**フォルダのアクセス許可を変更するには**

1. 左側のメニューから **[ダッシュボード]** を選択します。

1. リスト内のフォルダを選択します。

1. フォルダの詳細ページで、**[フォルダアクション]** を選択し、ドロップダウンリストから **[アクセス許可の管理]** を選択します。

1. 必要に応じてアクセス許可を更新します。

変更は自動的に保存されます。

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

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

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

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

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

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

1. 左側のメニューから **[Playlists]** (プレイリスト) を選択します。

1. 既存のプレイリストのリストからプレイリストを選択します。

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

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

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

**プレイリストを開始するには**

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

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

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

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

1. **[<プレイリスト名> を開始]** をクリックします。

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


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

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

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


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

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

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

**プレイリストを作成するには**

1. 左側のメニューから **[ダッシュボード]** を選択します。

1. **[Playlists]** (プレイリスト) ページでプレイリストを選択します。

1. **[新しいプレイリスト]** を選択します。

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

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

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

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

1. 変更を保存するには **[保存]** を選択します。

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

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

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

**プレイリストを保存するには**

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

1. **[Playlists]** (プレイリスト) を選択して、利用可能なプレイリストを表示します。

1. 所望のプレイリストを選択します。

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

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

1. 変更を保存するには **[保存]** を選択します。

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

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

**プレイリストを編集するには**

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

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

1. 変更を保存するには **[保存]** を選択します。

**プレイリストを削除するには**

1. **[Playlists]** (プレイリスト) を選択します。

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

**プレイリストでダッシュボードの順序を変更するには**

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

1. 変更を保存するには **[保存]** を選択します。

**ダッシュボードを削除するには**

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

1. 変更を保存するには **[保存]** を選択します。

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

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

**ビューモードでプレイリストを共有するには**

1. 左側のメニューの **[ダッシュボード]** から、**[プレイリスト]** を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

**ダッシュボードを共有するには**

1. ワークスペースの左側のメニューから **[ダッシュボード]** を選択します。

1. 共有するダッシュボードを選択します。

1. 画面上部の共有アイコンを選択します。

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

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

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

**直接リンクを共有するには**

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

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

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

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

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

**スナップショットを公開するには**

1. **[Snapshot]** (スナップショット) タブを選択します。

1. **[Local Snapshot]** (ローカルスナップショット) を選択します。

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

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

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

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

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

**パネルを共有するには**

1. 共有するパネルのパネルタイトルを選択します。パネルメニューが開きます。

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

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

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

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

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

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

**パネルスナップショットの公開**

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

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

**パネルスナップショットを公開するには**

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

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

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

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

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

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

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

1. **[ライブラリパネルl]** を選択します。

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

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

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

1. ダッシュボードを保存します。

# 変数
<a name="v10-dash-variables"></a>

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

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

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

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

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

**テンプレート**

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

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

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

**例**

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

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

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

**変数のベストプラクティス**
+ 変数のドロップダウンリストは、**[ダッシュボード設定]** の変数リストに一覧されている順序で表示されます。
+ 頻繁に変更する変数を一番上に置くと、ダッシュボードの左端に最初に表示されるようになります。
+ 変数は、デフォルトでドロップダウンリストの最上位値を事前に選択します。代わりに空の値を選択する場合は、次のように変数の設定を変更します。

  1. **[すべてのオプションを含める]** チェックボックスを選択します。

  1. **[すべての値のカスタム化]** フィールドに、値 `+` を入力します。

**Topics**
+ [変数の追加と管理](v10-dash-variable-add.md)
+ [変数の検査](v10-dash-variable-add-inspect.md)
+ [変数構文](v10-dash-variable-syntax.md)

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

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

次の表に、Grafana の変数タイプ一覧を示します。


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

**Topics**
+ [一般的なオプションの入力](#v10-dash-variable-options)
+ [クエリ変数の追加](#v10-dash-variable-add-query)
+ [カスタム変数の追加](#v10-dash-variable-add-custom)
+ [テキストボックス変数の追加](#v10-dash-variable-add-text)
+ [定数変数の追加](#v10-dash-variable-add-constant)
+ [データソース変数の追加](#v10-dash-variable-add-datasource)
+ [間隔変数の追加](#v10-dash-variable-add-internal)
+ [アドホックフィルターの追加](#v10-dash-variable-add-adhoc)
+ [変数選択オプションを設定する](#v10-dash-variable-add-selection)
+ [グローバル変数](#v10-dash-variable-add-global)
+ [連鎖変数](#v10-dash-variable-add-chained)
+ [変数の管理](#v10-dash-variable-add-manage)
+ [正規表現での変数のフィルタリング](#v10-dash-variable-add-filter)

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

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

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

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

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

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

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

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

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

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

## クエリ変数の追加
<a name="v10-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. **[クエリ]** フィールドにクエリを入力します。
   + クエリフィールドはデータソースによって異なります。一部のデータソースには、カスタムクエリエディタがあります。
   + クエリは、 `__text` および `__value` という名前の値を返す必要があります。例えば、SQL では、`SELECT hostname AS __text, id AS __value from MyTable` などのクエリを使用できます。他の言語のクエリは構文によって異なります。
   + 1 つの入力フィールドクエリエディタにより多くのスペースが必要な場合は、フィールドの右下隅にある線上にカーソルを合わせ、下にドラッグして展開します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   **[高度なデータソースピッカーを開く]** を選択して、データソースの追加 (管理者のみ可能) など、その他のオプションを表示することもできます。詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

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

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

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

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

## 間隔変数の追加
<a name="v10-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="v10-dash-variable-add-adhoc"></a>

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

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

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

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

   **[高度なデータソースピッカーを開く]** を選択して、データソースの追加 (管理者のみ可能) など、その他のオプションを表示することもできます。詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

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

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

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

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

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

### 複数値の変数
<a name="v10-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 形式](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw) を使用します。

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

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

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

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

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

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

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

## グローバル変数
<a name="v10-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 データソースで使用されます。

**\$1\$1\$1timezone**

`$__timezone` 変数は、現在選択されているタイムゾーン、`utc` または IANA タイムゾーンデータベースのエントリ (例: `America/New_York`) を返します。

現在選択されているタイムゾーンが*ブラウザ時間*である場合、Grafana はブラウザのタイムゾーンを判別しようとします。

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

*連鎖変数*は、*リンクされた変数*または*ネストされた変数*とも呼ばれ、変数クエリ内において 1 つ以上の他の変数を持つクエリ変数です。

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

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

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

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

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

**変数の順序**

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

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

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

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

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

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

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

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

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

## 正規表現での変数のフィルタリング
<a name="v10-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="v10-dash-variable-add-inspect"></a>

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

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

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

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.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="v10-dash-assess-dashboard-usage"></a>

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

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

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

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

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

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

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

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

1. ワークスペースのメインナビゲーションで **[接続]** を選択します。

1. **[データソース]** を選択します。

1. データソースを選択します。

1. **[インサイト]** タブを選択します。

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

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

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

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

検索ビューでは、インサイトデータを使用して、最も使用されているダッシュボード、壊れているダッシュボード、未使用のダッシュボードを見つけることができます。ダッシュボードは、次の項目でソートできます。
+ ビュー
+ エラー
+ ビュー
+ 作成日時
+ 更新日時

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

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

 次の戦略を使用して、一般的なダッシュボードの問題をトラブルシューティングします。

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

## ダッシュボードの更新レートの問題
<a name="v10-dash-refresh-rate-issues"></a>

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

次の構成を推奨します。
+ 必要に応じて、ダッシュボード、パネル、または変数の自動更新のみを有効にします。ユーザーはブラウザを手動で更新できます。
+ 自動更新が必要な場合は、1 分に 1 回、10 分に 1 回、1 時間に 1 回など、更新レートをより長い期間に設定します。
+ ダッシュボードの時間範囲を確認します。ダッシュボードの時間範囲が 1 週間など長い場合、自動更新は必要なく、無効にすべきです。

## null データの処理またはレンダリングが間違っている、または混乱している
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

一部のアプリケーションは断続的にデータを公開します。例えば、イベントが発生したときにのみメトリクスを投稿します。デフォルトでは、Grafana グラフはデータポイント間で線を接続しますが、これは誤解を招く可能性があります。

**[null 値の接続]** オプションが **[常に]** に設定されているグラフは、値が欠落している線を繋げます。

これを修正する 1 つの方法は、線の代わりにバーを使用し、**[値なし]** オプション (**[標準オプション]**の下) を `0` に設定することです。この場合、欠落したデータは、データのないグラフの領域として表示されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## コマンドパレット
<a name="v10-search-palette"></a>

コマンドパレットを使うと、次のことができます。
+ ダッシュボードとフォルダを検索して開きます。
+ ダッシュボードとアラートルールを作成します。
+ Grafana 内のページを見つけます。
+ ダークテーマまたはライトテーマに変更します。

コマンドパレットをトップで開き、「`ctrl+k`」(MacOS では「`cmd+k`」) と入力します。Grafana ナビゲーションバーで検索入力を選択することもできます。

**注記**  
前の手順に進むには、コマンドパレットを空にして `backspace` を押します。