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

# Grafana バージョン 9 での作業
<a name="using-grafana-v9"></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 のバージョン 9 を使用する Grafana ワークスペースの使用について説明します。

**Topics**
+ [Grafana バージョン 9 のダッシュボード](v9-dashboards.md)
+ [Grafana バージョン 9 のパネルと視覚化](v9-panels.md)
+ [Grafana バージョン 9 で探索する](v9-explore.md)
+ [Grafana バージョン 9 のアラート](v9-alerts.md)

# 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` を押してタグを選択します。

# Grafana バージョン 9 のパネルと視覚化
<a name="v9-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)」を参照してください。

 *パネル*は Grafana の基本的な視覚化構築ブロックです。各パネルには、パネルで選択されたデータソース特有のクエリエディタがあります。クエリエディタを使用すると、視覚化するデータを返すクエリを構築できます。

 各パネルにはさまざまなスタイルとフォーマットのオプションがあります。パネルをドラッグ、ドロップ、サイズ変更して、ダッシュボード上で配置を変更できます。

 パネルを追加する前に、データソースが設定されていることを確認してください。

追加のパネルタイプは、追加の[プラグイン](grafana-plugins.md)をワークスペースにインストールすることで使用できます。
+  特定のデータソース使用の詳細については「[データソースに接続する](AMG-data-sources.md)」を参照してください。

**Topics**
+ [パネルエディタの概要](v9-panels-editor-overview.md)
+ [パネルオプションの設定](v9-panels-configure-panel-options.md)
+ [標準オプションを設定する](v9-panels-configure-standard-options.md)
+ [データのクエリと変換](v9-panels-query-xform.md)
+ [しきい値を設定する](v9-panels-configure-thresholds.md)
+ [データリンクの設定](v9-panels-configure-data-links.md)
+ [フィールドのオーバーライドを設定する](v9-panels-configure-overrides.md)
+ [値マッピングを設定する](v9-panels-configure-value-mappings.md)
+ [凡例を設定する](v9-panels-configure-legend.md)
+ [計算タイプ](v9-panels-calculation-types.md)
+ [視覚化に注釈を付ける](v9-panels-annotate-visualizations.md)
+ [パネル検査ビュー](v9-panels-panel-inspector.md)
+ [Grafana バージョン 9 で利用可能な視覚化](v9-panels-viz.md)

# パネルエディタの概要
<a name="v9-panels-editor-overview"></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 パネルエディタの領域について説明します。
+  パネルヘッダー: ヘッダーセクションには、パネルが表示されるダッシュボードと、次のコントロールが一覧表示されます。
  +  **[ダッシュボード設定 (ギア) アイコン]**: ダッシュボード設定へのアクセスをクリックします。
  +  **[破棄]:** ダッシュボードを最後に保存してから行ったパネルへの変更が破棄されます。
  +  **[保存]**: パネルに加えた変更を保存します。
  +  **[適用]**: 行った変更が適用され、パネルエディタが閉じてダッシュボードに戻ります。ダッシュボードを保存して、適用された変更を保持する必要があります。
+  視覚化プレビュー: 視覚化プレビューセクションには、次のオプションが含まれています。
  +  **[テーブルビュー]**: 視覚化をテーブルに変換して、データを表示します。テーブルビューはトラブルシューティングに役立ちます。このビューには未加工データのみが含まれます。データに適用した変換や、[テーブル](v9-panels-table.md)の視覚化で使用できる書式設定オプションは含まれません。
  +  **[塗りつぶし]**: 視覚化プレビューで、使用可能なスペースを塗りつぶします。サイドペインの幅またはボトムペインの高さを変更すると、視覚化が変更され、使用可能なスペースが塗りつぶされます。
  +  **[実寸]:** 視覚化プレビューが、ダッシュボードの実際のサイズで表示されます。十分なスペースがない場合、視覚化はアスペクト比が保持されたまま縮小されます。
  +  **[時間範囲コントロール]** – **[デフォルト]**は、ブラウザのローカルタイムゾーンまたはより高度な設定で選択されたタイムゾーンです。
+  データセクション: データセクションには、クエリの入力、データの変換、アラートルールの作成 (該当する場合) を行うタブがあります。
  +  **[クエリ] タブ** – データソースを選択し、ここにクエリを入力します。
  +  **[変換 タブ]**: データ変換を適用します。
  +  **[アラート] タブ** – アラートルールを入力します。
+  パネル表示オプション: 表示オプションセクションには、データ視覚化のほぼすべての側面を設定するタブがあります。

## パネル検査ドロワーを開く
<a name="v9-panels-editor-open-panel"></a>

 検査ドロワーは、パネルの理解とトラブルシューティングに役立ちます。任意のパネルの未加工データの表示、データの CSV (comma-separated values: カンマ区切り) ファイルへのエクスポート、クエリリクエストの表示、JSON 形式のパネルとデータのエクスポートが可能です。

 **注**: すべてのパネルタイプにタブがすべてあるわけではありません。例えば、ダッシュボードリストパネルには検査する未加工データがないため、[統計]、[データ]、[クエリ] タブは表示されません。

 パネルインスペクターは、次のオプションで構成されます。
+  パネル検査ドロワーは、右側にドロワーが開いて表示されます。右上隅の矢印をクリックして、ドロワーペインを展開または縮小します。
+  **[データ タブ]** – 変換が適用されたクエリによって返される未加工データを表示します。オーバーライドや値マッピングなどのフィールドオプションは、デフォルトでは適用されません。
+  **[統計タブ]** – クエリにかかる時間および返される量を示します。
+  **[JSON] タブ -** パネル JSON、パネルデータ JSON、およびデータフレーム構造 JSON を、表示およびコピーできます。これは Grafana のプロビジョニングまたは管理に役立ちます。
+  **[クエリタブ] –** Grafana がデータソースへのクエリ実行時に送信されるサーバーへのリクエストを表示します。
+  **[エラータブ]** – エラーを表示します。クエリがエラーを返す場合にのみ表示されます。

# パネルオプションの設定
<a name="v9-panels-configure-panel-options"></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 モデルを表示する 
+  繰り返し行とパネルを追加する 

## パネルを編集する
<a name="v9-panels-edit-a-panel"></a>

 ダッシュボードにパネルを追加すると、いつでもパネルを開いてクエリを変更または更新したり、データ変換を追加したり、視覚化設定を変更したりできます。

1.  編集するパネルを含むダッシュボードを開きます。

1.  パネルのいずれかの部分にカーソルを合わせると、右上隅にアクションメニューが表示されます。

1.  メニューをクリックし、**[編集]** を選択します。

    キーボードショートカットを使用してパネルを開くには、パネルにカーソルを合わせ、**e** を押します。

    パネルが編集モードで開きます。

## パネルにタイトルと説明を追加する
<a name="v9-panels-add-title-description"></a>

 パネルにタイトルと説明を追加して、視覚化に関する重要な情報をユーザーと共有します。例えば、説明を使用して、視覚化の目的を文書化します。

1.  パネルを編集します。

1.  パネル表示オプションペインで、**[パネルオプション]** セクションを見つけます。

1.  **[タイトル]** を入力します。

    このフィールドに入力されたテキストは、パネルエディタのパネル上部とダッシュボードに表示されます。

1.  表示するパネルとデータの説明を記入します。

    このフィールドに入力したテキストは、パネルの左上隅にあるツールチップに表示されます。

    **[タイトル]** と **[説明]** フィールドで[[定義した変数]](v9-dash-variables.md)を使用できますが、[[グローバル変数]](v9-dash-variable-add.md#v9-dash-variable-add-global)は使用できません。

    

## パネル JSON モデルを表示する
<a name="v9-panels-json-model"></a>

 パネル、パネルデータ、データフレーム JSON モデルを検索してエクスポートします。

1.  パネルを含むダッシュボードを開きます。

1.  パネルのいずれかの部分にカーソルを合わせると、右上隅にアクションメニューが表示されます。

1.  メニューをクリックして、**[Inspect] (検査) > [Panel JSON]** を選択します。

1.  **[ソースの選択]** フィールドで、次のオプションのいずれかを選択します。
   +  **Panel JSON**: パネルを表す JSON オブジェクトを表示します。
   +  **[Panel data]**: パネルに渡されるデータを表す JSON オブジェクトを表示します。
   +  **[データフレーム構造]**: 変換、フィールド設定、オーバーライド設定が適用された未加工の結果セットを表示します。

1.  JSON を調べるには、**[>]** をクリックして JSON モデルの一部を展開または折りたたみます。

## 繰り返しパネルを設定する
<a name="v9-panels-configure-repeating-panels"></a>

 パネルまたは行をダッシュボードに動的に追加するように Grafana を設定できます。動的パネルは、変数の値に基づいてシステムが作成するパネルです。変数は、ダッシュボード内のすべてのパネルでクエリを動的に変更します。

**注記**  
パネルを繰り返すには、変数に 1 つ以上の項目を選択する必要があります。パネルを非表示にするためにパネルを 0 回繰り返すことはできません。

 **開始する前に:** 
+  クエリに複数値変数が含まれていることを確認します。

 **繰り返しパネルを設定するには:** 

1. 繰り返すパネルを編集します。

1.  表示オプションペインで、**[パネルオプション] > [繰り返しオプション]** をクリックします。

1.  **[direction]** (方向) を選択します。
   +  **[水平]** を選択してパネルを並べて配置します。Grafana は繰り返しパネルの幅を調整します。現在、行上の他のパネルと繰り返しパネルを混在して使うことはできません。
   +  **[垂直]** を選択して、列にパネルを配置します。繰り返しパネルの幅は、元の繰り返しパネルの幅と同じです。

1.  すべてのパネルに変更を伝達するには、ダッシュボードを再読み込みします。

# 標準オプションを設定する
<a name="v9-panels-configure-standard-options"></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 のデータの表示方法を変更します。オプションを変更すると、すべてのフィールド、つまりすべての系列または列に適用されます。例えば、単位をパーセンテージに変更すると、数値を含むすべてのフィールドがパーセンテージで表示されます。

 フィールドの書式設定オプションの完全なリストについては、「[標準オプション定義](#v9-panels-standard-options-definitions)」を参照してください。

**注記**  
 ほとんどの組み込み Grafana パネルに標準オプションを適用できます。新しいパネルとデータモデルに更新されていない古いパネルとコミュニティパネルの一部には、これらのフィールドオプションのすべてまたは一部が欠落します。

1.  ダッシュボードを開き、パネルタイトルをクリックし、**[編集]** をクリックします。

1.  パネル表示オプションペインで、**[標準オプション]** セクションを見つけます。

1.  適用する標準オプションを選択します。

1.  変更をプレビューするには、編集中のフィールドオプションボックスの外部をクリックするか、**Enter** を押します。

## 標準オプションの定義
<a name="v9-panels-standard-options-definitions"></a>

 このセクションでは、使用可能なすべての標準オプションについて説明します。

 ほとんどの組み込み Grafana パネルに標準オプションを適用できます。新しいパネルとデータモデルに更新されていない古いパネルとコミュニティパネルの一部には、これらのフィールドオプションのすべてまたは一部が欠落します。

 ほとんどのフィールドオプションは、編集中のフィールドオプションボックスの外部をクリックするか、Enter キーを押すまで、視覚化には影響しません。

**注記**  
 すべての視覚化に対するオプションの追加と拡張に常に取り組んでいるため、すべてのオプションをすべての視覚化に対して使用できない場合があります。

### Unit
<a name="v9-panels-standard-options-unit"></a>

 フィールドで使用する単位を選択できます。**[単位]** フィールドをクリックし、目的の単位が見つかるまでドリルダウンします。選択した単位は、時間を除くすべてのフィールドに適用されます。

#### ユーザー定義の単位
<a name="v9-panels-standard-options-custom-units"></a>

 単位ドロップダウンを使用して、ユーザー定義の単位、接頭辞、または接尾辞と、日付時刻形式を指定することもできます。

 ユーザー定義の単位を選択するには、単位を入力し、ドロップダウンで最後の **[カスタム: xxx]** オプションを選択します。
+  **suffix:<suffix>** 値の後に続くユーザー定義単位を指定できます。
+  **prefix:<prefix>** 値の前に置くユーザー定義単位を指定できます。
+  **time:<format>** ユーザー定義の日付時刻形式の場合は、**time:YYYY-MM-DD** などのように入力します。形式構文とオプションについては、「[形式](https://momentjs.com/docs/#/displaying/)」を参照してください。
+  **si:<base scale><unit characters>** ユーザー定義の SI 単位を指定できます。例: **si: mF**。これは、単位とソースデータスケールの両方を指定できるため、少し高度です。したがって、ソースデータがミリ (基本単位の千分の一) で表されている場合、単位の先頭にその SI スケール文字が付けられます。
+  **count:<unit>** ユーザー定義の集計単位を指定できます。
+  **currency:<unit>** ユーザー定義の通貨単位を指定できます。

 単位ピッカーにネイティブ絵文字を貼り付けて、ユーザー定義単位として選択することもできます。

#### [String units] (文字列の単位)
<a name="v9-panels-standard-options-string-units"></a>

 Grafana は、文字列を解析して数値として表示する際に、自動で表示が変わる場合があります。元の文字列値を表示するように Grafana を設定するには、フィールドオーバーライドを作成し、**[文字列]** 単位で単位プロパティを追加します。

### 最小
<a name="v9-panels-standard-options-min"></a>

 パーセンテージしきい値の計算に使用される最小値を設定できます。すべての系列とフィールドに基づいて自動計算する場合は、空白のままにします。

### 最大
<a name="v9-panels-standard-options-max"></a>

 パーセンテージしきい値の計算に使用される最大値を設定できます。すべての系列とフィールドに基づいて自動計算する場合は、空白のままにします。

### 小数
<a name="v9-panels-standard-options-decimals"></a>

 Grafana がレンダリングした値に含める小数点以下の桁数を指定します。このフィールドを空白のままにすると、Grafana は値に基づいて小数点以下の桁数を自動的に切り捨てます。例えば、1.1234 は 1.12 として表示され、100.456 は 100 として表示されます。

 すべての小数を表示するには、単位を **[String]** (文字列) に設定します。

### Display name (表示名)
<a name="v9-panels-standard-options-displayname"></a>

 すべてのフィールドの表示タイトルを設定できます。[変数](v9-dash-variables.md)を使用できます。

 複数の統計、フィールド、または系列が表示される場合、このフィールドは各統計のタイトルを制御します。**\$1\$1\$1\$1field.name\$1** などの式を使用して、タイトルの系列名またはフィールド名のみを使用できます。

 「Temp」という名前のフィールドがあり、ラベルが \$1"Loc"="PBI", "Sensor"="3"\$1 である場合 


|  式の構文  |  例  |  レンダリング先  |  説明  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName \$1  |  構文と同じ  |  Temp \$1Loc="PBI", Sensor="3"\$1  |  フィールド名とラベルがある場合は \$1\$1 で表示します。レスポンスにラベルキーが 1 つしかない場合、ラベル部分において、Grafana は括弧なしでラベルの値を表示します。 | 
|  \$1\$1\$1\$1field.name\$1  |  構文と同じ  |  Temp  |  フィールドの名前を表示します (ラベルなし)。 | 
|  \$1\$1\$1\$1field.labels\$1  |  構文と同じ  |  Loc="PBI", Sensor="3" |  ラベルを表示します (名前なし)。 | 
|  \$1\$1\$1\$1field.labels.X\$1  |  \$1\$1\$1\$1field.labels.Loc\$1  |  PBI  |  指定されたラベルキーの値を表示します。 | 
|  \$1\$1\$1\$1field.labels.\$1\$1values\$1  |  構文と同じ  |  PBI, 3  |  ラベルの値をカンマ区切りで表示します (ラベルキーなし)。 | 

 特定のフィールドに対する式をレンダリングした後に値が空の文字列である場合、デフォルトの表示方法が使用されます。

### カラースキーム
<a name="v9-panels-standard-options-color-scheme"></a>

 カラーオプションとその視覚化への影響は、作業中の視覚化によって異なります。一部の視覚化には、異なるカラーオプションがあります。

 値に基づいて、単一の色を指定するか、連続 (グラデーション) カラースキームを選択できます。連続色は、最小値と最大値に対する値の割合を使用して色を補間します。

 次のいずれかのパレットを選択します。


|  カラーモード  |  説明  | 
| --- | --- | 
|  [単一色]  |  オーバーライドルールに役立つ単一色を指定します  | 
|  [しきい値起点]  |  一致するしきい値から色を取るように Grafana に通知します  | 
|  Classic palette (クラシックパレット)  |  Grafana は、系列のインデックスでパレットの色を検索して色を割り当てます。グラフや円グラフ、その他のカテゴリ別データの視覚化に役立ちます。 | 
|  Green-Yellow-Red (by value) (緑黄赤 (値別))  |  連続色スキーム  | 
|  Blue-Yellow-Red (by value) (青黄赤 (値別))  |  連続色スキーム  | 
|  Blues (by value) (青 (値別))  |  連続色スキーム (パネルの背景を青に)  | 
|  Reds (by value) (赤 (値別))  |  連続色スキーム (パネルの背景色を青に)  | 
|  Greens (by value) (緑 (値別))  |  連続色スキーム (パネルの背景色を青に)  | 
|  Purple (by value) (紫 (値別))  |  連続色スキーム (パネルの背景色を青に)  | 

### 値なし
<a name="v9-panels-standard-options-no-value"></a>

 フィールド値が空または null の場合に Grafana が表示するものを入力します。デフォルト値はハイフン (-) です。

# データのクエリと変換
<a name="v9-panels-query-xform"></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 は、さまざまなタイプの[データソース ](AMG-data-sources.md)をサポートしています。データソース*[クエリ]*は、Grafana が*変換*および視覚化できるデータを返します。各データソースは独自のクエリ言語を使用し、データソースプラグインはそれぞれクエリエディタと呼ばれるクエリ構築ユーザーインターフェイスを実装します。

## クエリについて
<a name="v9-panels-query-xform-about"></a>

Grafana パネルは、クエリを介してデータソースと通信します。このクエリは、視覚化用のデータを取得します。クエリは、データソースで使用されるクエリ言語で記述された質問です。

パネルのデータソースオプションで、クエリの頻度とデータ収集の制限を設定できます。Grafana は、パネルごとに最大 26 個のクエリをサポートします。

各データソースのクエリ言語の詳細については、[「データソース」](AMG-data-sources.md)セクションを参照してください。

**クエリエディタ**

各データソースの*クエリエディタ*には、独自の機能を活用するクエリの作成に役立つカスタマイズされたユーザーインターフェイスが用意されています。

クエリ言語の違いにより、各データソースクエリエディタの外観と関数は異なります。データソースによっては、クエリエディタが自動補完機能、メトリクス名、変数の提案、ビジュアルクエリ構築インターフェイスを提供する場合があります。

特定のデータソースの一意のクエリエディタ機能の詳細については、以下の各ドキュメントを参照してください。
+ Grafana に含まれるデータソースについては、「[組み込みデータソース](AMG-data-sources-builtin.md)」を参照してください。
+ Grafana Enterprise の編集に含まれるデータソースについては、「[Enterprise データソースに接続する](AMG-data-sources-enterprise.md)」を参照してください。

**クエリ構文**

データソースは、異なるクエリ言語を使用してデータをリクエストします。特定のデータソースの一意のクエリ言語の詳細については、各ドキュメントを参照してください。

**[PostgreSQL の例]**:

```
SELECT hostname FROM host WHERE region IN($region)
```

**PromQL の例**:

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**[特別なデータソース]**

Grafana には、**[Grafana]**、**[混合]**、および **[ダッシュボード]** の 3 つの特別なデータソースも含まれています。詳細については、「データソース」を参照してください。

## クエリタブを操作する
<a name="v9-panels-query-xform-navigate"></a>

パネルの **[クエリ]** タブは、次の要素で構成されます。
+ **[データソースセレクタ]** – クエリが実行されるデータソースを選択します。
+ **[クエリオプション]** — 最大データ取得パラメータとクエリ実行時間間隔を設定します。
+ **[クエリインスペクターボタン]** — クエリインスペクターパネルを開き、クエリを表示および最適化できます。
+ **[クエリエディタリスト]:** – 作成したクエリを一覧表示します。
+ **[式]:** – 式ビルダーを使用してアラート式を作成します。式の詳細については、「[クエリ式の書き込み](v9-panels-query-xform-expressions.md)」を参照してください。

## クエリの追加
<a name="v9-panels-query-xform-add"></a>

クエリは、Grafana がダッシュボードパネルで視覚化するデータを返します。パネルを作成すると、Grafana は自動的にデフォルトのデータソースを選択します。

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

1. クエリを追加するパネルを編集します。

1. **[クエリ]** タブを選択します。

1. **[データソース]** ドロップダウンメニューを選択し、データソースを選択します。

1. **[クエリオプション]** を選択して、必要なデータポイントの最大数を設定します。クエリオプションの詳細については、「[クエリオプション](#v9-panels-query-xform-options)」を参照してください。

1. クエリエディタを使用してクエリを書き込みます。

1. **[適用]** を選択します。

Grafana はデータソースにクエリを実行し、データを視覚化します。

## クエリの管理
<a name="v9-panels-query-xform-manage"></a>

Grafana は、クエリを折りたたみ可能なクエリ行に整理します。各クエリ行にはクエリエディタが含まれ、文字 (A、B、C など) で識別されます。

クエリを管理するには、クエリのコピー、クエリの非表示、クエリの削除、クエリの順序変更、クエリエディタのヘルプの切り替えを行うことができます。

## クエリオプション
<a name="v9-panels-query-xform-options"></a>

データソースセレクタの横にある **[クエリオプション]** を選択すると、選択したデータソースの設定が表示されます。ここで行った変更は、このパネルで行われたクエリにのみ影響します。

Grafana は、ダークグレーテキストで表示されるデフォルトを設定します。変更はホワイトテキストで表示されます。フィールドをデフォルト設定に戻すには、フィールドからホワイトテキストを削除します。

パネルデータソースのクエリオプションには以下が含まれます。
+ **[最大データポイント数]** – データソースがサポートしている場合、返される各系列の最大データポイント数を設定します。クエリが最大データポイント設定よりも多くのデータポイントを返す場合、データソースは、平均、最大、または別の関数でデータポイントを集約することで、返されるポイント数を減らします。

  ポイントの数を制限して、クエリのパフォーマンスを向上させたり、視覚化された行を平滑にしたりできます。デフォルト値はグラフの幅 (またはピクセル数) です。グラフパネルに表示されるスペースと同じ数のデータポイントしか視覚化できないためです。

  ストリーミングデータでは、Grafana はローリングバッファの最大データポイント値を使用します。ストリーミングはデータの継続的なフローであり、バッファリングはストリームをチャンクに分割します。例えば、Loki はライブテーリングモードでデータをストリーミングします。
+ **[最小間隔]** – 自動計算された間隔の最小制限を設定します。これは通常、最小スクレイプ間隔です。データポイントを 15 秒ごとに保存する場合、それよりも間隔を短くしてもメリットはありません。また、スクレイプ間隔よりも低い最小値に設定して、粗く適切に機能するクエリを取得することもできます。
+ **[間隔]** – データポイントを時間別に集計またはグループ化するときに使用できる時間範囲を設定します。

  Grafana は、テンプレートクエリで変数として使用できる適切な間隔を自動的に計算します。変数は、秒 (`$__interval`) またはミリ秒 (`$__interval_ms`) で測定されます。

  間隔は通常、合計や平均などの集計関数で使用されます。例えば、これは間隔変数 `rate(http_requests_total[$__interval])` を使用する Prometheus クエリです。

  この自動間隔は、グラフの幅に基づいて計算されます。ユーザーがグラフを縮小すると、間隔が大きくなり、より粗視化された集計になります。同様に、ユーザーが拡大すると、間隔が短くなり、より高精細な集計になります。

  詳細については、「[グローバル変数](v9-dash-variable-add.md#v9-dash-variable-add-global)」を参照してください。
+ **[相対時間]** – 個々のパネルの相対時間範囲をオーバーライドします。これにより、パネルは、ダッシュボードの右上隅にあるダッシュボードタイムピッカーで選択されている時間とは異なります。これを使用して、同じダッシュボードに異なる期間または日数のメトリクスを表示できます。
**注記**  
ダッシュボードの時間範囲が絶対時間である場合、パネルの時間オーバーライドは効果がありません。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-panels-query-xform.html)
+ **[タイムシフト]** – タイムピッカーに対して開始と終了をシフトすることで、個々のパネルの時間範囲をオーバーライドします。例えば、パネルの時間範囲をダッシュボードのタイムピッカーより 2 時間早くシフトできます。
**注記**  
ダッシュボードの時間範囲が絶対時間である場合、パネルの時間オーバーライドは効果がありません。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v9-panels-query-xform.html)
+ **[キャッシュタイムアウト]** – *(データソースで使用可能な場合のみ表示)* 時系列ストアにクエリキャッシュがある場合、デフォルトのキャッシュタイムアウトをオーバーライドします。この値を秒単位で数値として指定します。

# クエリ式の書き込み
<a name="v9-panels-query-xform-expressions"></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-panels-query-about"></a>

サーバー側の式を使用すると、演算やその他のオペレーションでクエリから返されるデータを操作できます。式は新しいデータを作成し、式のデータを許容できる入力にするためにマイナーなデータ再構築を行う以外は、データソースから返されるデータを操作しません。

**式の使用**

式は主に [Grafana アラート](v9-alerts.md)によって使用されます。処理はサーバー側で行われるため、式はブラウザセッションなしで動作できます。ただし、式はバックエンドデータソースや視覚化でも使用できます。

**注記**  
式は、レガシーダッシュボードアラートでは機能しません。

式は、異なるデータソースからのクエリを組み合わせて有効にするか、データソースで使用できない演算を提供することで、データソースを補強することを目的としています。

**注記**  
可能であれば、データソース内でデータ処理を行う必要があります。ストレージから Grafana サーバーにデータをコピーして処理することは非効率であるため、式は軽量データ処理を対象としています。

式は、時系列または数値データを返すデータソースクエリで機能します。また、[多次元データ](getting-started-grafanaui.md#time-series-dimensions)でも動作します。例えば、複数の系列を返すクエリでは、各系列がラベルまたはタグで識別されます。

個々の式は 1 つ以上のクエリまたはその他の式を入力として受け取り、結果にデータを追加します。個々の式またはクエリは、RefID と呼ばれる名前付き識別子 (例: デフォルト文字 `A` または `B`) である変数で表されます。

個々の式または別の式にあるデータソースクエリの出力を参照するには、この識別子を変数として使用します。

**式のタイプ**

式は 2 種類のデータで動作します。
+ 時系列のコレクション。
+ 数値のコレクション (各数値は項目)。

各コレクションは、単一のデータソースクエリまたは式から返され、RefID で表されます。各コレクションはセットであり、セット内の各項目は、[ラベル](getting-started-grafanaui.md#labels)またはキーと値のペアとして保存されるディメンションによって一意に識別されます。

**データソースクエリ**

サーバー側の式は、バックエンドデータソースのデータソースクエリのみをサポートします。データは一般に、時系列データにラベル付けされているものと見なされます。将来的には、式がエラーをより適切に処理できるように、クエリの戻り値の型 (数値または時系列) データのアサーションを追加する予定でした。

データソースクエリは、式とともに使用されると、式エンジンによって実行されます。これを行うと、データはデータフレームごとに 1 つの時系列または 1 つの数値に再構成されます。例えば、テーブルビューの 1 つのフレームで複数の系列を返すデータソースを使用する場合、式で実行したときに異なるように見えることがあります。

現在、データフレームを使用する場合にサポートされる時系列以外の形式 (数値) は、時間、文字列の列、1 つの数値列のないデータフレームを返すテーブルレスポンスのみです。


| Loc | ホスト | Avg\$1CPU | 
| --- | --- | --- | 
|  MIA  |  A  |  1  | 
|  NYC  |  B  |  2  | 

上記の例では、式で動作する数値を生成します。文字列の列はラベルになり、数値列は対応する値になります。例えば、`{"Loc": "MIA", "Host": "A"}` の値は 1 です。

**オペレーション**

式には math、reduce、リサンプリング演算を使用できます。

**数値演算**

Math は、時系列または数値データに関する自由形式の数式です。Math 演算子では、数値と時系列を入力として受け取り、異なる数値と時系列に変更します。

他のクエリまたは式からのデータは、`$A` などのドル記号のプレフィックスが付いた RefID で参照されます。変数の名前にスペースがある場合は、`${my variable}` のような中括弧構文を使用できます。

数値定数は、10 進数 (`2.24`)、8 進数 (`072` のような先頭がゼロ)、または 16 進数 (`0x2A` のような先頭が 0x) にすることができます。指数と記号もサポートされています (例: `-0.8e-2`)。

**演算子**

算術演算子 (`+`、二項および単項 `-`、`*`、`/`、`%`、指数 `**`)、リレーショナル演算子 (`<`、`>`、`==`、`!=`、`>=`、`<=`)、論理演算子 (`&&`、`||`、および単項 `!`) がサポートされています。

データに対する演算処理は、数値データか時系列データかによって異なります。

`$A + $B` や `$A || $B` などの二項演算では、データのタイプに応じて、演算子は次の方法で適用されます。
+ `$A` と `$B` の両方が数値の場合、2 つの数値の間で演算が実行されます。
+ 1 つの変数が数値で、もう 1 つの変数が時系列の場合、時系列の各ポイントの値と数値との間の演算が実行されます。
+ `$A` と `$B` の両方が時系列データである場合、2 つの系列の各値間の演算は、`$A` と `$B` の両方に存在するタイムスタンプごとに実行されます。`Resample` 演算を使用してタイムスタンプを並べることができます。

まとめ
+ 数値 OP 数値 = 数値
+ 数値 OP 系列 = 系列
+ 系列 OP 系列 = 系列

式は 1 つの変数で表される複数の系列または数値で動作するため、二項演算は 2 つの変数間の統合 (結合) も実行します。これは、個々の系列または数値に関連付けられた識別ラベルに基づいて行われます。

したがって、`$A` にある `{host=web01}` のようなラベルを持つ数値と、同じラベルを持つ `$B` に別の数値がある場合、各変数内のこれら 2 つの項目間で演算が実行され、結果は同じラベルを共有します。この統合の動作のルールは次のとおりです。
+ ラベルのない項目は、すべてに結合されます。
+ `$A` と `$B` の両方に 1 つの項目 (1 つの系列、または 1 つの数値) しか含まれていない場合、それらは結合されます。
+ ラベルが正確な数値演算である場合、それらは結合されます。
+ ラベルが他のサブセットである場合、例えば、`$A` の項目には `{host=A,dc=MIA}` ラベルが付けられ、`$B` の項目には `{host=A}` ラベルが付けられると結合されます。
+ 項目ごとに異なるタグキーがある `$A` などの変数内では、結合動作は不定です。

リレーショナル演算子と論理演算子は、偽の場合は 0、真の場合は 1 を返します。

**数値演算関数**

ほとんどの関数は独自の式の演算にありますが、数値演算関数には、数学演算子や数学記号に似た関数がいくつかあります。関数が数値または系列のいずれかを取ることができる場合、引数と同じタイプが返されます。系列の場合、系列内の各ポイントの値に対して演算が実行されます。

*abs*

abs は、引数の絶対値を返します。これは、数値または系列です。例えば、`abs(-1)`、`abs($A)` などです。

*is\$1inf*

is\$1inf は数値または系列を取得し、`Inf` 値 (負または正) の `1` と他の値の `0` を返します。例えば、`is_inf($A)` などです。

**注記**  
例えば、負の無限大を具体的にチェックする必要がある場合は、`$A == infn()` のような比較を行うことができます。

*is\$1nan*

is\$1nan は数値または系列を取得し、`NaN` 値の `1` と他の値の `0` を返します。例えば、`is_nan($A)` などです。この関数は、`NaN` が `NaN` と等しくないために存在します。

*[is\$1null]*

is\$1null は数値または系列を取得し、`null` 値の `1` と他の値の `0` を返します。例えば、`is_null($A)` などです。

*is\$1number*

is\$1number は数値または系列を取得し、すべての実数値の `1` と他の値 (`null`、`Inf+`、`Inf-`、および `NaN`) の `0` を返します。例えば、`is_number($A)` などです。

*log*

Log は、引数の自然対数を返します。これは、数値または系列です。値が 0 未満の場合、`NaN` が返されます。例えば、`log(-1)`、`log($A)` などです。

*[inf、infn、nan、null]*

inf、infn、nan、null 関数はすべて、名前の単一の値を返します。これらは主にテスト用です。例えば、`null()` などです。

*round*

Round は、丸められた整数値を返します。例えば、`round(3.123)`、`round($A)` です。

*ceil*

Ceil は、数値を最も近い整数値に切り上げます。例えば、`ceil(3.123)` は `4` を返します。

*floor*

Floor は、数値を最も近い整数値に切り下げます。例えば、`floor(3.123` は `3` を返します。

**[削減]**

Reduce は、クエリまたは式から返される 1 つ以上の時系列を取得し、各系列を 1 つの数値に変換します。時系列のラベルは、それぞれ出力される削減された数値のラベルとして保持されます。

*[フィールド]*
+ **[関数]** – 使用する削減関数
+ **[入力]** – リサンプリングする変数 (refID (`A` など))
+ **[モード]** – 系列に数値以外の値が含まれている場合、削減関数の制御動作を許可します (null、NaN 、\$1-Inf)

**削減関数**

*Count*

Count は、各系列内のポイント数を返します。

*Mean*

Mean は、各系列のすべての値の合計を、その系列のポイント数で割った値を返します。`strict` モードでは、系列内の値が null または nan の場合、または系列が空の場合、NaN が返されます。

*[最小 と 最大]*

最小 と 最大は、系列内の最小値または最大値をそれぞれ返します。`strict` モードでは、系列内の値が null または nan の場合、または系列が空の場合、NaN が返されます。

*Sum*

Sum は、系列のすべての値の合計を返します。系列の長さがゼロの場合、合計は 0 になります。`strict` モードでは、系列内の値に NaN または Null がある場合、NaN が返されます。

*Last*

Last は、系列内の最後の数値を返します。系列に値がない場合は、NaN を返します。

**制限モード**

*Strict*

Strict モードでは、入力系列はそのまま処理されます。系列内の値が数値以外の場合 (null、NaN、または \$1-Inf)、NaN が返されます。

*Drop Non-Numeric*

このモードでは、入力系列内のすべての非数値 (null、NaN、または \$1-Inf) は、制限関数を実行する前に除外されます。

*Replace Non-Numeric*

このモードでは、数値以外の値はすべて事前定義された値に置き換えられます。

**[リサンプリング]**

リサンプリングでは、各時系列のタイムスタンプが一貫した時間間隔になるように変更されます。主なユースケースは、同じタイムスタンプを共有しない時系列をリサンプリングして、それらの間で演算を実行できるようにすることです。これは、2 つの系列をそれぞれリサンプリングし、リサンプリングされた変数を参照する Math 演算で行うことができます。

*[フィールド]*
+ **[入力]** – リサンプリングする時系列データの変数 (refID (`A` など))
+ **[リサンプリング先]** – リサンプリング先となる期間は、例えば、`10s.` 単位は `s` 秒、`m` 分、`h` 時間、`d` 日、`w` 週、`y` 年です。
+ **[ダウンサンプリング]** – ウィンドウサンプルごとに複数のデータポイントがある場合に使用する制限関数。動作の詳細については、「制限関数」を参照してください。
+ **[アップサンプリング]** – データポイントがないウィンドウサンプルを埋めるために使用するメソッド。
  + **pad** で最後の既知の値に置換
  + **backfill** で次の既知の値に置換
  + **fillna** で空のサンプルウィンドウを NaN に置換

## 式の書き込み
<a name="v9-panels-query-write"></a>

データソースがサポートしている場合、Grafana は **[式]** ボタンを表示し、クエリエディタリストに既存の式を表示します。

**式を記述するには**

1. パネルを開きます。

1. クエリの下で、**[式]** を選択します。

1. **[演算]** フィールドで、書き込む式のタイプを選択します。

1. 式を書き込みます。

1. **[適用]** を選択します。

## 特殊なケース
<a name="v9-panels-query-special"></a>

クエリされたデータソースが系列や数値を返さない場合、式エンジンは `NoData` を返します。例えば、式によってマージされた 2 つのデータソースクエリがリクエストに含まれている場合、`NoData` が少なくとも 1 つのデータソースクエリによって返された場合、クエリ全体で返される結果は `NoData` になります。Grafana アラートが `NoData` 結果を処理する方法の詳細については、「[データがない場合やエラーが発生した場合の対処](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error)」を参照してください。

# 別のパネルとクエリ結果を共有する
<a name="v9-panels-query-share"></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 は 1 つのクエリを送信し、他のパネルはクエリ結果を使用して視覚化を構築します。

この戦略は、例えば、同じデータを視覚化する複数のパネルがある場合に実行されるクエリの数を大幅に減らすことができます。

**クエリ結果を共有するには**

1. [ダッシュボードを作成](v9-dash-creating.md)します。

1. タイトルを「`Source panel`」に変更します。このパネルを他のパネルのソースとして使用します。

1. 共有するクエリを (複数) 定義します。

   利用可能なデータソースがない場合は、**[TestData]** データソースを使用します。このデータソースは、テストに使用できるランダムな時系列を返します。

1. 2 番目のパネルを追加し、クエリエディタで **[ダッシュボード]** データソースを選択します。

1. **[パネルリストから結果を使用する]** で、最初に作成したパネルを選択します。

ソースパネルで定義されたすべてのクエリが新しいパネルで使用できるようになりました。ソースパネルで行われたクエリは、複数のパネルと共有できます。

任意のクエリをクリックして、そのクエリが定義されたパネルに移動できます。

# [データを変換する]
<a name="v9-panels-xform"></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-panels-xform-types"></a>

Grafana には、データを変換するさまざまな方法があります。変換関数の完全なリストを以下に示します。

## 変換の順序
<a name="v9-panels-xform-order"></a>

複数の変換がある場合、Grafana はリスト順で変換を適用します。各変換では、処理中のパイプラインにある次の変換に渡される新しい結果セットが作成されます。

Grafana が変換を適用する順序は、結果に直接影響します。例えば、縮小変換を使用して 1 つの列のすべての結果を 1 つの値に集約する場合、変換はその 1 つの値にのみ適用できます。

## 変換関数をデータに追加する
<a name="v9-panels-xform-add"></a>

次の手順は、データに変換を追加する方法を示しています。

**パネルに変換を追加するには**

1. 1 つ以上の変換を追加するパネルに移動します。

1. パネルタイトルを選択し、**[編集]** をクリックします。

1. **[変換]** タブを選択します。

1. 変換を選択します。変換オプションを設定する変換行が表示されます。

1. **[変換ルールの追加]** を選択すると、別の変換ルールを追加できます。この変換は、前の変換が返した結果セットに作用します。

## 変換をデバッグする
<a name="v9-panels-xform-debug"></a>

変換の入力および出力結果のセットを表示するには、変換行の右側にあるバグアイコンを選択します。

入出力の結果セットにより、変換のデバッグが可能になります。

## 変換を削除する
<a name="v9-panels-xform-delete"></a>

不要な変換を削除することをお勧めします。変換を削除すると、視覚化からデータが削除されます。

前提条件:

変換に依存するすべてのダッシュボードを特定し、影響を受けるダッシュボードのユーザーに通知します。

**変換を削除するには**

1. パネルを開いて編集します。

1. **[変換]** タブを選択します。

1. 削除する変換の横にあるごみ箱アイコンを選択します。

## 変換関数
<a name="v9-panels-xform-functions"></a>

データに関する次の変換を実行できます。

**計算からのフィールドの追加**

この変換を使用して、他の 2 つのフィールドから計算した新しいフィールドを追加します。各変換では 1 つの新しいフィールドを追加できます。
+ **[モード]** – 以下のモードを選択します。
  + **[行を減らす]** – 選択したフィールドの各行に、選択済みの計算を個別に適用します。
  + **[二項演算]** – 選択した 2 つのフィールドから 1 行の値に基本的な二項演算 (合計や乗算など) を適用します。
+ **[Field name]** – 新しいフィールドの計算に使用する、フィールドの名前を選択します。
+ **[計算]** – **[掃き出し法]** を選択すると、**[計算]** フィールドが表示されます。フィールドをクリックして、新しいフィールドの作成に使用できる計算選択肢のリストを表示します。使用可能な計算の詳細については、「[計算タイプ](v9-panels-calculation-types.md)」を参照してください。
+ **[演算]** – **[二項演算]** モードを選択すると、**[演算]** フィールドが表示されます。これらのフィールドを使用すると、2 つの選択したフィールドから 1 行の値に対して基本的な数学演算を実行できます。二項演算に数値を使用することもできます。
+ **[エイリアス]** – (オプション) 新しいフィールドの名前を入力します。このフィールドを空白のままにすると、計算に一致するようにフィールドの名前が付けられます。
+ **[すべてのフィールドを置き換え]** – (オプション) 他のすべてのフィールドを非表示にし、計算したフィールドのみを視覚化に表示する場合は、このオプションを選択します。

**[連結フィールド]**

この変換は、全フレームの全フィールドを 1 つの結果に結合します。この 2 つのクエリを検討します。

クエリ A


| 温度 | アップタイム | 
| --- | --- | 
|  15.4  |  1230233  | 

クエリ B


| AQI | エラー | 
| --- | --- | 
|  3.2  |  5  | 

フィールドを連結すると、データフレームは次のようになります。


| 温度 | アップタイム | AQI | エラー | 
| --- | --- | --- | --- | 
|  15.4  |  1230233  |  3.2  |  5  | 

**[クエリ結果から設定]**

この変換を使用して、1 つのクエリを選択し、そこから **[最小]** 、**[最大]** 、**[単位]**、**[しきい値]** などの標準オプションを抽出し、他のクエリ結果に適用できます。これにより、動的なクエリ駆動型の視覚化設定が可能になります。

設定クエリ結果の各行に対して一意の設定を抽出する場合は、行からフィールドへの変換を試行します。

**オプション**
+ **[Config query]** (設定クエリ) – 設定として使用するデータを返すクエリを選択します。
+ **[適用先]** – 設定を適用するフィールドまたは系列を選択します。
+ **[オプションに適用]** – 通常は、**[適用先]** で選択したオプションに応じて、フィールドタイプまたはフィールド名の正規表現を使用します。

**[フィールドタイプの変換]**

この変換により、指定されたフィールドのフィールドタイプが変更されます。
+ **[Field]** – 使用可能なフィールドから選択
+ **[as]** – 変換するフィールドタイプを選択
  + **[Numeric]** – 値の数値の作成を試行
  + **[String]** – 値の文字列を作成
  + **[時間]** – 値を時間として解析
    + yyyy-mm-dd や DD MM YYYY hh:mm:ss などの文字列の入力として DateFormat を指定するオプションを表示
  + **[Boolean]** – 値はブール値となる

例えば、次のクエリでは、時間フィールドを Time として、日付形式を YYYY として選択することで変更できます。


| Time | Mark | 値 | 
| --- | --- | --- | 
|  7/1/2017  |  above  |  25  | 
|  8/2/2018  |  below  |  22  | 
|  9/2/2019  |  below  |  29  | 
|  10/4/2020  |  above  |  22  | 

結果


| Time | Mark | 値 | 
| --- | --- | --- | 
|  1/1/2017  |  above  |  25  | 
|  1/1/2018  |  below  |  22  | 
|  1/1/2019  |  below  |  29  | 
|  1/1/2020  |  above  |  22  | 

**[名前によるデータのフィルタリング]**

この変換を使用してクエリ結果の一部を削除します。

Grafana は **[Identifier]** (識別子) フィールドを表示し、続いてクエリによって返されるフィールドを表示します。

フィルターは次の 2 つのいずれかの方法で適用できます。
+ 正規表現を入力します。
+ フィールドを選択してフィールドのフィルタリングを切り替えます。フィルタリングされたフィールドにはダークグレーテキストが表示され、フィルタリングされていないフィールドには白いテキストが表示されます。

**[クエリによるデータのフィルタリング]**

1 つ以上のクエリを非表示にするには、複数のクエリがあるパネルでこの変換を使用します。

Grafana では、クエリ識別文字がダークグレーテキストで表示されます。フィルタリングを切り替えるには、クエリ識別子をクリックします。クエリ文字が白い場合、結果が表示されます。クエリ文字が暗い場合、結果は非表示です。

**注記**  
この変換は Graphite では使用できません。このデータソースは、返されたデータとクエリの相関関係をサポートしていないためです。

**[値によるデータのフィルタリング]**

この変換により、Grafana でデータを直接フィルタリングして、クエリ結果から一部のデータポイントを削除できます。1 つ以上の定義済み条件と一致するデータを含めるか除外するかを選択できます。その条件は選択したフィールドに適用されます。

この変換はデータソースが値によりネイティブにフィルタリングしない場合に役立ちます。共有クエリを使用している場合、これを使用して値を絞り込んで表示することもできます。

すべてのフィールドで使用できる条件は次のとおりです。
+ **[Regex]** – 正規表現を照合
+ **[Is Null]** – 値が null の場合に照合
+ **[Is Not Null]** – 値が null でない場合に照合します。
+ **Equal** – 値が指定値と等しい場合に照合
+ **Different** – 値が指定された値と異なる場合に照合

数値フィールドで使用可能な条件は以下のとおりです。
+ **Greater** – 値が指定値より大きい場合に照合
+ **Lower** – 値が指定値よりも小さい場合に照合
+ **Greater or equal** – 値が指定値以上の場合に照合
+ **Lower or equal** – 値が指定値以下の場合に照合
+ **Range** – 指定された最小値と最大値 (最小値と最大値を含む) 間の範囲を照合します。

以下のデータセットを考慮します。


| Time | 温度 | 高度 | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 23 秒  |  32  |  101  | 
|  7/7/2020 午前 11 時 34 分 22 秒  |  28  |  125  | 
|  7/7/2020 午前 11 時 34 分 21 秒  |  26  |  110  | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  23  |  98  | 
|  7/7/2020 午前 10 時 32 分 24 秒  |  31  |  95  | 
|  7/7/2020 午前 10 時 31 分 22 秒  |  20  |  85  | 
|  7/7/2020 午前 9 時 30 分 57 秒  |  19  |  101  | 

温度が 30°C 未満のデータポイントを **[含める]** にすると、設定は次のようになります。
+ **フィルタータイプ** – `Include`
+ **[条件]** – `Temperature` が `Lower Than 30` と一致する行

30°C 未満の温度のみが含まれる場合、次の結果が得られます。


| Time | 温度 | 高度 | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 22 秒  |  28  |  125  | 
|  7/7/2020 午前 11 時 34 分 21 秒  |  26  |  110  | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  23  |  98  | 
|  7/7/2020 午前 10 時 31 分 22 秒  |  20  |  85  | 
|  7/7/2020 午前 9 時 30 分 57 秒  |  19  |  101  | 

複数の条件をフィルターに追加できます。例えば、高度が 100 を超える場合にのみデータを含めることができます。これを行うには、次の設定にその条件を追加します。
+ フィルタータイプ – `Match All` 条件を満たす `Include` 行
+ Condition 1 – `Temperature` が `30` より `Lower` に一致する行
+ Condition 2 – `Altitude` が `Greater` より `100` に一致する行

複数の条件がある場合、条件に**すべて一致**、または追加した条件の**いずれかに一致**する行にアクション (包含/除外) を適用するかを選択できます。

上記の例では、温度が 30°C 未満かつ高度が 100 を超える行を含めるため、**[すべて一致]** を選択しました。温度が 30°C 未満または高度が 100 を超える行を含める場合は、**[任意の一致]** を選択します。これには、元のデータの最初の行が含まれます。元のデータの温度は 32°C (最初の条件と一致しない) ですが、高度は 101 (2 番目の条件と一致する) であるため、含まれます。

無効または不完全な設定条件は無視されます。

**[グループ化の条件]**

この変換では、指定されたフィールド (列) 値でデータをグループ化し、各グループの計算を処理します。計算選択肢のリストの表示をクリックします。

オリジナルデータの例を次に示します。


| Time | サーバー ID | CPU 温度 | サーバーステータス | 
| --- | --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー 1  |  80  |  シャットダウン  | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー 3  |  62  |  OK  | 
|  7/7/2020 午前 10 時 32 分 20 秒  |  サーバー 2  |  90  |  オーバーロード  | 
|  7/7/2020 午前 10 時 31 分 22 秒  |  サーバー 3  |  55  |  OK  | 
|  7/7/2020 午前 9 時 30 分 57 秒  |  サーバー 3  |  62  |  再起動  | 
|  7/7/2020 午前 9 時 30 分 5 秒  |  サーバー 2  |  88  |  OK  | 
|  7/7/2020 午前 9 時 28 分 6 秒  |  サーバー 1  |  80  |  OK  | 
|  7/7/2020 午前 9 時 25 分 5 秒  |  サーバー 2  |  88  |  OK  | 
|  7/7/2020 午前 9:23:07  |  サーバー 1  |  86  |  OK  | 

この変換では 2 つのステップを実行します。まず、データをグループ化させる 1 つ以上のフィールドを指定します。これにより、これらのフィールドの同じ値すべてが、ソートされたかのようにグループ化されます。例えば、サーバー ID フィールドでグループ化すると、次のようにデータがグループ化されます。


| Time | サーバー ID | CPU 温度 | サーバーステータス | 
| --- | --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー 1  |  80  |  シャットダウン  | 
|  7/7/2020 午前 9 時 28 分 6 秒  |  サーバー 1  |  80  |  OK  | 
|  7/7/2020 午前 9:23:07  |  サーバー 1  |  86  |  OK  | 
|  7/7/2020 午前 10 時 32 分 20 秒  |  サーバー 2  |  90  |  オーバーロード  | 
|  7/7/2020 午前 9 時 30 分 5 秒  |  サーバー 2  |  88  |  OK  | 
|  7/7/2020 午前 9 時 25 分 5 秒  |  サーバー 2  |  88  |  OK  | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー 3  |  62  |  OK  | 
|  7/7/2020 午前 10 時 31 分 22 秒  |  サーバー 3  |  55  |  OK  | 
|  7/7/2020 午前 9 時 30 分 57 秒  |  サーバー 3  |  62  |  再起動  | 

同じ値のサーバー ID を持つすべての行がグループ化されます。

データをグループ化するフィールドを選択すると、他のフィールドにさまざまな計算を追加でき、その計算を行の各グループに適用できます。例えば、これらの各サーバーの平均 CPU 温度を計算できます。そのため、CPU 温度フィールドに適用される*[平均]*計算を追加して、以下を取得できます。


| サーバー ID | CPU 温度 (平均) | 
| --- | --- | 
|  サーバー 1  |  82  | 
|  サーバー 2  |  88.6  | 
|  サーバー 3  |  59.6  | 

また、複数の計算を追加できます。例:
+ 時間のフィールドでは、*[最後]*の値を計算して、各サーバーで最後のデータポイントがいつ受信されたかを把握できます。
+ サーバーステータスフィールドでは、*[最後]*の値を計算して、サーバーごとに最後の状態値を確認できます。
+ また、温度フィールドでは、*最後*の値を計算して、サーバーごとに最新の測定温度を知ることもできます。

その後、以下を取得します。


| サーバー ID | CPU 温度 (平均) | CPU 温度 (最新) | 時間 (最後) | サーバーステータス (最後) | 
| --- | --- | --- | --- | --- | 
|  サーバー 1  |  82  |  80  |  7/7/2020 午前 11 時 34 分 20 秒  |  シャットダウン  | 
|  サーバー 2  |  88.6  |  90  |  7/7/2020 午前 10 時 32 分 20 秒  |  オーバーロード  | 
|  サーバー 3  |  59.6  |  62  |  7/7/2020 午前 11 時 34 分 20 秒  |  OK  | 

この変換により、時系列からキー情報を抽出して便利な方法で表示できます。

**Join by field** (フィールドで結合)

この変換を使用して、複数の結果を 1 つのテーブルに結合します。これは、複数の時系列の結果を共有時間フィールドを持つ単一のワイドテーブルに変換する場合に特に便利です。

*Inner join* (内部結合)

内部結合は、選択したフィールドからすべてのテーブルが同じ値を共有する複数のテーブルからのデータをマージします。このタイプの結合では、すべての結果で値が一致しないデータを除外します。

この変換を使用して、複数のクエリの結果 (渡された結合フィールドまたは最初の列の組み合わせ) を 1 つの結果に結合し、正常な結合を実行できない行を削除します。

次の例では、2 つのクエリがテーブルデータを返します。内部結合変換を適用する前に、2 つの個別のテーブルとして視覚化されます。

クエリ A


| Time | ジョブ | アップタイム | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  ノード  |  25260122  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  postgre  |  123001233  | 
|  7/7/2020 午前 11 時 14 分 20 秒  |  postgre  |  345001233  | 

クエリ B


| Time | サーバー | エラー | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー 1  |  15  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  サーバー 2  |  5  | 
|  7/7/2020 午前 11 時 4 分 20 秒  |  サーバー 3  |  10  | 

内部結合変換を適用した後の結果は次のようになります。


| Time | ジョブ | アップタイム | サーバー | エラー | 
| --- | --- | --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  ノード  |  25260122  |  サーバー 1  |  15  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  postgre  |  123001233  |  サーバー 2  |  5  | 

*Outer join* (外部結合)

外部結合には、すべての入力で値が一致しない内部結合と行のすべてのデータが含まれます。内部結合が時間フィールドでクエリ A とクエリ B を結合している間、外部結合には時間フィールドで一致しないすべての行が含まれます。

次の例では、2 つのクエリがテーブルデータを返します。外部結合変換を適用する前に、2 つのテーブルとして視覚化されます。

クエリ A


| Time | ジョブ | アップタイム | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  ノード  |  25260122  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  postgre  |  123001233  | 
|  7/7/2020 午前 11 時 14 分 20 秒  |  postgre  |  345001233  | 

クエリ B


| Time | サーバー | エラー | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー 1  |  15  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  サーバー 2  |  5  | 
|  7/7/2020 午前 11 時 4 分 20 秒  |  サーバー 3  |  10  | 

外部結合変換を適用した後の結果は次のようになります。


| Time | ジョブ | アップタイム | サーバー | エラー | 
| --- | --- | --- | --- | --- | 
|  7/7/2020 午前 11 時 4 分 20 秒  |    |    |  サーバー 3  |  10  | 
|  7/7/2020 午前 11 時 14 分 20 秒  |  postgre  |  345001233  |    |    | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  ノード  |  25260122  |  サーバー 1  |  15  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  postgre  |  123001233  |  サーバー 2  |  5  | 

**[フィールドへのラベル付け]**

この変換により、ラベルまたはタグを含む時系列の結果がテーブルに変更され、各ラベルキーと値がテーブルの結果に含まれます。ラベルは、列または行の値として表示できます。

2 つの時系列のクエリ結果を示します。
+ 系列 1 – ラベル サーバー = サーバー A、データセンター = EU
+ 系列 2 – ラベル サーバー = サーバー B、データセンター = EU

**[列]** モードでは、結果は次のように表示されます。


| Time | サーバー | データセンター | 値 | 
| --- | --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー A  |  EU  |  1  | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー B  |  EU  |  2  | 

[Rows] (行) モードでは、結果には各系列のテーブルがあり、次のような各ラベル値が表示されます。


| ラベル | 値 | 
| --- | --- | 
|  サーバー  |  サーバー A  | 
|  データセンター  |  EU  | 


| ラベル | 値 | 
| --- | --- | 
|  サーバー  |  サーバー B  | 
|  データセンター  |  EU  | 

*値フィールド名*

**値フィールド名**としてサーバーを選択した場合、サーバーラベルの値ごとに 1 つのフィールドを取得します。


| Time | データセンター | サーバー A | サーバー B | 
| --- | --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  EU  |  1  |  2  | 

*マージ動作*

フィールドトランスフォーマーへのラベルは、内蔵されている 2 つの異なる変換です。1 つ目は、1 つの系列で動作し、ラベルをフィールドに抽出します。2 つ目は、すべての結果を 1 つのテーブルに結合するマージ変換です。マージ変換は、一致するすべてのフィールドで結合を試みます。このマージステップは必須であり、オフにすることはできません。

**注記**  
*[マージ]*変換は単独で使用でき、以下で詳細に説明します。

これを説明するために、重複ラベルのない時系列を返すクエリが 2 つある例を次に示します。
+ 系列 1 – ラベル サーバー = サーバー A
+ 系列 2 – ラベル データセンター = EU

これにより、まず次の 2 つのテーブルが作成されます。


| Time | サーバー | 値 | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー A  |  10  | 


| Time | データセンター | 値 | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  EU  |  20  | 

マージ後


| Time | サーバー | 値 | データセンター | 
| --- | --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  サーバー A  |  10  |    | 
|  7/7/2020 午前 11 時 34 分 20 秒  |    |  20  |  EU  | 

**Merge** (マージ)

この変換を使用して、複数クエリの結果を 1 つの結果にまとめます。これはテーブルパネルの視覚化を使用する場合に役立ちます。マージできる値は同じ行に結合されます。共有フィールドに同じデータが含まれている場合は値をマージできます。

次の例では、テーブルデータを返すクエリが 2 つあります。変換を適用する前に、2 つの個別のテーブルとして視覚化されます。

クエリ A


| Time | ジョブ | アップタイム | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  ノード  |  25260122  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  postgre  |  123001233  | 

クエリ B


| Time | ジョブ | エラー | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  ノード  |  15  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  postgre  |  5  | 

マージ変換を適用した後の結果は次のとおりです。


| Time | ジョブ | エラー | アップタイム | 
| --- | --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  ノード  |  15  |  25260122  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  postgre  |  5  |  123001233  | 

**[フィールドの整理]**

この変換を使用して、クエリが返すフィールドの名前を変更、並べ替え、非表示にします。

**注記**  
この変換は単一クエリを持つパネルでのみ機能します。パネルに複数のクエリがある場合は、外部結合変換を適用するか、追加のクエリを削除する必要があります。

Grafana では、クエリが返すフィールドのリストが表示されます。以下の操作を実行できます。
+ フィールドの上にカーソルを置いて、フィールドの順序を変更します。カーソルが手の形になると、フィールドを新しい場所にドラッグできます。
+ フィールド名の隣の目アイコンをクリックして、フィールドを非表示または表示します。
+ 名前変更ボックスに新しい名前を入力して、フィールドの名前を変更します。

**[値による分割]**

この変換により、複数の系列をグラフ化する際に、異なる `WHERE` 句を持つ同じデータソースへの複数のクエリが不要になります。次のデータを含むメトリクス SQL テーブルを検討します。


| Time | リージョン | 値 | 
| --- | --- | --- | 
|  10/20/2022 12:00:00 PM  |  米国  |  1520  | 
|  10/20/2022 12:00:00 PM  |  EU  |  2936  | 
|  10/20/2022 午前 1 時 00 分  |  米国  |  1327  | 
|  10/20/2022 午前 1 時 00 分  |  EU  |  912  | 

v9.3 より前では、US の赤いトレンドラインと EU の青いトレンドラインを同じ時系列パネルにプロットする場合は、これを 2 つのクエリに分割する必要があります。

```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```

また、メトリクステーブルに実際に存在するリージョンを事前に知る必要があります。

*[値による分割]*トランスフォーマーを使用すると、単一のクエリを発行し、選択した 1 つ以上の列 (`fields`) に対して一意の値で結果を分割できるようになりました。次の例では `Region` を使用しています。

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| Time | リージョン | 値 | 
| --- | --- | --- | 
|  10/20/2022 12:00:00 PM  |  米国  |  1520  | 
|  10/20/2022 午前 1 時 00 分  |  米国  |  1327  | 


| Time | リージョン | 値 | 
| --- | --- | --- | 
|  10/20/2022 12:00:00 PM  |  EU  |  2936  | 
|  10/20/2022 午前 1 時 00 分  |  EU  |  912  | 

**[削減]**

*[削減]* 変換は、フレーム内の各フィールドに計算を適用し、単一の値を返します。この変換を適用すると、時間フィールドは削除されます。

以下の入力を検討します。

クエリ A


| Time | Temp | アップタイム | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  12.3  |  256122  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  15.4  |  1230233  | 

クエリ B


| Time | AQI | エラー | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  6.5  |  15  | 
|  7/7/2020 午前 11 時 24 分 20 秒  |  3.2  |  5  | 

縮小のトランスフォーマーには 2 つのモードがあります。
+ **[シリーズから行]** – 各フィールドの行と各計算の列を作成します。
+ **[縮小フィールド]** – 既存のフレーム構造を維持しますが、各フィールドを 1 つの値に折りたたみます。

例えば、系列で **[最初]** と **[最後]** の計算を使用して **[シリーズから行]** 変換を行った場合、結果は次のようになります。


| フィールド | First | Last | 
| --- | --- | --- | 
|  Temp  |  12.3  |  15.4  | 
|  アップタイム  |  256122  |  1230233  | 
|  AQI  |  6.5  |  3.2  | 
|  エラー  |  15  |  5  | 

最後の計算における縮小フィールドは、それぞれ 1 行、2 つのフレームになります。

クエリ A


| 温度 | アップタイム | 
| --- | --- | 
|  15.4  |  1230233  | 

クエリ B


| AQI | エラー | 
| --- | --- | 
|  3.2  |  5  | 

**[正規表現で名前を変更]**

この変換を使用して、正規表現と置換パターンを使用してクエリ結果の一部の名前を変更します。

正規表現を指定できます。正規表現は、バックリファレンスをサポートする置換パターンとともに、一致にのみ適用されます。例えば、ホストあたりの CPU 使用率を視覚化し、ドメイン名を削除するとします。正規表現を `([^\.]+)\..+` に設定し、置換パターンを `$1` に設定することで、`web-01.example.com` は `web-01` になります。

**Rows to fields** (行からフィールドへ)

行からフィールドへの変換は、行を別々のフィールドに変換します。これは、フィールドを個別にスタイル変更および設定できるため便利です。また、動的フィールド設定のソースとして追加のフィールドを使用したり、フィールドラベルにマッピングしたりすることもできます。その後、追加のラベルを使用して、結果フィールドにより適切な表示名を定義できます。

この変換には、設定クエリによって返されるデータ内のすべてのフィールドを一覧表示するフィールドテーブルが含まれます。このテーブルでは、各設定プロパティにマッピングするフィールドを制御できます ([Use as] (用途) オプション)。返されるデータに複数の行がある場合、選択する値を選ぶこともできます。

この変換には以下が必要です。
+ フィールド名のソースとして使用する 1 つのフィールド。

  デフォルトでは、変換は最初の文字列フィールドをソースとして使用します。このデフォルト設定は、代わりに使用するフィールドの **[用途]** 列で **[フィールド名]** を選択してオーバーライドできます。
+ 値のソースとして使用する 1 つのフィールド。

  デフォルトでは、変換は最初の数値フィールドをソースとして使用します。ただし、このデフォルト設定は、代わりに使用するフィールドの **[用途]** 列で **[フィールド値]** を選択してオーバーライドできます。

以下にデータを視覚化する場合に役立ちます。
+ ゲージ
+ 統計
+ 円グラフ

*追加フィールドをラベルにマッピング*

フィールドが設定プロパティにマッピングされない場合、Grafana は出力フィールドのラベルのソースとして自動的に使用します。

例:


| 名前 | データセンター | 値 | 
| --- | --- | --- | 
|  サーバー A  |  米国  |  100  | 
|  サーバー B  |  EU  |  200  | 

出力:


| サーバー A (ラベル: データセンター: US) | サーバー B (ラベル: データセンター: EU) | 
| --- | --- | 
|  10  |  20  | 

フィールド表示名で追加のラベルを使用して、より完全なフィールド名を提供できるようになりました。

あるクエリから設定を抽出して別のクエリに適用する場合は、[クエリ結果から設定] 変換を使用する必要があります。

*例*

入力


| 名前 | 値 | 最大 | 
| --- | --- | --- | 
|  サーバー A  |  10  |  100  | 
|  サーバー B  |  20  |  200  | 
|  サーバー C  |  30  |  300  | 

出力


| サーバー A (設定: 最大=100) | サーバー B (設定: 最大=200) | サーバー C (設定: 最大=300) | 
| --- | --- | --- | 
|  10  |  20  |  30  | 

ソースデータ内の各行が個別のフィールドになります。各フィールドには、最大設定オプションも設定されるようになりました。最小値、最大値、単位、しきい値などのオプションはすべてフィールド設定の一部であり、このような設定を行うと、パネルエディタのオプションペインで手動設定されるオプションではなく、視覚化によって使用されます。

**[時系列の準備]**

時系列の準備変換は、データソースが、使用するパネルでサポートされていない形式で時系列データを返す場合に役立ちます。

この変換は、時系列データをワイド形式からロング形式、またはその逆に変換することで、この問題を解決するのに役立ちます。

**[マルチフレーム時系列]** オプションを選択して、時系列データフレームをワイド形式からロング形式に変換します。

**[ワイド時系列]** オプションを選択して、時系列データフレームをロング形式からワイド形式に変換します。

**[シリーズから行]**

この変換を使用して、複数の時系列データクエリの結果を 1 つの結果にまとめます。これはテーブルパネルの視覚化を使用する場合に役立ちます。

この変換の結果には、時間、メトリクス、値の 3 つの列が含まれます。メトリクス列が追加されると、メトリクスのソースとなるクエリを簡単に確認できます。ソースクエリのラベルを定義して、この値をカスタマイズします。

次の例では、時系列データを返すクエリが 2 つあります。変換を適用する前に、2 つの個別のテーブルとして視覚化されます。

クエリ A


| Time | 温度 | 
| --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  25  | 
|  7/7/2020 午前 10 時 31 分 22 秒  |  22  | 
|  7/7/2020 午前 9 時 30 分 5 秒  |  19  | 

クエリ B


| Time | 湿度 | 
| --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  24  | 
|  7/7/2020 午前 10 時 32 分 20 秒  |  29  | 
|  7/7/2020 午前 9 時 30 分 57 秒  |  33  | 

シリーズから行 変換を適用した後の結果は次のとおりです。


| Time | メトリクス | 値 | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  温度  |  25  | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  湿度  |  22  | 
|  7/7/2020 午前 10 時 32 分 20 秒  |  湿度  |  29  | 
|  7/7/2020 午前 10 時 31 分 22 秒  |  温度  |  22  | 
|  7/7/2020 午前 9 時 30 分 57 秒  |  湿度  |  33  | 
|  7/7/2020 午前 9 時 30 分 5 秒  |  温度  |  19  | 

**[並べ替え]**

この変換では、設定されたフィールドで各フレームがソートされます。`reverse` にチェックがついている場合、値は逆の順序で返されます。

**[制限]**

この変換を使用して、表示される行数を制限します。

次の例では、データソースから次のレスポンスがあります。


| Time | メトリクス | 値 | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  温度  |  25  | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  湿度  |  22  | 
|  7/7/2020 午前 10 時 32 分 20 秒  |  湿度  |  29  | 
|  7/7/2020 午前 10 時 31 分 22 秒  |  温度  |  22  | 
|  7/7/2020 午前 9 時 30 分 57 秒  |  湿度  |  33  | 
|  7/7/2020 午前 9 時 30 分 5 秒  |  温度  |  19  | 

以下は、値が「3」の制限変換を追加した後の結果です。


| Time | メトリクス | 値 | 
| --- | --- | --- | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  温度  |  25  | 
|  7/7/2020 午前 11 時 34 分 20 秒  |  湿度  |  22  | 
|  7/7/2020 午前 10 時 32 分 20 秒  |  湿度  |  29  | 

# クエリのトラブルシューティング
<a name="v9-panels-query-troubleshoot"></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 のバグや視覚化の問題のように見えても、ほとんどの場合、データソースクエリまたはデータソースレスポンスの問題です。まず、パネルクエリとレスポンスを検査します。

詳細については、「[リクエストとレスポンスデータの検査](v9-panels-panel-inspector.md)」を参照してください。

**クエリが遅い**

クエリが返すデータポイントの数を確認してください。多くのデータポイントを返すクエリは遅くなります。解決策は以下のとおりです。
+ **[クエリオプション]**で、返される**[最大データポイント数]**を制限します。
+ **クエリオプション**で、**最小間隔**時間を長くします。
+ クエリで、`group by` 関数を使用します。

# しきい値を設定する
<a name="v9-panels-configure-thresholds"></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-panels-thresholds-about"></a>

 しきい値は、しきい値に達するか超えたときに、ダッシュボードに視覚的に反映されるメトリクスに対して指定する値です。

 しきい値は、クエリ結果に基づいて視覚化を条件付きでスタイル付けおよび色付けするための 1 つの方法をもたらします。しきい値は、すべてではないのですが、ほとんどの視覚化に適用できます。視覚化の詳細については、「[視覚化パネル](v9-panels.md)」を参照してください。

 しきい値を使用すると、次のことができます。
+  [時系列の視覚化](v9-panels-time-series.md)でグリッド線またはグリッド領域を色付け 
+  [時系列の視覚化](v9-panels-time-series.md)で線を色付け 
+  [統計の視覚化](v9-panels-stat.md)で背景または値のテキストを色付け 
+  [ゲージ視覚化](v9-panels-gauge.md)のゲージマーカーとしきい値マーカーを色分け 
+  [ジオマップ視覚化](v9-panels-geomap.md)でマーカーを色付け 
+  [テーブル視覚化](v9-panels-table.md)でセルテキストまたは背景を色付け 
+  [状態タイムラインの視覚化](v9-panels-state-timeline.md)でリージョンとリージョンの色を定義 

 しきい値には、次の 2 つのタイプがあります。
+  **[絶対値]** しきい値は数値で定義されます。例えば、1～150 のスケールで 80 とします。
+  **[パーセンテージ]** しきい値は、最小値または最大値に対して定義されます。例えば、80% です。

### デフォルトのしきい値
<a name="v9-panels-thresholds-default"></a>

 しきい値をサポートする視覚化において、Grafana はデフォルトのしきい値を次のように設定します。
+  80 = red (80 = 赤) 
+  Base = green (ベース = 緑) 
+  Mode = Absolute (モード = 絶対値) 

 **[Base]** (ベース) 値は、マイナス無限大を表します。一般的に「良い」色です。

## しきい値の追加または削除
<a name="v9-panels-thresholds-add-delete"></a>

 パネルにはお好みの数のしきい値を追加できます。Grafana はしきい値を高い順に自動的にソートします。

 しきい値がビジネスオペレーションに関連しなくなった場合は削除します。しきい値を削除すると、システムはしきい値を含むすべての視覚化からしきい値を削除します。

1.  しきい値を追加するには 

   1.  しきい値を追加するパネルを編集します。

   1.  オプションサイドペインで **[しきい値]** セクションを見つけ、**[しきい値を追加]** をクリックします。

   1.  しきい値の色、数値、モードを選択します。しきい値モードは、このパネルのすべてのしきい値に適用されます。

   1.  時系列パネルで、**[しきい値の表示]** オプションを選択します。

1.  しきい値を削除するには、しきい値を含むパネルに移動し、削除するしきい値の横にあるごみ箱アイコンをクリックします。

## レガシーグラフパネルにしきい値を追加する
<a name="v9-panels-thresholds-legacy-graph"></a>

 グラフパネルの視覚化では、しきい値を使用すると、グラフに線やセクションを追加できるため、グラフがしきい値を超えたタイミングを簡単に認識できます。

1.  しきい値を追加するグラフパネルに移動します。

1.  **[Panel]**タブで、**[しきい値]** をクリックします。

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

1.  以下のフィールドに値を入力します。
   +  **T1** – しきい値を表示するために両方の値が必要です。
     +  **lt** または **gt** – しきい値の適用対象示すため、より小さい場合は **lt**、より大きい場合は **gt** を選択します。
     +  **[値]** – しきい値を入力します。Grafana では、その値で Y 軸に沿ってしきい値線が描画されます。
   +  **Color** – 色に対応する条件を選択、または独自の色を定義します。
     +  **[カスタム]** – 塗りつぶしの色と線の色を定義します。
     +  **[重大]** - 塗りつぶしの色と線の色は赤色です。
     +  **[警告]** – 塗りつぶしの色と線の色は黄色です。
     +  **OK** – 塗りつぶしの色と線の色は緑色です。
   +  **[塗りつぶし]** - しきい値の塗りつぶしを表示するかどうかを制御します。
   +  **[線]** – しきい値の線を表示するかどうかを制御します。
   +  **[Y 軸]** – **左**または**右**を選択します。

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

# データリンクの設定
<a name="v9-panels-configure-data-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)」を参照してください。

 データリンク変数またはデータリンクを使用して、パネル間のリンクを作成できます。

## データリンク変数
<a name="v9-panels-data-link-variables"></a>

 データリンクで変数を使用すると、系列フィールド、ラベル、値を参照できます。データリンクの詳細については、「[データリンク](#v9-panels-data-links)」を参照してください。

 使用可能な変数のリストを表示するには、データリンク **URL** フィールドに「**\$1**」と入力して、使用できる変数のリストを表示します。

**注記**  
 これらの変数はバージョン 6.4 で変更されたため、古いバージョンの Grafana の場合は、バージョンピッカーを使用して古いバージョンの Grafana のドキュメントを選択してください。

 データリンク URL のテンプレート変数も使用できます。「[ダッシュボード変数の追加と管理](v9-dash-variables.md)」を参照してください。

## 時間範囲パネル変数
<a name="v9-panels-time-range-panel-variables"></a>

 これらの変数を使用すると、データリンク URL に現在の時間範囲を含めることができます。
+  **\$1\$1url\$1time\$1range** - 現在のダッシュボードの時間範囲 (つまり**?from=now-6h&to=now**) 
+  **\$1\$1\$1from および \$1\$1\$1to** - 詳細については、「[グローバル変数](v9-dash-variable-add.md#v9-dash-variable-add-global)」を参照してください。

## 系列変数
<a name="v9-panels-series-variables"></a>

 系列固有の変数は、**\$1\$1series** 名前空間で使用できます。
+  **\$1\$1series.name** - URL への系列名 

## フィールド変数
<a name="v9-panels-field-variables"></a>

 フィールド固有の変数は、**\$1\$1field** 名前空間で使用できます。
+  **\$1\$1field.name** - フィールドの名前 
+  **\$1\$1field.labels.<LABEL>** - URL へのラベルの値。ラベルにドットが含まれている場合は、**\$1\$1field.labels["<LABEL>"]** 構文を使用します。

## 値変数
<a name="v9-panels-value-variables"></a>

 値固有の変数は、**\$1\$1value** 名前空間で使用できます。
+  **[\$1\$1value.time** - URL への値のタイムスタンプ (Unix ms エポック) (例: **?time=1560268814105**） 
+  **[\$1\$1value.raw]** - raw 値 
+  **[\$1\$1value.numeric]** - 値の数値表現 
+  **[\$1\$1value.text]** - 値のテキスト表現 
+  **[\$1\$1value.calc** - 値が計算の結果である場合の計算名] 

## テンプレート変数
<a name="v9-panels-template-variables"></a>

 テンプレート変数を使用する別のダッシュボードにリンクするときは、リンクをクリックした人の変数値を選択します。

 **\$1\$1var-myvar:queryparam\$1** - ここで、**var-myvar** は、使用する現在のダッシュボードのテンプレート変数と一致するテンプレート変数の名前です。


|  可変状態  |  作成された URL の結果  | 
| --- | --- | 
|  1 つの値を選択済み  |  var-myvar=value1  | 
|  複数の値を選択済み  |  var-myvar=value1&var-myvar=value2  | 
|  すべて選択済み  |  var-myvar=All  | 

 現在のダッシュボードのすべての変数を URL に追加する場合は、**\$1\$1\$1\$1all\$1variables\$1** を使用します。

## データリンク
<a name="v9-panels-data-links"></a>

 データリンクを使用すると、リンクへのより詳細なコンテキストを提供できます。カーソルの下に系列名または値を含むリンクを作成できます。例えば、視覚化で 4 つのサーバーが表示されていた場合は、そのうちの 1 つまたは 2 つにデータリンクを追加できます。

 リンク自体には、視覚化に応じてさまざまな方法でアクセスできます。グラフでは、データポイントまたは線をクリックする必要があります。統計、ゲージ、棒ゲージなどのパネルでは、視覚化の任意の場所をクリックしてコンテキストメニューを開くことができます。

 データリンクに変数を使用すると、データフィルターが設定された状態の詳細なダッシュボードにユーザーを移動させることができます。例えば、 変数を使用して、時間範囲、系列、または変数の選択を指定できます。詳細については、「[データリンク変数](#v9-panels-data-link-variables)」を参照してください。

### 入力候補機能
<a name="v9-panels-typeahead-suggestions"></a>

 データリンクを作成または更新する際に、キーボードの Cmd\$1Space または Ctrl\$1Space を押すと入力候補が表示され、URL に変数をより簡単に追加できます。

### データリンクを追加する
<a name="v9-panels-add-a-datalink"></a>

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

1.  [フィールド] タブで、[データリンク] セクションまでスクロールダウンします。

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

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

1.  リンク先の **URL** を入力します。

    ダッシュボードで定義済みのテンプレート変数のいずれかを追加することもできます。**URL** フィールドをクリックして「**\$1**」と入力するか、Ctrl\$1Space または Cmd\$1Space を押すと、使用可能な変数の一覧が表示されます。パネルリンクにテンプレート変数を追加することで、関連する変数がすでに設定されている適切なコンテキストをリンクからユーザーに送信します。詳細については、「[データリンク変数](#v9-panels-data-link-variables)」を参照してください。

1.  リンクを新しいタブで開く場合は、**[新しいタブで開く]** を選択します。

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

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

### データリンクの更新
<a name="v9-panels-update-a-datalink"></a>

1.  [フィールド] タブで、変更するリンクを見つけます。

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

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

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

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

### データリンクの削除
<a name="v9-panels-delete-a-datalink"></a>

1.  [フィールド] タブで、削除するリンクを見つけます。

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

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

# フィールドのオーバーライドを設定する
<a name="v9-panels-configure-overrides"></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)」を参照してください。

 オーバーライドを使用すると、特定のフィールドまたは系列に対して視覚化設定をカスタマイズできます。これは、特定のフィールドセットをターゲットとし、それぞれ複数のオプションを定義できるオーバーライドルールを追加することで実現されます。

 例えば、**[正規表現と一致する名前付きフィールド]**を使用してオーバーライドを追加して、テキスト「bytes」を含むすべてのフィールドに単位を設定し、オーバーライドルールに単位オプションを追加できます。

## 例 1: 温度の形式
<a name="v9-panels-overrides-format-temperature"></a>

 結果セットは、時間と温度の 2 つのフィールドで構成されるデータフレームであるとします。


|  時間  |  温度  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0  | 
|  2020-01-02 03:05:00  |  47.0  | 
|  2020-01-02 03:06:00  |  48.0  | 

 この構造の各フィールド (列) には、値の表示方法を変更するフィールドオプションを適用できます。つまり、例えば、単位を温度 > 摂氏に設定して、次の表を作成できます。


|  時間  |  温度  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0 °C  | 
|  2020-01-02 03:05:00  |  47.0 °C  | 
|  2020-01-02 03:06:00  |  48.0 °C  | 

 また、小数点は必須ではないため、削除できます。小数を**自動**からゼロ (**0**) に変更すると、次の表になります。


|  時間  |  温度  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  | 
|  2020-01-02 03:05:00  |  47 °C  | 
|  2020-01-02 03:06:00  |  48 °C  | 

## 例 2: 温度と湿度の形式
<a name="v9-panels-overrides-format-humidity"></a>

 結果セットが、「時間」、「高温」、「低温」、「湿度」の 4 つのフィールドで構成されるデータフレームである場合を例にします。


|  時間  |  高温  |  低温  |  湿度  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45.0  |  30.0  |  67  | 
|  2020-01-02 03:05:00  |  47.0  |  34.0  |  68  | 
|  2020-01-02 03:06:00  |  48.0  |  31.0  |  68  | 

 摂氏単位を追加し、小数点以下を削除しましょう。この結果は以下の表になります。


|  時間  |  高温  |  低温  |  湿度  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67 °C  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68 °C  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68 °C  | 

 温度フィールドは良く見えますが、湿度を変更する必要があります。これを修正するには、湿度フィールドにフィールドオプションオーバーライドを適用し、単位を [Misc] (その他) > % (0～100) に変更します。


|  時間  |  高温  |  低温  |  湿度  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67%  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68%  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68%  | 

## フィールドオーバーライドを追加する
<a name="v9-panels-overrides-add-a-field"></a>

 フィールドオーバーライドルールは、特定のフィールドまたは系列の視覚化設定をカスタマイズできます。

1.  オーバーライドを追加するパネルを編集します。

1.  パネルオプションサイドペインで、ペインの下部にある **[フィールドオーバーライドの追加]** をクリックします。

1.  オーバーライドルールが適用されるフィールドを選択します。
   +  **[名前付きフィールド]**: 使用可能なすべてのフィールドの一覧からフィールドを選択します。このセレクタでルールに追加するプロパティは、この単一フィールドにのみ適用されます。
   +  **[正規表現と一致する名前付きフィールド]**: 正規表現でオーバーライドするフィールドを指定します。このセレクタでルールに追加するプロパティは、フィールド名が正規表現と一致するすべてのフィールドに適用されます。
   +  **[タイプ別フィールド]**: 文字列、数値などのフィールドをタイプ別に選択します。このセレクタでルールに追加するプロパティは、選択したタイプに一致するすべてのフィールドに適用されます。
   +  **[クエリによって返されるフィールド]**: A、B、C など、特定のクエリによって返されるすべてのフィールドを選択します。このセレクタでルールに追加するプロパティは、選択したクエリによって返されるすべてのフィールドに適用されます。

1.  **[オーバーライドプロパティの追加]** をクリックします。

1.  適用するフィールドオプションを選択します。

1.  フィールドに値を追加してオプションを入力します。オプションをデフォルト値に戻すには、フィールドの白い文字を削除します。

1.  **[オーバーライドプロパティの追加]** をクリックして、このフィールドにオーバーライドを追加し続けます。または、**[オーバーライドの追加]** をクリックして、オーバーライドを追加する別のフィールドを選択できます。

1.  完了したら **[保存]** をクリックして、すべてのパネル編集をダッシュボードに保存します。

## フィールドオーバーライドの削除
<a name="v9-panels-overrides-delete-a-field"></a>

 不要になったフィールドオーバーライドを削除します。オーバーライドを削除すると、値の外観はデフォルトで元の形式になります。この変更は、影響を受けるパネルに依存するダッシュボードとダッシュボードユーザーに影響します。

1.  削除するオーバーライドを含むパネルを編集します。

1.  パネルオプションサイドペインで、オーバーライドが表示されるまで下にスクロールします。

1.  削除するオーバーライドをクリックし、関連付けられたごみ箱アイコンをクリックします。

## フィールドオーバーライドの表示
<a name="v9-panels-overrides-view"></a>

 フィールドオーバーライドは、パネル表示オプションで表示できます。

1.  表示するオーバーライドを含むパネルを編集します。

1.  パネルオプションサイドペインで、オーバーライドが表示されるまで下にスクロールします。

 **[すべて]** タブに表示されるオーバーライド設定は、**[オーバーライド]** タブに表示される設定と同じです。

## フィールドオーバーライドの編集
<a name="v9-panels-overrides-edit-a-field"></a>

 オーバーライド設定に変更を加える場合は、フィールドオーバーライドを編集します。加えた変更はすぐに反映されます。

1.  編集するオーバーライドを含むパネルを編集します。

1.  パネルオプションサイドペインで、オーバーライドが表示されるまで下にスクロールします。

1.  変更するオーバーライドを見つけます。

1.  次のいずれかを実行します。
   +  既存のオーバーライドまたはフィールド選択パラメータの設定を編集します。
   +  プロパティの横にある **[X]** をクリックして、既存のオーバーライドプロパティを削除します。
   +  **[オーバーライドプロパティの追加]** をクリックして、オーバーライドプロパティを追加します。

# 値マッピングを設定する
<a name="v9-panels-configure-value-mappings"></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-panels-value-mappings-types"></a>

 Grafana は、次の値マッピングをサポートしています。
+  **[値]**: テキスト値を色または別の表示テキストにマッピングします。例えば、値 **10** のすべてのインスタンスが数値ではなく **Perfection\$1** として表示されるように値マッピングを設定できます。
+  **[Range]**: 数値範囲を表示テキストと色にマッピングします。例えば、値が特定の範囲内にある場合、数値ではなく**下限**または**上限**を表示するように範囲値マッピングを設定できます。
+  **[Regex]**: 正規表現を代替テキストと色にマッピングします。例えば、値が **www.example.com** の場合、Grafana が **www** を表示し、ドメインを切り捨てるように正規表現値マッピングを設定できます。
+  **[特殊]** **[Null]**、**[NaN]** (数値以外) などの特殊な値、**[真]** や **[偽]** などのブール値を表示テキストと色にマッピングします。例えば、**[Null]** 値が **N/A** として表示されるように、特殊な値マッピングを設定できます。

 また、左側のドットを使用して、リスト内の値マッピングをドラッグして並べ替えることもできます。

## 値をマッピングする
<a name="v9-panels-value-mappings-map-a-value"></a>

 単一の値をフォーマットする場合は、値をマッピングします。

1.  値をマッピングするパネルを開きます。

1.  パネル表示オプションで **[値マッピング]** セクションを見つけ、**[値マッピングを追加]** をクリックします。

1.  **[新しいマッピングを追加]** をクリックし、**[値l** を選択します。

1.  Grafana が一致する値を入力します。

1.  (オプション) 表示テキストを入力します。

1.  (オプション) 色を設定します。

1.  **[更新]** をクリックして、値マッピングを保存します。

## 範囲をマッピングする
<a name="v9-panels-value-mappings-map-a-range"></a>

 複数の連続値をフォーマットする場合は、値の範囲をマッピングします。

1.  値の範囲をマッピングするパネルを編集します。

1.  パネル表示オプションの **[値マッピング]** セクションで、**[値マッピングを追加]** をクリックします。

1.  **[新しいマッピングを追加]** をクリックし、**[Range]** (範囲) を選択します。

1.  Grafana が一致する範囲内に開始値と終了値を入力します。

1.  (オプション) 表示テキストを入力します。

1.  (オプション) 色を設定します。

1.  **[更新]** をクリックして、値マッピングを保存します。

## 正規表現をマッピングする
<a name="v9-panels-value-mappings-map-a-regex"></a>

 正規表現値のテキストと色をフォーマットする場合は、正規表現をマッピングします。

1.  正規表現をマッピングするパネルを編集します。

1.  パネル表示オプションの **[値マッピング]** セクションで、**[値マッピングを追加]** をクリックします。

1.  **[新しいマッピングを追加]** をクリックし、**[Regex]** (正規表現) を選択します。

1.  Grafana が一致する正規表現パターンを入力します。

1.  (オプション) 表示テキストを入力します。

1.  (オプション) 色を設定します。

1.  **[更新]** をクリックして、値マッピングを保存します。

## 特殊な値をマッピングする
<a name="v9-panels-value-mappings-map-a-special-value"></a>

 まれな値、ブール値、または空の値をフォーマットする場合は、特殊な値をマッピングします。

1.  特殊な値をマッピングするパネルを編集します。

1.  パネル表示オプションで **[値マッピング]** セクションを見つけ、**[値マッピングを追加]** をクリックします。

1.  **[新しいマッピングを追加]**をクリックし、**[特殊]** を選択します。

1.  Grafana が一致する特殊な値を選択します。

1.  (オプション) 表示テキストを入力します。

1.  (オプション) 色を設定します。

1.  **[更新]** をクリックして、値マッピングを保存します。

## 値マッピングを編集する
<a name="v9-panels-value-mappings-edit-a-value"></a>

 値マッピングはいつでも変更できます。

1.  編集する値マッピングを含むパネルを編集します。

1.  パネル表示オプションの **[値マッピング]** セクションで、**[値マッピングの編集]** をクリックします。

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

# 凡例を設定する
<a name="v9-panels-configure-legend"></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-panels-legend-isolate"></a>

視覚化は視覚的に複雑になることが多く、データ系列が数多く含まれている場合があります。視覚化から系列データを削除することで、表示を簡素化できます。これにより、表示したいデータが分離されます。Grafana は **[Override]** タブに新しいオーバーライドを自動的に作成します。

変更を適用すると、視覚化の変更がパネルのすべてのユーザーに表示されます。

**視覚化で系列データを分離するには**

1. パネルを開きます。

1. 凡例で、分離する系列のラベルを選択します。

   システムによって、他のすべての系列データ表示から削除されます。

1. 系列データを分離された系列に段階的に追加するには、**Ctrl** キーまたは **Command** キーを押して、追加する系列のラベルを選択します。

1. すべてのデータを含むデフォルトの表示に戻すには、任意の系列ラベルを 2 回クリックします。

1. パネルのすべてのビューワーに表示されるように変更を保存するには、**[適用]** を選択します。

このトピックは現在、次の視覚化に適用されます。
+ [棒グラフ](v9-panels-bar-chart.md)
+ [ヒストグラム](v9-panels-histogram.md)
+ [円グラフ](v9-panels-piechart.md)
+ [状態タイムライン](v9-panels-state-timeline.md)
+ [ステータス履歴](v9-panels-status-history.md)
+ [時系列](v9-panels-time-series.md)

## 凡例への値の追加
<a name="v9-panels-legend-add-values"></a>

視覚化にコンテキストを追加する方法として、系列データ値を凡例に追加できます。必要な数だけ値を追加できます。変更を適用したら、凡例を水平にスクロールするとすべての値を表示できます。

**凡例に値を追加するには**

1. パネルを編集します。

1. パネル表示オプションペインで、**[凡例]** セクションを見つけます。

1. **[凡例値]** フィールドで、凡例に表示する値を選択します。

1. **[適用]** を選択して変更を保存すると、ダッシュボードに戻ります。

## 系列の色の変更
<a name="v9-panels-legend-change-color"></a>

デフォルトでは、Grafana は系列データの色を指定しますが、これは変更できます。

**系列の色を変更するには**

1. パネルを編集します。

1. 凡例で、系列に関連付けられたカラーバーを選択します。

1. カラーパレットから事前設定された色またはユーザー定義の色を選択します。

1. **[適用]** を選択して変更を保存すると、ダッシュボードに戻ります。

## 系列の並べ替え
<a name="v9-panels-legend-sort"></a>

凡例モードを**テーブル**に変更し、凡例に表示されるように [計算タイプ](v9-panels-calculation-types.md) を選択できます。凡例テーブルの計算名ヘッダーを選択して、テーブル内の値を昇順または降順に並べ替えます。

並べ替えの順序は、棒グラフパネルの棒の位置と、時系列および棒グラフパネルの積み上げ系列の順序に影響します。

**注記**  
この機能は、棒グラフ、ヒストグラム、時系列、XY チャートのパネルにのみ対応しています。

# 計算タイプ
<a name="v9-panels-calculation-types"></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 で実行できる計算の一覧を示します。これらの計算は、**[変換]** タブと棒ゲージ、ゲージ、および統計の視覚化で確認できます。


|  計算  |  説明  | 
| --- | --- | 
|  All nulls  |  すべての値が null のとき真  | 
|  All zeros  |  すべての値が 0 のとき真  | 
|  Change count  |  フィールドの値が変更される回数  | 
|  Count  |  フィールド内の値の数  | 
|  Delta  |  値の累積変化、カウント増分のみ  | 
|  Difference  |  フィールドの最初の値と最後の値の差  | 
|  Difference percent  |  フィールドの最初と最後の値の変化率  | 
|  Distinct count  |  フィールド内の一意の値の数  | 
|  最初 (null ではない)  |  最初、null でないフィールド内の値  | 
|  最大  |  フィールドの最大値  | 
|  Mean  |  フィールド内のすべての値の平均値  | 
|  Variance  |  フィールド内のすべての値の分散  | 
|  StdDev  |  フィールド内のすべての値の標準偏差  | 
|  最小  |  フィールドの最小値  | 
|  最小 (above zero)  |  フィールドの最小値、正の値  | 
|  Range  |  フィールドの最大値と最小値との差  | 
|  Step  |  フィールドの値間の最小間隔  | 
|  Total  |  フィールド内のすべての値の合計  | 

# 視覚化に注釈を付ける
<a name="v9-panels-annotate-visualizations"></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 には、ネイティブ注釈ストアと、グラフパネルから直接、または HTTP API を介して注釈イベントを追加する機能があります。

**注釈の追加**

1. ダッシュボードで、**[時系列]** パネルをクリックします。コンテキストメニューが表示されます。

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

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

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

または、注釈を追加するには、**[時系列]** パネル上で `Ctrl+Click` または `Cmd+Click` し、**[注釈の追加]** ポップアップが表示されます。

**リージョン注釈の追加**

1. ダッシュボードで、**時系列**パネル上で `Ctrl+Click` または `Cmd+Click` します。

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

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

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

**注釈の編集**

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

1. 注釈ツールチップの編集 (鉛筆) アイコンをクリックします。

1. 説明や、オプションでタグを変更します。

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

**注釈の削除**

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

1. 注釈ツールチップのごみ箱アイコンをクリックします。

**ビルトインクエリクエリ**

注釈を追加すると、それらは引き続き表示されます。これは、すべてのダッシュボードに存在する組み込みの注釈クエリが原因です。この注釈クエリは、現在のダッシュボードから発生するすべての注釈イベントを取得し、それらが作成されたパネルに表示されます。これには、アラート状態履歴の注釈が含まれます。**[注釈]** 設定 (ダッシュボードの歯車メニュー) を開き、`Annotations & Alerts (Built-in)` という名前のクエリを変更することで、注釈の取得と描画を停止できます。

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

**タグによるクエリ**

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

Grafana v8.1 以降のバージョンでは、既存のタグの先行入力もサポートされており、少なくとも 1 つのタグを提供します。

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

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

**その他のデータソースのクエリ**

注釈イベントは、注釈クエリを介して取得されます。ダッシュボードに新しい注釈クエリを追加するには、ダッシュボード設定メニューを開き、**[注釈]** を選択します。これにより、ダッシュボードの注釈設定ビューが開きます。新しい注釈クエリを作成するには、**[新規]** ボタンをクリックします。

注釈クエリの名前を指定します。この名前は、このクエリから注釈イベントを表示または非表示にするトグル (チェックボックス) に付けられます。例えば、2 つの注釈クエリ(`Deploys` と `Outages`) があるとします。トグルを使用すると、表示する注釈を決定できます。

**注釈クエリの詳細**

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

# パネル検査ビュー
<a name="v9-panels-panel-inspector"></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 パネルの未加工データの検査、データの CSV (comma-separated values: カンマ区切り) ファイルへのエクスポート、クエリリクエストの表示、JSON 形式のパネルとデータのエクスポートが可能です。

**注記**  
 すべてのパネルタイプにタブがすべてあるわけではありません。例えば、ダッシュボードリストパネルには検査する未加工データがないため、[統計]、[データ]、[クエリ] タブは表示されません。

 パネルインスペクターは、次のオプションで構成されます。

1.  パネルインスペクターでは、ペインの上部に **[Inspect: [NameOfPanelBeingInspected]]** が表示されます。右上隅の矢印をクリックして、ペインを展開または縮小できます。

1.  **[データ タブ]** – 変換が適用されたクエリによって返される未加工データを表示します。オーバーライドや値マッピングなどのフィールドオプションは、デフォルトでは適用されません。

1.  **[統計タブ]** – クエリにかかる時間および返される量を示します。

1.  **[JSON] タブ -** パネル JSON、パネルデータ JSON、およびデータフレーム構造 JSON を、表示およびコピーできます。これは Grafana のプロビジョニングまたは管理に役立ちます。

1.  **[クエリタブ] –** Grafana がデータソースへのクエリ実行時に送信されるサーバーへのリクエストを表示します。

1.  **[エラータブ]** – エラーを表示します。クエリがエラーを返す場合にのみ表示されます。

## 未加工のクエリ結果をダウンロードする
<a name="v9-panels-raw-query-results"></a>

 Grafana は、お使いのデータで構成される CSV ファイルを生成します。これには、そのデータに対する任意の変換も含まれます。パネルがフィールドオプションまたはフィールドオプションオーバーライドを適用する前後にデータを表示するように選択できます。

1.  ダウンロードするクエリデータを含むパネルを編集します。

1.  クエリエディタで、**[Query Inspector]** (クエリインスペクター) をクリックします。

1.  **[Data]** (データ) をクリックします。

    パネルに複数のクエリがある、または複数のノードにクエリを実行する場合は、追加のオプションがあります。
   +  **[結果の選択]**: 表示する結果セットデータを選択します。
   +  **[データを変換する]** 
   +  **[時間で結合]**: すべてのクエリの生データを一度に表示し、列ごとに結果セットを 1 つ表示します。列見出しをクリックして、データの順序を変更します。

1.  システムがフィールドのオーバーライドを適用する前にデータを表示するには、**[フォーマットされたデータ]** トグルをクリックします。

1.  Excel 専用にフォーマットされた CSV ファイルをダウンロードするには、**[Excel 用にダウンロード]** トグル をクリックします。

1.  **[CSV ダウンロード]** をクリックします。

## クエリパフォーマンスの検査
<a name="v9-panels-query-performance"></a>

 **[統計]** タブには、クエリにかかる時間、送信したクエリの数、返された行数を示す統計が表示されます。この情報は、特に数値が予想外に高い場合や低い場合のクエリのトラブルシューティングに役立ちます。

1.  クエリを含むパネルを、検査するパフォーマンスで編集します。

1.  クエリエディタで、**[Query Inspector]** (クエリインスペクター) をクリックします。

1.  **[Stats]** (統計) をクリックします。

 統計が読み取り専用形式で表示されます。

## クエリリクエストとレスポンスを検査する
<a name="v9-panels-query-request-response"></a>

 予期しない結果を返すクエリ、または期待される結果を返さないクエリのトラブルシューティングを行う場合は、クエリリクエストとレスポンスデータを検査します。

1.  エクスポートするクエリを含むパネルを編集します。

1.  クエリエディタで、**[Query Inspector]** (クエリインスペクター) をクリックします。

1.  **[更新]** をクリックします。

    パネルにはレスポンスデータが入力されます。

1.  必要に応じて調整を行い、クエリを再実行します。

1.  クエリリクエストとレスポンスデータをダウンロードするには、**[Copy to clipboard]** (クリップボードにコピー) アイコンをクリックし、結果を別のアプリケーションに貼り付けます。

# Grafana バージョン 9 で利用可能な視覚化
<a name="v9-panels-viz"></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 は、さまざまなユースケースをサポートするさまざまな視覚化を提供します。ドキュメントのこのセクションでは、組み込まれているパネル、そのオプション、そして一般的な使用方法について説明します。

パネルの使用の開始からその基本まで学べる一般的なパネルは、[時系列パネル](v9-panels-time-series.md) パネルです。

**Topics**
+ [アラートリストパネル](v9-panels-alert-list.md)
+ [注釈パネル](v9-panels-annotations.md)
+ [棒グラフパネル](v9-panels-bar-chart.md)
+ [棒ゲージ](v9-panels-bar-gauge.md)
+ [ローソク足パネル](v9-panels-candlestick.md)
+ [Canvas パネル](v9-panels-canvas.md)
+ [時計パネル](v9-panels-clock.md)
+ [ダッシュボードの一覧表示](v9-panels-dashboard-list.md)
+ [ゲージパネル](v9-panels-gauge.md)
+ [ジオマップパネル](v9-panels-geomap.md)
+ [グラフパネル](v9-panels-graph.md)
+ [ヒートマップパネル](v9-panels-heatmap.md)
+ [ヒストグラムパネル](v9-panels-histogram.md)
+ [ログパネル](v9-panels-logs.md)
+ [ニュースパネル](v9-panels-news.md)
+ [ノードグラフパネル](v9-panels-node-graph.md)
+ [円グラフパネル](v9-panels-piechart.md)
+ [Plotly パネル](v9-panels-plotly.md)
+ [サンキーパネル](v9-panels-sankey.md)
+ [散布図パネル](v9-panels-scatter.md)
+ [統計パネル](v9-panels-stat.md)
+ [状態タイムラインパネル](v9-panels-state-timeline.md)
+ [ステータス履歴パネル](v9-panels-status-history.md)
+ [テーブルパネル](v9-panels-table.md)
+ [テキストパネル](v9-panels-text.md)
+ [時系列パネル](v9-panels-time-series.md)
+ [トレースパネル (ベータ)](v9-panels-traces.md)
+ [WindRose](v9-panels-windrose.md)

# アラートリストパネル
<a name="v9-panels-alert-list"></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 バージョン 9 のアラート](v9-alerts.md)」を参照してください。　

この設定で、視覚化する内容を絞り込みます。

## オプション
<a name="v9-panels-alert-list-options"></a>
+  **[グループモード]** – **[デフォルトのグループ化]** を選択して、アラートルール別にグループ化されたアラートインスタンスを表示します。また、**[カスタムグループ化]** では、ラベルのカスタムセット別にアラートインスタンスをグループ化します。
+  **[最大項目数]** – 一覧表示するアラートの最大数を設定します。
+  **[ソート順序]** – アラートをどのような順番で表示するかを選択します。
  +  **アルファベット (昇順)** – アルファベット順
  +  **アルファベット (降順)** – 逆アルファベット順
  +  **[重要性]** – 以下を参照。1 が最も高い。
    + `alerting` または `firing`: 1
    + `no_data`: 2
    + `pending`: 3
    + `ok`: 4
    + `paused` または `inactive`: 5
+  **[このダッシュボードからのアラート]** – アラートリストが含まれているダッシュボードからのみアラートを表示します。

## フィルター
<a name="v9-panels-alert-filter"></a>

選択したクエリ、フォルダ、またはタグでアラートをフィルタリングする場合、次のオプションを使用できます。
+  **[アラート名]** – アラート名クエリを入力します。
+  **[アラートインスタンスラベル]** – ラベルクエリを使用してアラートインスタンスをフィルタリングします。例えば、`{severity="critical", instance=~"cluster-us-.+"}` と指定します。
+  **[フォルダ]** – フォルダを選択します。選択したフォルダ内のダッシュボードからのアラートのみが表示されます。
+  **[データソース]** – 選択したデータソースからアラートをフィルタリングします。

## 状態フィルター
<a name="v9-panels-alert-state-filter"></a>

このパネルに表示するアラートの状態を選択します。
+ アラート中/発生中
+ 保留中
+ データなし
+ 普通
+ エラー

# 注釈パネル
<a name="v9-panels-annotations"></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-panels-annotations-query"></a>

以下のオプションは、注釈のリストに対するソースクエリを制御します。

**[クエリフィルター]**

クエリフィルターを使用して、組織内のすべてのダッシュボードまたはこのパネルがある現在のダッシュボードから注釈のリストを作成します。これには次のオプションがあります。
+ すべてのダッシュボード - 現在の組織内のすべてのダッシュボードの注釈を一覧表示します。
+ このダッシュボード - リストを現在のダッシュボードの注釈に制限します。

**[時間範囲]**

時間範囲オプションを使用して、リストを現在の時間範囲に制限するかどうかを指定します。これには次のオプションがあります。
+ [なし] - 注釈クエリの時間範囲の制限はありません。
+ このダッシュボード - リストを、注釈リストパネルが利用可能なダッシュボードの時間範囲に制限します。

**[タグ]**

タグオプションを使用して、注釈をタグでフィルタリングします。リストを絞り込むために複数のタグを追加できます。

**注記**  
必要に応じて、タグリストを空のままにして、パネル自体の結果の一部としてリストされているタグを選択して、その場でフィルタリングします。

*[制限]*

制限オプションを使用して、返される結果の数を制限します。

## [Display] (表示)
<a name="v9-panels-annotations-display"></a>

これらのオプションは、注釈パネル表示に含まれる追加のメタデータを制御します。

**[ユーザーの表示]**

このオプションを使用して、注釈を作成したユーザーを表示または非表示にします。

**[時間の表示]**

このオプションを使用して、注釈の作成時刻を表示または非表示にします。

**[タグの表示]**

このオプションを使用して、注釈に関連付けられたタグを表示または非表示にします。*[NB]*: タグを使用して、パネル自体の注釈リストをその場でフィルタリングできます。

## リンク動作
<a name="v9-panels-annotations-links"></a>

**[リンクの対象]**

このオプションを使用して、注釈付きデータを表示する方法を選択します。これには次のオプションがあります。
+ [Panel] (パネル) - このオプションは、対応する注釈を含むパネルのフル画面表示に直接移動します。
+ ダッシュボード - このオプションは、全ダッシュボードのコンテキストで注釈に焦点を当てます。

**[前に時間指定]**

このオプションを使用して、注釈の前に時間範囲を設定します。「1h」= 1 時間、「10m」= 10 分などの期間文字列値を使用します。

**[後に時間指定]**

このオプションを使用して、注釈の後に時間範囲を設定します。

# 棒グラフパネル
<a name="v9-panels-bar-chart"></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-panels-bar-chart-formats"></a>

サポートされるデータフレームは 1 つだけで、X 軸または Y 軸の項目として使用する文字列フィールドが少なくとも 1 つ、および数値フィールドが 1 つ以上必要です。以下は、データ形式の例です。


|  ブラウザ  |  市場シェア  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17.5  | 

複数の数値フィールドがある場合は、パネルにグループ化されたバーが表示されます。

### 時系列または複数の結果セットの視覚化
<a name="v9-panels-bar-chart-visualization"></a>

複数の時系列またはテーブルがある場合は、まず結合を使用して結合するか、変換を減らす必要があります。例えば、複数の時系列があり、その最終値と最大値を比較する場合は、変換の **[削減]** を追加し、**[計算]** で **[最大]** と **[Last]** をオプションとして指定します。

## 棒グラフのオプション
<a name="v9-panels-bar-chart-options"></a>

これらのオプションで、視覚的表現の内容を絞り込みます。

**[Orientation]** (向き)
+  **[自動]** – Grafana は、パネルのディメンションに基づいてバーの向きを決定します。
+  **[水平]** – X 軸をカテゴリ軸にします。
+  **[垂直]** – Y 軸をカテゴリ軸にします。

**[X 軸の目盛ラベルの最大長]** は、棒グラフラベルの最大長を設定します。最大長を超えるラベルは省略記号で切り捨てられます。

**[バーラベルの最小間隔]** は、バーラベル間の最小間隔を設定します。

**[値の表示]**

値がバーの上部または左側に表示されるかどうかを制御します。
+  **[自動]** – スペースがある場合は値が表示されます。
+  **[常に表示]** – 常に値を表示します。
+  **[常に非表示]** – 常に値を表示しません。

**[積み上げ]**

棒グラフの積み上げを制御します。
+  **[Off]** (オフ) – バーは積み重ねられません。
+  **[普通]** – バーは積み重ねられます。
+  **[パーセント]** – バーは積み重ねられ、各バーの高さは積み重ねの合計の高さの割合です (バーの積み重ねはすべて同じ高さになり、最大 100% となります)。

**[グループの幅]** は、グループの幅を制御します。0=最小、1=最大幅です。

**[Bar width]** は、バーの幅を制御します。0=最小、1=最大幅です。

**[Bar radius]** は、バーの半径を制御します。0 = 最小、0.5 = 最大半径です。

**[カーソル上の全領域をハイライト]** は、ポインターでバーにカーソルを合わせた際に、バーの周囲を強調表示するかを制御します。

**[線の幅]**: 棒の線幅を制御します。

**[塗りつぶしの不透明度]**: 棒の塗りつぶし不透明度を制御します。

**[グラデーションモード]**: グラデーション塗りつぶしモードを設定します。塗りつぶしグラデーションは線の色を基準にします。色を変更するには、標準のカラースキームフィールドオプションを使用します。グラデーションの外観は**[塗りつぶしの不透明度]**設定の影響を受けます。
+  **[なし]** – グラデーション塗りつぶしなし。これはデフォルト設定です。
+  **[不透明度]** – グラデーションの透明度は Y 軸の値に基づいて計算されます。Y 軸の値とともに塗りつぶしの不透明度が増加します。
+  **[色相]** – グラデーション色は線の色相に基づいて生成されます。

**[ツールチップモード]** – 視覚化にカーソルを合わせると、Grafana はツールチップを表示できます。ツールチップの動作を選択します。
+  **[単独]** – ツールチップには、グラフ上でカーソルを合わせている系列が 1 つだけ表示されます。
+  **[すべて]** – ツールチップには、グラフ内のすべての系列が表示されます。Grafana は、ツールチップの系列一覧で、カーソルを合わせている系列を太字で強調表示します。
+  **[非表示]** – グラフを操作するときにツールチップを表示しません。

**注記**  
オーバーライドを使用して、ツールチップから個々の系列を非表示にできます。

**[凡例モード]** – これらの設定を使用して視覚化内の凡例の表示方法を改善します。詳細については、「[凡例を設定する](v9-panels-configure-legend.md)」を参照してください。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

**[凡例の配置]** - 凡例を配置する場所を選択します。
+  **[Bottom]** – グラフの下。
+  **[右側]** – グラフの右側。

**[凡例計算]** - 凡例に表示する標準計算を選択します。複数選択できます。

**[テキストサイズ]** – 棒グラフのテキストのサイズを変更する値を入力します。

**[軸]** – 次のフィールド設定を使用して、軸の表示方法を絞り込みます。一部のフィールドオプションは、編集するフィールドオプションボックスの外部をクリックするか、Enter キーを押すまで、視覚的表現には影響しません。
+  **[配置]** – Y 軸の配置を設定します。
+  **[自動]** – Grafana は、Y 軸を系列に自動的に割り当てます。異なるユニットを持つ系列が 2 つ以上ある場合、Grafana は左軸を最初のユニットに、右軸を次のユニットに割り当てます。
+  **[左]** – 左側にすべての Y 軸を表示します。
+  **[右側]** – 右側にすべての Y 軸を表示します。
+  **[非表示]** – すべての Y 軸を非表示にします。
+  **[ラベル]** – Y 軸テキストラベルを設定します。複数の Y 軸がある場合は、オーバーライドで異なるラベルを割り当てることができます。
+  **[幅]** – 軸の固定幅を設定します。デフォルトでは、Grafana は軸の幅を動的に計算します。

  軸の幅を設定することで、異なる軸タイプのデータが同じ表示比率を共有できます。これにより、軸が互いに視覚的に近接して移動または伸張されないため、複数のグラフのデータの価値を簡単に比較できます。
+  **[ソフト最小値とソフト最大値]** – Y 軸の制限をより適切に制御するために、ソフト最小値またはソフト最大値オプションを設定します。デフォルトでは、Grafana はデータセットに基づいて Y 軸の範囲を自動的に設定します。

  ソフト最小値とソフト最大値の設定により、データがほぼフラットなときに、小さな変動が大きな変動に見えるのを防ぎます。また、標準の最小値と最大値のフィールドオプションから派生したハード最小値または最大値により、定義されたポイントを超えたスパイクを切り取ることで、断続的なスパイクが有用な詳細を平坦化することを防げます。

  標準最小/最大値オプションを設定して、Y 軸のハード制限を定義できます。

# 棒ゲージ
<a name="v9-panels-bar-gauge"></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 つの値にまとめて表示することで情報を簡素化します。Grafana がまとめるにあたり、計算方法を選択します。

このパネルには、クエリの結果によって、1 つまたは複数の棒ゲージを表示できます (データが複数の系列、行、または列で構成されている場合など)。

## 値オプション
<a name="v9-panels-bar-gauge-value"></a>

次のオプションを使用して、視覚化で値を表示する方法を絞り込みます。

**[表示]** – Grafana がデータを表示する方法を選択します。

**[計算]** – すべての行を元に計算した値を表示します。
+ **[計算]** – Grafana が多くのフィールドを 1 つの値に減らすために使用する reducer 関数を選択します。使用可能な計算の一覧については、「計算タイプ」を参照してください。
+ **[フィールド]** – パネルに表示されるフィールドを選択します。

**[すべての値]** - 行ごとに個別の統計を表示します。このオプションを選択すると、表示する行数を制限することもできます。
+ **[制限]** – 表示する行の最大数。デフォルトは 5,000 です。
+ **[フィールド]** – パネルに表示されるフィールドを選択します。

## 棒ゲージオプション
<a name="v9-panels-bar-gauge-options"></a>

棒ゲージの表示方法を設定します。

**[Orientation]** (向き) – 積み重ね方向を選択します。
+ **[自動]** – Grafana が最適な方向を選択します。
+ **[水平]** – バーは水平方向に左から右に伸びます。
+ **[垂直]** – バーは垂直に下から上に伸びます。

**Display mode (表示モード)** – 表示モードを選択します。
+ **グラデーション]** – しきい値レベルはグラデーションを定義します。
+ **[Retro LCD]** – ゲージを小さなセルに分け、点灯または消灯させて表示します。
+ **[基本]** – 一致するしきい値に基づいて単一色で表示します。

**[塗りつぶされていない領域を表示]** – バーの塗りつぶされていない領域を濃い灰色で表示する場合は、このオプションを選択します。Retro LCD 表示モードには適用されません。

**[最小幅]**

垂直方向におけるバーの列の最小幅を制限します。

大量のデータがある場合、X 軸スクロールバーを自動的に表示します。

**[最小高さ]**

水平方向におけるバーの行の最小高さを制限します。

大量のデータがある場合、Y 軸スクロールバーを自動的に表示します。

# ローソク足パネル
<a name="v9-panels-candlestick"></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)」を参照してください。

ローソク足パネルの作成により、価格変動に焦点を当てた多数の一貫したディメンションを含むデータを視覚化できます。ローソク足パネルには、OHLC (Open-High-Low-Close: 始値、高値、安値、終値) モードと、時系列データに基づく追加のディメンションのサポートが含まれています。

ローソク足パネルの作成は、[時系列パネル](v9-panels-time-series.md) の基礎に基づいて構築され、多くの一般的な設定が含まれています。

**モード**

モードオプションを使用すると、視覚化に使用されるディメンションを切り替えられます。
+ **[Candles]** (ローソク) は、パネルのディメンションを、ローソク足チャートの作成で使用される始値、高値、安値、終値のディメンションに制限します。
+ **[Volume]** (ボリューム) は、パネルディメンションをボリュームディメンションに制限します。
+ **[Both]** (両方) は、ローソク足パネルのデフォルトの動作です。これには、ローソク足とボリュームの両方の視覚化が含まれます。

**Candle style (ローソクのスタイル)**
+ **[Candles]** はデフォルトの表示スタイルで、始値ディメンションと終値ディメンションとの間にローソクスタイルの視覚化が作成されます。
+ **[OHLC 棒]** は、4 つのコアディメンションである始値、高値、安値、終値を表示します。

**Color strategy (カラー戦略)**
+ **[始値から]** は、デフォルトの動作です。このモードは、期間内の料金変動が正の場合、*Up* カラー (下部) を使用します。つまり、クローズ時の値がオープン時の値以上である場合、*Up* カラーが使用されます。
+ **[前の終値以降]** は、ローソクの色が中間期の価格変動または値の変化に基づいている代替の表示方法です。つまり、オープン時の値がクローズ時の以前の値より大きい場合、*Up* カラーが使用されます。オープン時の値がクローズ時の以前の値よりも低い場合、*Down* カラーが使用されます。*このオプションでは、中空ローソク足グラフ作成モードもトリガーされます*。中空ローソク足は、期間内の変動が正 (値はオープン時よりもクローズ時が高い) であることを示します。塗りつぶされたローソク足は、期間内の変動が負 (値はオープン時よりもクローズ時が低い) であることを示します。詳細については、 「[違いの説明](https://thetradingbible.com/how-to-read-hollow-candlesticks)」を参照してください。

**アップカラーとダウンカラー**

**[Up color]** と **[Down color]** オプションは、料金変動がアップまたはダウンするときにどの色を使用するかを選択します。上記の*カラー戦略*は、ローソクまたは OHLC バーの色を選択するために、期間内または中間期の料金変動を使用するかどうかを決定します。

**始値、高値、安値、終値**

ローソク足パネルは、フィールドを適切なディメンションにマッピングしようとします。**[始値]**、**[高値]**、**[安値]**、および **[終値]** オプションを使用すると、パネルが適切なマッピングをできない場合に、データをこれらのディメンションにマッピングできます。

**注記**  
これらの値は凡例から非表示になります。
+ **[始値]** は、指定された期間の開始値に対応します。
+ **[高値]** は、指定された期間の最大値に対応します。
+ **[安値]** は、指定された期間の最小値に対応します。
+ **[終値]** は、指定された期間の最終 (終了) 値に対応します。
+ **[ボリューム]** は、特定の期間のサンプル数に対応します。(取引数など)

**追加フィールド**

ローソク足パネルは時系列パネルに基づいています。始値、高値、安値、終値、ボリューム以外の追加のデータディメンションを視覚化できます。**[含める]** オプションと **[無視]** オプションを使用すると、パネルは [時系列パネル](v9-panels-time-series.md) で使用できるのと同じスタイルと設定を使用して、単純な移動平均、ボリンジャーバンドなど、含まれている他のデータを視覚化できます。

# Canvas パネル
<a name="v9-panels-canvas"></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)」を参照してください。

Canvas は、Grafana の権限とカスタム要素の柔軟性を組み合わせた新しいパネルです。Canvas 視覚化は、静的レイアウトと動的レイアウトに要素を明示的に配置できる拡張可能なフォームビルドパネルです。これにより、Grafana の UI 内全体で、標準の Grafana パネルでは不可能な方法でカスタムビジュアライゼーションとオーバーレイデータを設計できます。一般的な UI およびウェブ設計ツールを使用したことがある場合、キャンバスパネルの設計は非常に馴染みのあるものになります。

## [Elements] (要素)
<a name="v9-panels-canvas-elements"></a>

**メトリクス値**

メトリクス値要素を使用すると、キャンバスに表示するデータを簡単に選択できます。この要素には、コンテキストメニューの「編集」オプションを通じて、またはパネルをダブルクリックしてトリガーできる一意の「編集」モードがあります。編集モードでは、表示するフィールドデータを選択できます。

**[テキスト]**

テキスト要素を使用すると、キャンバスにテキストを簡単に追加できます。また、要素は、ダブルクリックまたはコンテキストメニューの編集メニューオプションによってトリガーされる編集モードもサポートします。

**[Rectangle]** (長方形)

長方形要素を使用すると、基本的な長方形をキャンバスに追加できます。長方形要素は、テキスト (固定データとフィールドデータの両方) の表示をサポートし、データのしきい値に基づいて背景色を変更できます。

**[Icon]** (アイコン)

アイコン要素を使用すると、サポートされているアイコンをキャンバスに追加できます。アイコンは、しきい値または値マッピングに基づいて色を設定できます。

## Canvas の編集
<a name="v9-panels-canvas-editing"></a>

**[インラインエディタ]**

Canvas は新しい編集エクスペリエンスを導入しました。ダッシュボードモードのコンテキストで、キャンバスパネルをインラインで編集できるようになりました。

**コンテキストメニュー**

コンテキストメニューでは、一般的なタスクにアクセスできます。サポートされている機能には、インラインエディタの開閉、要素の複製、要素の削除などがあります。

コンテキストメニューは、パネルまたは特定のキャンバス要素に対する右クリックアクションによってトリガーされます。パネルを右クリックすると、背景イメージを設定し、キャンバスに要素を簡単に追加できます。

要素を右クリックすると、要素を編集、削除、複製したり、要素のレイヤーの位置を変更したりできます。

## キャンバスオプション
<a name="v9-panels-canvas-options"></a>

**インライン編集**

インライン編集トグルを使用すると、キャンバスパネルをロックまたはロック解除できます。オフにすると、キャンバスパネルが*ロック*され、要素が所定の位置にフリーズし、意図しない変更を防止できます。

# 時計パネル
<a name="v9-panels-clock"></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)」を参照してください。

時計パネルは、現在の時刻またはカウントダウンを表示します。毎秒更新されます。
+ **[モード]** (モード) – デフォルトは**時間**です。**カウントダウン**を選択した場合、**カウントダウンの期限**を設定してカウントダウンを開始します。
+ **[12 時間または 24 時間表記]** – 時間は 12 時間形式と 24 時間形式のいずれかを選択できます。
+ **[タイムゾーン]** – タイムゾーンは、moment timezone のライブラリから提供されます。デフォルトでは、使用しているコンピュータのタイムゾーンが使用されます。
+ **[カウントダウン期限]** – **[モード]**を**[カウントダウン]**に設定した場合、カウントダウンが終わる日時を指定します。
+ **[カウントダウン終了テキスト]** – カウントダウンが終了するタイミングで表示されるテキストを指定します。
+ **日付/時刻の書式設定オプション** – フォントサイズ、フォントの太さ、日付/時刻の書式設定をカスタマイズします。カウントダウンを表示していて、秒単位のカウントダウンを表示したくない場合は、24 時間表記の場合は `hh:mm`、12 時間時表記の場合は `h:mm A` に時間形式を変更してください。オプションの完全な一覧については、「[表示](https://momentjs.com/docs/#/displaying/)」を参照してください。
+ **[背景色]** – 時計の背景色を選択します。

# ダッシュボードの一覧表示
<a name="v9-panels-dashboard-list"></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)」を参照してください。

ダッシュボードリストの視覚化により、他のダッシュボードへの動的リンクを表示できます。リストは、スター付きダッシュボード、最近表示されたダッシュボード、検索クエリ、ダッシュボードタグを使用できるよう設定が可能です。

ダッシュボードのロードごとに、このパネルはダッシュボードリストに対してクエリを実行し、常に最新の結果を表示します。

**オプション**

これらのオプションで、視覚化する内容を絞り込みます。
+ **[Starred]** (スター付き) – スター付きダッシュボードをアルファベット順に表示します。
+ **[最近表示]** – 最近表示したダッシュボードをアルファベット順に表示します。
+ **[検索]** – 検索クエリまたはタグでダッシュボードを表示します。**クエリ**または**タグ**に少なくとも 1 つの値を入力する必要があります。**クエリ**フィールドと**タグ**フィールドでは、`$my_var` や `${my_var}` など、変数補間がサポートされています。
+ **[見出しの表示]** – 選択したリスト選択 (スター付き、最近表示、検索) が見出しとして表示されます。
+ **[最大項目数]** – セクションごとに一覧表示する項目の最大数を設定します。例えば、これをデフォルト値の 10 のままにして、スター付きダッシュボードと最近表示ダッシュボードを表示した場合、パネルには各セクションに 10 個、合計 20 個のダッシュボードが表示されます。

**[検索]**

これらのオプションは、**検索**オプションが選択されている場合にのみ適用されます。
+ **[クエリ]** – 検索するクエリを入力します。クエリでは大文字と小文字が区別されず、部分的な値も受け入れられます。
+ **[フォルダ]** – 表示するダッシュボードフォルダを選択します。
+ **[タグ]** – ここに検索するタグを入力します。既存のタグは入力時に表示されず、大文字と小文字*が*区別されます。

**注記**  
複数のタグと文字列が表示されると、ダッシュボードリストに*すべての*条件に一致するタグと文字列が表示されます。

# ゲージパネル
<a name="v9-panels-gauge"></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 つの値に減らすために使用する reducer 関数を選択します。使用可能な計算のリストについては、「[計算タイプ](v9-panels-calculation-types.md)」を参照してください。
+ **[フィールド]** – パネルに表示するフィールドを選択します。

**[すべての値]**

行ごとに個別の統計を表示します。このオプションを選択すると、表示する行数を制限することもできます。
+ **[制限]** – 表示する行の最大数。デフォルトは 5,000 です。
+ **[フィールド]** – パネルに表示するフィールドを選択します。

**ゲージ**

ゲージの表示方法を設定します。
+ **[しきい値ラベルの表示]** – しきい値を表示するかどうかを制御します。
+ **[しきい値マーカーの表示]** – しきい値バンドを内部ゲージ値バンドの外部に表示するかどうかを制御します。

**[テキストサイズ]**

ゲージテキストのサイズを調整します。
+ **[タイトル]** – ゲージタイトルサイズの数値を入力します。
+ **[値]** – ゲージ値サイズの数値を入力します。

# ジオマップパネル
<a name="v9-panels-geomap"></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-panels-geomap-view"></a>

マップビューは、ダッシュボードのロード時にマップの初期ビューを制御します。

**[初期ビュー]**

初期ビューは、パネルが最初にロードされたときに GeoMap パネルがどのようにレンダリングされるかを設定します。
+ **[ビュー]** は、パネルが最初にロードされたときにマップの中心を設定します。
  + **[Fit to data]** は、データが変更されたときのマップレイヤーと更新のデータ範囲に基づいてマップビューに適合します。
    + **[データ]** オプションでは、[すべてのレイヤー] のデータ、単一の [レイヤー]、または選択したレイヤーの [最後の値] に基づいて範囲を選択できます。
    + **[レイヤー]** において、単一の [レイヤー] またはレイヤーの [最後の値] からデータをフィッティングする場合に選択できます。
    + **[パディング]** は、データ範囲を超えた相対的な割合でパディングを設定します ([最後の値] のみを参照する場合は使用できません)。
    + **[Max Zoom]** は、データをフィッティングするときに最大ズームレベルを設定します。
  + **[座標]** は、以下に基づいてマップビューを設定します。
    + **Latitude** (緯度)
    + **Longitude** (経度)
  + デフォルトビューには、以下を含むものもあります。
    + **(0°, 0°)**
    + **北米**
    + **南米**
    + **欧州**
    + **アフリカ**
    + **西アジア**
    + **南アジア**
    + **東南アジア**
    + **東アジア**
    + **オーストラリア**
    + **オセアニア**
+ **[Zoom]** は、初期ズームレベルを設定します。

## レイヤーのマッピング
<a name="v9-panels-geomap-layers"></a>

Geomap 視覚化は、複数のレイヤーの表示をサポートします。各レイヤーは、ベースマップ上に地理空間データをどのように表示するかを決定します。

**タイプ**

ジオマップの視覚的表現では、3 つのマップレイヤータイプを選択できます。
+ [マーカーレイヤー](#v9-panels-geomap-markers) は、各データポイントにマーカーをレンダリングします。
+ [ヒートマップレイヤー](#v9-panels-geomap-heatmap) はデータのヒートマップを視覚化します。
+ [GeoJSON レイヤー](#v9-panels-geomap-geojson) は GeoJSON ファイルから静的データをレンダリングします。

また、現在アルファに入っているレイヤータイプは 5 つあります。
+ [夜間/昼間レイヤー (アルファ）](#v9-panels-geomap-nightday) は夜間または昼間のリージョンをレンダリングします。
+ **[Icon at last point (alpha)]** は、最後のデータポイントにアイコンをレンダリングします。
+ **[Dynamic GeoJSON (alpha)]** は、クエリ結果に基づいて GeoJSON ファイルをスタイルします。
+ **[Route (alpha)]** は、データポイントをルートとしてレンダリングします。
+ [写真レイヤー (アルファ)](#v9-panels-geomap-photos) は、各データポイントに写真をレンダリングします。

**[レイヤーコントロール]**

レイヤーコントロールを使用すると、レイヤーの作成、名前の変更、レイヤーの順序の変更、削除を行うことができます。
+ **[レイヤーを追加]** で、Geomap 視覚化用に設定可能な追加のデータレイヤーを作成します。レイヤーを追加すると、レイヤータイプを選択するように求められます。レイヤータイプは、パネル設定中にいつでも変更できます。各レイヤータイプの詳細については、上記の「**レイヤータイプ**」セクションを参照してください。
+ レイヤーコントロールを使用すると、パネルのレイヤーの名前変更、削除、順序変更をすることができます。
  + **[レイヤー名の編集]** (鉛筆アイコン) でレイヤーの名前を変更できます。
  + **[Trash Bin]** (ごみ箱) でレイヤーを削除できます。
  + **[Reorder]** (順序変更) (6 つのドット/グラブハンドル) では、レイヤーの順序を変更できます。上位レイヤーのデータは、下位レイヤーのデータの上に表示されます。パネルはドラッグアンドドロップするたびにレイヤーの順序を更新するため、レイヤーの順序の選択を簡素化します。

1 つのジオマップパネルに複数のデータレイヤーを追加して、リッチで詳細な視覚化を作成できます。

**場所**

ジオマップパネルには、地理的データの情報源が必要です。このデータには 4 つのマッピングオプションがあり、データベースクエリを使用して取得します。
+ **[自動]** でロケーションデータを自動的に検索します。クエリがデータフィールドの次のいずれかの名前に基づいている場合は、このオプションを使用します。
  + ジオハッシュ:「geohash」
  + 緯度:「latitude」、「lat」
  + 経度:「longitude」、「lng」、「lon」
  + ルックアップ:「lookup」
+ **Coords** (座標): クエリに座標データが含めることを指定します。データベースクエリから、緯度と経度の数値データフィールドを選択するよう求められます。
+ **Geohash** (ジオハッシュ): クエリがジオハッシュデータが含めることを指定します。データベースクエリから、ジオハッシュの文字列データフィールドを選択するよう求められます。
+ **[ルックアップ]**: クエリに値にマッピングする必要があるロケーション名データが含めることを指定します。データベースクエリと地名索引からルックアップフィールドを選択するよう求められます。地名索引は、クエリされたデータを地理的ポイントにマッピングするために使用されるディレクトリです。

## マーカーレイヤー
<a name="v9-panels-geomap-markers"></a>

マーカーレイヤーを使用すると、データポイントを円、正方形、三角形、星などのさまざまな形のマーカーとして表示することができます。

マーカーには多くのカスタマイズオプションがあります。
+ [**マーカーの色**] で、マーカーの色を設定します。デフォルトの `Single color` では、すべてのポイントが 1 色に保たれます。`Thresholds` セクションで設定されたデータポイント値としきい値に応じて、複数の色を使用できる代替オプションがあります。
+ **マーカーサイズ**: マーカーのサイズを設定します。デフォルトは `Fixed size` で、すべてのマーカーサイズはデータポイントに関係なく同じになります。ただし、対応するデータポイントに円を拡大縮小するオプションもあります。マーカーレイヤーの拡大縮小の範囲を指定するため、マーカーサイズの `Min` と `Max` を設定する必要があります。
+ **[Marker Shape]** を使用すると、データに追加のビジュアルコンテキストを提供するのに役立つ図形、アイコン、またはグラフィックを選択できます。シンプルな図形や Unicon ライブラリなど、Grafana に含まれているアセットから選択します。画像アセットを含む URL を指定することもできます。画像は SVG (Scalable Vector Graphics: スケーラブルベクトルグラフィック) である必要があります。
+ **[塗りつぶしの透明度]**: 各マーカーの透明度を設定します。

## ヒートマップレイヤー
<a name="v9-panels-geomap-heatmap"></a>

ヒートマップレイヤーは、さまざまなデータポイントをクラスター化して、密度の異なる場所を視覚化します。ヒートマップレイヤーを追加するには

[Data レイヤー] のドロップダウンメニューをクリックし、`Heatmap` を選択します。

`Markers` と同様に、視覚化するデータポイントとその視覚化方法を決定するオプションが表示されます。
+ **[重み値]** では、ヒートマップクラスターの強度を設定します。`Fixed value` は、すべてのデータポイントで一定の重み値を維持します。この値は 0～1 の範囲で設定します。マーカーと同様に、ドロップダウンには、データ値に応じて重み値を自動的にスケールする代替オプションがあります。
+ **[Radius]** (半径): ヒートマップクラスターのサイズを設定します。
+ **[Blur]** (ぼかし) では、各クラスターのぼかしの量を設定します。

## GeoJSON レイヤー
<a name="v9-panels-geomap-geojson"></a>

GeoJSON レイヤーを使用すると、ファイルシステムから静的 GeoJSON ファイルを選択してロードできます。
+ **[GeoJSON URL]** では、Grafana に付属する GeoJSON ファイルを選択できます。
+ **[デフォルトのスタイル]** では、上記のルールが一致しない場合に適用するスタイルを制御します。
  + **[色]** ではデフォルトのスタイルの色を設定します
  + **[不透明度]** ではデフォルトの不透明度を設定します
+ **[スタイルルール]** では、機能のプロパティに基づいてスタイルを適用します
  + **[ルール]** を使用すると、GeoJSON ファイルから*特徴量*、*条件*、および*[値]*を選択して、ルールを定義できます。ごみ箱アイコンを使用して、現在のルールを削除できます。
  + **[色]** では、現在のルールに対するスタイルの色を設定します
  + **[不透明度]** では、現在のルールの透明性レベルを設定します
+ **[スタイルルールの追加]** で、追加のスタイルルールを作成できます。

## CARTO レイヤー
<a name="v9-panels-geomap-carto"></a>

CARTO レイヤーは [CARTO](https://carto.com/about-us/) Raster ベースマップからのものです。

**オプション**
+ **Theme (テーマ)**

   **Light** テーマ、**Dark** テーマ、または **Auto** テーマのいずれかのテーマを選択します。
+ **[ラベルの表示]** で、マップの上部に国の詳細が表示されます。
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## XYZ タイルレイヤー
<a name="v9-panels-geomap-xyz"></a>

XYZ タイルレイヤーは、汎用タイルレイヤーからのマップです。

**注記**  
汎用タイルレイヤーの詳細については、「[Web マップのタイル化](https://en.wikipedia.org/wiki/Tiled_web_map)」および「[Open Street Map タイルサーバーの一覧](https://wiki.openstreetmap.org/wiki/Tile_servers)」を参照してください。

**オプション**
+ **URL テンプレート**
**注記**  
`https://tile.openstreetmap.org/{z}/{x}/{y}.png` など、\$1z\$1/\$1x\$1/\$1y\$1 が付いた有効なタイルサーバー URL を設定します。
+ **[Attribution]** (属性) では、[マップコントロール](#v9-panels-geomap-controls)に表示されるレイヤーのリファレンス文字列を設定します。
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## Open Street Map レイヤー
<a name="v9-panels-geomap-osm"></a>

[Open Street Map](https://www.openstreetmap.org/about) からのマップで、これは共同による無料の地理的世界データベースです。

**オプション**
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## ArcGIS レイヤー
<a name="v9-panels-geomap-arcgis"></a>

[ArcGIS](https://services.arcgisonline.com/arcgis/rest/services) レイヤーは、[ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS MapServer からのレイヤーです。

**オプション**
+ **サーバーインスタンス**で、次のマップタイプから選択します。
  + World Street Map (世界の道路地図)
  + World Imagery (衛星画像)
  + World Physical
  + Topographic (トポロジ)
  + USA Topographic (米国トポロジ)
  + World Ocean (海洋図)
  + Custom MapServer (書式設定については [XYZ](#v9-panels-geomap-xyz) を参照)
    + URL テンプレート
    + Attribution (属性)
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## 夜間/昼間レイヤー (アルファ）
<a name="v9-panels-geomap-nightday"></a>

夜間/昼間レイヤーには、現在の時間範囲に基づいて夜間および昼間の領域が表示されます。

**注記**  
詳細については、「[OpenLayers の拡張機能 - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)」を参照してください。

**オプション**
+ **[表示]** では、パネルの時間範囲から時間ソースを切り替えます
+ **[Night region color]** では、夜間領域の色を選択します
+ **[Display sun]** (太陽の表示) で太陽アイコンが切り替えられます
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## 写真レイヤー (アルファ)
<a name="v9-panels-geomap-photos"></a>

写真レイヤーは、各データポイントに写真をレンダリングします。

**注記**  
詳細については、「[OpenLayers の拡張機能 - 画像写真スタイル](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)」を参照してください。

**オプション**
+ **画像ソースフィールド**

  次のいずれかの形式で、画像データを含む文字列フィールドを選択します。
  + **画像 URL**
  + **Base64 でエンコードされた**バイナリ画像 (`data:image/png;base64,…`)
+ **[Kind]** (種類)

   画像の周りのフレームスタイルを選択します
  + **[Square]** (平方)
  + **[Circle]** (円形)
  + **[Anchored]** (アンカー)
  + **[Folio]** (フォリオ)
+ **[Crop]** (トリミング) では、画像がフィットするようにトリミングされるかどうか切り替えます
+ **[Shadow]** (シャドウ) では、画像の背後にあるボックスシャドウを切り替えます
+ **[Border]** (境界線) では、画像の周囲の境界サイズを設定します
+ **[境界線の色]** では、画像の周囲の境界線の色を設定します
+ **[Radius]** (範囲) では、画像の全体的なサイズをピクセル単位で設定します

## マップコントロール
<a name="v9-panels-geomap-controls"></a>

マップコントロールインターフェイスには、マップ情報とツールオーバーレイの以下のオプションが含まれています。

**Zoom**

このセクションでは、各ズームコントロールについて説明します。

*Show zoom control*

ズームコントロールを左上隅に表示します。

*Mouse wheel zoom*

マウスホイールを使用してズームインまたはズームアウトできる設定を、オンまたはオフにします。

**Show attribution**

マップ上のベースマップレイヤーの属性を表示します。

**Show scale**

スケール情報を左下隅に表示します。

**注記**  
[m]/[km] 単位で表示します。

**Show measure tools**

測定ツールを右上隅に表示します。測定値は、このコントロールが開いている場合にのみ表示されます。
+ **クリック**して測定を開始します
+ **連続クリック**で測定を続行します
+ **ダブルクリック**して測定を終了します

**注記**  
測定タイプまたは単位を変更すると、以前の測定がマップから削除されます。  
コントロールを閉じてから再度開くと、最新の測定値が表示されます。  
測定値は、クリックしてドラッグすることで変更できます。

*Length*

ジオメトリの球面長を取得します。この長さは、座標間の大圏距離の合計です。マルチパートジオメトリの場合、長さは各パートの長さの合計です。ジオメトリは「EPSG:3857」にあると仮定されます。

長さ測定には、次の単位を選択できます。
+ **メートル (m/km)**
+ **フィート (ft)**
+ **マイル (mi)**
+ **海里 (nmi)**

*[面積]*

ジオメトリの球の表面積を取得します。この面積は、ポリゴンエッジが球上の大円のセグメントであると仮定して計算されます。ジオメトリは「EPSG:3857」にあると仮定されます。

面積測定には、次の単位を選択できます。
+ **平方メートル (m²)**
+ **平方キロメートル (km²)**
+ **平方フィート (ft²)**
+ **平方マイル (mi²)**
+ **エーカー (acre)**
+ **ヘクタール (ha)**

**Show debug**

デバッグ情報をマップの右上隅に表示します。これは、データソースのデバッグまたは検証に役立ちます。
+ **[Zoom]** は、マップの現在のズームレベルを表示します。
+ **[Center]** (中央) には、マップ中央の現在の**経度**と**緯度**が表示されます。

**Tooltip** (ツールチップ)
+ **[なし]** では、データポイントがクリックされた場合にのみツールチップが表示されます。
+ **[Details]** (詳細) では、データポイントにポインタを合わせると、ツールチップが表示されます。

# グラフパネル
<a name="v9-panels-graph"></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-panels-graph-data-and-field-options"></a>

グラフ視覚化を使用すると、次のオプションを適用できます。
+  [[データを変換する]](v9-panels-xform.md) 
+ アラート。これはアラートを設定できる唯一の視覚化タイプです。詳細については、「[Grafana バージョン 9 のアラート](v9-alerts.md)」を参照してください。
+  [しきい値を設定する](v9-panels-configure-thresholds.md) 

## 表示オプション
<a name="v9-panels-graph-display-options"></a>

視覚化を絞り込むためには、次の設定を使用します。
+  **[棒]** – 値を棒グラフとして表示します。
+  **[線]** – 値を折れ線グラフとして表示します。
+  **[線の幅]** – 系列の線幅を指定します。デフォルトは 1 です。
+  **[階段]** – 隣接するポイントを階段として描画します。
+  **[領域塗りつぶし]** – シリーズの色塗りつぶし量を指定します。デフォルトは 1 で、0 はなしです。
+  **[塗りつぶしグラデーション]** – エリア塗りつぶしのグラデーションの程度を指定します。デフォルトは 0 で、グラデーションはありません。10 は急なグラデーションです。
+  **[ポイント]** – 値のポイントを表示します。
+  **[ポイント半径]** – ポイントの大きさを制御します。
+  **[アラートしきい値]** – アラートしきい値とリージョンをパネルに表示します。

### スタッキングおよび null 値
<a name="v9-panels-graph-stacking-and-null-value"></a>
+  **[スタック]** – 各シリーズが別のシリーズの上にスタックされます。
+  **[パーセント]** – 各系列が全系列の合計のパーセンテージとして描画されます。このオプションは **[スタック]** が選択されている場合に使用できます。
+  **[Null 値]** – null 値の表示方法を指定します。*これは重要な設定です。*以下の注記を参照してください。
  +  **[接続‭]** – 系列にギャップがある場合、つまり 1 つ以上の null 値がある場合、線はギャップをスキップして次の null 以外の値に接続します。
  +  **[null]** - 系列にギャップがある場合、つまり null 値の場合、グラフの線は分割されてギャップが表示されます。これはデフォルトの設定です。
  +  **[ゼロとしての null]** – シリーズにギャップがある場合、つまり null 値は、グラフパネルにゼロ値として表示されます。

**重要**  
サーバーの CPU 負荷をモニタリングしているときに負荷が 100% に達すると、サーバーはロックアップされ、統計情報を送信するエージェントは負荷統計を収集できなくなります。これによりメトリクスにギャップが生じ、デフォルトの *null* 設定を使用すると Amazon Managed Grafana にはギャップが表示され、何かが間違っていることを示します。これが*[接続]*に設定されていると、このシグナルを見逃しやすくなります。

### ホバー時のツールヒント
<a name="v9-panels-graph-hover-tooltip"></a>

これらの設定を使用して、グラフの視覚化上にカーソルを置いたときに表示されるツールヒントの外観を変更します。
+  **[モード]** - カーソルのツールチップに表示される系列数を決定します。
  +  **[すべての系列]** – カーソルのツールチップには、グラフ内の系列がすべて表示されます。Grafana ワークスペースは、ツールヒント内のシリーズリストで、一時停止しているシリーズを太字で強調表示します。
  +  **[単独]** – ツールチップには、カーソルを合わせている系列が 1 つだけ表示されます。
+  **[ソート順序]** – **[すべての系列]** モードを選択した場合、カーソルのツールチップにおいて系列の順序を並べ替えます。グラフで一時停止すると、Amazon Managed Grafana は線に関連付けられた値を表示します。一般的に、ユーザーは最大値や最小値に最も関心があります。これらの値をソートすると、目的のデータを簡単に見つけることができます。
  +  **[なし]** – ツールチップ内のシリーズ順序は、クエリのソート順序によって決まります。例えば、シリーズ名によりシリーズをアルファベット順にソートできます。
  +  **[増加]** – ホバー時のツールチップ内のシリーズは値が昇順にソートされ、リストの上部には最小値が表示されます。
  +  **[減少]** – ホバー時のツールチップ内のシリーズは値が降順にソートされ、リストの上部に最大値が表示されます。

## シリーズオーバーライド
<a name="v9-panels-graph-series-overrides"></a>

シリーズオーバーライドを使用すると、グラフパネル内の系列を他の系列とは異なるレンダリングにできます。表示オプションは、シリーズごとに、または正規表現ルールを使用してカスタマイズできます。例えば、1 つのシリーズで線の幅を太くして目立つようにしたり、右の Y 軸に移動したりできます。

シリーズオーバーライドは複数追加できます。

**シリーズオーバーライドの追加方法**

1. **[シリーズオーバーライドの追加]** を選択します。

1. **[エイリアスまたは正規表現]** で、シリーズを入力または選択します。フィールドを選択すると使用可能なシリーズのリストが表示されます。

   例えば、`/Network.*/` は `Network out` および `Network in` という名前の 2 つのシリーズと一致します。

1. **[\$1]** を選択してからシリーズに適用するスタイルを選択します。各エントリには複数のスタイルを追加できます。
+  **[棒]** – 系列を棒グラフとして表示します。
+  **[折れ線]** – シリーズを折れ線グラフとして表示します。
+  **[折れ線塗りつぶし]** – 領域塗りつぶしで折れ線グラフを表示します。
+  **[塗りつぶしグラデーション]** – 領域塗りつぶしグラデーション量を指定します。
+  **[線の幅]** – 線幅を設定します。
+  **[Null ポイントモード]** – このオプションを使用して null 値を無視、またはゼロに置き換えます。これはデータ内ののギャップを無視する場合に重要です。
+  **[下を塗りつぶし]** – 2 つのシリーズ間の領域を塗りつぶします。
+  **[階段線]** — シリーズを階段線として表示します。
+  **[ダッシュ]** – ダッシュで線を表示します。
+  **[シリーズを非表示]** – シリーズを非表示にします。
+  **[ダッシュ長さ]** – 線内のダッシュの長さを設定します。
+  **[ダッシュスペース]** – 線内のダッシュ間のスペースの長さを設定します。
+  **[ポイント]** – 個別のポイントとして系列を表示します。
+  **[ポイント半径]** – ポイントのレンダリング半径を設定します。
+  **[スタック]** – シリーズのスタックグループを設定します。
+  **[色]** – シリーズの色を設定します。
+  **[Y 軸]** – 系列の Y 軸を設定します。
+  **[Z インデックス]** – 系列の z インデックス (レンダリング順序) を設定します。このオプションは、棒グラフや面グラフなどの、さまざまなスタイルをオーバーレイする場合に重要です。
+  [変換] – 負の値に変換して Y 軸の下にレンダリングします。
+  **[凡例]** – 凡例内にシリーズを表示するかどうかを制御します。
+  **[ツールヒントで非表示]** – グラフのツールヒントにシリーズを表示するかどうかを制御します。

## [Axes] (軸)
<a name="v9-panels-graph-axes"></a>

これらのオプションを使用して、視覚化内の軸表示を制御します。

### [Left Y]/[Right Y]
<a name="v9-panels-graph-left-yright-y"></a>

オプションは両方の Y 軸で同じです。
+  **[表示]** – 軸の表示または非表示を選択します。
+  **[単位]** – Y 値の表示単位を選択します。
+  **[スケール]** – Y 値に使用するスケールを、**[線形]**、または **[対数]** から選択します。デフォルトは **[線形]** です。
+  **[Y 最小]** – Y の最小値です。デフォルトは **[自動]** です。
+  **[Y 最大]** – Y の最大値です。デフォルトは **[自動]** です。
+  **[小数]** – Y 値に表示される小数点以下の桁数を定義します。デフォルトは **[自動]** です。
+  **[ラベル]** – Y 軸のラベルを指定します。デフォルトは [“",] です

### Y 軸
<a name="v9-panels-graph-y-axes"></a>
+  **[配置]** – 左右の Y 軸を値で配置します。デフォルトは [未チェック/偽] です。
+  **[レベル]** – Y=0 から始まる、左右の Y 軸の配置に使用する値を入力します。デフォルトは 0 です。このオプションは、**[配置]** が選択されている場合に使用できます。

### X 軸
<a name="v9-panels-graph-x-axis"></a>
+  **[表示]** – 軸の表示または非表示を選択します。
+  **[モード]** – 表示モードではグラフパネルの視覚化が完全に変更されます。3 つのパネルを 1 つにしたようなものです。メインモードは、X 軸の時間による時系列モードです。他の 2 つのモードは、時間とヒストグラムのモードではなく、X 軸上のシリーズ使用する基本的な棒グラフモードです。
  +  **[時間]** (デフォルト) – X 軸は時間を表し、データは時間 (時間、分など) でグループ化されます。
  +  **[系列]** – データは時間ではなく系列でグループ化されます。Y 軸は引き続き値を表します。
    +  **[値]** – これは値のために使用する集計タイプです。デフォルトは **[合計]** (値を合計) です。
  +  **[ヒストグラム]** – このオプションではグラフをヒストグラムに変換します。ヒストグラムは数値を範囲にグループ化する棒グラフの一種で、バケットやビンとも呼ばれます。背の高い棒は、より多くのデータがその範囲内にあることを示します。

    ヒストグラムの詳細については、「[ヒストグラムおよびヒートマップの概要](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)」を参照してください。
    +  **[バケット]** – 値をグループ化するためのバケットの数を設定します。空にすると、Amazon Managed Grafana は適切な数のバケットを計算しようとします。
    +  **[X 最小]** – この下限未満のヒストグラムから値をフィルタリングします。
    +  **[X 最大]** – この上限を超える値をフィルタリングします。

## 凡例
<a name="v9-panels-graph-legend"></a>

これらの設定を使用して、グラフ内の凡例の表示方法を改善します。

### オプション
<a name="v9-panels-graph-legends-options"></a>
+  **[表示]** – クリアすると凡例は非表示になります。デフォルトが選択されます (真)。
+  **[テーブルとして]** – 選択すると凡例がテーブルに表示されます。デフォルトがチェックされます (真)。
+  **[右側]** - 選択すると右側に凡例が表示されます。
+  [幅] – 凡例の最小幅をピクセル単位で入力します。このオプションは、**[右側]** を選択した場合に使用できます。

### 値
<a name="v9-panels-graph-values"></a>

凡例名の横に追加の値を表示できます。
+  **[最小]** – メトリクスクエリから返される最小値です。
+  **[最大]** – メトリクスクエリから返される最大値です。
+  **平均** – メトリクスクエリから返される平均値です。
+  **[現在]** – メトリクスクエリから返された最後の値です。
+  **[合計]** – メトリクスクエリから返されるすべての値の合計です。
+  **[小数]** – 凡例値およびグラフカーソルのツールチップに表示される小数点以下の桁数です。

Amazon Managed Grafana はクライアント側の凡例値を計算します。これらの凡例値は、メトリクスクエリが使用している集計またはポイント統合のタイプによって異なります。上記の凡例値がすべて同時に正確になることはありません。

例えば、おそらく平均をアグリゲーターとして使用する、リクエスト/秒の割合などをプロットする場合、凡例の合計はリクエストの合計数を表しません。これは Amazon Managed Grafana が受信したすべてのデータポイントの合計にすぎません。

### シリーズの非表示
<a name="v9-panels-graph-hide-series"></a>

メトリクスクエリからのシリーズの値すべてが特定の値であるときに、シリーズを非表示にします。
+  **[null のみを使用]** – Value=null (デフォルトは未チェック)
+  **[ゼロのみを使用]** – Value=ゼロ (デフォルトは未チェック)

### 時間リージョン
<a name="v9-panels-graph-time-regions"></a>

週末、営業時間、勤務時間外など、グラフ上の特定の時間リージョンを強調表示して見やすくできます。設定されたすべての時間リージョンは UTC 時間です。

# ヒートマップパネル
<a name="v9-panels-heatmap"></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)」を参照してください。

ヒートマップパネルの視覚化により、ヒストグラムを経時的に表示できます。ヒストグラムの詳細については、「[ヒストグラムおよびヒートマップの概要](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)」を参照してください。

## データから計算する
<a name="v9-panels-heatmap-calculate"></a>

この設定は、データが既に計算されたヒートマップ (データソース/トランスフォーマーから) であるか、パネルで計算する必要があるヒートマップであるかを決定します。

**X バケット**

この設定は、X 軸をバケットに分割する方法を決定します。**サイズ**入力で時間間隔を指定できます。例えば、`1h` の時間範囲により、セルは X 軸で 1 時間幅になります。

**Y バケット**

この設定は、Y 軸をバケットに分割する方法を決定します。

**Y バケット目盛**

次のいずれかの Y 軸値目盛を選択します。
+ **[線形]** – 線形目盛。
+ **[log (base 2)]** – 底が 2 の対数目盛。
+ **[log (base 10)]** – 底が 10 の対数目盛。

## Y 軸
<a name="v9-panels-heatmap-y-axes"></a>

Y 軸の表示方法を定義します。

 **[配置]**
+ **[左]** – 左側
+ **[Right]** – 右側
+ **[非表示]** – 非表示

**[単位]**

単位設定

**[小数]**

この設定により、小数点以下の設定が決まります。

**[最小/最大値]**

この設定では、軸範囲を設定します。

**[Reverse]** (逆順)

選択すると、軸は逆の順序で表示されます。

## カラー
<a name="v9-panels-heatmap-colors"></a>

色のスペクトルは、値の数 (各バケット内) と各バケットに割り当てられた色間とのマッピングを制御します。スペクトルの左端の色は最低数を表し、右端の色は最大数を表します。一部のカラースキームは、ライトテーマを使用するときに自動的に反転されます。

また、カラーモードを [不透明度]‭ に変更することもできます。この場合、色は変わりませんが、不透明度はバケット数に応じて変化します。
+ **モード**
  + **[Scheme]** (スキーム) – セルの色で表されるバケット値。
    + **[Scheme]** – モードが**スキーム**の場合、カラースキームを選択します。
  + **[不透明度]** – セルの不透明度で表されるバケット値。[Opaque] (不透明) セルは最大値を意味します。
    + **[Color]** – セルのベース色。
    + **[Scale]** (目盛) – バケット値を不透明度にマッピングするための目盛。
      + **[線形]** – 線形目盛。バケット値は不透明度に対して直線的にマッピングされます。
      + **[sqrt]** (平方根) – 対数目盛。セルの不透明度は `value ^ k` として計算され、`k` は設定された**指数**値です。指数が `1` より小さい場合、対数スケールが表示されます。指数が `1` より大きい場合、指数スケールが表示されます。`1` の場合、目盛は線形と同じになります。
    + **[Exponent]** – 指数の値 (`0` より大きい場合)。

**[値を元にした開始/終了の色]**

デフォルトでは、Grafana は最小および最大バケット値に基づいてセルの色を計算します。[最小値] と [最大値] では、これらの値を上書きできます。バケット値は Z 軸、最小値と最大値はそれぞれ Z の最小値と Z の最大値と考えてください。
+ **[開始値]** – セルの色の計算に使用される最小値。バケット値が最小値より小さい場合、「最小値」の色にマッピングされます。系列の最小値はデフォルト値です。
+ **[終了値]** – セルの色の計算に使用される最大値。バケット値が最大値より大きい場合、「最大値」の色にマッピングされます。系列の最大値はデフォルト値です。

## セル表示
<a name="v9-panels-heatmap-cell"></a>

セル表示設定を使用して、ヒートマップ内のセルの視覚化を絞り込みます。

## 追加の表示オプション
<a name="v9-panels-heatmap-options"></a>

**Tooltip** (ツールチップ)
+ **[Show tooltip]** - ヒートマップのツールチップを表示します。
+ **[Show Histogram]** – ツールチップに Y 軸のヒストグラムを表示します。ヒストグラムは、特定のタイムスタンプにおけるバケット値の分布を表します。

**[凡例]**

視覚化にヒートマップの凡例を表示するかどうかを選択します。

**Exemplars** (見本)

見本データの表示に使用する色を設定します。

# ヒストグラムパネル
<a name="v9-panels-histogram"></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)」を参照してください。

ヒストグラムの視覚化は値の分布を計算して棒グラフとして表示します。Y 軸と各バーの高さは各括弧に含まれる値の数を表し、X 軸は値の範囲を表します。

ヒストグラムの視覚化では、1 つ以上の数値フィールドを持つ時系列とテーブル結果をサポートしています。

## サポートされる形式
<a name="v9-panels-histogram-formats"></a>

ヒストグラムの視覚化では、1 つ以上の数値フィールドを持つ時系列とテーブル結果をサポートしています。

## 表示オプション
<a name="v9-panels-histogram-options"></a>

これらのオプションで、視覚的表現の内容を絞り込みます。

**[バケットサイズ]**

バケットのサイズです。自動バケットサイズ設定 (全範囲の 10% まで) では、この値は空のままにします。

**[バケットオフセット]**

最初のバケットを 0 で始めない場合です。ゼロ以外のオフセットでは集計ウィンドウがシフトします。例えば、デフォルトの 0 オフセットの 0～5、5～10、10～15 の 5 サイズのバケットは、オフセット 2 の 2～7、7～12、12～17 になる場合があります。この場合、オフセット 0、5、10 であれば事実上何も実行されません。通常、このオプションは自動ではなく、明示的に定義されたバケットサイズで使用します。この設定が作用するためには、オフセット量を 0 より大きく、バケットサイズより小さくする必要があります。この範囲外の値には、この範囲内の値と同じ効果があります。

**[系列の結合]**

これにより、すべての系列とフィールドが結合されたヒストグラムにマージされます。

**[線の幅]**: 棒の線幅を制御します。

**[塗りつぶしの不透明度]**: 棒の塗りつぶし不透明度を制御します。

**[グラデーションモード]**: グラデーション塗りつぶしモードを設定します。塗りつぶしグラデーションは線の色を基準にします。色を変更するには、標準のカラースキームフィールドオプションを使用します。グラデーションの外観は[塗りつぶしの不透明度]設定の影響を受けます。
+  **[なし]** – グラデーション塗りつぶしなし。これはデフォルト設定です。
+  **[不透明度]** – グラデーションの透明度は Y 軸の値に基づいて計算されます。Y 軸の値とともに塗りつぶしの不透明度が増加します。
+  **[色相]** – グラデーション色は線の色相に基づいて生成されます。

**[ツールチップモード]** グラフにカーソルを合わせると、Grafana はツールチップを表示できます。ツールチップの動作を選択します。
+  **[単独]** – ツールチップには、カーソルを合わせている系列のみが表示されます。
+  **[すべて]** – ホバー時のツールチップには視覚化のすべてのシリーズが表示されます。Grafana は、ツールチップの系列一覧で、カーソルを合わせている系列を太字で強調表示します。
+  **[非表示]** – ツールチップを表示しません。

**注記**  
オーバーライドを使用して、ツールチップから個々の系列を非表示にします。

## 凡例オプション
<a name="v9-panels-histogram-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの [カラースキーム] オプションを [単一色] または [クラシックパレット] に設定することが重要です。凡例にしきい値の括弧を表示するには、カラースキームを [しきい値起点] に設定します。

**[凡例モード]** – これらの設定を使用して視覚化内の凡例の表示方法を改善します。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

**[凡例の配置]** 凡例を配置する場所を選択します。
+  **[Bottom]** – グラフの下。
+  **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する標準計算を選択します。複数選択できます。詳細については、「[計算タイプ](v9-panels-calculation-types.md)」を参照してください。

**[凡例計算]**

凡例に表示する計算を選択します。複数選べます。

# ログパネル
<a name="v9-panels-logs"></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)」を参照してください。

ログパネルの視覚化では、Elastic、Influx、Loki などのログをサポートするデータソースのログ行が表示されます。通常、グラフパネルの横のこのパネルを使用して、関連するプロセスのログ出力を表示します。

ログパネルには、**[Query]** タブに入力されたクエリの結果が表示されます。複数のクエリ結果がマージされ、時間別にソートされます。表示可能な行よりも多くの行がデータソースから返される場合は、パネル内でスクロールできます。

レンダリングされる行数を制限するには、**[クエリオプション]**で **[最大データポイント数]** の設定を使用できます。設定しない場合、データソースは通常デフォルトの制限を適用します。

## ログレベル
<a name="v9-panels-logs-level"></a>

**レベル**ラベルが指定されているログの場合、ラベルの値を使用してログレベルを決定し、それに応じて色を更新します。ログに指定されたレベルラベルがない場合、そのコンテンツが、サポートされている表現のいずれかと一致するかどうかを調べます (詳細については、下記を参照してください)。ログレベルは常に最初の一致によって決まります。Grafana がログレベルを判別できない場合、**不明な**ログレベルとして視覚化されます。詳細については、「[ログの視覚的表現](v9-explore-logs.md#v9-explore-logs-viz)」を参照してください。

## ログの詳細
<a name="v9-panels-logs-details"></a>

各ログ行には、より堅牢なインタラクションのために、ラベルと検出されたフィールドを含む拡張可能な領域があります。各フィールドまたはラベルには、表示されているすべてのログに関連する統計を表示する統計アイコンがあります。

**データリンク**

データリンクを使用すると、ログメッセージの任意の部分を内部リンクまたは外部リンクに変換できます。作成されたリンクは、**[ログの詳細]** ビュー内の **[リンク]** セクションにボタンとして表示されます。

**表示オプション**

以下の設定を使用して、視覚化する内容を絞り込みます。
+  **[時間]** – 時間列を表示または非表示にします。これはデータソースから報告されたログ行と関連するタイムスタンプです。
+  **[一意のラベル]** – 一意のラベル列を表示または非表示にします。この列には、共通ではないラベルのみが表示されます。
+ **[共通ラベル]** - を表示または非表示にします
+  **[行の折り返し]** – 行の折り返しを切り替えます。
+ **[Prettify JSON]** – すべての JSON ログを pretty print (整形表示) するには、これを `true` に設定します。この設定は、JSON 以外の形式のログには影響しません。
+ **[ログ詳細の有効化]** – オプションを切り替えて、各ログ行のログ詳細ビューを表示します。デフォルトの設定は `true` です。
+  **[Order]** (順序) – 結果を降順または昇順で表示します。デフォルトは **[降順]** で、最新のログが最初に表示されます。**[昇順]** に設定すると最も古いログ行が最初に表示されます。

# ニュースパネル
<a name="v9-panels-news"></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)」を参照してください。

このパネルには RSS フィードが表示されます。デフォルトでは、Grafana Labs のブログ記事が表示されます。

**[表示]** セクションに RSS の URL を入力します。このパネルタイプは他のクエリを受け入れません。

**注記**  
RSS フィードは、プロキシなしで Grafana フロントエンドによって読み込まれます。その結果、適切な [CORS ヘッダー](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)で設定された RSS フィードのみが読み込まれます。表示しようとしている RSS フィードが読み込みに失敗する場合は、RSS フィードを再ホストするか、独自のプロキシ作成を検討してください。

# ノードグラフパネル
<a name="v9-panels-node-graph"></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-panels-node-graph-requirements"></a>

ノードグラフのパネルでは、ノードとエッジを表示するためにデータの特定の形状が必要です。このパネルでは、すべてのデータソースやクエリを視覚化できるわけではありません。

ノードグラフの視覚化は、*ノード*および*エッジ*で構成されます。
+ ある*ノード*は円として表示されます。あるノードは、アプリケーション、サービス、またはアプリケーションの観点から関連するその他のものを表す場合があります。
+ ある*エッジ*は、2 つのノードを接続する線として表示されます。接続は、リクエスト、オペレーション、または 2 つのノード間の他の関係である場合があります。

ノードとエッジの両方にメタデータまたは統計を関連付けることができます。データソースは、表示される情報と値を定義するため、異なるデータソースが異なるタイプの値を表示したり、一部の値を表示しなかったりすることができます。

## ノード
<a name="v9-panels-node-graph-nodes"></a>

通常、ノードには、ノード内の 2 つの統計値とノードのすぐ下の 2 つの識別子、通常は名前とタイプが表示されます。ノードでは、ノードの周囲に一連の別の値を色付きの円として表示することもできます。異なる色のセクションは、合計が 1 になる異なる値を表します。例えば、円の赤い部分によってエラーの割合を表すことができます。

ノードを選択すると表示されるコンテキストメニューには、さらに詳細を表示できます。Grafana ワークスペースの他の部分または外部リンクをターゲットにできる追加のリンクを、コンテキストメニューに含めることもできます。

**注記**  
ノードグラフには 1,500 個のノードしか表示できません。この制限を超えると、右上隅に警告が表示され、一部のノードは非表示になります。グラフ内の **[非表示ノード]** マーカーをクリックすると、グラフの非表示部分を展開できます。

## エッジ
<a name="v9-panels-node-graph-edges"></a>

エッジでは、エッジにカーソルを合わせると統計を表示することもできます。ノードと同様に、エッジを選択すると、追加の詳細とリンクを含むコンテキストメニューを開けます。

この視覚化をサポートする最初のデータソースは、サービスマップ機能の AWS X-Ray データソースです。詳細については、「[AWS X-Ray データソースに接続する](x-ray-data-source.md)」を参照してください。

## ノードグラフの操作方法
<a name="v9-panels-node-graph-navigation"></a>

ノードグラフ内でパンするには、ノードまたはエッジの外部を選択してポインタをドラッグします。

ノードグラフの左上隅にあるボタンを使用するとズームできます。

**非表示ノード**

特定の時間に表示されるノードの数は、合理的なパフォーマンスを維持するために制限されます。この制限外のノードは、そのエッジに接続されている非表示ノードのおよその数を示すクリック可能なマーカーの背後に隠されます。マーカーを選択して、そのノードの周りのグラフを展開できます。

**グリッドビュー**

グリッドビューに切り替えて、グラフ内の最も興味深いノードの概要を把握できます。グリッドビューは、エッジのないグリッド内のノードを表示し、ノード内に表示される統計、またはノードの色付き境界で表される統計でソートできます。

ノードをソートするには、凡例内の統計を選択します。統計名の横にあるマーカーは、ソートおよびソート方向に現在使用されている統計を示します。

ノードを選択し、**[グラフレイアウトで表示]** オプションで、選択したノードに焦点を当ててグラフレイアウトに切り替え、グラフ全体のコンテキストで表示します。

## Data API
<a name="v9-panels-node-graph-data-api"></a>

この視覚化では、正しく表示するために、データソースから返されるデータの特定の形状が必要です。

ノードグラフには、少なくともグラフのエッジを記述するデータフレームが必要です。デフォルトでは、ノードグラフはこのデータフレームに基づいてノードと統計を計算します。必要に応じて、ノード固有のメタデータをより多く表示する必要がある場合に備えて、ノードを記述する 2 番目のデータフレームを送信できます。ノードグラフをレンダリングするには、両方のデータフレームに `frame.meta.preferredVisualisationType = 'nodeGraph'` を設定するか、`nodes` と `edges` にそれぞれ名前を付ける必要があります。

**構造からのエッジデータ**

必須フィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
|  id  |  string  |  エッジの一意の識別子。  | 
|  ソース  |  string  |  ソースノードの ID。  | 
|  target  |  string  |  ターゲットの ID。  | 

オプションのフィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
|  Mainstat  |  文字列/数値  |  エッジにカーソルを合わせたときのオーバーレイに表示される最初の統計。値はそのまま示す文字列でも、数値でもかまいません。数値の場合、そのフィールドに関連付けられている単位も表示されます。  | 
|  secondarystat  |  文字列/数値  |  mainStat と同じですが、そのすぐ下に表示されます。  | 
|  detail\$1\$1\$1  |  文字列/数値  |  プレフィックスが `detail__` の任意のフィールドは、エッジをクリックするとコンテキストメニューのヘッダーに表示されます。より判読可能なラベルに `config.displayName` を使用します。  | 

**構造からのノードデータ**

必須フィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
|  id  |  string  |  ノードの一意の識別子。この ID は、ソースフィールドとターゲットフィールドのエッジによって参照されます。  | 

オプションのフィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
|  title  |  string  |  ノードのすぐ下に表示されるノードの名前。  | 
|  subtitle  |  string  |  タイトルの下に表示される追加の名前、タイプ、またはその他の識別子。  | 
|  mainstat  |  文字列/数値  |  ノード自体の中に表示される最初の統計。これは、値をそのまま表示する文字列でも数値でもかまいません。数値の場合、そのフィールドに関連付けられている単位も表示されます。  | 
|  secondarystat  |  文字列/数値  |  mainStat と同じですが、ノード内でその下に表示されます。  | 
|  arc\$1\$1\$1  |  数値  |  プレフィックスが `arc__` の任意のフィールドは、ノードの周囲に色円を作成するために使用されます。これらのフィールドのすべての値は、合計で 1 になる必要があります。`config.color.fixedColor` を使用して色を指定できます。  | 
|  detail\$1\$1\$1  |  文字列/数値  |  ノードをクリックすると、プレフィックスが `detail__` の任意のフィールドがコンテキストメニューのヘッダーに表示されます。より人間が判読可能なラベルに `config.displayName` を使用します。  | 

# 円グラフパネル
<a name="v9-panels-piechart"></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 つ以上のクエリから誘導された系列、または系列内の値が、円グラフのスライスで相互に関連して表示されます。スライスの円弧の長さ、面積、中心角度は、すべての値の合計に関連するため、すべてスライス値に比例します。この種類のグラフは、一連の小規模な値を見た目がきれいな形ですばやく比較する場合に最適です。

## 値オプション
<a name="v9-panels-piechart-value"></a>

次のオプションを使用して、視覚化に使う値を絞り込みます。

**[表示]**

表示する情報量を選択します。
+ **[計算]** – 各値を系列ごとに単一の値に減らします。
+ **[すべての値]** – 1 つの系列におけるすべての値を表示します。

**計算**

計算を選択すると、各系列を削減する計算を選択できます。使用可能な計算の詳細については、「[計算タイプ](v9-panels-calculation-types.md)」を参照してください。

**[制限]**

1 つの系列におけるすべての値を表示する場合、表示される値の数には制限があります。

**フィールド**

視覚化するフィールドを 1 つ以上選択します。各フィールド名はリストで確認できます。または、次のいずれかのオプションを選択できます。
+ **[数値フィールド]** – 数値を持つすべてのフィールド。
+ **[すべてのフィールド]** – 変換によって削除されないすべてのフィールド。
+ **[時間]** – 時間値を持つすべてのフィールド。

## 円グラフオプション
<a name="v9-panels-piechart-options"></a>

これらのオプションで、視覚化の見え方を調整します。

**円グラフタイプ**

円グラフの表示スタイルを選択します。次のいずれかになります。
+ **[Pie]** (円) – 標準円グラフ
+ **[Donut]** (ドーナツ) – 中央に穴がある円グラフ

**ラベル**

円グラフに表示するラベルを選択します。複数選べます。
+ **[名前]** – 系列名またはフィールド名。
+ **[パーセント]** – 全体の割合。
+ **[Value]** – 未加工の数値。

デフォルトでは、ラベルはグラフ部分の上に白で表示されます。グラフの色を濃く選択して、より見やすくすることができます。長い名前や数字は文字切れする可能性があります。

**[ツールチップモード]**

視覚化にカーソルを合わせると、Grafana はツールチップを表示できます。ツールチップの動作を選択します。
+ **[単独]** – ツールチップには、グラフ上でカーソルを合わせている系列が 1 つだけ表示されます。
+ **[すべて]** – ツールチップには、グラフ内のすべての系列が表示されます。Grafana は、ツールチップの系列一覧で、カーソルを合わせている系列を太字で強調表示します。
+ **[非表示]** – グラフを操作するときにツールチップを表示しません。

オーバーライドを使用して、ツールチップから個々の系列を非表示にします。

**[凡例モード]**

これらの設定を使用して、グラフで凡例がどのように表示されるかを定義します。凡例の詳細については、[「凡例の設定」](v9-panels-configure-legend.md)を参照してください。
+ **[リスト]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+ **[テーブル]** – 凡例をテーブルとして表示します。
+ **[非表示]** – 凡例を非表示にします。

**[凡例の配置]**

凡例を表示する場所を選択します。
+ **[Bottom]** – グラフの下。
+ **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する[標準計算](v9-panels-calculation-types.md)を選択します。複数選択できます。

凡例に表示する値を選択します。複数選べます。
+ **[パーセント]** – 全体の割合。
+ **[Value]** – 未加工の数値。

凡例の詳細については、「[凡例の設定](v9-panels-configure-legend.md)」を参照してください。

# Plotly パネル
<a name="v9-panels-plotly"></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)」を参照してください。

Plotly パネルは、オープンソースの javascript グラフ作成ライブラリである [Plotly](https://plotly.com/javascript/) を使用してグラフをレンダリングします。

**データ**、**レイアウト**、および**設定** フィールドは、「[Plotly ドキュメント](https://plotly.com/javascript/plotlyjs-function-reference/)」で説明されている一般的なパラメータと一致します。これらは JSON 形式である必要があります。

データソースによって提供されるデータは、Plotly グラフに挿入される前に、ユーザー定義スクリプトを介して変換できます。スクリプトには 2 つの引数が含まれます。
+ `data` – データソースから返されるデータ。
+ `variables` – 現在のダッシュボードに [Grafana 変数](templates-and-variables.md)を含むオブジェクト (ユーザー変数と、グローバル変数である `__from`、`__to`、`__interval`、`__interval_ms`)。

スクリプトは、`data`、`layout`、`config`、`frames` のプロパティから 1 つ以上を有するオブジェクトを返す必要があります。以下に例を示します。

```
let x  = data.series[0].fields[0].values.buffer
let y  = data.series[0].fields[1].values.buffer
let serie = {
    x : x,
    y : y,
    name : variables.project //where project is the name of a Grafana’s variable
}

return {
    data : [serie],
    config : {
    displayModeBar: false
    }
}
```

*データ*、*レイアウト*、および *設定* フィールドで指定されたスクリプトと JSON によって返されるオブジェクトはマージされます (ディープマージ)。

スクリプトが指定されていない場合、パネルは*データ*、*レイアウト*、および *設定* フィールドのみを使用します。

# サンキーパネル
<a name="v9-panels-sankey"></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 つのグループを含むサンキーダイアグラムを示しています。

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/sankey-panel.png)


**仕組み**

サンキーパネルには、フローのソースとターゲットの 2 つ以上の列のデータが必要です。クエリは、データを少なくとも 2 つのグループにグループ化する必要があります。パネルは、データポイントの最初の列からクエリの順序で最後の列へのリンクを描画します。リンクの厚さは、クエリ内のメトリクスによって割り当てられた値に比例します。

**カスタマイズ**
+ **リンク** – 現在、リンクの色にはマルチまたはシングルの 2 つのオプションがあります。デフォルトでは、マルチカラーです。リンクの単一色を選択するには、**[単一リンクの色のみ]**オプションを切り替え、Grafana のカラーピッカーから色を選択します。
+ **[ノード]** – **[ノードの色]** オプションを変更することで、長方形ノードの色を変更できます。
+ **[ノード幅]** – ノードの幅は、**[ノード幅]** スライダーで調整するか、入力ボックスに数値を入力することで調整できます。数値は整数である必要があります。
+ **[ノードパディング]** – ノード間の垂直パディングは、**[ノードパディング]** スライダーで調整するか、入力ボックスに数値を入力することで調整できます。数値は整数である必要があります。リンクが細すぎる場合は、この数値を調整してみてください。
+ **ヘッダー** – 列ヘッダーは、エディタパネルの **[表示名]** オーバーライドを使用して変更できます。**[テキスト色]** で選択した色と同じ色になります
+ **[サンキーレイアウト]** – サンキーリンクのレイアウトは、**[レイアウト反復]** スライダーを使用して微調整できます。この数は整数でなければならず、レイアウトの生成に使用される緩和反復の数です。

# 散布図パネル
<a name="v9-panels-scatter"></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)」を参照してください。

散布図パネルは、他のグラフパネルよりもシンプルなインターフェイスを持つテーブルデータの X/Y 散布図を示しています。グラフパネルとは異なり、散布図パネルではデータが時系列に含まれる必要はありません。散布図パネルには、データの 2 つ以上の数値列を含むテーブル形式のデータセットが必要です。

これらのいずれかを X 軸に割り当てることができます。1 つ以上を一連の Y 軸値に割り当てることができ、その結果データは一連の点としてプロットされます。各系列では、オプションで、統計に基づく複数のベストフィットのいずれかを使用して回帰線を表示することもできます。

**散布図の作成**

次の手順では、散布図パネルを使用して散布図を作成する方法について説明します。この例では、次の表のように、年齢別の男の子と女の子の平均身長を示す数値 `Age`、`Boys`、`Girls` の 3 つの列を持つ `HEIGHT` で呼び出されるデータがあると想定します。


| 年齢 | 男の子の身長 | 女の子の身長 | 
| --- | --- | --- | 
|  5  |  109.7  |  109.5  | 
|  6  |  115.6  |  115.4  | 
|  7  |  121.1  |  120.8  | 
|  8  |  126.3  |  126  | 
|  9  |  131.3  |  131.3  | 
|  10  |  136.2  |  137.1  | 
|  11  |  141.2  |  143.2  | 
|  12  |  147  |  148.7  | 
|  13  |  153.6  |  152.6  | 
|  14  |  159.9  |  155.1  | 
|  15  |  164.4  |  156.7  | 
|  16  |  167.3  |  157.6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158.3  | 
|  19  |  170.8  |  158.6  | 

**散布図パネルを使用して散布図を作成するには**

1. Grafana ダッシュボードで、**[パネルの追加]** を選択します。

1. [クエリ] には、必要なデータを返すクエリを書き込みます。この場合、`SELECT * FROM HEIGHT` などのクエリを使用します。

1. **[散布図]** での視覚化を選択します。

これにより、最初の列を X 軸として使用し、他の数値列を Y 軸として使用して散布図が作成されます。

**設定オプション**

散布図パネルには、次の 4 つのカスタム設定オプションが用意されています。
+ **[X 軸]** – X 軸として使用するフィールド、軸の範囲とタイトル、および表示情報を選択できます。
+ **[Y 軸]** – 各フィールドの表示オプション、軸の範囲とタイトル情報など、Y 軸に表示するフィールドを選択できます。また、各フィールドの回帰線を表示することもできます。回帰線設定の詳細については、以下の情報を参照してください。
+ **[凡例]** – パネルの凡例をオンまたはオフにしたり、凡例内のテキストサイズを選択したりできます。
+ **[表示]** – グリッドの色や境界スタイルなど、グラフの他のオプションを設定できます。

**回帰線の設定**

各 Y 軸データセットには、個々の点に加えて線を表示できます。線タイプには 5 つのオプションがあります。
+ **[なし]** – 回帰線を表示しません。
+ **[単純]** – データセットポイントを接続する回帰線を表示します。
+ **[線形]** – 最小二乗法、ベストフィット方式を使用して直線を表示します。
+ **[指数]** – 指数のベストフィット回帰線を表示します。
+ **[累乗]** – 累乗のベストフィット回帰線を表示します。

# 統計パネル
<a name="v9-panels-stat"></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 つの大きな統計値を表示します。しきい値を使用して背景または値の色を制御できます。

デフォルトでは、統計パネルには次のいずれかが表示されます。
+ 単一の系列またはフィールドの値のみ。
+ 複数の系列またはフィールドの値と名前の両方。

**テキストモード**を使用して、テキストが表示されるかどうかを制御できます。

## 自動レイアウト調整
<a name="v9-panels-stat-automatic-adjust"></a>

パネルは、ダッシュボードで使用可能な幅と高さに応じてレイアウトを自動的に調整します。パネルが小さすぎると、グラフ (スパークライン) が自動的に非表示になります。

## 値オプション
<a name="v9-panels-stat-value"></a>

次のオプションを使用して、視覚化で値を表示する方法を絞り込みます。

**[表示]**

Grafana がデータを表示する方法を選択します。

**[計算]**

すべての行を元に計算した値を表示します。
+ **[計算]** – Grafana が多くのフィールドを 1 つの値に減らすために使用する reducer 関数を選択します。使用可能な計算のリストについては、「[標準計算](v9-panels-calculation-types.md)」を参照してください。
+ **[フィールド]** – パネルに表示されるフィールドを選択します。

**[すべての値]**

行ごとに個別の統計を表示します。このオプションを選択すると、表示する行数を制限することもできます。
+ **[制限]** – 表示する行の最大数。デフォルトは 5,000 です。
+ **[フィールド]** – パネルに表示されるフィールドを選択します。

## 統計スタイル
<a name="v9-panels-stat-styles"></a>

視覚化のスタイルを変更します。

**[Orientation]** (向き)

積み重ね方向を選択します。
+ **[自動]** – Grafana が最適な方向を選択します。
+ **[水平]** – バーは水平方向に左から右に伸びます。
+ **[垂直]** – バーは垂直に上から下に伸びます。

**テキストモード**

テキストモードオプションを使用して、パネルがレンダリングするテキストを制御できます。値が重要ではなく、名前と色のみが重要である場合は、**[テキストモード]** を **[名前]** に変更します。値は色を決定するために引き続き使用され、ツールチップに表示されます。
+ **[自動]** – データに複数の系列またはフィールドが含まれている場合は、名前と値の両方を表示します。
+ **[値]** – 値のみを表示し、名前は表示しません。代わりに、カーソルのツールチップに名前が表示されます。
+ **[値と名前]** – 常に値と名前を表示します。
+ **[名前]** – 値の代わりに名前を表示します。値はカーソルのツールチップに表示されます。
+ **[なし]** – 何も表示しません (空)。名前と値は、カーソルのツールチップに表示されます。

**カラーモード**

カラーモードを選択します。
+ **[値]** – 値とグラフ領域のみを色付けします。
+ **[Background]** (背景) – 背景も色付けします。

**グラフモード**

グラフとスパークラインモードを選択します。
+ **[なし]** – グラフを非表示にし、値のみを表示します。
+ **[エリア]** – 値の下に面グラフを表示します。これには、クエリが時間列を返す必要があります。

**テキストの整列**

アライメントモードを選択します。
+ **[自動]** – 値が 1 つだけ表示されている場合 (繰り返しなし)、値は中央に配置されます。複数の系列または行が表示されている場合、値は左揃えになります。
+ **[Center]** (中央) – 統計値は中央にあります。

テキストサイズ

ゲージテキストのサイズを調整します。
+ **[タイトル]** – ゲージタイトルサイズの数値を入力します。
+ **[値]** – ゲージ値サイズの数値を入力します。

# 状態タイムラインパネル
<a name="v9-panels-state-timeline"></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-panels-state-timeline-options"></a>

これらのオプションで、視覚的表現の内容を絞り込みます。

**[Merge equal consecutive values] (等しい連続値をマージする)**

Grafana は、互いに隣接する同じ値をマージするかどうかを制御します。

**[値の表示]**

値が状態領域内でレンダリングされるかどうかを制御します。[自動] は、十分なスペースがある場合に値をレンダリングします。

**[値の整列]**

状態領域内の値のアライメントを制御します。

**[Row height]** (行の高さ)

行間のスペースを制御します。1 = スペースなし = 0.5 = 50% のスペース。

**[線の幅]**

状態領域の線幅を制御します。

**[塗りつぶしの不透明度]**

状態領域の不透明度を制御します。

## 値のマッピング
<a name="v9-panels-state-timeline-valuemap"></a>

ブール値または文字列値に色を割り当てるには、[値マッピングを設定する](v9-panels-configure-value-mappings.md) を使用します。

## しきい値を含む時系列データ
<a name="v9-panels-state-timeline-threshold"></a>

パネルは時系列データでも使用できます。この場合、しきい値を使用して時系列を個別の色付き状態領域に変換します。

## 凡例オプション
<a name="v9-panels-state-timeline-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの [カラースキーム] オプションを [単一色] または [クラシックパレット] に設定することが重要です。凡例にしきい値の括弧を表示するには、カラースキームを [しきい値起点] に設定します。

**[凡例モード]** – これらの設定を使用して視覚化内の凡例の表示方法を改善します。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

**[凡例の配置]** 凡例を配置する場所を選択します。
+  **[Bottom]** – グラフの下。
+  **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する[標準計算](v9-panels-calculation-types.md)を選択します。複数選択できます。

# ステータス履歴パネル
<a name="v9-panels-status-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)」を参照してください。

ステータス履歴の視覚化は、時間の経過に伴う周期的な状態を表示します。各フィールドまたは系列は、横の列としてレンダリングされます。ボックスがレンダリングされ、各値を中央に配置します。

ステータス履歴の視覚化は、文字列、ブール値、数値フィールドまたは時系列で機能します。時間フィールドは必須です。値マッピングを使用して、文字列の色付け、またはテキスト値の数値範囲への割り当てができます。

## 表示オプション
<a name="v9-panels-status-history-timeline-options"></a>

これらのオプションで、視覚的表現の内容を絞り込みます。

**[値の表示]**

値が値ボックス内でレンダリングされるかどうかを制御します。[自動] は、十分なスペースがある場合に値をレンダリングします。

**[列幅]** は、ボックスの幅を制御します。1=最大、0=最小幅。

**[線の幅]** は、状態領域の線幅を制御します。

**[塗りつぶしの不透明度]** は、状態領域の塗りつぶしの不透明度を制御します。

## 値のマッピング
<a name="v9-panels-status-history-valuemap"></a>

ブール値または文字列値に色を割り当てるには、[値マッピングを設定する](v9-panels-configure-value-mappings.md) を使用します。

## しきい値を含む時系列データ
<a name="v9-panels-status-history-threshold"></a>

パネルは時系列データでも使用できます。この場合、しきい値を使用してボックスを色付けします。グラデーションのカラースキームを使用して値を色付けすることもできます。

## 凡例オプション
<a name="v9-panels-status-history-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの [カラースキーム] オプションを [単一色] または [クラシックパレット] に設定することが重要です。凡例にしきい値の括弧を表示するには、カラースキームを [しきい値起点] に設定します。

**[凡例モード]** – これらの設定を使用して視覚化内の凡例の表示方法を改善します。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

**[凡例の配置]** 凡例を配置する場所を選択します。
+  **[Bottom]** – グラフの下。
+  **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する[標準計算](v9-panels-calculation-types.md)を選択します。複数選択できます。

# テーブルパネル
<a name="v9-panels-table"></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 データにおける複数のモードをサポートしています。このパネルには、日付の書式設定、値の書式設定、色付けのためのオプションも用意されています。

## 列の並べ替え
<a name="v9-panels-table-sort"></a>

列タイトルをクリックして、ソート順序をデフォルトから降順や昇順に変更します。クリックするたびに、ソート順序はサイクルの次のオプションに変わります。一度に 1 つの列のみでソートすることができます。

## テーブルオプション
<a name="v9-panels-table-options"></a>

**ヘッダーの表示**

データソースからインポートされた列名を表示または非表示にします。

## 列幅
<a name="v9-panels-table-width"></a>

デフォルトでは、Grafana はテーブルサイズと最小列幅に基づいて列幅を自動的に計算します。このフィールドオプションは、設定をオーバーライドし、すべての列の幅をピクセル単位で定義できます。

例えば、`100` をフィールドに入力すると、フィールドの外部をクリックしたときにすべての列の幅が 100 ピクセルに設定されます。

## [最小列幅]
<a name="v9-panels-table-min"></a>

デフォルトでは、テーブル列の最小幅は 150 ピクセルです。このフィールドオプションでは、デフォルトを上書きでき、テーブルパネルの新しい最小列幅をピクセル単位で定義します。

例えば、`75` をフィールドに入力すると、フィールドの外部をクリックしたときにすべての列が幅 75 ピクセル以上でスケールされます。

スマートフォンやタブレットなどのスモールスクリーンデバイスの場合、デフォルトの `150` ピクセル値を `50` に減らして、テーブルベースのパネルをダッシュボードで正しくレンダリングできます。

## [列の配置]
<a name="v9-panels-table-alignment"></a>

Grafana がセルの内容を配置する方法を選択します。
+ Auto (デフォルト)
+ Left (左)
+ Center (中央)
+ Right (右)

## セルタイプ
<a name="v9-panels-table-cell-type"></a>

デフォルトでは、Grafana は表示設定を自動的に選択します。以下のオプションのいずれかを選択して、すべてのフィールドのデフォルトを設定することで、設定を上書きできます。一部のセルタイプでは、追加の設定を使用できます。

**注記**  
**フィールド**タブでこれらを設定すると、時間フィールドを含むすべてのフィールドにタイプが適用されます。**オーバーライド**タブで設定して、変更を 1 つ以上のフィールドに適用できます。

**[文字色]**

しきい値が設定されている場合、フィールドテキストは適切なしきい値の色で表示されます。

**Color background (gradient or solid) (背景色 (グラデーションまたは無地))**

しきい値が設定されている場合、フィールドの背景は適切なしきい値の色で表示されます。

**ゲージ**

セルは、複数の異なるプレゼンテーションタイプでグラフィカルゲージとして表示できます。

**ベーシック**

基本モードでは、ゲージの色を定義するしきい値レベルを含むシンプルなゲージが表示されます。

**Gradient** (グラデーション)

しきい値レベルによりグラデーションが決定されます。

**LCD**

ゲージは小さなセルに分割され、点灯または消灯で表示されます。

**JSON ビュー**

コードとしてフォーマットされた値を表示します。値がオブジェクトの場合、カーソルを合わせると JSON オブジェクトのブラウジングができる JSON ビューが表示されます。

## セル値の検査
<a name="v9-panels-table-cell-value"></a>

テーブルセルから値の検査を有効にします。raw 値はモーダルウィンドウに表示されます。

**注記**  
セル値の検査は、セル表示モードが [Auto]、[文字色]、[Color background]、または [JSON ビュー] に設定されている場合にのみ使用できます。

## [Column filter] (列フィルター)
<a name="v9-panels-table-col-filter"></a>

列データの表示方法を一時的に変更できます。例えば、最大から最小までの値を順序付けたり、特定の値を非表示にしたりできます。詳細については、以下の「[フィルターテーブル列](#v9-panels-table-filter)」を参照してください。

## Pagination (ページ分割)
<a name="v9-panels-table-pagination"></a>

ページ分割を有効または無効にするには、このオプションを使用します。これは、クエリに影響を与えないフロントエンドオプションです。有効にすると、ページサイズはテーブルの高さに自動的に調整されます。

## テーブル列のフィルタリング
<a name="v9-panels-table-filter"></a>

**列フィルター**をオンにすると、テーブルオプションをフィルタリングできます。

**列のフィルタリングを有効にするには**

1. Grafana で、フィルタリングする列を含むテーブルを使用してダッシュボードに移動します。

1. フィルタリングするテーブルパネルで、パネルエディタを開きます。

1. **[フィールド]** タブを選択します。

1. **[テーブル]** オプションで、**[列フィルター]** オプションをオンにします。

各列のタイトルの横にフィルターアイコンが表示されます。

**列の値のフィルタリング**

列の値をフィルタリングするには、列タイトルの横にあるフィルター (ファネル) アイコンを選択します。Grafana にその列のフィルターオプションが表示されます。

表示する値の横にあるチェックボックスを選択します。上部の検索フィールドにテキストを入力してそれらの値をディスプレイに表示すると、スクロールして探さずに選択できます。

**列フィルターのクリア**

フィルターが適用された列では、タイトルの横に青い漏斗が表示されます。

フィルターを削除するには、青いファネルアイコンを選択し、[Clear filter] (フィルターのクリア) を選択します。

## テーブルフッター
<a name="v9-panels-table-footer"></a>

テーブルフッターを使用して、フィールドの[計算](v9-panels-calculation-types.md)を表示できます。

テーブルフッターを有効にしたら、**[計算]** を選択し、計算する**フィールド**を選択します。

フィールドを選択しない場合、システムはすべての数値フィールドに計算を適用します。

**行のカウント**

選択したフィールドの値の数ではなく、データセット内の行数を表示する場合は、**[カウント]** 計算を選択し、**[カウント行]** を有効にします。

# テキストパネル
<a name="v9-panels-text"></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)」を参照してください。

テキストパネルを使用すると、ダッシュボードにテキストまたは HTML を直接含めることができます。これは、コンテキスト情報と説明の追加や、複雑な HTML を埋め込むために使用できます。

**モード**

モードは、埋め込みコンテンツの表示方法を決定します。これには次のオプションがあります。
+ **[Markdown]** – このオプションはコンテンツをマークダウンとしてフォーマットします。
+ **[HTML]** – この設定では、コンテンツをサニタイズされた HTML としてレンダリングします。
+ **[Code]** – この設定では、読み取り専用コードエディタ内でコンテンツをレンダリングします。適切な言語を選択して、埋め込みテキストに構文強調表示を適用します。

**[変数]**

コンテンツの変数が展開されて表示されます。

# 時系列パネル
<a name="v9-panels-time-series"></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-time-series-panel-tooltip.md)
+ [凡例オプション](v9-time-series-panel-legend.md)
+ [グラフスタイルオプション](v9-time-series-graph.md)
+ [軸オプション](v9-time-series-axis.md)
+ [色オプション](v9-time-series-color.md)

# ツールチップオプション
<a name="v9-time-series-panel-tooltip"></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-time-series-panel-legend"></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)」を参照してください。

**[凡例モード]** – 凡例の表示方法を選択します。
+  **[リスト]** – 凡例を一覧として表示します。これがデフォルトです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

**[凡例の配置]** – 凡例を表示する場所を選択します。
+  **[Bottom]** – グラフの下。
+  **[右側]** – グラフの右側。

**[凡例計算]**

凡例に表示する計算を選択します。詳細については、「[計算タイプ](v9-panels-calculation-types.md)」を参照してください。

# グラフスタイルオプション
<a name="v9-time-series-graph"></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)」を参照してください。

**[Graph style] (グラフスタイル)**

このオプションを使用して、時系列データを表示する方法を定義します。オーバーライドを使用して、同じグラフに複数のスタイルを組み合わせることができます。3 つのスタイルオプションがあります。その他のスタイルオプションの一部は、特定のグラフスタイルにのみ適用されます。
+ **[折れ線]** – 時系列をグラフに折れ線で表示します。
+ **[棒]** – 時系列をグラフに一連の棒で表示し、データポイントごとに 1 つずつ表示します。
+ **[ポイント]** – 時系列をグラフに点で表示し、データポイントごとに 1 つずつ表示します。

**[棒の配置]**

棒グラフの場合は、グラフ上のデータポイントが描画される場所を基準にして、棒の位置を設定します。棒には幅があるため、棒をデータポイントの前、後、または中央に配置することができます。**[前]**、**[中央]**、または**[後]** をこのオプションで選択します。

**[線の幅]**

折れ線グラフの線の太さ、または棒グラフで各棒の枠線の太さを設定します。

**[塗りつぶしの不透明度]**

塗りつぶし色の不透明度を設定します。塗りつぶしは、折れ線グラフの線の下にある領域を表示したり、棒グラフの棒の色として表示したりするために使用します。

**[グラデーションモード]**

グラデーションモードでは、系列の色に基づいてグラデーションの塗りつぶしを指定します。色を変更するには、標準のカラースキームフィールドオプションを使用します。詳細については、「[カラースキーム](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme)」を参照してください。グラデーションモードのオプションは次のとおりです。
+ **[なし]** – グラデーションの塗りつぶしなし。
+ **[不透明度]** – Y 軸の値が増加するにつれて、塗りつぶしの不透明度が増加する不透明度グラデーション。
+ **[色相]** – 系列の色相に基づくグラデーション。
+ **[Scheme]** (スキーム) – カラースキームによって定義されるカラーグラデーション。この設定は、塗りつぶしと線で使用できます。詳細については、「[色オプション](v9-time-series-color.md)」を参照してください。

グラデーションの外観は、**[塗りつぶしの不透明度]**設定でも変更されます。

**[ポイント表示]**

視覚化を設定して、折れ線グラフまたは棒グラフにポイントを追加できます。**[常に表示]**、**[常に非表示]**、または **[自動]** を選択できます。**自動**を使用する場合、Grafana はデータの密度に基づいてポイントを表示するかどうかを決定します。データの密度が十分に低い場合、ポイントが表示されます。

**[ポイントサイズ]**

描画されたポイントのサイズを、直径 1～40 ピクセルに設定します。

**[線形補間]**

Grafana が系列の線形を補間する方法を選択します。選択肢は、**[直線]**、**[平滑線]**、**[前のステップ]**、**[後のステップ]** です。

**[線のスタイル]**

線のスタイルを設定します。色を変更するには、標準のカラースキームフィールドオプションを使用します。

線のスタイルの外観は、**[線幅]** と **[塗りつぶしの不透明度]** の設定に影響されます。

線のスタイルの選択肢は、**[実線]**、**[破線]**、および **[点線]** です。

**[null 値の接続]**

null 値 (データ内のギャップ) をグラフに表示する方法を選択します。null 値は、連続線を形成するために接続することも、オプションで、超えるとデータ内のギャップが接続されなくなるしきい値を設定することもできます。**[常に非表示]** で常にデータポイントをギャップで接続しない、**[常に表示]** で常にデータポイントをギャップで接続する、またはデータ内のギャップを接続しなくなる **[しきい値]** を設定することができます。

**[Stack series (系列の積み上げ)]**

*積み上げ*により、Grafana は系列の上に別の系列を表示できます。視覚化で積み上げを使用すると、誤解を招くグラフを簡単に作成できるため、注意が必要です。積み上げが最適な手段ではない理由の詳細については、「[積み上げに関する問題](https://www.data-to-viz.com/caveat/stacking.html)」を参照してください。

積み上げのオプションは次のとおりです。
+ **[Off]** (オフ) – 系列の積み上げをオフにします。
+ **[普通]** – 系列の上に別の系列を積み上げます。
+ **[100%]** – パーセンテージで積み上げるため、すべての系列の合計が 100% になります。

**グループ内の系列の積み上げ**

積み上げ動作をオーバーライドして、グループ内で系列を積み上げることができます。オーバーライドの作成の詳細については、「[フィールドのオーバーライドを設定する](v9-panels-configure-overrides.md)」を参照してください。オーバーライドを作成するときは、系列に含める積み上げグループの名前を指定します。

**[下を塗りつぶす]**

**[下を塗りつぶす]**オプションは、2 つの系列間の領域を塗りつぶします。このオプションは、系列またはフィールドのオーバーライドとしてのみ使用できます。このオプションを使用すると、系列の折れ線から 0 までではなく、2 つの系列間の領域を塗りつぶすことができます。例えば、*[最大値]*と*[最小値]*という 2 つの系列がある場合、**[最大値]**系列を選択し、**[最小値]**系列まで**[下を塗りつぶす]**ようオーバーライドできます。これにより、2 つの折れ線間の領域のみが塗りつぶされます。

# 軸オプション
<a name="v9-time-series-axis"></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)」を参照してください。

軸カテゴリのオプションにより、X 軸と Y 軸のレンダリング方法が変わります。一部のオプションは、編集するフィールドオプションボックスの外部をクリックするまで有効になりません。または、`Enter` キーを押す方法もあります。

**[配置]**

Y 軸の配置を選択します。オプションは以下のとおりです。
+ **[自動]** – Grafana は、Y 軸を系列に自動的に割り当てます。異なるユニットを持つ系列が 2 つ以上ある場合、Grafana は左軸を最初のユニットに、右軸を次のユニットに割り当てます。
+ **[左]** – 左側にすべての Y 軸を表示します。
+ **[右側]** – 右側にすべての Y 軸を表示します。
+ **[非表示]** – すべての Y 軸を非表示にします。

各フィールドまたは系列に軸を割り当てるには、[[フィールドオーバーライドの追加]](v9-panels-configure-overrides.md) をします。

**ラベル**

Y 軸テキストラベルを設定します。複数の Y 軸がある場合は、オーバーライドで異なるラベルを割り当てることができます。

**[幅]**

軸の固定幅を設定します。デフォルトでは、Grafana は軸の幅を動的に計算します。

軸の幅を設定することで、異なる軸タイプのデータが同じ表示比率を共有できます。この設定により、軸が互いに視覚的に近接して移動または伸張されないため、複数のグラフのデータの価値を簡単に比較できます。

**[ソフト最小値とソフト最大値]**

Y 軸の制限をより適切に制御するために、**ソフト最小値**または**ソフト最大値**オプションを設定します。デフォルトでは、Grafana はデータセットに基づいて Y 軸の範囲を自動的に設定します。

ソフト最小設定とソフト最大設定により、大きな変更がない場合に小さな変更を可視化できます。標準最小フィールドオプションと最大フィールドオプションから導出されるハード最小値または最大値は、特定のポイントを超えてスパイクを切り取ることで、断続的なスパイクが有用な詳細を平坦化することを防げます。

Y 軸のハード制限を定義するために、標準の最小/最大オプションを設定できます。詳細については、「[標準オプションの設定](v9-panels-configure-standard-options.md)」を参照してください。

**[Scale]** (スケール)

Y 軸のスケール方法を設定します。選択肢は、**[線形]** と **[対数]** です。対数を選択した場合は、さらに底 2 または底 10 の対数スケールを選択できます。

**[Transform]** (変換)

系列をオーバーライドして、グラフ上の値に変換を適用できます (基になる値や、ツールチップ、コンテキストメニュー、凡例の値には影響しません)。変換オプションは 2 つあります。
+ **[負の Y 変換]** – 結果を Y 軸の負の値に反転します。
+ **[Constant]** (定数) – 最初の値を定数線として表示します。

# 色オプション
<a name="v9-time-series-color"></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)」を参照してください。

デフォルトでは、グラフは標準の[カラースキーム](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme)オプションを使用して系列の色を割り当てます。凡例にある系列の色アイコンをクリックすることで、凡例を使用してカラーピッカーを開くこともできます。この方法で色を設定すると、特定の系列に特定の色を設定するオーバーライドルールが自動的に作成されます。

以下は、系列の色のデフォルトを変更するために使用できる追加オプションです。

**Classic palette** (クラシックパレット)

最も一般的なセットアップは、グラフに**クラシックパレット**を使用することです。このスキームは、その順序に基づいて、各フィールドまたは系列に色を自動的に割り当てます。クエリでフィールドの順序が変更されると、色も変わります。オーバーライドルールを使用して、特定のフィールドの色を手動で設定できます。

**[単一色]**

このモードを使用して色を指定します。凡例の各系列の横にある色付き線アイコンをクリックして、カラーピッカーを開くこともできます。これにより、カラースキームを単一色と選択した色に設定する新しいオーバーライドが自動的に作成されます。

**値別カラースキーム**

**[しきい値起点: 値別]** や **[緑黄赤: 値別]** などの値別カラースキームを選択すると、**[系列に使用する色]** オプションが表示されます。このオプションは、系列に色を割り当てるためにどの値 (最終値、最小値、最大値) を使用するかを管理します。

**スキームグラデーションモード**

**グラフスタイルの**下にある**グラデーションモード**オプションには、**Scheme** という名前のモードがあります。**スキーム**を有効にすると、折れ線または棒グラフは、選択した**カラースキーム**から定義されたグラデーション色を受け取ります。

**[しきい値起点]**

**[カラースキーム]** が **[しきい値起点 (値別)]** に設定され、**[グラデーションモード]** が **[スキーム]** に設定されている場合、折れ線または棒グラフの色は定義されたしきい値を超えると変化します。スキームで選択された正確な色のみが表示されます。

**グラデーションカラースキーム**

**グラデーションモード**を**スキーム**に設定*せずに*グラデーションカラースキームを使用すると、系列内の値がしきい値セット間を移動するにつれて、選択した色間でグラデーションを形成します。

# トレースパネル (ベータ)
<a name="v9-panels-traces"></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)」を参照してください。

*トレース*は、インフラストラクチャ内のサービスを横断するリクエストを追跡およびログ記録できる視覚化です。

トレースの詳細については、「[Explore でのトレース](v9-explore-tracing.md)」を参照してください。

# WindRose
<a name="v9-panels-windrose"></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)」を参照してください。

WindRose パネルは、生の時系列データを受信し、データを変換して WindRose チャートにマッピングします。

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/windrose.png)


## オプション
<a name="v9-panels-windrose-options"></a>

WindRose パネルは、以下のオプションをサポートしています。
+ 軸の頻度
+ 軸のスタイル (角度またはコンパス)
+ 目盛 (線形、正方形、対数)

# Grafana バージョン 9 で探索する
<a name="v9-explore"></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 のダッシュボード UI は、視覚化用のダッシュボードを構築する機能を提供します。*Explore* は、クエリに集中できるように、ダッシュボードとパネルのオプションを取り除きます。これにより、クエリが動作するまで反復処理を行い、クエリからダッシュボードを構築できます。

**注記**  
ダッシュボードを作成せず単にデータを探索したい場合は、Explore を使用するとはるかに簡単になります。データソースがグラフとテーブルのデータをサポートしている場合、Explore は結果をグラフとテーブルの両方で表示します。これにより、データの傾向と詳細を同時に確認できます。

## 探索を開始する
<a name="v9-explore-start"></a>

**注記**  
Explore にアクセスするには、エディタまたは管理者ロールが必要です。

**Explore にアクセスするには**

1. Grafana ワークスペースで、左側のメニューバーから Explore メニュー項目を選択します。

   空の Explore タブが開きます。

   または、パネル内の既存のクエリから開始するには、パネルメニューから Explore オプションを選択します。これにより、パネルからのクエリを含む Explore タブが開き、ダッシュボードの外部でクエリを微調整または反復できます。

1. 左上のドロップダウンからデータソースを選択します。[Prometheus](prometheus-data-source.md) には、Explore のカスタム実装があり、他のデータソースは標準のクエリエディタを使用します。

1. クエリフィールドに、データを探索するクエリを書き込みます。クエリフィールドの横に、クリアボタン (X)、クエリ追加ボタン (\$1)、クエリ削除ボタン (-) の 3 つのボタンが表示されます。通常のクエリエディタと同様に、複数のクエリを追加または削除できます。

   クエリの詳細については、「[データのクエリと変換](v9-panels-query-xform.md)」を参照してください。

## 分割して比較する
<a name="v9-explore-compare"></a>

分割ビューを使用すると、グラフとテーブルを並べて比較したり、関連データを 1 ページでまとめて確認したりすることができます。

**上部で分割ビューを開く**

1. Explore ビューで、**[分割]** ボタンを選択して現在のクエリを複製し、ページを 2 つの並列クエリに分割します。
**注記**  
新しいクエリには別のデータソースを選択できます。例えば、2 つの異なるサーバーに対して同じクエリを比較したり、ステージング環境を本番環境と比較したりできます。

   分割ビューでは、いずれかのタイムピッカーにある時刻同期ボタンを選択することで、両方のパネルのタイムピッカーを連携できます (一方を変更すると、他方も変更されます)。タイムピッカーを連携すると、分割ビュークエリの開始時刻と終了時刻が同期されます。これにより、両方の分割パネルで同じ時間間隔を確認できます。

1. 新しく作成したクエリを閉じるには、[分割を閉じる] ボタンをクリックします。

## 短縮リンクを共有する
<a name="v9-explore-share"></a>

短縮リンクの共有機能を使用すると、クエリパラメータで長い URL を使用する代わりに、/goto/:uid 形式のより短くてシンプルな URL を作成できます。クエリ結果への短縮リンクを作成するには、Explore ツールバーで **[共有]** オプションを選択します。使用されない短縮リンクは、7 日後に自動的に削除されます。

# Explore でのクエリ管理
<a name="v9-explore-manage"></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)」を参照してください。

クエリのデバッグを支援するために、Explore ではクエリリクエストとレスポンス、クエリ統計を「クエリインスペクター」を使用して調査できます。この機能は、パネルインスペクタータスク「[クエリのパフォーマンス検査](v9-panels-panel-inspector.md#v9-panels-query-performance)」、「[クエリリクエストとレスポンスデータの検査](v9-panels-panel-inspector.md#v9-panels-query-request-response)」と類似しています。

## クエリ履歴
<a name="v9-explore-manage-history"></a>

クエリ履歴は、Explore で使用したクエリのリストです。履歴は Grafana データベースに保存され、他のユーザーと共有されません。履歴内のクエリの保持期間は 2 週間です。2 週間以上経過したクエリは自動的に削除されます。履歴を開いて操作するには、Explore の **[クエリ履歴]** ボタンを選択します。

**注記**  
スター付き (お気に入り) クエリは 2 週間の保持期間の対象ではなく、削除されません。

**クエリ履歴の表示**

クエリ履歴を使用すると、クエリの履歴を表示できます。個々のクエリごとに、次のことができます。
+ クエリを実行する
+ コメントを作成および/または編集します。
+ クエリをクリップボードにコピーする。
+ クエリを含む短縮リンクをクリップボードにコピーする。
+ クエリをスター付き (お気に入り) にする。

**お気に入りのクエリを管理する**

[クエリ履歴] タブにあるスター付きのすべてのクエリは、[スター付き] リストに表示されます。これにより、お気に入りのクエリにすばやくアクセスし、ゼロから入力することなくこれらのクエリを再利用できます。

**[クエリ履歴の並べ替え]**

デフォルトでは、クエリ履歴には最新のクエリが表示されます。履歴は日付またはデータソース名で、昇順または降順に並べ替えることができます。

**クエリ履歴を並べ替えるには**

1. **[クエリの並べ替え順序]** フィールドを選択します。

1. 以下のオプションのいずれかを選択します。
   + 新しい順
   + [古い順]

**クエリ履歴のフィルタリング**

クエリ履歴とスター付きタブで、クエリ履歴を特定のデータソースに対してフィルタリングできます。

**データソースに対する履歴のフィルタリング**

1. **[特定のデータソースのクエリをフィルタリング]** フィールドを選択します。

1. 履歴をフィルタリングするデータソースを選択します。複数のデータソースを選択することもできます。

**[クエリ履歴]** タブでは、スライダーを使用して日付でクエリをフィルタリングすることもできます。
+ 垂直スライダーを使用して、クエリを日付でフィルタリングします。
+ 上部のハンドルをドラッグして開始日を設定します。
+ 上部のハンドルをドラッグして終了日を設定します。

**クエリ履歴の検索**

クエリとコメントをまたいで履歴を検索できます。クエリ履歴タブとスター付きタブでクエリを検索できます。

**クエリ履歴で検索するには**

1. **[クエリ検索]** フィールドを選択します。

1. 検索する用語を検索フィールドに入力します。

**クエリ履歴設定**

[設定] タブでクエリ履歴をカスタマイズできます。オプションについては、以下の表を参照してください。


| 設定 | デフォルトの値 | 
| --- | --- | 
| デフォルトのアクティブタブを変更する | [クエリ履歴] タブ | 

**注記**  
クエリ履歴設定は全体に及び、分割モードで両方のパネルに適用されます。

## Prometheus 固有の機能
<a name="v9-explore-manage-prometheus"></a>

Explore には、Prometheus のカスタムクエリエクスペリエンスが搭載されています。クエリを実行すると、実際にはグラフ用の通常の Prometheus クエリとテーブル用の*インスタントクエリ*の 2 つのクエリが実行されます。インスタントクエリは、グラフに表示されるデータの適切な要約を示す各時系列の最後の値を返します。

**メトリクスエクスプローラー**

クエリフィールドの左側で **[メトリクス]** を選択すると、メトリクスエクスプローラーが開きます。エクスプローラーには、メトリクスがプレフィックスごとにグループ化された階層メニューが示されます。例えば、すべてのアラートマネージャーメトリクスは `alertmanager` プレフィックスの下にグループ化されます。これは、利用可能なメトリクスを単に確認したい場合に有効です。

**クエリフィールド**

クエリフィールドは、メトリクス名、関数の自動補完機能に対応しており、標準の Prometheus クエリエディタとほぼ同じように動作します。Enter キーを押して新しい行を作成し、Shift\$1Enter キーを押してクエリを実行できます。

Ctrl\$1Space キーを押すとオートコンプリートメニューが開きます。オートコンプリートメニューには新たに [履歴] セクションが追加されており、最近実行されたクエリの一覧が表示されます。

クエリフィールドの下に提案が表示される場合があり、そのフィールドでクエリを選択すると、提案された変更でクエリを更新します。
+ カウンター (指数関数的に増加するメトリクス) では、レート関数が提案されます。
+ バケットの場合、ヒストグラム関数が候補として表示されます。
+ 記録ルールの場合、ルールを展開できます。

**テーブルをフィルタリング**

テーブルパネルの**ラベル**列にあるフィルターボタンを選択すると、クエリ式にフィルターを追加することができます。複数のクエリに対してフィルターを追加することもでき、フィルターはすべてのクエリに追加されます。

# Explore のログ
<a name="v9-explore-logs"></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)」を参照してください。

Explore では、メトリクスとともに、次のデータソースでログを調査できます。
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

インフラストラクチャのモニタリングとインシデント対応中に、メトリクスとログをより深く掘り下げて原因を見つけることができます。Explore では、メトリクスとログを並べて表示することで、メトリクスとログを関連付けることもできます。これにより、新しいデバッグワークフローが作成されます。

1. アラートを受信します。

1. メトリクスをドリルダウンして調べます。

1. もう一度ドリルダウンし、メトリクスと時間間隔 (今後は分散トレース) に関連するログを検索します。

## ログの視覚的表現
<a name="v9-explore-logs-viz"></a>

ログクエリの結果はグラフにヒストグラムとして表示され、個々のログについては以下のセクションで説明します。

データソースがフルレンジのログボリュームヒストグラムをサポートしている場合、入力されたすべてのログクエリのログ分布を含むグラフが自動的に表示されます。この機能は、現在 OpenSearch および Loki データソースでサポートされています。

**注記**  
Loki では、このフルレンジのログボリュームヒストグラムをメトリクスクエリによってレンダリングします。このクエリは、クエリされた時間範囲に応じてコストがかかる可能性があります。このクエリは、小規模な Loki インストールで処理するのが特に難しい場合があります。これを軽減するには、Loki の前に [nginx](https://www.nginx.com/) などのプロキシを使用して、これらのクエリにおけるユーザー定義のタイムアウト (10 秒など) を設定することをお勧めします。ログボリュームヒストグラムクエリは、値 `Source=logvolhist` の HTTP ヘッダー `X-Query-Tags` を持つクエリを検索することで識別できます。これらのヘッダーは、Grafana によってすべてのログボリュームヒストグラムクエリに追加されます。

データソースがフルレンジのログボリュームヒストグラムのロードをサポートしていない場合、ログモデルは、自動的に計算された時間間隔でバケット化されたログ行数に基づいて時系列を計算し、最初のログ行のタイムスタンプは結果からヒストグラムの開始を固定します。時系列の終了点は、タイムピッカーの **To** 範囲に固定されます。

**ログレベル**

レベルラベルが指定されているログの場合、Grafana はラベルの値を使用してログレベルを判別し、それに応じて色を更新します。ログにレベルラベルが指定されていない場合、そのコンテンツがサポートされている表現のいずれかと一致するかどうかを調べようとします (詳細については、以下を参照してください)。ログレベルは常に最初の一致によって決まります。Grafana がログレベルを判別できない場合、不明なログレベルとして視覚化されます。

**ヒント**  
Loki データソースを使用し、`level` がログラインにある場合は、パーサー (JSON、logfmt、regex など) を使用して、レベル情報をログレベルの決定に使用されるレベルラベルに抽出できます。これにより、ヒストグラムはさまざまなログレベルを個別のバーに表示できます。

**サポートされているログレベルと、ログレベルの略記と表現のマッピング**


| サポートされている式 | ログレベル | 色 | 
| --- | --- | --- | 
| emerg | critical | 紫色 | 
| fatal | critical | 紫色 | 
| alert | critical | 紫色 | 
| crit | critical | 紫色 | 
| critical | critical | 紫色 | 
| err | エラー | 赤 | 
| eror | エラー | 赤 | 
| エラー | エラー | 赤 | 
| warn | 警告 | 黄色 | 
| 警告 | 警告 | 黄色 | 
| 情報 | 情報 | 緑色 | 
| information | 情報 | 緑色 | 
| notice | 情報 | 緑色 | 
| dbug | デバッグ | 青 | 
| デバッグ | デバッグ | 青 | 
| トレース | トレース | 水色 | 
| \$1 | 不明 | 灰色 | 

## ログナビゲーション
<a name="v9-explore-logs-nav"></a>

ログ行の横にあるログナビゲーションインターフェイスを使用して、より多くのログをリクエストできます。これを行うには、ナビゲーションの下部にある **[古いログ]** ボタンを選択します。行制限に達し、さらにログを表示する場合は、これを使用してさらに多くのログを取得できます。各リクエストは、ナビゲーションに個別のページとして表示されます。各ページには、受信ログ行の開始と終了のタイムスタンプが表示されます。表示するページをクリックすると、以前の結果を表示できます。Explore がログナビゲーションから実行された過去 5 つのリクエストをキャッシュすることで、ページをクリックしたときに同じクエリを再実行しません。

## 視覚的表現オプション
<a name="v9-explore-logs-vis-options"></a>

ログの表示方法をカスタマイズしたり、表示する列を選択することができます。

**[時間]**

時間列を表示または非表示にします。これはデータソースから報告されたログ行と関連するタイムスタンプです。

**[一意のラベル]**

非共通ラベルのみを含む一意のラベル列を表示または非表示にします。すべての一般的なラベルが上に表示されます。

**[行の折り返し]**

ディスプレイで行の折り返しを使用する場合は、これを真に設定します。False に設定すると、水平スクロールになります。

**Prettify JSON (JSONの整形)**

すべての JSON ログを pretty print (整形表示) するには、これを `true` に設定します。この設定は、JSON 以外の形式のログには影響しません。

**Deduplication (重複排除)**

ログデータは非常に反復的であり、Explore は重複するログ行を非表示にすることで役立ちます。使用できる重複排除アルゴリズムはいくつかあります。
+ **[完全]** - 完全一致は、日付フィールドを除き、行全体で行われます。
+ **[数値]** - 数値の一致は、期間、IP アドレスなどの数値を除外した後に行で行われます。
+ **[署名]** - 最も積極的な重複排除で、残りの空白と句読点のすべての文字、数字、一致を削除します。

**[結果の順序の反転]**

受信したログの順序は、デフォルトの降順 (新しい順) から昇順 (古い順) に変更できます。

**ラベルと検出されたフィールド**

各ログ行には、より堅牢なインタラクションのために、ラベルと検出されたフィールドを含む拡張可能な領域があります。すべてのラベルについて、選択したラベルをフィルタリングして抽出 (ポジティブフィルター)、除外 (ネガティブフィルター) する機能が追加されました。また、各フィールドやラベルには、表示されているすべてのログに関連する統計を表示する統計アイコンもあります。

**改行のエスケープ**

Explore は、改行 (`\n`、`\r`) やタブ (`\t`) など、ログ行で誤ってエスケープされたシーケンスを自動的に検出します。このようなシーケンスを検出すると、Explore は [改行のエスケープ] オプションを提供します。

Explore は、検出した誤ってエスケープされたシーケンスを自動的に修正できます

**エスケープシーケンスを自動的に修正するには**

1. **[改行のエスケープ]** を選択してシーケンスを置き換えます。

1. 置き換えを手動で確認し、その正確性を確認します。

Explore はこれらのシーケンスを置き換えます。そうすると、オプションは **[改行のエスケープ]** から **[エスケープの削除]** に変更されます。受信した入力に基づいて解析が正確ではない可能性があるため、変更を評価します。**[エスケープの削除]** を選択すると、置き換えを元に戻すことができます。

**データリンク**

データリンクを使用すると、ログメッセージの任意の部分を内部リンクまたは外部リンクに変換できます。作成されたリンクは、**[ログの詳細]** ビュー内の **[リンク]** セクションにボタンとして表示されます。

**フィールドの可視性を切り替える**

ログ行を展開し、目のアイコンをクリックするとフィールドを表示または非表示にできます。

## Loki 固有の機能
<a name="v9-explore-logs-loki"></a>

Loki は Grafana Labs のオープンソースのログ集約システムです。Loki は、ログの内容にインデックスを作成するのではなく、ログストリームごとにラベルのセットを作成するため、費用対効果が高いように設計されています。Loki からのログは、Prometheus のラベルセレクタを使用したクエリと同様の方法でクエリを実行されます。ラベルを使用して、Prometheus ラベルと一致するよう作成されるログストリームをグループ化します。Grafana Loki の詳細については、「[Grafana Loki](https://github.com/grafana/loki)」Github を参照してください。

詳細については、ログデータのクエリ方法に関する [[Loki]](using-loki-in-AMG.md) を参照してください。

**メトリクスからログに切り替える**

Prometheus クエリからログクエリに切り替えると (まず分割してメトリクスとログを並べることができます)、ログに存在するクエリのラベルが保持され、それらを使用してログストリームに対してクエリを実行します。例えば、次の Prometheus クエリがある場合です。

```
grafana_alerting_active_alerts{job="grafana"}
```

ログデータソースに切り替えると、次のようになります。

```
{job="grafana"}
```

これにより、検索できる選択した時間範囲内のログのチャンクが返されます。

## ログサンプル
<a name="v9-explore-logs-sample"></a>

選択したデータソースがログサンプルを実装し、ログクエリとメトリクスクエリの両方をサポートしている場合、メトリクスクエリの場合は、視覚化されたメトリクスに寄与したログ行のサンプルを自動的に表示できます。この機能は、現在 Loki データソースでサポートされています。

**[ライブテーリング]**

ライブテーリング機能を使用して、サポートされているデータソースに関するリアルタイムログを表示します。

Explore ツールバーの **[Live]** ボタンを選択して、Live Tail ビューに切り替えます。

Live Tail ビューでは、新しいログが画面の下部に表示され、背景が淡いコントラストになるため、最新情報を簡単に追跡できます。**[一時停止]** ボタンを選択するか、ログビューをスクロールしてライブテーリングを一時停止し、中断することなく以前のログを調べます。**[再開]** ボタンを選択してライブテーリングを再開するか、**[停止]** ボタンを選択してライブテーリングを終了し、標準の Explore ビューに戻ります。

# Explore でのトレース
<a name="v9-explore-tracing"></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)」を参照してください。

Explore を使用すると、トレース中のデータソースからトレースを視覚化できます。

以下のデータソースがサポートされています。
+ [Jaeger](jaeger-data-source.md)
+ [Tempo](tempo-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

上記のデータソースのクエリを設定する方法については、特定のデータソースのドキュメントを参照してください。

## トレースビューの説明
<a name="v9-explore-trace-view"></a>

このセクションでは、Trace View ダッシュボードの要素について説明します。

**ヘッダー**

トレースビューのヘッダーには、次の要素があります。
+ ヘッダータイトル: ルートスパンの名前とトレース ID を表示します。
+ 検索: 検索されたテキストを含むスパンを強調表示します。
+ メタデータ: トレースに関するさまざまなメタデータを表示します。

**ミニマップ**

要約ビューまたはトレースタイムラインを表示します。ポインタをミニマップにドラッグして、より短い時間範囲にズームインできます。ズームはメインタイムラインも更新するため、短いスパンを簡単に確認できます。ミニマップにカーソルを合わせ、ズームすると、ズームをリセットする選択のリセットボタンが表示されます。

**タイムライン**

トレース内のスパンのリストを表示します。各スパン行は、次の要素で構成されます。
+ [子を展開] ボタン: 選択したスパンのすべての子スパンを展開または折りたたみます。
+ サービス名: スパンをログに記録したサービスの名前。
+ オペレーション名: このスパンが表すオペレーションの名前。
+ スパン期間バー: トレース内のオペレーション期間の視覚的表現。

**スパンの詳細**

スパン行の任意の場所をクリックすると、以下を含むスパンの詳細が表示されます。
+ オペレーション名
+ スパンメタデータ
+ タグ: このスパンに関連付けられている任意のタグ。
+ プロセスメタデータ: このスパンをログに記録したプロセスに関するメタデータ。
+ ログ: このスパンおよび関連するキー値によってログに記録されたログのリスト。Zipkin ログの場合、セクションには Zipkin 注釈が表示されます。

**ノードグラフ**

オプションで、表示されたトレースのノードグラフを展開できます。データソースによっては、トレースのスパンをグラフ内のノードとして表示したり、現在のトレースに基づくサービスグラフなどのコンテキストを追加したりできます。

**ログへのトレース**

トレースビューのスパンから、そのスパンに関連するログに直接移動できます。これは、Tempo、Jaeger、および Zipkin データソースで使用できます。各データソースの設定方法については、関連するドキュメントを参照してください。

ドキュメントアイコンをクリックして、設定されたデータソースを使用して Explore で分割ビューを開き、スパンに関連するログに対してクエリを実行します。

## サービスグラフビュー
<a name="v9-explore-trace-graph"></a>

Service Graph ビューは、スパンメトリクス (レート、エラーレート、期間 (RED) のデータを追跡) とサービスグラフを視覚化します。要件が設定されると、この事前設定されたビューがすぐに利用できます。

詳細については、[Tempo](tempo-data-source.md) データソースのページを参照してください。[サービスグラフビューページ](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)は、「*Tempo ドキュメント*」でも確認できます。

# Explore の Inspector
<a name="v9-explore-inspector"></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)」を参照してください。

インスペクターは、クエリの理解とトラブルシューティングに役立ちます。未加工データを検査し、そのデータをカンマ区切り値 (CSV) ファイルにエクスポートし、ログ結果を TXT 形式でエクスポートし、クエリリクエストを表示できます。

## Inspector UI
<a name="v9-explore-inspector-ui"></a>

インスペクターには次のタブがあります。
+ **[統計タブ]** – クエリにかかる時間および返される量を示します。
+ **[クエリタブ]** – Grafana がデータソースへのクエリ実行時に送信されるサーバーへのリクエストを表示します。
+ **[JSON] タブ** – データ JSON とデータフレーム構造 JSON を表示およびコピーできます。
+ **[データタブ]** – クエリによって返される未加工データを表示します。
+ **[エラータブ]** – エラーを表示します。クエリがエラーを返す場合にのみ表示されます。

## Inspector タスク
<a name="v9-explore-inspector-tasks"></a>

Explore Inspector では、さまざまなタスクを実行できます。

**Inspector を開く**

検査するクエリを実行したら、**[Inspector]** ボタンを選択します。

画面の下部にインスペクターペインが開きます。

*未加工クエリ結果の検査*

クエリによって返されるデータである未加工のクエリ結果をテーブルに表示できます。

**[Inspector]** タブで、**[Data]** タブをクリックします。

複数のクエリまたは複数のノードのクエリには、追加のオプションがあります。
+ **[データフレームを表示する]:** 表示する結果セットデータを選択します。
+ **[時間で結合された系列]**: すべてのクエリの未加工データを一度に表示し、列ごとに結果セットを 1 つ表示します。列見出しをクリックしてデータをソートできます。

**未加工のクエリ結果を CSV としてダウンロード**

未加工のクエリ結果を表示すると、結果の CSV ファイルを生成できます。表示される結果の CSV ファイルを取得するため、CSV ファイルを生成する前に、必要な結果が得られるように結果を絞り込んでください。

CSV ファイルを生成するには、**[Inspector]** タブで **[CSV のダウンロード]** を選択します。

Excel 用にフォーマットされた CSV ファイルをダウンロードするには、**[データオプション]** を展開して **[Excel 用にダウンロード]** トグルをオンにしてから、**[CSV のダウンロード]** オプションを選択します。

*ログ結果を TXT としてダウンロード*

**[Inspector]** タブで **[ログのダウンロード]** を選択すると、現在表示しているログの TXT ファイルを生成できます。

**トレース結果のダウンロード**

データソースタイプに基づいて、Grafana は、サポートされている形式 (Jaeger、Zipkin、または OTLP 形式) のいずれかでトレース結果の JSON ファイルを生成できます。

トレースをダウンロードするには、**[Inspector]** タブで**[トレースのダウンロード]** を選択します。

**クエリパフォーマンスの検査**

**[統計]** タブには、クエリにかかる時間、送信したクエリの数、返された行数を示す統計が表示されます。この情報は、特に数値が予想外に高い場合や低い場合のクエリのトラブルシューティングに役立ちます。

統計は読み取り専用です。

**[JSON モデルの表示]**

データだけでなく、データフレーム JSON モデルも探索してエクスポートできます。

**JSON モデルを表示するには**

1. インスペクターパネルで、**[JSON]** タブをクリックします。

1. **[ソースの選択]** ドロップダウンから、以下のいずれかのオプションを選択します。
   + **[データ]** – Explore に返されたデータを表す JSON オブジェクトを表示します。
   + **[データフレーム構造]** – 未加工の結果セットを表示します。

1. JSON の一部を展開または折りたたんで、個別のセクションを表示できます。**[クリップボードにコピー]** オプションを選択して、JSON 本文をコピーし、別のアプリケーションに貼り付けることもできます。

**データソースへの未加工リクエストとレスポンスの表示**

Explore と Inspector タブを操作すると、クエリで生成する未加工のリクエストとレスポンスデータを表示できます。Inspector で **[クエリ]** タブを選択し、**[更新]** を選択して未加工データを表示します。

Grafana はクエリをサーバーに送信し、結果を表示します。クエリの特定の部分をドリルダウン、そのすべてを展開または折りたたみ、またはデータをクリップボードにコピーして他のアプリケーションで使用できます。

# Grafana バージョン 9 のアラート
<a name="v9-alerts"></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 アラートからは、システムの問題が発生した直後に、サービスの中断を最小限に抑えるための強力で実用的なアラートが提供されます。

Amazon Managed Grafana には最新のアラートシステム *[Grafana アラート]*が含まれており、アラート情報を一元的に管理、検索できるビューが用意されています。以下に、その機能の一部を紹介します。
+ Grafana アラートを一元的に作成および管理できるビュー。
+ Cortex と Loki 管理のアラートを作成および管理できる単一のインターフェイス。
+ Prometheus、Amazon Managed Service for Prometheus、およびその他のアラートマネージャー互換データソースからのアラート情報の表示。

Amazon Managed Grafana ワークスペースを作成するときは、Grafana アラートを使用するか、[従来のダッシュボードアラート](old-alerts-overview.md) を使用するかを選択できます。このセクションでは、Grafana アラートについて説明します。

**注記**  
Classic アラートを有効にしてワークスペースを作成し、Grafana アラートに切り替える場合は、[2 つのアラートシステム間で切り替える](v9-alerting-use-grafana-alerts.md)ことができます。

## Grafana アラートの制約事項
<a name="v9-alert-limitations"></a>
+ Grafana アラートシステムは、利用可能なすべての Amazon Managed Service for Prometheus、Prometheus、Loki、およびアラートマネージャーデータソースからルールを取得できますが、他のサポートされているデータソースからはルールを取得できない場合があります。
+ Prometheus ではなく Grafana で定義されたアラートルールは、複数の通知をコンタクトポイントに送信します。ネイティブ Grafana アラートを使用している場合は、新しい Grafana アラート機能を有効にせず、従来のダッシュボードアラートのまま使用することをお勧めします。Prometheus データソースで定義されたアラートを表示する場合は、Grafana アラートを有効にすることをお勧めします。これにより、Prometheus アラートマネージャーで作成されたアラートの通知が 1 つだけ送信されます。
**注記**  
この制限は、Grafana v10.4 以降をサポートする Amazon Managed Grafana ワークスペースの制限ではなくなりました。

**Topics**
+ [Grafana アラートの制約事項](#v9-alert-limitations)
+ [概要:](v9-alerting-overview.md)
+ [アラートの詳細](v9-alerting-explore.md)
+ [アラートの設定](v9-alerting-setup.md)
+ [従来のダッシュボードアラートを Grafana アラートに移行する](v9-alerting-use-grafana-alerts.md)
+ [アラートルールの管理](v9-alerting-managerules.md)
+ [アラート通知の管理](v9-alerting-managenotifications.md)

# 概要:
<a name="v9-alerting-overview"></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. **データソース**

   アラートで使用するデータに接続します。このデータは、アラートの時系列データであることが多く、モニタリングおよび分析するシステムの詳細を示します。詳細については、[[データソース]](AMG-data-sources-builtin.md) を参照してください。

1. **アラートルール**

   アラートルールは、アラートインスタンスを起動するかどうかを決定する一連の評価基準であり、データソースからデータをプルするための 1 つ以上のクエリと式、アラートの必要性を表す条件、評価の頻度、およびオプションでアラートが発せられるために条件を満たす必要がある期間で構成されます。

   Grafana マネージドアラートは、多次元アラートをサポートします。つまり、各アラートルールは複数のアラートインスタンスを作成できます。これは、1 つの式で複数のシリーズを観察する場合に非常に強力です。

1. **ラベル**

   アラートルールとそのインスタンスを通知ポリシーとサイレンスに一致させます。また、アラートを重要度別にグループ化するためにも使用できます。

1. **通知ポリシー**

   アラートが発生したときにチームに通知するために、アラートがルーティングされる場所、タイミング、および方法を設定します。各通知ポリシーは、どのアラートを担当するかを示すラベルマッチャーのセットを指定します。通知ポリシーには、1 つ以上の通知者で構成されるコンタクトポイントが割り当てられます。

1. **コンタクトポイント**

   アラート発生時の通知先への通知方法を定義します。アラートがチームに適切に通知されるように、多数の ChatOps ツールをサポートしています。

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

**すべてのアラートを単一のページに**

Grafana が管理するアラートと、Prometheus 互換データソースに存在するアラートの両方が 1 つの Grafana アラートページに統合されます。

**多次元アラート**

アラートルールは、「多次元アラート」と呼ばれるアラートルールごとに複数の個別のアラートインスタンスを作成できるため、1 つのアラートルールだけでシステム全体の可視性を得るための機能と柔軟性が得られます。

**ルーティングアラート**

定義したラベルに基づいて、各アラートインスタンスを特定のコンタクトポイントにルーティングします。通知ポリシーは、アラートがどこで、いつ、どのようにコンタクトポイントにルーティングされるかを定義するルールのセットです。

**アラートのサイレンシング**

サイレンスを使用すると、1 つ以上のアラートルールからの永続通知の受信を停止できます。また、特定の基準に基づいてアラートを部分的に一時停止することもできます。サイレンスには、整理と可視性を向上させるための独自の専用セクションがあるため、メインアラートビューを乱すことなく一時停止したアラートルールをスキャンできます。

**ミュートタイミング**

ミュートタイミングでは、通知を新たに生成または送信しない時間間隔を指定できます。また、メンテナンス期間など、繰り返し発生する期間中にアラート通知を停止することができます。

# アラートの詳細
<a name="v9-alerting-explore"></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-alerting-explore-rule-types"></a>

**Grafana マネージドルール**

Grafana マネージドルールは、最も柔軟なアラートルールの種類です。これにより、サポートされている任意のデータソースのデータに対して動作するアラートを作成できます。複数のデータソースをサポートするだけでなく、式を追加してデータを変換し、アラート条件を設定することもできます。これは、単一のルール定義で複数のデータソースからのアラートを許可する唯一のルールタイプです。

**Mimir および Loki ルール**

Mimir または Loki アラートを作成するには、互換性のある Prometheus または Loki データソースが必要です。データソースをテストし、Ruler API がサポートされているかどうかを観察することで、データソースが Grafana 経由でルール作成をサポートしているかどうかを確認できます。

**記録ルール**

記録ルールは、互換性のある Prometheus または Loki データソースでのみ使用できます。記録ルールでは、頻繁に必要になる式や計算負荷の高い式を事前に計算し、その結果を新しい時系列セットとして保存できます。これは、集計データに対してアラートを実行する場合や、計算コストの高い式を繰り返しクエリするダッシュボードがある場合に便利です。

## 主な概念と特徴
<a name="v9-alerting-explore-features"></a>

次の表には、Grafana アラートを最大限に活用できるように設計された主要な概念、機能、およびそれらの定義の一覧を示します。


| 主要な概念または機能 | 定義 | 
| --- | --- | 
|  アラートに使用するデータソース  |  メトリクス、ログ、トレースをクエリおよび視覚化するデータソースを選択します。  | 
|  アラートのプロビジョニング  |  アラートリソースを管理し、ファイルプロビジョニングまたは Terraform を使用して Grafana システムにプロビジョニングします。  | 
|  アラートマネージャー  |  アラートインスタンスのルーティングとグループ化を管理します。  | 
|  アラートルール  |  アラートルールを発動させる評価基準のセット。アラートルールは、1 つ以上のクエリと式、条件、評価の頻度、その条件の持続時間で構成されます。アラートルールは、複数のアラートインスタンスを生成できます。  | 
|  アラートインスタンス  |  アラートインスタンスは、アラートルールのインスタンスです。1 次元アラートルールには 1 つのアラートインスタンスがあります。多次元アラートルールには 1 つ以上のアラートインスタンスがあります。複数の結果に一致する単一のアラートルール、たとえば 10 台の仮想マシンに対する CPU の監視は、複数 (この場合は 10) のアラートインスタンスとしてカウントされます。この数は時間の経過とともに変動する場合があります。たとえば、システム内のすべての仮想マシンの CPU 使用率を監視するアラートルールは、仮想マシンを追加するとアラートインスタンスが増加します。アラートインスタンスのクォータの詳細については、[クォータ到達エラー](v9-alerting-managerules-grafana.md#v9-alerting-rule-quota-reached) を参照してください。  | 
|  アラートグループ  |  アラートマネージャーは、ルート通知ポリシーのラベルを使用して、デフォルトでアラートインスタンスをグループ化します。これにより、コンタクトポイントに送信される重複排除とアラートインスタンスのグループが制御されます。  | 
|  コンタクトポイント  |  アラートルール発生時の通知先への通知方法を定義します。  | 
|  メッセージテンプレート  |  コンタクトポイント使用する再利用可能なカスタムテンプレートを作成します。  | 
|  通知ポリシー  |  アラートがどこで、いつ、どのようにグループ化され、コンタクトポイントにルーティングされるかを定義するルールのセット。  | 
|  ラベルとラベル照合機能  |  ラベルはアラートルールを識別するための一意な識別子です。ラベルによってアラートルールが通知ポリシーとサイレンスに紐づけられ、どのポリシーで処理されるか、どのアラートルールをサイレンス対象にするかを決定します。  | 
|  サイレンス  |  1 つ以上のアラートインスタンスからの通知を停止します。サイレンスとミュートタイミングの違いは、サイレンスは指定した時間帯の間だけ有効であるのに対し、ミュートタイミングはスケジュールに沿って繰り返される点です。アラートインスタンスをサイレンス対象とするにはラベル照合機能を使用します。  | 
|  ミュートタイミング  |  通知を新たに生成または送信しない時間間隔を指定します。また、メンテナンス期間など、繰り返し発生する期間中にアラート通知を停止することができます。既存の通知ポリシーにリンクする必要があります。  | 

# データソース
<a name="v9-alerting-explore-datasources"></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 アラートと互換性のある[データソース](AMG-data-sources-builtin.md)は多数あります。各データソースはプラグインでサポートされています。以下に示す組み込みデータソースのいずれかを使用できます。

これらは、Amazon Managed Grafana と互換性があり、Amazon Managed Grafana でサポートされているデータソースです。
+ [アラートマネージャーデータソースに接続する](data-source-alertmanager.md)
+ [Amazon CloudWatch データソースへの接続](using-amazon-cloudwatch-in-AMG.md)
+ [Amazon OpenSearch Service データソースへの接続](using-Amazon-OpenSearch-in-AMG.md)
+ [AWS IoT SiteWise データソースに接続する](using-iotsitewise-in-AMG.md)
+ [An AWS IoT TwinMaker データソースに接続する](AMG-iot-twinmaker.md)
+ [Amazon Managed Service for Prometheus およびオープンソースの Prometheus データソースへの接続](prometheus-data-source.md)
+ [Amazon Timestream データソースへの接続](timestream-datasource.md)
+ [Amazon Athena データソースに接続する](AWS-Athena.md)
+ [Amazon Redshift データソースに接続する](AWS-Redshift.md)
+ [AWS X-Ray データソースに接続する](x-ray-data-source.md)
+ [Azure Monitor データソースへの接続](using-azure-monitor-in-AMG.md)
+ [Google Cloud Monitoring データソースへの接続](using-google-cloud-monitoring-in-grafana.md)
+ [Graphite データソースに接続する](using-graphite-in-AMG.md)
+ [InfluxDB ソースデータベースに接続するには](using-influxdb-in-AMG.md)
+ [Loki データソースに接続するには](using-loki-in-AMG.md)
+ [Microsoft SQL Server データソースに接続する](using-microsoft-sql-server-in-AMG.md)
+ [MySQL データソースに接続する](using-mysql-in-AMG.md)
+ [OpenTSDB データソースに接続する](using-opentsdb-in-AMG.md)
+ [PostgreSQL データソースに接続する](using-postgresql-in-AMG.md)
+ [Jaeger データソースへの接続](jaeger-data-source.md)
+ [Zipkin データソースへの接続](zipkin-data-source.md)
+ [Tempo データソースへの接続](tempo-data-source.md)
+ [テスト用 TestData データソースの設定](testdata-data-source.md)

# アラートルールについて
<a name="v9-alerting-explore-rules"></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 つ以上のクエリと式、条件、評価の頻度、およびオプションとしてその条件の持続時間で構成されます。

評価するデータセットを「クエリと式」で選択し、「条件」にアラートがアラートを発行するための基準 (しきい値) を設定します。

間隔は、アラートルールが評価される頻度を指定します。「持続時間」を設定した場合、その条件下にある状態の継続時間を示します。また、アラートルールでは、データがない場合のアラート動作も設定できます。

**Topics**
+ [アラートルールタイプ](v9-alerting-explore-rules-types.md)
+ [アラートインスタンス](v9-alerting-rules-instances.md)
+ [名前空間とグループ](v9-alerting-rules-grouping.md)
+ [通知テンプレートの作成](v9-alerting-rules-notification-templates.md)

# アラートルールタイプ
<a name="v9-alerting-explore-rules-types"></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 マネージドルールは、最も柔軟なアラートルールの種類です。これにより、既存の任意のデータソースのデータに対して動作するアラートを作成できます。

あらゆるデータソースをサポートするだけでなく、[[式]](v9-panels-query-xform-expressions.md)を追加してデータを変換し、アラート条件を表現できます。

Mimir、Loki、Cortex ルール

Mimir、Loki、または Cortex アラートを作成するには、互換性のある Prometheus データソースが必要です。データソースが互換性があるかどうかを確認するには、データソースをテストし、Ruler API がサポートされているかどうかの詳細を確認します。

記録ルール

記録ルールは、Mimir、Loki、Cortex などの互換性のある Prometheus データソースでのみ使用できます。

記録ルールを使用すると、式の結果を新しい時系列のセットに保存できます。これは、集計データに対してアラートを実行する場合や、同じ式を繰り返しクエリするダッシュボードがある場合に便利です。

Prometheus での[記録ルール](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/)の詳細については、こちらを参照してください。

# アラートインスタンス
<a name="v9-alerting-rules-instances"></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 つの式で複数のシリーズを観察する場合に強力です。

次の PromQL 式を検討してください。

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

この式を使用するルールは、評価中に監視している CPU の数と同じ数のアラートインスタンスを作成し、単一のルールで各 CPU のステータスをレポートできるようにします。

# 名前空間とグループ
<a name="v9-alerting-rules-grouping"></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 マネージドルールのフォルダと、Mimir、Loki、または Prometheus のルールとグループ名の名前空間を使用して整理できます。

**名前空間**

Grafana マネージドルールを作成する場合、 フォルダを使用してアクセス制御を実行し、特定のフォルダ内のすべてのルールへのアクセスを許可または拒否できます。

**グループ**

グループ内のすべてのルールは、同じ**間隔**で評価されます。

グループ内のアラートルールと記録ルールは、常に**順番に**評価されます。つまり、同時に出現順に評価されるルールはありません。

**ヒント**  
ルールを異なる間隔で同時に評価したい場合は、異なるグループに保存することを検討してください。

# 通知テンプレートの作成
<a name="v9-alerting-rules-notification-templates"></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 のデフォルトテンプレートは [Go テンプレートシステム](https://golang.org/pkg/text/template)に基づいており、一部のフィールドはテキストとして評価され、他のフィールドは HTML (エスケープに影響する可能性があります) として評価されます。

デフォルトのテンプレート [[default\$1template.go]](https://github.com/grafana/alerting/blob/main/templates/default_template.go) は、カスタムテンプレートの便利なリファレンスとして機能します。

コンタクトポイントに使用するほとんどのフィールドはテンプレート化できるため、再利用可能なカスタムテンプレートを作成し、複数のコンタクトポイントで使用すると良いでしょう。テンプレートを使用したカスタム通知の詳細については、「[通知のカスタマイズ](v9-alerting-notifications.md)」を参照してください。

**テンプレートのネスト**

テンプレートは他のテンプレートに埋め込むことができます。

例えば、 `define` キーワードを使用してテンプレートフラグメントを定義できます。

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

その後、 `template` キーワードを使用して、このフラグメント内にカスタムテンプレートを埋め込むことができます。例えば、次のようになります。

```
Alert summary:
{{ template "mytemplate" . }}
```

以下の任意のビルトインのテンプレートオプションを使用して、カスタムテンプレートを埋め込むことができます。


| 名前 | 注意事項 | 
| --- | --- | 
|  `default.title`  |  全体的なステータス情報を表示します。  | 
|  `default.message`  |  発生中および解決済みのアラートの概要をフォーマット付きで提供します。  | 
|  `teams.default.message`  |  `default.messsage` と同様に、Microsoft Teams 用にフォーマットされています。  | 

**通知テンプレートの HTML**

アラート通知テンプレートの HTML はエスケープされます。結果の通知では、HTML のレンダリングはサポートされていません。

一部の通知機能は、結果の通知のルックアンドフィールを変更する代替方法をサポートしています。例えば、Grafana は `<grafana-install-dir>/public/emails/ng_alert_notification.html` に E メールをアラートするためのベーステンプレートをインストールします。このファイルを編集して、すべてのアラートメールの外観を変更できます。

# 数値データのアラート
<a name="v9-alerting-explore-numeric"></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 が時系列データではなく数値データのアラートを処理する方法について説明します。

特定のデータソースの中で、時系列ではない数値データは、サーバーサイド式 (SSE) で直接アラートしたり、渡したりすることができます。これにより、データソース内の処理と効率が向上し、アラートルールを簡素化することができます。時系列データではなく数値データを基にアラートを送信する場合、ラベル付きの各時系列を 1 つの数値に集約する必要はありません。代わりに、ラベル付き番号が Grafana に返されます。

**表形式のデータ**

この機能は、表形式データをクエリするバックエンドデータソースでサポートされています。
+ MySQL 、Postgres、MSSQL、Oracle などの SQL データソース。
+ Azure Kusto ベースのサービス: Azure Monitor (Logs)、Azure Monitor (Azure Resource Graph)、および Azure Data Explorer。

Grafana 管理のアラートまたは SSE を含むクエリは、以下の場合、これらのデータソースでは数値として扱われます。
+ データソースクエリの「Format AS」オプションが「テーブル」に設定されている。
+ クエリから Grafana に返されるテーブルレスポンスには、1 つの数値 (int、double、float など) 列と、オプションで追加の文字列列のみが含まれている。

文字列がある場合、それらの列はラベルになります。列の名前はラベル名になり、各行の値は対応するラベルの値になります。複数の行が返された場合、各行はラベルによって一意に識別される必要があります。

**例**

「DiskSpace」という名前の MySQL テーブルの場合:


| Time | ホスト | ディスク | PercentFree | 
| --- | --- | --- | --- | 
|  2021 年 6 月 7 日  |  web1  |  /etc  |  3  | 
|  2021 年 6 月 7 日  |  web2  |  /var  |  4  | 
|  2021 年 6 月 7 日  |  web3  |  /var  |  8  | 
|  ...  |  ...  |  ...  |  ...  | 

データを時間でフィルタリングしてクエリを実行できますが、時間系列は Grafana に返す必要はありません。例えば、空き容量が 5% 未満の場合にホスト、ディスクごとにトリガーされるアラートです。

```
SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
   SELECT
      Host, 
      Disk, 
      Avg(PercentFree) 
   FROM DiskSpace
   Group By
      Host, 
      Disk 
   Where __timeFilter(Time)
```

このクエリでは、次のようなレスポンステーブルが Grafana に返されます。


| ホスト | ディスク | PercentFree | 
| --- | --- | --- | 
|  web1  |  /etc  |  3  | 
|  web2  |  /var  |  4  | 
|  web3  |  /var  |  0  | 

このクエリがアラートルールの**条件**として使用されると、ゼロ以外のクエリはアラートになります。その結果、次の 3 つのアラートインスタンスが生成されます。


| ラベル | ステータス | 
| --- | --- | 
|  \$1Host=web1,disk=/etc\$1  |  [アラート]  | 
|  \$1Host=web2,disk=/var\$1  |  [アラート]  | 
|  \$1Host=web3,disk=/var\$1  |  普通  | 

# ラベルと注釈
<a name="v9-alerting-explore-labels"></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)」を参照してください。

ラベルと注釈には、アラートに関する情報が含まれています。ラベルと注釈はどちらも同じ構造であり、名前付き値のセットですが、用途は異なります。ラベルまたは同等の注釈の例は、`alertname="test"` である場合があります。

ラベルと注釈の主な違いは、ラベルはアラートを他のすべてのアラートと区別するために使用され、注釈は既存のアラートに追加情報を追加するために使用されるという点です。

例えば、2 つの高 CPU アラートを考えてみましょう。1 つは `server1` 用、もう 1 つは `server2` 用です。このような例では、最初のアラートに `server="server1"` というラベルがあり、2 番目のアラートに `server="server2"` というラベルがある、`server` というラベルがある場合があります。ただし、 `server1` や `75%` がサーバーの名前と CPU 使用率に置き換えられる `"The CPU usage for server1 is above 75%."` などの各アラートに説明を追加することもできます (これを行う方法については、[ラベルと注釈のテンプレート作成](v9-alerting-explore-labels-templating.md) のドキュメントを参照してください）。このような説明は、注釈としてより適しています。

## ラベル
<a name="v9-alerting-explore-labels-labels"></a>

ラベルには、アラートを識別する情報が含まれます。ラベルの例は `server=server1` です。各アラートには複数のラベルを含めることができ、アラートのラベルの完全なセットはラベルセットと呼ばれます。アラートを識別するのはこのラベルセットです。

例えば、アラートにラベルセット `{alertname="High CPU usage",server="server1"}` が設定されているのに対し、別のアラートにラベルセット `{alertname="High CPU usage",server="server2"}` が設定されている場合があります。`alertname` ラベルは同じですが、`server` ラベルは異なるため、これらは 2 つの別々のアラートです。

アラートのラベルセットは、データソースのラベル、アラートルールのカスタムラベル、`alertname` などの予約済みラベルの組み合わせです。

**カスタムラベル**

カスタムラベルは、アラートルールからの追加ラベルです。注釈と同様に、カスタムラベルには名前が必要です。その値には、アラートが発射したときに評価されるテキストコードとテンプレートコードの組み合わせを含めることができます。カスタムラベルをテンプレート化する方法については、 [こちら](v9-alerting-explore-labels-templating.md)を参照してください。

テンプレートでカスタムラベルを使用する場合、多数の個別のアラートが生成されるのを避けるため、ラベルの値がアラートルールの連続した評価間で変化しないようにすることが重要です。ただし、テンプレートが異なるアラートに対して異なるラベル値を生成しても問題ありません。例えば、値が変更されるたびに新しいアラートセットが作成されてしまうため、クエリの値をカスタムラベルに入れないでください。代わりに注釈を使用します。

また、アラートのラベルセットに同じ名前のラベルが 2 つ以上ないことを確認することも重要です。カスタムラベルの名前がデータソースのラベルと同じ場合は、そのラベルが置き換えられます。ただし、カスタムラベルの名前が予約済みラベルと同じ場合、カスタムラベルはアラートから省略されます。

## ‏注釈
<a name="v9-alerting-explore-labels-annotations"></a>

注釈は、既存のアラートに追加情報を追加する名前付きペアです。Grafana には、`description`、`summary`、`runbook_url`、`dashboardUId`、`panelId` など、推奨される注釈が多数あります。カスタムラベルと同様に、注釈には名前が必要です。その値には、アラートが発射したときに評価されるテキストコードとテンプレートコードの組み合わせを含めることができます。注釈にテンプレートコードが含まれている場合は、アラートが発生したときにテンプレートが 1 回評価されます。アラートが解決されても、再評価されません。注釈をテンプレートする方法については、[こちら](v9-alerting-explore-labels-templating.md)を参照してください。

# ラベル一致の仕組み
<a name="v9-alerting-explore-labels-matching"></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)」を参照してください。

ラベルとラベルマッチャーを使用して、アラートルールを通知ポリシーとサイレンスにリンクできます。これにより、アラートインスタンスを柔軟に管理し、処理するポリシーとサイレンスするアラートを指定できます。

ラベルマッチャーは、**ラベル**、**値**、**演算子** の 3 つの異なる部分で構成されます。
+ **[ラベル]**フィールドは、一致するラベルの名前です。ラベル名と完全に一致する必要があります。
+ **[値]**フィールドは、指定された**ラベル**名の対応する値と一致します。一致方法は、**演算子**の値によって異なります。
+ **[演算子]** フィールドは、ラベル値と一致させる演算子です。利用できる演算子は次のとおりです。


| 演算子 | 説明 | 
| --- | --- | 
|  `=`  |  値と完全に等しいラベルを選択します。  | 
|  `!=`  |  値と等しくないラベルを選択します。  | 
|  `=~`  |  値と正規表現が一致するラベルを選択します。  | 
|  `!~`  |  値と正規表現が一致しないラベルを選択します。  | 

複数のラベルマッチャーを使用している場合は、AND 論理演算子を使用して組み合わせられます。つまり、ルールをポリシーにリンクするには、すべてのマッチャーが一致する必要があります。

**シナリオの例**

アラートに次のラベルセットを定義する場合：

```
{ foo=bar, baz=qux, id=12 }
```

次に：
+ `foo=bar` として定義されたラベルマッチャーは、このアラートルールと一致します。
+ `foo!=bar` として定義されたラベルマッチャーがこのアラートルールと一致*しません*。
+ `id=~[0-9]+` として定義されたラベルマッチャーは、このアラートルールと一致します。
+ `baz!~[0-9]+` として定義されたラベルマッチャーは、このアラートルールと一致します。
+ `foo=bar`と`id=~[0-9]+`として定義された 2 つのラベルマッチャーは、このアラートルールと一致します。

# Grafana アラートのラベル
<a name="v9-alerting-explore-labels-alerting"></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 アラート内のアラートを一意に識別するものです。
+ アラートマネージャーはラベルを使用して、通知ポリシーのサイレンスとアラートグループのアラートを照合します。
+ アラート UI には、そのルールの評価中に生成されたすべてのアラートインスタンスのラベルが表示されます。
+ コンタクトポイントには、通知を生成する際にラベルにアクセスして、そのアラートに固有の情報を含めることができます。
+ [アラートルール](v9-alerting-managerules.md)にラベルを追加できます。ラベルは手動で設定でき、テンプレート関数を使用し、他のラベルを参照できます。アラートルールに追加されたラベルは、ラベル間で競合が発生した場合に優先されます (Grafana の予約済みラベルの場合を除きます。詳細については、以下を参照してください)。

**外部アラートマネージャーの互換性**

Grafana の組み込みアラートマネージャーは、Unicode ラベルキーと値の両方をサポートしています。外部 Prometheus アラートマネージャーを使用している場合、ラベルキーは[[データモデル]](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)と互換性がある必要があります。つまり、ラベルキーには、**ASCII 文字**、**数字**および**アンダースコア**のみが含まれ、正規表現 `[a-zA-Z_][a-zA-Z0-9_]*` と一致する必要があります。無効な文字は、Grafanaアラートエンジンによって削除または置換されてから、次の規則に従って外部アラートマネージャーに送信されます。
+ `Whitespace` は削除されます。
+ `ASCII characters` は、`_`に置き換えられます。
+ `All other characters` は、小文字の 16 進数表現に置き換えられます。これが最初の文字の場合、`_` というプレフィックスがつきます。

**注記**  
複数のラベルキーが同じ値にサニタイズされている場合、重複にはサフィックスとして追加された元のラベルの短いハッシュが付加されます。

**Grafana 予約済みラベル**

**注記**  
`grafana_` のプレフィックスがついたラベルは、Grafana によって特別な用途のために予約されています。`grafana_` で始まる手動で設定されたラベルが追加されると、競合時に上書きされます。

Grafana 予約済みラベルは、手動で設定されたラベルと同じ方法で使用できます。利用可能な予約済みラベルの現在のリストは次のとおりです。


| ラベル | 説明 | 
| --- | --- | 
|  grafana\$1folder  |  アラートを含むフォルダのタイトル。  | 

# ラベルと注釈のテンプレート作成
<a name="v9-alerting-explore-labels-templating"></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 では、Prometheus と同じようにラベルと注釈をテンプレート化します。Prometheus を使用した経験がある場合は、アラートのラベルと値を含む `$labels` 変数と `$value` 変数に精通していると思います。アラートが Prometheus データソースを使用していない場合でも、Grafana で同じ変数を使用できます。以前に Prometheus を使用したことがない場合は、これらの変数のそれぞれとテンプレートの作成方法をこのページで説明するのでご安心ください。

## Go のテンプレート言語
<a name="v9-alerting-explore-labels-templating-go"></a>

ラベルと注釈のテンプレートは、Go のテンプレート言語 [ text/template ](https://pkg.go.dev/text/template)で記述されます。

**開始と終了のタグ**

テキスト/テンプレートでは、テンプレートが変数を印刷するか、if ステートメントなどのコントロール構造を実行するかに関係なく、テンプレートは `{{`で始まり、`}}` で終わります。これは、変数の出力に `{{` と `}}` を使用し、制御構造に `{%` と `%}` を使用する Jinja などの他のテンプレート言語とは異なります。

**印刷**

何かの値を印刷するには、`{{` と `}}` を使用します。関数の結果または変数の値を印刷できます。例えば、`$labels` 変数を印刷するには、次のように書き込みます。

```
{{ $labels }}
```

**ラベルを反復処理する**

`$labels` 内の各ラベルを反復処理するには、`range` を使用できます。ここでは、`$k` は名前を表し、`$v` は現在のラベルの値を表します。例えば、クエリがラベル `instance=test` を返した場合、 `$k` は `instance` になり、`$v` は `test` になります。

```
{{ range $k, $v := $labels }}
{{ $k }}={{ $v }}
{{ end }}
```

## ラベル、値、値変数
<a name="v9-alerting-explore-labels-templating-variables"></a>

**ラベル変数**

`$labels` 変数には、クエリのラベルが含まれます。たとえば、インスタンスがダウンしているかどうかを確認するクエリは、停止しているインスタンスの名前を含むインスタンスラベルを返す場合があります。例えば、インスタンスの 1 つが 5 分以上ダウンしたときに発生するアラートルールがあるとします。どのインスタンスがダウンしているかを知らせる概要をアラートに追加します。`$labels` 変数を使用すると、概要にインスタンスラベルを印刷する概要を作成できます。

```
Instance {{ $labels.instance }} has been down for more than 5 minutes
```

**ドット付きのラベル**

印刷するラベルに、テンプレート内の同じドットを使用して名前にドット (ピリオド) が含まれている場合、機能しません。

```
Instance {{ $labels.instance.name }} has been down for more than 5 minutes
```

これは、テンプレートが `$labels.instance` で `name` という既存のフィールドを使用しようとしているためです。代わりに、`index` 関数を使用する必要があります。この関数は、`$labels` 変数 `instance.name` にラベルを出力します。

```
Instance {{ index $labels "instance.name" }} has been down for more than 5 minutes
```

**値変数**

`$value` 変数の動作は Prometheus とは異なります。Prometheusでは、`$value` は式の値を含む浮動小数点数ですが、Grafana では、このアラートルールのすべてのしきい値、縮小式、数式およびクラシック条件のラベルと値を含む文字列です。クエリの結果は 10 から 10,000 行またはメトリクスのどこかに返される可能性があるため、含まれていません。

アラートの概要で `$value` 変数を使用する場合:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $value }})
```

概要は、次のようになります。

```
api has an over 5% of responses with 5xx errors: [ var='B' labels={service=api} value=6.789 ]
```

ここでは、`var='B'` は RefID B を持つ式を指します。Grafana では、すべてのクエリと式は、アラートルール内の各クエリと式を識別する RefID によって識別されます。同様に、`labels={service=api}` はラベルを表し、`value=6.789` は値を表します。

RefID A がないことが観察された可能性があります。これは、ほとんどのアラートルールでは RefID A がクエリを参照し、クエリが多くの行や時系列を返す可能性があるため、`$value` に含まれていないためです。

**値変数**

`$value` 変数に必要以上の情報が含まれている場合は、代わりに `$values` を使用して個々の式のラベルと値を印刷できます。`$value` とは異なり、`$values` 変数は、各式のラベルと浮動小数点値を含むオブジェクトのテーブルで、RefID によってインデックス化されます。

アラートの概要に RefID `B` を使用して式の値を印刷する場合：

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $values.B }}%
```

概要には、値のみが含まれます。

```
api has an over 5% of responses with 5xx errors: 6.789%
```

ただし、`{{ $values.B }}` は数字 6.789 を出力しますが、実際には RefID B のラベルと値の両方を含むオブジェクトを出力する文字列であり、B の浮動小数点値ではありません。RefID B の浮動小数点値を使用するには、`$values.B` の `Value` フィールドを使用する必要があります。アラートの概要の浮動小数点値をヒューマナイズする場合：

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanize $values.B.Value }}%
```

**データなし、ランタイムエラー、タイムアウト**

アラートルールのクエリがデータなしを返す場合、またはデータソースのエラーやタイムアウトが原因で失敗した場合、そのクエリを使用するしきい値、縮小式、または数式もデータやエラーを返しません。この場合、これらの式は `$values` には存在しません。使用する前に RefID が存在することを確認することをお勧めします。RefID が存在しない場合、クエリがデータやエラーを返さない場合にテンプレートが壊れます。これは、if ステートメントを使用して行うことができます。

```
{{ if $values.B }}{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanizePercentage $values.B.Value }}{{ end }}
```

## クラシック条件
<a name="v9-alerting-explore-labels-templating-classic"></a>

ルールがしきい値、縮小式、および数式の代わりにクラシック条件を使用する場合、`$values` 変数はクラシック条件の条件の Ref ID と位置の両方によってインデックス化されます。例えば、RefID B に 2 つの条件を含むクラシック条件がある場合、`$values` には 2 つの条件 `B0` と `B1` が含まれます。

```
The first condition is {{ $values.B0 }}, and the second condition is {{ $values.B1 }}
```

## 関数
<a name="v9-alerting-explore-labels-templating-functions"></a>

ラベルと注釈を展開するときにも、次の関数を使用できます。

**args**

`args` 関数は、オブジェクトのリストをキー arg0、arg1 などのマップに変換します。これは、複数の引数をテンプレートに渡せるようにすることを目的としています。

**例**

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**externalURL**

`externalURL` 関数は、ini ファイル (複数可) で設定された Grafana サーバーの外部 URL を返します。

**例**

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**graphLink**

`graphLink` 関数は、指定された式とデータソースの [Grafana バージョン 9 で探索する](v9-explore.md) のグラフィックビューへのパスを返します。

**例**

```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```

**humanize**

`humanize` 関数は 10 進数をヒューマナイズします。

**例**

```
{{ humanize 1000.0 }}
```

```
1k
```

**humanize1024**

`humanize1024` は `humanize` と似ていますが、1000 ではなく 1024 をベースとして使用します。

**例**

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**humanizeDuration**

`humanizeDuration` 関数は、期間を秒単位でヒューマナイズします。

**例**

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**humanizePercentage**

`humanizePercentage` 関数は、比率値をパーセンテージにヒューマナイズします。

**例**

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**humanizeTimestamp**

`humanizeTimestamp` 関数は Unix タイムスタンプをヒューマナイズします。

**例**

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**match**

`match` 関数は、テキストを正規表現パターンと一致させます。

**例**

```
{{ match "a.*" "abc" }}
```

```
true
```

**pathPrefix**

`pathPrefix` 関数は、ini ファイル (複数可) で設定された Grafana サーバーのパスを返します。

**例**

```
{{ pathPrefix }}
```

```
/grafana
```

**tableLink**

`tableLink` 関数は、指定された式とデータソースの [Grafana バージョン 9 で探索する](v9-explore.md) の表形式ビューへのパスを返します。

**例**

```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```

**title**

`title` 関数は、各単語の最初の文字を大文字にします。

**例**

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**toLower**

`toLower` 関数はすべてのテキストを小文字で返します。

**例**

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**toUpper**

`toUpper` 関数は、すべてのテキストを大文字で返します。

**例**

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

`reReplaceAll` 関数は、正規表現に一致するテキストを置き換えます。

**例**

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# アラートルールの状態と正常性
<a name="v9-alerting-explore-state"></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)」を参照してください。

アラートルールの状態と正常性は、アラートに関するいくつかの主要なステータスインジケータを理解するのに役立ちます。

*アラートルールの状態 *、*アラートインスタンスの状態*、*アラートルールの正常性*の 3 つの主要なコンポーネントがあります。それぞれに関連はありますが、各コンポーネントは微妙に異なる情報を伝達します。

**アラートルールの状態**

アラートルールは、次のいずれかの状態になります。


| State | 説明 | 
| --- | --- | 
|  普通  |  評価エンジンによって返される時系列のいずれも `Pending` または `Firing` 状態ではありません。  | 
|  保留中  |  評価エンジンから返される少なくとも 1 つの時系列は `Pending` です。  | 
|  発射  |  評価エンジンから返される少なくとも 1 つの時系列は `Firing` です。  | 

**注記**  
アラートは最初に `pending` に移行し、次に `firing` に移行します。そのため、アラートが発生する前に少なくとも 2 つの評価サイクルが必要になります。

**アラートインスタンスの状態**

アラートインスタンスは、次のいずれかの状態になります。


| State | 説明 | 
| --- | --- | 
|  普通  |  発射も保留中もなく、すべてが正しく機能しているアラートの状態。  | 
|  保留中  |  設定されたしきい値期間未満でアクティブであったアラートの状態。  | 
|  [アラート]  |  設定されたしきい値期間よりも長くアクティブであったアラートの状態。  | 
|  NoData  |  設定された時間枠のデータを受信しない状態。  | 
|  エラー  |  アラートルールの評価を試みたときに発生したエラー。  | 

**アラートルールの正常性**

アラートルールは、次のいずれかの正常性ステータスとなります。


| State | 説明 | 
| --- | --- | 
|  Ok  |  アラートルールを評価するときにエラーがありません。  | 
|  エラー  |  アラートルールの評価中にエラーが発生しました。  | 
|  NoData  |  ルール評価中に返される少なくとも 1 つの時系列にデータがありません。  | 

**`NoData` および `Error` [の特別なアラート]**

アラートルールの評価で状態 `NoData` または `Error` が生成されると、Grafana アラートは、次の追加ラベルを含むアラートインスタンスを生成します。


| ラベル | 説明 | 
| --- | --- | 
|  AlertName  |  状態に応じて、`DatasourceNoData` または `DatasourceError` のいずれか。  | 
|  datasource\$1uid  |  状態の原因となったデータソースの UID。  | 

これらのアラートは、サイレンスを追加したり、コンタクトポイントにルーティングしたりすることで、通常のアラートと同じ方法で処理できます。

# コンタクトポイント
<a name="v9-alerting-explore-contacts"></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)」を参照してください。

コンタクトポイントを使用して、アラートルールが発生したときにコンタクトに通知する方法を定義します。コンタクトポイントは、E メール、Slack、ウェブフックなど、1 つ以上のコンタクトポイントタイプを持つことができます。アラートルールが発動すると、コンタクトポイントにリストされているすべてのコンタクトポイントタイプに通知が送信されます。Grafana アラートマネージャーと外部アラートマネージャーのコンタクトポイントを設定できます。

通知テンプレートを使用して、コンタクトポイントタイプの通知メッセージをカスタマイズすることもできます。

**サポートされているコンタクトポイントタイプ**

次の表に、Grafana でサポートされているコンタクトポイントのタイプを示します。


| 名前 | タイプ | 
| --- | --- | 
|  Amazon SNS  |  `sns`  | 
|  OpsGenie  |  `opsgenie`  | 
|  Pager Duty  |  `pagerduty`  | 
|  Slack  |  `slack`  | 
|  VictorOps  |  `victorops`  | 

コンタクトポイントの詳細については、「[コンタクトポイント (通知先) の使用](v9-alerting-contact-points.md)」と「[通知のカスタマイズ](v9-alerting-notifications.md)」を参照してください。

# 通知
<a name="v9-alerting-explore-notifications"></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」と呼ばれる独自のアラートマネージャーがありますが、[Prometheus アラートマネージャー](https://prometheus.io/docs/alerting/latest/alertmanager/)などの他のアラートマネージャーからの通知の送信もサポートしています。Grafana アラートマネージャーは、通知ポリシーと問い合わせポイントを使用して、通知の送信方法と送信先、通知の送信頻度、アラートをすべて同じ通知で送信するか、ラベルのセットに基づいてグループ化された通知で送信するか、個別の通知として送信するかを設定します。

## 通知ポリシー
<a name="v9-alerting-explore-notifications-policies"></a>

通知ポリシーは、通知の送信日時と送信場所を制御します。通知ポリシーでは、すべてのアラートを同じ通知でまとめて送信するか、ラベルのセットに基づいてグループ化された通知でアラートを送信するか、個別の通知としてアラートを送信するかを選択できます。各通知ポリシーを設定して、通知の送信頻度を制御するだけでなく、1 日の特定時刻および特定の曜日に通知を禁止するための 1 つ以上のミュートタイミングを設定することもできます。

通知ポリシーは、ツリーのルートにルートポリシーと呼ばれる通知ポリシーがあるツリー構造で構成されています。ルートポリシーは 1 つだけ設定でき、削除できません。

特定のルーティングポリシーはルートポリシーの子であり、一致するラベルのセットに基づいてすべてのアラートまたはアラートのサブセットを照合するために使用できます。通知ポリシーは、一致するラベルがアラート内のラベルと一致するときにアラートと一致します。

特定のルーティングポリシーには「ネストされたポリシー」と呼ばれる独自の子ポリシーを含めることができ、アラートの追加マッチングが可能になります。特定のルーティングポリシーの例としては、Ops チームにインフラストラクチャアラートを送信する場合があります。子ポリシーは、Pagerduty に高優先度アラートを送信し、Slack に低優先度アラートを送信することができます。

ラベルに関係なく、すべてのアラートはルートポリシーと一致します。ただし、ルートポリシーがアラートを受信すると、特定の各ルーティングポリシーが調査され、アラートに一致する最初の特定のルーティングポリシーにアラートが送信されます。特定のルーティングポリシーにさらに子ポリシーがある場合、ネストされたポリシーの 1 つとアラートとのマッチングを試行できます。ネストされたポリシーがアラートと一致しない場合、特定のルーティングポリシーが一致するポリシーになります。特定のルーティングポリシーがないか、アラートに一致する特定のルーティングポリシーがない場合、ルートポリシーは一致するポリシーです。

## コンタクトポイント
<a name="v9-alerting-explore-notifications-contacts"></a>

コンタクトポイントには、通知を送信するための設定が含まれています。コンタクトポイントは統合のリストであり、それぞれが特定の E メールアドレス、サービス、または URL に通知を送信します。コンタクトポイントには、同じ種類の複数の統合、または異なる種類の統合の組み合わせを含めることができます。例えば、コンタクトポイントには、Pager Duty 統合、Pager Duty と Slack 統合、または Pager Duty 統合、Slack 統合、および 2 つの Amazon SNS 統合を含めることができます。統合なしでコンタクトポイントを設定することもできますが、その場合、通知は送信されません。

コンタクトポイントは、通知ポリシーに追加されるまで通知を送信できません。通知ポリシーは 1 つのコンタクトポイントにのみアラートを送信できますが、複数の通知ポリシーに同時にコンタクトポイントを追加できます。アラートが通知ポリシーと一致すると、アラートはその通知ポリシーのコンタクトポイントに送信され、その通知ポリシーはその設定の各統合に通知を送信します。

**注記**  
コンタクトポイントでサポートされている統合の詳細については、「[コンタクトポイント](v9-alerting-explore-contacts.md)」を参照してください。

## 通知テンプレートの作成
<a name="v9-alerting-explore-notifications-templating"></a>

テンプレートを使用して通知をカスタマイズできます。例えば、テンプレートを使用して、Slack に送信される通知のタイトルとメッセージを変更することができます。

テンプレートは個々の統合やコンタクトポイントに限定されず、同じコンタクトポイント内の多数の統合や、異なるコンタクトポイント間の統合でも使用できます。例えば、Grafana ユーザーは、`custom_subject_or_title` というテンプレートを作成し、2 つの個別のテンプレートを作成することなく、Pager Duty のテンプレート件名と Slack メッセージのタイトルの両方に使用できます。

すべての通知テンプレートはアラートページの [コンタクトポイント] タブにあり、[[Go のテンプレート言語]](https://pkg.go.dev/text/template)で記述されます。

## サイレンス
<a name="v9-alerting-explore-notifications-silences"></a>

サイレンスを使用して、1 つ以上の発射ルールからの通知をミュートできます。サイレンスは、アラートの発射や解決を停止したり、ユーザーインターフェイスで発射アラートを非表示にしたりしません。サイレンスは、分、時間、日、月、または年で設定し、その期間だけ続きます。

# アラートの設定
<a name="v9-alerting-setup"></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)」を参照してください。

アラートの作成と管理に必要な機能と統合を設定します。

**Topics**
+ [外部アラートマネージャーの追加](v9-alerting-setup-alertmanager.md)
+ [Grafana アラートリソースのプロビジョニング](v9-alerting-setup-provision.md)

# 外部アラートマネージャーの追加
<a name="v9-alerting-setup-alertmanager"></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 アラート UI を使用して、サイレンス、コンタクトポイント、通知ポリシーを管理できます。これらのページのドロップダウンオプションを使用すると、アラートマネージャーを切り替えることができます。

**注記**  
Grafana 9.2 以降、アラートページの [管理] タブからの外部アラートマネージャーの URL 設定は廃止されました。これは、今後のリリースで削除されます。

外部アラートマネージャーは、メインの Grafana ナビゲーションメニューから Grafana 設定を使用してデータソースとして設定する必要があります。これにより、Grafana 内から外部アラートマネージャーの連絡先と通知ポリシーを管理できるようになり、以前は URL で外部アラートマネージャーを構成するときに表示されていた HTTP 基本認証資格情報も暗号化されます。

外部アラートマネージャーを追加するには、次のステップに従います。

1. [設定]、[データソース] を続けてクリックします。

1. アラートマネージャーを検索します。

1. 実装を選択し、必要に応じてページのフィールドに入力します。

   データソースをプロビジョニングする場合は、`jsonData` フィールドの `handleGrafanaManagedAlerts` フラグを `true` に設定して、Grafana が管理するアラートをこのアラートマネージャーに送信します。
**注記**  
アラートマネージャーの Prometheus、Grafana Mimir、および Cortex 実装がサポートされています。Prometheus の場合、Grafana アラート UI のコンタクトポイントと通知ポリシーは読み取り専用です。

1. [保存してテスト] をクリックします。

# Grafana アラートリソースのプロビジョニング
<a name="v9-alerting-setup-provision"></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 アラートプロビジョニングを使用すると、組織に最適な方法でアラートデータを作成、管理、維持できるため、このプロセスが容易になります。

選択できるオプションは 2 つあります。

1. アラートプロビジョニング HTTP API を使用してアラートリソースをプロビジョニングします。
**注記**  
通常、Grafana UI から API でプロビジョニングされたアラートルールを編集することはできません。  
編集を有効にするには、 API でアラートルールを作成または編集するときに、x-disable-provenance ヘッダーを次のリクエストに追加します。  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Terraform を使用してアラートリソースをプロビジョニングします。

**注記**  
現在、Grafana アラートのプロビジョニングでは、アラートルール、コンタクトポイント、ミュートタイミング、テンプレートがサポートされています。ファイルプロビジョニングまたは Terraform を使用してプロビジョニングされたアラートリソースは、それらを作成したソースでのみ編集でき、Grafana やその他のソース内から編集することはできません。例えば、ディスクからのファイルを使用してアラートリソースをプロビジョニングする場合、Terraform または Grafana 内からデータを編集することはできません。

**Topics**
+ [Terraform を使用したアラートリソースの作成と管理](v9-alerting-setup-provision-terraform.md)
+ [Grafana でのプロビジョニングされたアラートリソースの表示](v9-alerting-setup-provision-view.md)

# Terraform を使用したアラートリソースの作成と管理
<a name="v9-alerting-setup-provision-terraform"></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)」を参照してください。

Terraform の Grafana プロバイダーを使用してアラートリソースを管理し、Grafana システムにプロビジョニングします。Terraform プロバイダーによる Grafana アラートのサポートにより、Grafana アラートスタック全体をコードとして簡単に作成、管理、維持できます。

Terraform を使用してアラートリソースを管理する方法の詳細については、Terraform ドキュメントの [[Grafana プロバイダー]](https://registry.terraform.io/providers/grafana/grafana/latest/docs) ドキュメントを参照してください。

Terraform を使用してアラートリソースを作成および管理するには、次のタスクを実行します。

1. プロビジョニング用の API キーを作成します。

1. Terraform プロバイダーを設定します。

1. Terraform でアラートリソースを定義します。

1. `terraform apply` を実行して、アラートリソースをプロビジョニングします。

## 前提条件
<a name="v9-alerting-setup-provision-tf-prerequisites"></a>
+ grafana/grafana [[Terraform プロバイダー]](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 以降があることを確認します。
+ また、Grafana 9.1 以降を使用していることを確認します。Grafana バージョン 9 で Amazon Managed Grafana インスタンスを作成した場合、これは当てはまります。

## プロビジョニング用の API キーの作成
<a name="v9-alerting-setup-provision-tf-apikey"></a>

[通常の Grafana API キーを作成して](Using-Grafana-APIs.md)、Grafana で Terraform を認証できます。API キーを使用する既存のツールのほとんどは、新しい Grafana アラートサポートと自動的に連携します。Terraform で使用するキーの作成の詳細については、[[Amazon Managed Grafana オートメーションでの Terraform の使用]](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/)を参照してください。

**プロビジョニング用の API キーを作成するには**

1. CI パイプラインの新しいサービスアカウントを作成します。

1. ロール「アラートルールプロビジョニング API にアクセス」を割り当てます。

1. 新しいサービスアカウントトークンを作成します。

1. Terraform で使用するトークンに名前を付けて保存します。

または、基本認証を使用することもできます。サポートされているすべての認証形式を表示するには、Terraform ドキュメントの [[Grafana 認証]](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) を参照してください。

## Terraform プロバイダーの設定
<a name="v9-alerting-setup-provision-tf-configure"></a>

Grafana アラートのサポートは、[[Grafana Terraform プロバイダー]](https://registry.terraform.io/providers/grafana/grafana/latest/docs) の一部として含まれています。

以下は、Terraform プロバイダーの設定に使用できる例です。

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## コンタクトポイントとテンプレートのプロビジョニング
<a name="v9-alerting-setup-provision-tf-contacts"></a>

コンタクトポイントは、アラートスタックを外部に接続します。これは、外部システムに接続する方法と通知の配信先を Grafana に伝えます。選択できる[統合](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional)は 15 種類以上あります。この例では、Slack コンタクトポイントを使用します。

**コンタクトポイントとテンプレートをプロビジョニングするには**

1. このコードブロックをローカルマシンの .tf ファイルにコピーします。*<slack-webhook-url>* を Slack Webhook URL (またはその他のコンタクトポイントの詳細) に置き換えます。

   この例では、アラート通知を Slack に送信するコンタクトポイントを作成します。

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. 通知のテキストをテキストフィールドに入力します。

   `text` フィールドは [Go 形式のテンプレート](https://pkg.go.dev/text/template)をサポートします。これにより、Terraform で Grafana アラート通知テンプレートを直接管理できます。

1. `terraform apply` コマンドを実行します。

1. Grafana UI に移動し、コンタクトポイントの詳細を確認します。

   UI から Terraform 経由でプロビジョニングされたリソースを編集することはできません。これにより、アラートスタックは常にコードと同期したままになります。

1. **[テスト]** をクリックして、コンタクトポイントが正しく機能することを確認します。

**注記**  
多くのコンタクトポイントで同じテンプレートを再利用できます。上記の例では、`{{ template "Alert Instance Template" . }}` ステートメントを使用して共有テンプレートが埋め込まれています  
その後、このフラグメントは Terraform で個別に管理できます。  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## 通知ポリシーとルーティングのプロビジョニング
<a name="v9-alerting-setup-provision-tf-notifications"></a>

通知ポリシーは、アラートインスタンスをどこにルーティングするかではなく、どのようにルーティングするかを Grafana に指示します。ラベルとマッチャーのシステムを使用して、発動アラートを以前に定義したコンタクトポイントに接続します。

**通知ポリシーとルーティングをプロビジョニングするには**

1. このコードブロックをローカルマシンの .tf ファイルにコピーします。

   この例では、アラートは `alertname` によってグループ化されます。つまり、同じ名前のアラートから送信される通知は、同じ Slack メッセージにグループ化されます。

   特定の通知を別の方法でルーティングする場合は、サブポリシーを追加できます。サブポリシーを使用すると、ラベルマッチングに基づいて異なるアラートにルーティングを適用できます。この例では、ラベル a=b のすべてのアラートにミュートタイミングを適用します。

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. mute\$1timings フィールドで、ミュートタイミングを通知ポリシーにリンクします。

1. `terraform apply` コマンドを実行します。

1. Grafana UI に移動し、通知ポリシーの詳細を確認します。
**注記**  
Terraform からプロビジョニングされたリソースを UI から編集することはできません。これにより、アラートスタックは常にコードと同期したままになります。

1. **[テスト]** をクリックして、通知ポイントが正しく機能していることを確認します。

## ミュートタイミングのプロビジョニング
<a name="v9-alerting-setup-provision-tf-mutetiming"></a>

ミュートタイミングを使用すると、定義された期間のアラート通知をミュートできます。

**ミュートタイミングをプロビジョニングするには**

1. このコードブロックをローカルマシンの .tf ファイルにコピーします。

   この例では、アラート通知は週末にミュートされます。

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. `terraform apply` コマンドを実行します。

1. Grafana UI に移動し、ミュートタイミングの詳細を確認します。

1. `mute_timings` フィールドを使用して、通知ポリシーで新しく作成したミュートタイミングを参照します。これにより、通知の一部またはすべてにミュートタイミングが適用されます。
**注記**  
Terraform からプロビジョニングされたリソースを UI から編集することはできません。これにより、アラートスタックは常にコードと同期したままになります。

1. **[テスト]** をクリックして、ミュートタイミングが正しく機能していることを確認します。

## アラートルールのプロビジョニング
<a name="v9-alerting-setup-provision-tf-rules"></a>

[アラートルール](v9-alerting-managerules.md)を使用すると、あらゆる Grafana データソースに対してアラートを実行できます。これは、既に設定済みのデータソースを使用することも、アラートルールとともに [[Terraform でデータソースを定義]](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source)することもできます。

**アラートルールをプロビジョニングするには**

1. クエリするデータソースと、ルールを保存するフォルダを作成します。

   この例では、[テスト用 TestData データソースの設定](testdata-data-source.md) データソースが使用されます。

   アラートは Grafana の任意のバックエンドデータソースに対して定義できます。

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. アラートルールを定義します。

   アラートルールの詳細については、[[Grafana マネージドアラートの作成方法]](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/) を参照してください。

1. 1 つ以上のルールを含むルールグループを作成します。

   この例では、`grafana_rule_group` リソースグループが使用されます。

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Grafana UI に移動し、アラートルールを確認します。

   アラートルールが発射しているかどうかを確認できます。また、アラートルールの各クエリステージを視覚化することもできます。

   アラートが発生すると、Grafana は定義したポリシーを通じて通知をルーティングします。

   例えば、コンタクトポイントとして Slack を選択した場合、Grafana の埋め込み[アラートマネージャー](https://github.com/prometheus/alertmanager)は Slack にメッセージを自動的に投稿します。

# Grafana でのプロビジョニングされたアラートリソースの表示
<a name="v9-alerting-setup-provision-view"></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. Grafana インスタンスを開きます。

1. アラートに移動します。

1. アラートルールなど、アラートリソースフォルダをクリックします。

   プロビジョニング済みのリソースには **[プロビジョニング済み]** というラベルが付けられているため、手動で作成されていないことがわかります。

**注記**  
Grafana からプロビジョニングされたリソースを編集することはできません。リソースプロパティを変更するには、プロビジョニングファイルを変更して Grafana を再起動するか、ホットリロードを実行します。これにより、ファイルが再度プロビジョニングされた場合やホットリロードが実行された場合に上書きされるリソースへの変更を防止します。

# 従来のダッシュボードアラートを Grafana アラートに移行する
<a name="v9-alerting-use-grafana-alerts"></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 アラートに切り替えるには、 機能にオプトインする必要があります。

、、 AWS CLIまたは Amazon Managed Grafana API を使用して AWS マネジメントコンソール、Grafana アラートを使用するように Amazon Managed Grafana インスタンスを設定できます。Grafana アラートのオン/オフの切り替えなど、Amazon Managed Grafana の設定方法の詳細については、「[Amazon Managed Grafana ワークスペースを設定する](AMG-configure-workspace.md)」を参照してください。

**注記**  
Grafana アラートを使用する場合、Grafana で定義されたアラートルールは、Prometheusではなく、複数の通知をコンタクトポイント (通知先) に送信します。ネイティブ Grafana アラートを使用している場合は、新しい Grafana アラート機能を有効にせず、従来のダッシュボードアラートのまま使用することをお勧めします。Prometheus データソースで定義されたアラートを表示する場合は、Grafana アラートを有効にすることをお勧めします。これにより、Prometheus アラートマネージャーで作成されたアラートの通知が 1 つだけ送信されます。  
この制限は、Grafana v10.4 以降をサポートする Amazon Managed Grafana ワークスペースで削除されました。

## Grafana アラートシステムへの移行
<a name="v9-alerting-use-grafana-alerts-opt-in"></a>

Grafana アラートを有効にすると、既存の従来のダッシュボードアラートは Grafana アラートと互換性のある形式で移行されます。移行後のアラートと新しく作成したアラートは、Grafana インスタンスのアラートページに表示されます。Grafana アラートを使用した場合、Grafana が管理するアラートルールは、一致するときに 1 つのアラートではなく、複数の通知を送信します。

従来のダッシュボードアラートと Grafana アラートへの読み取りおよび書き込みアクセス権は、それらが保存されているフォルダのアクセス権限で制御されます。移行中、従来のダッシュボードアラートアクセス許可は、次のように新しいルールアクセス許可と照合されます。
+ 元のアラートが属するダッシュボードにアクセス権限が設定されている場合、移行時に元のダッシュボードの権限 (フォルダから継承された権限を含む) 設定で `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` という形式の名前のフォルダが作成されます。
+ ダッシュボードにアクセス権限が設定されておらず、ダッシュボードがフォルダ内にある場合、ルールはこのフォルダにリンクされ、そのアクセス権限が継承されます。
+ ダッシュボードにアクセス権限が設定されておらず、ダッシュボードが General (全般) フォルダにある場合、ルールは General (全般) アラートフォルダにリンクされ、ルールにはデフォルトのアクセス権限が継承されます。

**注記**  
Grafana のアラート設定には `NoData` に対する `Keep Last State` オプションがないため、このオプションは従来のルールを移行する際に `NoData` になります。`Error` 処理のためのオプション `Keep Last State` は、新しいオプション `Error` に移行されます。`Keep Last State` の動作に合わせるため、移行時には各アラートルールに対して 1 年間のサイレンスが Amazon Managed Grafana によって自動的に作成されます。

通知チャネルは、適切なルートと受信者が設定されたアラートマネージャー設定に移行されます。デフォルトの通知チャネルは、コンタクトポイントとしてデフォルトのルートに追加されますが、ダッシュボードアラートに関連付けられていない通知チャネルは `autogen-unlinked-channel-recv` ルートに送られます。

### 制限事項
<a name="v9-alerting-use-grafana-alerts-limitations"></a>
+ Grafana アラートシステムは、利用可能なすべての Prometheus、Loki、およびアラートマネージャーデータソースからルールを取得できますが、他のサポートされているデータソースからアラートルールを取得できない場合があります。
+ Grafana アラートと従来のダッシュボードアラートを交互に移行すると、どちらか一方でのみサポートされる機能のデータが失われる可能性があります。
**注記**  
従来のダッシュボードアラートに戻した場合、Grafana アラートが有効になっている間に新たに作成されたアラートルールやアラート設定に加えられたすべての変更は失われます。

# アラートルールの管理
<a name="v9-alerting-managerules"></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 つ以上のクエリと式、条件、評価の頻度、およびオプションとしてその条件の持続時間で構成されます。

評価するデータセットを「クエリと式」で選択し、「条件」にアラートがアラートを発行するための基準 (しきい値) を設定します。間隔は、アラートルールが評価される頻度を指定します。「持続時間」を設定した場合、その条件下にある状態の継続時間を示します。また、アラートルールでは、データがない場合のアラート動作も設定できます。

**注記**  
Grafana マネージドアラートルールは、ルールを保存するフォルダの編集権限を持つユーザーのみが編集または削除できます。  
外部 Grafana Mimir または Loki インスタンスのアラートルールは、エディタまたは管理者ロールを持つユーザーが編集または削除できます。

**Topics**
+ [Grafana 管理のアラートルールの作成](v9-alerting-managerules-grafana.md)
+ [Grafana Mimir または Loki 管理のアラートルールの作成](v9-alerting-managerules-mimir-loki.md)
+ [Grafana Mimir または Loki 管理の記録ルールの作成](v9-alerting-managerules-mimir-loki-recording.md)
+ [Grafana Mimir または Loki ルールグループと名前空間](v9-alerting-managerules-mimir-loki-groups.md)
+ [アラートルールの表示と編集](v9-alerting-managerules-view-edit.md)

# Grafana 管理のアラートルールの作成
<a name="v9-alerting-managerules-grafana"></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 はコンタクトポイント (通知先) に通知を送信します。

**Grafana 管理のルールの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[新しいアラートルール]** を選択します。

1. **ステップ 1** で、以下を参照してルール名、タイプ、ストレージの場所を追加します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[ルールタイプ]** ドロップダウンから、**[Grafana 管理のアラート]** を選択します。
   + **[フォルダ]** ドロップダウンから、ルールの保存先となるフォルダを選択します。フォルダを選択しない場合、ルールは `General` フォルダに保存されます。フォルダを作成する場合、ドロップダウンを選択し、新しいフォルダ名を入力します。

1. **ステップ 2** で、評価するクエリと式を追加します。
   + 名前はデフォルトのままでも構いませんが、変更する場合、カーソルを合わせて編集アイコンを選択します。
   + クエリの場合、ドロップダウンからデータソースを選択します。
   + 1 つ以上の[クエリまたは式](v9-panels-query-xform-expressions.md)を追加します。
   + 式ごとに **[クラシック条件]**を選択して単一のアラートルールを作成するか、**[Math]**、**[削減]**、**[リサンプリング]** オプションから選択して、各シリーズに個別のアラートを作成します。これらのオプションの詳細については、「[1 次元ルールと多次元ルール](#v9-alerting-single-multi-rule)」を参照してください。
   + **[Run queries]** (クエリの実行) を選択して、クエリが正しく動作すことを確認します。

1. **ステップ 3** で、条件を追加します。
   + **[条件]** ドロップダウンから、アラートルールを発動させるクエリまたは式を選択します。
   + **Evaluate every** (～ごとに評価する) には、評価の頻度を指定します。10 秒の倍数である必要があります。例えば、`1m` や `30s` などです。
   + **[評価対象]** には、アラートが発行されるために必要な条件の継続時間を指定します。
**注記**  
条件が違反すると、アラートは `Pending` 状態に入り、そのまま指定された期間条件の違反が継続するとアラートは `Firing` 状態に移行します。条件から外れた場合、`Normal` 状態に戻ります。
   + **[Configure no data and error handling]** (データがない場合の設定とエラー処理) で、データがない場合のアラート動作を設定します。「[データがない場合やエラーが発生した場合の対処](#v9-alerting-rule-no-data-error)」のガイドラインを参照してください。
   + **[アラートのプレビュー]** を選択してルールを評価し、生成されるアラートを確認します。プレビューでは、データとエラー処理条件は除外されます。

1. **ステップ 4** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[ラベルと注釈](v9-alerting-explore-labels.md)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

ルールを作成したら、ルールの通知を作成できます。通知の詳細については、「[アラート通知の管理](v9-alerting-managenotifications.md)」を参照してください。

## 1 次元ルールと多次元ルール
<a name="v9-alerting-single-multi-rule"></a>

Grafana 管理のアラートルールでは、従来の条件を使用してルールを作成することも、多次元ルールを作成することもできます。

**1 次元ルール (従来の条件)**

従来の条件式を使用して、条件が満たされたときに単一のアラートを発行するルールを作成します。複数のシリーズを返すクエリの場合、Grafana は各シリーズのアラート状態を追跡しません。そのため、複数のシリーズでアラート条件が満たされた場合でも、Grafana が送信するアラートは 1 件のみです。

式のフォーマット方法の詳細については、*Grafana ドキュメント*の「[式](https://grafana.com/docs/grafana/next/panels/query-a-data-source/)」を参照してください。

**多次元ルール**

クエリで返されるシリーズごとに個別のアラートインスタンスを生成するには、多次元ルールを作成します。

**注記**  
多次元ルールによって生成された各アラートインスタンスは、アラートの合計クォータにカウントされます。クォータに達すると、ルールは評価されなくなります。多次元ルールのクォータの詳細については、「[クォータ到達エラー](#v9-alerting-rule-quota-reached)」を参照してください。

1 つのルールから複数のインスタンスを作成するには、`Math`、`Reduce`、または `Resample` 式を使用して多次元ルールを作成します。例えば、以下のことが可能です:
+ 各クエリに `Reduce` 式を追加すると、選択した時間範囲の値が 1 つの値に集計されます。([数値データ を使用するルール](v9-alerting-explore-numeric.md)には必要ありません)。
+ ルールの条件を含む `Math` 式を追加します。もしクエリや reduce 式がすでにアラートを発行すべき場合は正の数、発行しない場合に 0 を返す場合、これは必要ありません。

  例: 
  + `$B > 70` は、B クエリ/式の値が 70 を超える場合にアラートを発行します。
  + `$B < $C * 100` は、B の値が C の値に 100 を掛けた値より小さい場合にアラートを発行します。比較対象のクエリの結果に複数のシリーズがある場合、異なるクエリのシリーズが同じラベルを持っているか、一方が他方のサブセットである場合に一致します。

**注記**  
Grafana は、テンプレート変数を使用したアラートクエリはサポートしていません。詳細については、コミュニティページ「[アラートクエリではアラート設定時にテンプレート変数を使用できません](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514)」を参照してください。



**多次元ルールのパフォーマンスに関する考慮事項**

各アラートインスタンスは、アラートのクォータ (上限数) にカウントされます。アラートの上限数を超えるインスタンスを作成する多次元ルールは評価されず、クォータエラーが返されます。詳細については、「[クォータ到達エラー](#v9-alerting-rule-quota-reached)」を参照してください。

多次元アラートは、Grafana ワークスペースや、Grafana がアラートルールを評価するためにクエリを実行するデータソースのパフォーマンスに大きな影響を与える可能性があります。監視システムのパフォーマンスを最適化したい場合、以下の考慮事項を参照してください。
+ **ルール評価の頻度** – アラートルールの **[Evaluate Every]** (～ごとに評価する) プロパティでルール評価の頻度を制御します。評価の頻度を許容可能な最小頻度に収めることをお勧めします。
+ **結果セットのカーディナリティ** – ルールで作成されるアラートインスタンスの数は直接そのパフォーマンスに影響します。例えば、すべての仮想マシン上の各 API パスごとに API 応答エラーを監視しているとします。このセットのカーディナリティは「パスの数 × 仮想マシンの数」になります。例えば、仮想マシンあたりのパスごとではなく、仮想マシンあたりの合計エラー数を監視することで、結果セットのカーディナリティを減らすことができます。
+ **クエリの複雑さ** – データソースが迅速に処理して応答できるクエリにするだけで、リソースの消費を大幅に抑えることができます。これは他の考慮事項よりは重要度が低いものの、他の点での最適化が十分に行われている場合、個別のクエリパフォーマンスの見直しが役立つ可能性があります。また、これらのルールの評価がデータソースに与える影響にも注意する必要があります。アラートクエリは、監視データベースで処理されるクエリの大部分を占めることが多いため、Grafana インスタンスにかかる負荷要因がデータソースにも同様に影響を与えます。

## クォータ到達エラー
<a name="v9-alerting-rule-quota-reached"></a>

1 つのワークスペース内に保持できるアラートインスタンスの数にはクォータ (上限) があります。この上限に達した場合、そのワークスペースにこれ以上新たにアラートルールを作成できなくなります。多次元アラートでは、アラートインスタンスの数は時間の経過とともに変動する場合があります。

以下に、アラートインスタンスを使用する際に覚えておくべき重要な点について紹介します。
+ 作成するのが 1 次元ルールのみの場合、ルールからはそれぞれ 1 つのアラートインスタンスが作成されます。1 つのワークスペースに作成できるルールの上限は、アラートインスタンスのクォータ数までとなります。
+ 多次元ルールからは複数のアラートインスタンスが作成されますが、その数は評価されるまでわかりません。例えば、Amazon EC2 インスタンスの CPU 使用率を追跡するアラートルールを作成した場合、最初は 50 台の EC2 インスタンスが対象となり、50 個のアラートインスタンスが作成されますが、1 週間後にさらに 10 台の EC2 インスタンスが追加された場合、次の評価時には 60 個のアラートインスタンスが存在することになります。

  アラートインスタンスの数は、多次元アラートを作成するときに評価され、アラートインスタンスのクォータをすぐに超えるインスタンスを作成することはできません。アラートインスタンスの数は変動する可能性があるため、ルール評価の都度クォータがチェックされます。
+ 評価時に、ルールがアラートインスタンスのクォータを超える場合、アラートルールが更新されアラートインスタンスの合計数がサービスクォータを下回るまで、そのルールは評価されません。この場合、クォータに達したことを通知するアラート通知を受け取ります (通知は評価対象のルールの通知ポリシーを基に送信されます)。通知には、`QuotaReachedError` 値を含む `Error` 注釈が含まれています。
+ `QuotaReachedError` を引き起こすルールは、評価されなくなります。評価は、更新が行われ、更新後の評価が `QuotaReachedError` を引き起こさなくなった場合にのみ再開されます。評価されていないルールは、Grafana コンソールに**クォータ到達**エラーが表示されます。
+ アラートインスタンスの数を減らすには、アラートルールを削除するか、複数次元のアラートを編集してアラートインスタンスを減らします (例えば、仮想マシン内の API ごとに 1 個のアラートではなく、仮想マシンごとの 1 件のエラーに対して 1 個のアラートを持つようにします)。
+ 評価を再開するには、アラートを更新して保存します。アラートインスタンスの数を減らすように更新することもできますし、インスタンス数を減らすために他の変更を加えた場合、変更なしで保存しても構いません。再開可能な場合、評価が再開されます。さらに別の `QuotaReachedError` を引き起こす結果となった場合、保存することはできません。
+ アラートが保存され、アラートクォータを超えることなく評価が再開された場合、Grafana コンソールにはしばらくの間**クォータ到達**エラーが (次の評価間隔まで) 表示され続けることがありますが、アラートルール評価が開始され、ルールのしきい値に達するとアラートが送信されます。
+ アラートのクォータおよびその他のクォータの詳細については、「[Amazon Managed Grafana のサービスクォータ](AMG_quotas.md)」を参照してください。

## データがない場合やエラーが発生した場合の対処
<a name="v9-alerting-rule-no-data-error"></a>

データがない場合やエラーが発生した場合のアラート動作の処理方法を選択します。

データがない場合に選択できる処理方法を、以下の表に照会します。


| データがない場合の選択肢 | 行動 | 
| --- | --- | 
|  データなし  |  アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用したアラート `DatasourceNoData` を作成します。  | 
|  [アラート]  |  アラートルールの状態を `Alerting` に設定します。  | 
|  OK  |  アラートルールの状態を `Normal` に設定します。  | 

エラーが発生した場合に選択できる処理方法を、以下の表に照会します。


| エラーまたはタイムアウト時の選択肢 | 行動 | 
| --- | --- | 
|  [アラート]  |  アラートルールの状態を `Alerting` に設定します  | 
|  OK  |  アラートルールの状態を `Normal` に設定します  | 
|  エラー  |  アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用したアラート `DatasourceError` を作成します。  | 

# Grafana Mimir または Loki 管理のアラートルールの作成
<a name="v9-alerting-managerules-mimir-loki"></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 Mimir または Loki インスタンスのアラートルールを作成することができます。

**注記**  
Grafana Mimir は、Amazon Managed Service for Prometheus および Prometheus データソースに接続できます。

**前提条件**
+ Prometheus データソースへの書き込みアクセス権限があることを確認します。アクセス権限がない場合、Cortex 管理のアラートルールを作成または更新することはできません。
+ Grafana Mimir および Loki データソースの場合、それぞれのサービスを設定して Ruler API を有効にします。
  + **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集する場合、他のストレージタイプを設定してください。
  + **Grafana Mimir** – `/prometheus` ではなく、レガシー `/api/prom` プレフィックスを使用します。Prometheus データソースは Grafana Mimir と Prometheus の両方に対応しており、Grafana はクエリ API と Ruler API の両方が同じ URL にあることを想定しています。Ruler API に別の URL を指定することはできません。

**注記**  
特定の Loki または Prometheus データソースのアラートルールを管理しない場合は、その設定に移動し、**[アラート UI 経由でアラートを管理する]** チェックボックスをオフにします。

**Grafana Mimir または Loki 管理のアラートルールを追加するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[アラートルールの作成]** を選択します。

1. **ステップ 1** で、次のようにルールタイプと詳細を選択します。
   + **Mimir または Loki アラート**を選択します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[データソース]の選択**ドロップダウンから、Prometheus または Loki データソースを選択します。
   + **[名前空間]** ドロップダウンから、既存のルール名前空間を選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。詳細については、「[Cortex または Loki ルールグループと名前空間](alert-rules.md#alert-rule-groups)」を参照してください。
   + **[グループ]** ドロップダウンから、選択した名前空間内の既存のグループを選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。

1. **ステップ 2** で、評価するクエリを追加します。

   値は PromQL または LogQL 式で指定することができます。評価結果に 0 より大きい値を持つシリーズが 1 つ以上ある場合、ルールはアラートを発行します。アラートはシリーズごとに作成されます。

1. **ステップ 3** で、アラート評価間隔を指定します。

   条件の **[For]** テキストボックスに、アラートが発行されるために必要な条件の継続時間を指定します。例えば `5m` を指定した場合、条件が 5 分間継続した場合にアラートが発行されます。
**注記**  
条件が満たされると、アラートは `Pending` 状態に入り、そのまま指定された期間条件が継続するとアラートは `Firing` 状態に移行します。条件から外れた場合、`Normal` 状態に戻ります。

1. **ステップ 4** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[ラベルと注釈](v9-alerting-explore-labels.md)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[アラートのプレビュー]** を選択してルールを評価し、生成されるアラートを確認します。各アラートの状態と値を含むアラートのリストが表示されます。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

ルールを作成したら、ルールの通知を作成できます。通知の詳細については、「[アラート通知の管理](v9-alerting-managenotifications.md)」を参照してください。

# Grafana Mimir または Loki 管理の記録ルールの作成
<a name="v9-alerting-managerules-mimir-loki-recording"></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 Mimir または Loki インスタンスの記録ルールを作成および管理することができます。記録ルールは、頻繁に必要になる式や計算負荷の高い式を事前に計算し、その結果を新しい時系列セットとして保存します。この新しい時系列のクエリは、特にダッシュボードでは、ダッシュボードが更新されるたびに同じ式をクエリするため、より高速になります。

**前提条件**

Grafana Mimir および Loki データソースの場合、それぞれのサービスを設定して Ruler API を有効にします。
+ **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集する場合、他のストレージタイプを設定してください。
+ **Grafana Mimir** – Grafana Mimir を指定するようにデータソースを設定するときは、`/prometheus` ではなくレガシー `/api/prom` プレフィックスを使用します。Prometheus データソースは Grafana Mimir と Prometheus の両方に対応しており、Grafana はクエリ API と Ruler API の両方が同じ URL にあることを想定しています。Ruler API に別の URL を指定することはできません。

**注記**  
特定の Loki または Prometheus データソースのアラートルールを管理しない場合は、その設定に移動し、**[アラート UI 経由でアラートを管理する]** チェックボックスをオフにします。

**Grafana Mimir または Loki 管理の記録ルールを追加するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[アラートルールの作成]** を選択します。

1. **ステップ 1** で、以下を参照してタイプ、ルール名、ストレージの場所を追加します。
   + **Mimir または Loki の記録ルール**オプションを選択します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[データソース]の選択**ドロップダウンから、Prometheus または Loki データソースを選択します。
   + **[名前空間]** ドロップダウンから、既存のルール名前空間を選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。詳細については、「[Cortex または Loki ルールグループと名前空間](alert-rules.md#alert-rule-groups)」を参照してください。
   + **[グループ]** ドロップダウンから、選択した名前空間内の既存のグループを選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。

1. **ステップ 2** で、評価するクエリを追加します。

   値は PromQL または LogQL 式で指定することができます。評価結果に 0 より大きい値を持つシリーズが 1 つ以上ある場合、ルールはアラートを発行します。アラートはシリーズごとに作成されます。

1. **ステップ 3** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[アラートルールの注釈とラベル](alert-rules.md#alert-rule-labels)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

# Grafana Mimir または Loki ルールグループと名前空間
<a name="v9-alerting-managerules-mimir-loki-groups"></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 分です。また、Grafana Mimir または Loki の名前空間とルールグループの名前を変更したり、ルールグループの評価間隔を編集することができます。

**ルールグループまたは名前空間の編集方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. 編集するルールグループまたは名前空間内のルールに移動します。

1. **[編集]** (ペン) アイコンを選択します。

1. ルールグループまたは名前空間に変更を加えます。
**注記**  
名前空間では、名前のみを編集できます。ルールグループの場合、名前、またはグループ内のルールの評価間隔を変更します。たとえば、ルールを 1 分ごとに評価する場合は `1m` を選択し、30 秒ごとに評価する場合は `30s` を選択します。

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

# アラートルールの表示と編集
<a name="v9-alerting-managerules-view-edit"></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 によって管理されるルールが一覧表示され、**Cortex/Loki** セクションには Prometheus 互換データソースのルールが一覧表示されます。Prometheus 互換データソースのアラートルールは表示できますが、編集することはできません。

Mimir/Cortex/Loki ルールセクションには、Mimir、Cortex、または Loki データソースのすべてのルールが一覧表示されます。クラウドアラートルールもこのセクションに表示されます。

大量のアラートを管理する場合、拡張アラートルール検索機能を使用して、フォルダ、評価グループ、ルールをフィルタリングできます。さらに、ラベル、状態、タイプ、正常性などのプロパティでアラートルールをフィルタリングできます。

**注記**  
プロビジョニングされたアラートのクエリ定義は表示することはできますが、編集はできません。これらを表示できるため、ルール定義のプロビジョニングリポジトリに戻ることなく、クエリとルール定義が正しいことを確認できます。

## アラートルールの表示
<a name="v9-alerting-managerules-view"></a>

Grafana アラートを使用すると、すべてのアラートを 1 ページに表示できます。

**アラートの詳細を表示するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。デフォルトでは、ルールはデータソースの種類ごとにグループ化して表示されます。各アラートの現在の状態別に表示することもできます (詳細については後述します)。

1. **[表示形式]** では、グループビューと状態ビューを切り替えることができます。

1. 行の横にある矢印を選択すると、その行の詳細が表示されます。ルールの詳細には、ルールのラベル、注釈、データソース、クエリ、およびルールから生成されたアラートインスタンスのリストが含まれます。

**注記**  
アラートの詳細については、「[アラートルールの状態と正常性](v9-alerting-explore-state.md)」を参照してください。

**グループビュー**

グループビューには、フォルダ別にグループ化された Grafana アラートルールと、`namespace` \$1 `group` 別にグループ化された Loki または Prometheus アラートルールが表示されます。これは、ルールの管理を目的としたデフォルトのルールリストビューです。各グループを展開すると、そのグループ内のルールのリストが表示されます。さらにルールを展開すると、その詳細を見ることができます。また、ルールから生成されたアクションボタンとアラートを展開して、詳細を表示することもできます。

**状態ビュー**

状態ビューには、アラートルールが状態ごとグループ化されて表示されます。このビューを使用すると、各ルールがどの状態にあるかを一目で確認できます。各ルールは展開して詳細を表示することがでます。アクションボタンとこのルールによって生成されたアラート、および各アラートをさらに展開して詳細を表示することができます。

**アラートルールのフィルター**

**[アラート]** ページに表示されるアラートルールは、いくつかの方法でフィルタリングできます。
+ 特定のデータソースを使用するルールだけを表示するには **[データソースの選択]** でフィルタリングするデータソースを選択します。
+ また、**[ラベルで検索]** から検索条件を選択して、ラベルでフィルタリングすることもできます。例えば、`environment=production,region=~US|EU,severity!=warning` と入力して、米国と欧州の本番稼働警告をフィルタリングできます。
+ 特定の状態のルールだけを表示するには **[状態でアラートをフィルタリング]** で表示する状態を選択します。

## アラートルールの編集または削除
<a name="v9-alerting-managerules-edit"></a>

Grafana管理のアラートルールの編集または削除は、ルールが保存されているフォルダに対する編集権限を持つユーザーのみが行うことができます。外部 Mimir または Loki インスタンスのアラートルールの編集または削除は、エディタまたは管理者ロールを持つユーザーが行うことができます。

**ルールを編集または削除するには**

1. **表示**、**編集**、**削除**のルールコントロールが表示されるまでルールを展開します。

1. **[編集]** を選択してルールの作成ページを開きます。更新方法はルール作成方法と同じです。詳細については、「[Grafana 管理のアラートルールの作成](v9-alerting-managerules-grafana.md)」または「[Grafana Mimir または Loki 管理のアラートルールの作成](v9-alerting-managerules-mimir-loki.md)」の手順を参照してください。

1. 削除する場合は **[削除]** を選択してルールを削除します。

## アラートルールのエクスポート
<a name="v9-alerting-managerules-export"></a>

Export を選択すると、Grafana ワークスペースの YAML または JSON にルールを**[エクスポート]**できます。これにより、新しいルールを定義してからエクスポートするオプションが提供されます。UI を使用してルールを作成し、プロビジョニング API または terraform スクリプトで使用するためにエクスポートできます。

**注記**  
これは、Grafana ワークスペースとプロビジョニングインターフェイスの両方でサポートされています。

# アラート通知の管理
<a name="v9-alerting-managenotifications"></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 つのアラートルールで複数の個別の*アラートインスタンス*をトリガーできます。

アラートマネージャーは、これらのアラートインスタンスを受信し、ミュートタイミングを処理し、アラートをグループ化し、通知ポリシーで定義されているようにコンタクトポイントに通知を送信します。

**Topics**
+ [アラートマネージャー](v9-alerting-managenotifications-alertmanager.md)
+ [コンタクトポイント (通知先) の使用](v9-alerting-contact-points.md)
+ [通知ポリシーの使用](v9-alerting-notification-policies.md)
+ [通知のカスタマイズ](v9-alerting-notifications.md)
+ [Prometheus データソースのアラート通知のサイレンス化](v9-alerting-silences.md)
+ [ミュートタイミング](v9-alerting-notification-muting.md)
+ [アラートグループ別に表示およびフィルタリングする](v9-alerting-viewfiltergroups.md)
+ [通知エラーの表示](v9-alerting-viewnotificationerrors.md)

# アラートマネージャー
<a name="v9-alerting-managenotifications-alertmanager"></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)」を参照してください。

アラートマネージャーを使用すると、アラートを迅速かつ効率的に管理して対応できます。E メールや Slack など選択したチャネルを介して通知を送信することで、アラートを受信し、ミュート、抑制、グループ化、ルーティングを処理します。

Grafana では、Grafana アラートマネージャー、または外部アラートマネージャーを使用できます。複数のアラートマネージャーを実行することもできます。決定は、セットアップとアラートの生成場所によって異なります。

**Grafana アラートマネージャー**

Grafana アラートマネージャーは、事前設定済みで、Grafana をオンプレミスまたはオープンソースで実行している場合にデフォルトで選択できる内部アラートマネージャーです。

Grafana アラートマネージャーは Grafana からアラートを受信できますが、Mimir や Loki など、Grafana の外部からアラートを受信することはできません。

**注記**  
禁止ルールは Grafana アラートマネージャーではサポートされていません。

**外部アラートマネージャー**

Grafana、Loki、Mimir、Prometheus のすべてのアラートを受信するために 1 つのアラートマネージャーを使用したい場合は、外部のアラートマネージャーを使用するように Grafana を設定できます。この外部アラートマネージャーは、Grafana 内から設定および管理できます。

Grafana アラートマネージャーの代わりに、独自の外部アラートマネージャーを設定し、そこでアラートを送信する場合の例を 2 つ示します。

1. Prometheus などの他のアラートジェネレーターがあるため、独自のクラウドインフラストラクチャに既にオンプレミスのアラートマネージャーを設定しており、引き続き使用したい場合。

1. Prometheus オンプレミスとホストされた Grafana の両方を使用して、クラウドインフラストラクチャで実行されるのと同じアラートマネージャーにアラートを送信したい場合。

アラートマネージャーは、[コンタクトポイントのアラート] および [通知ポリシー] ページのドロップダウンメニューに表示されます。

データソースをプロビジョニングする場合は、`jsonData` フィールドの `handleGrafanaManagedAlerts` フラグを `true` に設定して、Grafana が管理するアラートをこのアラートマネージャーに送信します。

# コンタクトポイント (通知先) の使用
<a name="v9-alerting-contact-points"></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)」を参照してください。

連絡窓口は、アラート発生時の通知の受け取り方の設定に使用します。コンタクトポイントには、Amazon Simple Notification Service や Slack など、1 つ以上のコンタクトポイント統合を指定できます。アラートが発生すると、コンタクトポイントにリストされているすべてのコンタクトポイント統合に通知が送信されます。必要に応じて、[通知テンプレート](v9-alerting-create-templates.md)を使用して、コンタクトポイントタイプの通知メッセージをカスタマイズできます。

**注記**  
Grafana で管理されるアラートの通知先 (コンタクトポイント) は、作成および編集が可能です。アラートマネージャーアラートの通知先 (コンタクトポイント) は読み取り専用です。

## コンタクトポイント (通知先) の使用
<a name="v9-alerting-working-contact-points"></a>

次の手順では、通知先 (コンタクトポイント) を追加、編集、テスト、削除する方法について説明します。

**コンタクトポイントの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[コンタクトポイント]** を選択し、**[コンタクトポイントを追加]** を選択します。

1. **[アラートマネージャー]** ドロップダウンから、アラートマネージャーを選択します。デフォルトでは、Grafana アラートマネージャーが選択されています。

1. コンタクトポイントの** [名前]** を入力します。

1. **[コンタクトポイント統合]** から、タイプを選択し、そのタイプに基づいて必須フィールドを選択します。例えば、Slack を選択した場合は、Slack チャネルと通知先となるユーザーを入力します。

1. 選択したコンタクトポイントで利用可能な場合は、任意の**オプション設定**を選択して追加の設定を指定します。

1. **[通知設定]**で**[解決済みメッセージの無効化]**を選択すると、アラートが解決した際に通知を受け取らないようにすることができます (任意)。

1. コンタクトポイントにコンタクトポイントタイプを追加したい場合は、**[新しいコンタクトポイントタイプ]** を選択し、必要なコンタクトポイントタイプごとに手順を繰り返します。

1. **[コンタクトポイントの保存]** を選択して変更を保存します。

**コンタクトポイントの編集方法**

1. **[コンタクトポイント]**を選択すると、現在設定されているコンタクトポイントのリストが表示されます。

1. 編集する連絡先を選択し、**[編集]** アイコン (ペン) を選択します。

1. 必要な変更を加え、**[コンタクトポイントの保存]** を選択して変更を保存します。

コンタクトポイントを作成したら、テスト通知を送信して、正しく設定されていることを確認します。

**テスト通知の送信方法**

1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。

1. テストする連絡先を選択し、**[編集]** アイコン (ペン) を選択します。

1. **[テスト]** アイコン (紙飛行機) を選択します。

1. 事前定義されたテスト通知を送信するか、**[カスタム]** を選択してテスト通知に独自の注釈とラベルを追加するかを選択します。

1. **[テスト通知を送信]**を選択して、指定されたコンタクトポイント宛にアラートをテストします。

使用されていないコンタクトポイントは、通知ポリシーで削除できます。

**連絡先の削除方法**

1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。

1. 削除する連絡先を選択し、**[削除]** アイコン (ゴミ箱) を選択します。

1. 確認ダイアログボックスで、**[はい、削除]** を選択します。

**注記**  
コンタクトポイントが通知ポリシーで使用されている場合、コンタクトポイントを削除する前に、通知ポリシーを削除するか、別のコンタクトポイントを使用するように編集する必要があります。

## サポートされている通知方法の一覧
<a name="v9-alerting-contactpoint-supported-notifiers"></a>


|  名前  |  タイプ  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| Pager Duty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# 通知ポリシーの使用
<a name="v9-alerting-notification-policies"></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 つ以上の子ポリシーを持つことができます。ルートポリシーを除く各ポリシーは、特定のアラートラベルにも一致させることができます。各アラートはルートポリシーによって評価され、次に各子ポリシーによって評価されます。特定のポリシーに対して `Continue matching subsequent sibling nodes` オプションを有効にすると、1 つ以上の一致があっても評価が続行されます。子ポリシーのいずれとも一致しない場合、親ポリシーの設定とコンタクトポイント (通知先) の情報によってアラートの動作が制御されます。特定のポリシーと一致しない場合、ルートポリシーがアラートを制御します。

**注記**  
Grafana 管理のアラートの通知ポリシーを作成および編集することができますが、アラートマネージャーアラートの通知ポリシーは読み取り専用となっています。

**通知のグループ化**

グループ化すると、似た性質のアラート通知を 1 つの funnel にまとめられます。これは、システム上で一度に複数の障害が発生して多数のアラートが同時に発生する場合、大規模な停止中にアラート通知を制御することができます。

**グループ化の例**

例えば、異なる環境でデータベースに接続されている100のサービスがあるとします。これらのサービスは、ラベル `env=environmentname` で区別され、サービスがデータベースに到達できるかどうかを監視するためのアラートルールが設定されています。このアラートルールは、`alertname=DatabaseUnreachable` という名前のアラートを作成します。

サービスの半分がデータベースに到達できなくなったネットワークの分断が発生すると、50 件のアラートが個別に発生しますが、影響を受けている環境のリストを含む (50 件ではなく) 1 ページの通知を受け取りたいと考えています。

`group_by: [alertname]`でグループ化を設定することができます(サービスごとに異なる `env` ラベルを使用する代わりに)。この設定を行うと、Grafana は、このアラートルールの影響を受けるすべての環境が記載された 1 通のコンパクトな通知を送信します。

**特殊グループ**

Grafana には 2 つの特殊グループがあります。デフォルトのグループである `group_by: null` は、*すべての*アラートを 1 つのグループにグループ化します。`...` という名前の特殊ラベルを使用してすべてのラベルでアラートをグループ化することで、グループ化を無効にし、各アラートを独自のグループに送信することもできます。

## 通知の使用
<a name="v9-alerting-notification-policies-working"></a>

以下に、通知ポリシーを作成および管理するための手順を紹介します。

**ルート通知ポリシーの編集方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[通知ポリシー]** を選択します。

1. **[アラートマネージャー]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. **[ルートポリシー]** セクションで、**[編集]** アイコン (ペン) を選択します。

1. **[デフォルトのコンタクトポイント]** で、アラートルールが特定のポリシーと一致しない場合に通知を送信するコンタクトポイント (通知先) を更新します。

1. **[グループ化対象]** で、アラートをグループ化するラベル (または特殊グループ) を選択します。

1. **[タイミングオプション]** で、以下のいずれかを選択します。
   + **[グループ待機]** – 同じグループのアラートをバッファリングしてから、最初の通知を送信するまでの待機時間。デフォルト値は 30 秒です。
   + **[グループ間隔]** – グループ内の 2 つの通知の最小時間間隔。デフォルト値は 5 分です。
   + **[繰り返し間隔]** – グループに新しいアラートが追加されなかった場合に、通知を再送信するまでの最小時間間隔。デフォルトは 4 時間です。

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

**上位の特定のポリシーの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[通知ポリシー]** を選択します。

1. **[アラートマネージャー]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. **[特定のルーティング]** セクションで、**[新しい特定のポリシー]** を選択します。

1. **[一致するラベル]** セクションで、一致するアラートラベルを 1 つ以上追加します。ラベルの一致の詳細については、このトピックの後半で説明します。

1. **コンタクトポイント**で、アラートがこの特定のポリシーと一致する場合に通知を送信するコンタクトポイントを追加します。ネストされたポリシーは、このコンタクトポイントを上書きします。

1. オプションで、アラートが現在のポリシーと一致した後でも、**[後続の兄弟ノードを照合し続ける]** を有効にして、兄弟ポリシーの照合を続行します。このオプションを有効にすると、同じアラートに対して複数の通知を取得できます。

1. 必要に応じて **[グループ化を上書き]** を選択して、ルートポリシーとは異なるグループ化を指定します。

1. 必要に応じて **[一般的なタイミングを上書き]** を選択して、グループ通知ポリシーで設定されているタイミングオプションを上書きします。

1. **[ポリシーの保存]** を選択して変更を保存します。

**ネストしたポリシーの追加方法**

1. ネストしたポリシーの作成先となる特定のポリシーを展開します。

1. **[ネストしたポリシーの追加]** を選択し、詳細を追加します (最上位の特定のポリシーを追加する場合と同様)。

1. **[ポリシーの保存]** を選択して変更を保存します。

**特定のポリシーの編集方法**

1. **[アラート]** ページから **[通知ポリシー]** を選択するとページを開き、現在設定されているポリシーが一覧表示されます。

1. 編集する設定ポリシーを選択したら、**[編集]** アイコン (ペン) を選択します。

1. 必要な変更を加えます (最上位の特定のポリシーを追加する場合と同様)。

1. **[ポリシーを保存]** を選択します。

**ポリシーの検索**

ポリシーのツリー内では、*ラベルマッチャー*または*コンタクトポイント*で検索できます。
+ コンタクトポイントで検索するには、**[コンタクトポイントで検索]** フィールドにコンタクトポイントの部分的な名前または完全な名前を入力します。
+ ラベルで検索するには、**[ラベルで検索]** 入力フィールドに有効なラベルマッチャーを入力します。複数のマッチャーをカンマで区切って入力できます。有効なマッチャー入力の例は `severity=high, region=~EMEA|NA` です。
**注記**  
ラベルで検索する場合、一致するすべてのポリシーは完全一致になります。部分一致と正規表現形式の一致はサポートされていません。

**ラベル一致の仕組み**

ポリシーは、アラートのラベルがポリシーで指定されたすべての*一致ラベル*と合致する場合に、そのアラートに適用されます。
+ **ラベル** – 一致させるラベルの名前。アラートのラベル名と完全に一致する必要があります。
+ **[演算子]** – ラベル値と一致するラベル値の比較に使用される演算子。利用できる演算子は次のとおりです。
  + `=` 値が指定された文字列と完全に一致するラベルが選択されます。
  + `!=` 値が指定された文字列と一致しないラベルが選択されます。
  + `=~` 指定された文字列の正規表現解釈値と一致するラベルが選択されます (指定された文字列は正規表現として解釈されます)。
  + `!=` 指定された正規表現と一致しないラベルが選択されます。
+ **[値])** – ラベル値と一致する値。選択した演算子に応じて、文字列または正規表現として照合させることができます。

# 通知のカスタマイズ
<a name="v9-alerting-notifications"></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)」を参照してください。

通知テンプレートを使用して、通知をカスタマイズします。

通知テンプレートを使用して、通知内のメッセージのタイトル、メッセージ、形式を変更できます。

通知テンプレートは、E メールや Slack などの特定のコンタクトポイント統合には関連付けられていません。ただし、異なるコンタクトポイント統合用に個別の通知テンプレートを作成することもできます。

通知テンプレートを使用すると、次のことができます。
+ 概要、説明、ラベルと注釈、値、リンクなど、通知内の情報を追加、削除、または並べ替える
+ テキストを太字と斜体で書式設定し、改行を追加または削除する

通知テンプレートを次の目的には使用できません。
+ Slack や Microsoft Teams などのインスタントメッセージングサービスで通知のデザインを変更する

**Topics**
+ [Go のテンプレート言語の使用](v9-alerting-notifications-go-templating.md)
+ [通知テンプレートの作成](v9-alerting-create-templates.md)
+ [テンプレートリファレンス](v9-alerting-template-reference.md)

# Go のテンプレート言語の使用
<a name="v9-alerting-notifications-go-templating"></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)」を参照してください。

Go のテンプレート言語である [text/template](https://pkg.go.dev/text/template) で通知テンプレートを書き込みます。

このセクションでは、Go のテンプレート言語の概要と、text/template でのテンプレートの作成について説明します。

## dot
<a name="v9-go-dot"></a>

text/template には dot と呼ばれる特別なカーソルがあり、`.` として記述されます。このカーソルは、テンプレート内の使用場所に応じて値が変化する変数と考えることができます。例えば、通知テンプレートの開始時に `.` は、`Alerts`、`Status`、`GroupLabels`、`CommonLabels`、`CommonAnnotations` および `ExternalURL` を含む多数のフィールドを含む `ExtendedData` オブジェクトを参照します。ただし、dot は、リスト上の `range` で使用される場合、`with` 内で使用される場合、または他のテンプレートで使用する機能テンプレートを記述する場合、他の何かを参照する場合があります。これの例は [通知テンプレートの作成](v9-alerting-create-templates.md) で、すべてのデータと関数は [テンプレートリファレンス](v9-alerting-template-reference.md) で確認できます。

## 開始と終了のタグ
<a name="v9-go-openclosetags"></a>

テキスト/テンプレートでは、テンプレートが変数を印刷するか、if ステートメントなどのコントロール構造を実行するかに関係なく、テンプレートは `{{`で始まり、`}}` で終わります。これは、変数の出力に `{{` と `}}` を使用し、制御構造に `{%` と `%}` を使用する Jinja などの他のテンプレート言語とは異なります。

## 印刷
<a name="v9-go-print"></a>

何かの値を印刷するには、`{{` と `}}` を使用します。dot の値、dot のフィールド、関数の結果、[[変数]](#v9-go-variables)の値を印刷できます。例えば、dot が `ExtendedData` を参照する `Alerts` フィールドを印刷するには、次のように記述します。

```
{{ .Alerts }}
```

## アラートを反復処理する
<a name="v9-go-iterate-alerts"></a>

アラートに関するすべての情報ではなく、各アラートのラベルのみを印刷するには、`range` を使用して `ExtendedData` でアラートを反復処理できます。

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

範囲内の dot は、`ExtendedData` ではなく `Alert` を参照します。`{{ .Labels }}` を使用して、各アラートのラベルを印刷できます。これは、アラートのリスト内の現在のアラートを参照するように `{{ range .Alerts }}` が dot を変えるために機能します。範囲が終了すると、dot は範囲の開始前に存在していた値にリセットされます。この例では `ExtendedData` です。

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## 注釈とラベルを反復処理する
<a name="v9-go-iterate-labels"></a>

各アラートのラベルを `The name of the label is $name, and the value is $value` の形式で印刷するテンプレートを書きましょう。ここで、`$name` と `$value` には各ラベルの名前と値が含まれます。

前の例と同様に、`.Alerts` の範囲を使用して のアラートを繰り返し、dot がアラートのリスト内の現在のアラートを参照するようにし、ソートされたラベルで 2 番目の範囲を使用して、dot が現在のラベルを参照するように 2 回目に更新されます。2 番目の範囲内では、 `.Name` と `.Value` を使用して各ラベルの名前と値を出力します。

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## If ステートメント
<a name="v9-go-if"></a>

テンプレートでは if ステートメントを使用できます。例えば、`.Alerts` にアラートがない場合に `There are no alerts` を出力するには、次のように記述します。

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## With
<a name="v9-go-with"></a>

With は if ステートメントと似ていますが、if ステートメントとは異なり、`with` は dot を更新して with の値を参照します。

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## [変数]
<a name="v9-go-variables"></a>

text/template の変数は、テンプレート内に作成する必要があります。例えば、`$variable` という変数を現在の dot の値で作成するには、次のように記述します。

```
{{ $variable := . }}
```

範囲内の `$variable` または `with` を使用でき、これらは変数が定義された時点の dot の値を参照します。dot の現在の値は参照されません。

例えば、2 番目の範囲で `{{ .Labels }}` を使用するテンプレートを記述することはできません。ここでは、現在のアラートではなく、現在のラベルが dot で参照されるためです。

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

これを修正するには、最初の範囲と 2 番目の範囲の前に `$alert` という変数を定義します。

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## インデックスを含む範囲
<a name="v9-go-rangeindex"></a>

範囲の開始時にインデックス変数と値変数を定義することで、範囲内の各アラートのインデックスを取得できます。

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## テンプレートの定義
<a name="v9-go-define"></a>

`define` とテンプレートの名前を二重引用符で囲むことで、他のテンプレート内で使用できるテンプレートを定義できます。`__subject`、`__text_values_list`、`__text_alert_list`、`default.title`、`default.message` などのデフォルトテンプレートを含め、他のテンプレートと同じ名前のテンプレートを設定しないでください。デフォルトテンプレートと同じ名前のテンプレート、または別の通知テンプレート内のテンプレートと同じ名前で作成されている場合、Grafana はいずれかのテンプレートを使用することになり、混乱が生じます。Grafana は、同じ名前のテンプレートが 2 つ以上ある場合、エラーメッセージを返しません。

```
{{ define "print_labels" }}
{{ end }}
```

## テンプレートを埋め込む
<a name="v9-go-embed"></a>

`template`、二重引用符で囲まれたテンプレートの名前、およびテンプレートに渡されるカーソルを使用して、テンプレート内で定義されたテンプレートを埋め込むことができます。

```
{{ template "print_labels" . }}
```

## テンプレートにデータを渡す
<a name="v9-go-passdata"></a>

テンプレート内では、dot はテンプレートに渡される値を参照します。

例えば、テンプレートに発射アラートのリストが渡された場合、dot は発射アラートのリストを参照します。

```
{{ template "print_alerts" .Alerts }}
```

テンプレートにアラートのソート済みラベルが渡された場合、dot はソート済みラベルのリストを参照します。

```
{{ template "print_labels" .SortedLabels }}
```

これは、再利用可能なテンプレートを記述する場合に役立ちます。例えば、すべてのアラートを出力するには、次のように記述します。

```
{{ template "print_alerts" .Alerts }}
```

次に、発射アラートのみを出力するには、次のように記述します。

```
{{ template "print_alerts" .Alerts.Firing }}
```

これは、`.Alerts` と `.Alerts.Firing` の両方がアラートのリストであるために機能します。

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## コメント
<a name="v9-go-comments"></a>

`{{/*` および `*/}}` を使用してコメントを追加できます。

```
{{/* This is a comment */}}
```

コメントが改行を追加しないようにするには、以下を使用します。

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## インデント
<a name="v9-go-indentation"></a>

タブとスペースの両方のインデントと改行を使用して、テンプレートをより読みやすくすることができます。

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

ただし、テンプレートのインデントはテキストにも適用されます。次に、削除する方法を説明します。

## スペースと改行を削除する
<a name="v9-go-removespace"></a>

text/template では、 `{{-` と `-}}` を使用して、先頭と末尾のスペースと改行を削除します。

例えば、インデントと改行を使用してテンプレートをより読みやすくする場合です。

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

インデントと改行はテキストにも表示されます。

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

各範囲の先頭の `}}` を `-}}` に変更することで、テキストからインデントと改行を削除できます。

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

これにより、テンプレートのインデントと改行がテキストから取り除かれます。

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# 通知テンプレートの作成
<a name="v9-alerting-create-templates"></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 つ以上のテンプレートを追加できます。

通知テンプレート名は、一意である必要があります。同じ通知テンプレートまたは異なる通知テンプレートに、同じ名前のテンプレートを 2 つ使用することはできません。`__subject`、`__text_values_list`、`__text_alert_list`、`default.title`、`default.message` などのデフォルトテンプレートと同じ名前のテンプレートを定義しないでください。

[コンタクトポイント] タブには、通知テンプレートのリストが表示されます。

## 通知テンプレートの作成
<a name="v9-alerting-creating-templates"></a>

**通知テンプレートを作成するには**

1. **[テンプレートの追加]** をクリックします。

1. `email.subject` などの通知テンプレートの名前を選択します。

1. テンプレートの内容をコンテンツフィールドに書き込みます。

   例えば、次のようになります。

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

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

   `{{ define "email.subject" }}` (`email.subject` はテンプレートの名前) と `{{ end }}` はコンテンツの先頭と末尾に自動的に追加されます。

**複数のテンプレートを含む通知テンプレートを作成するには**

1. **[テンプレートの追加]** をクリックします。

1. 通知テンプレート全体の名前を入力します。例えば、`email`。

1. 各テンプレートの最初と最後に `{{ define "name-of-template" }}` と `{{ end }}` を含む各テンプレートをコンテンツフィールドに書き込みます。`email.subject` や `email.message` など、通知テンプレート内の各テンプレートにわかりやすい名前を使用できます。この場合、上記で入力した通知テンプレートの名前は再度使用しないでください。

   次のセクションでは、作成するテンプレートの詳細な例を示します。

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

## E メールの件名テンプレートの作成
<a name="v9-alerting-create-template-subject"></a>

この例では、発射アラートと解決済みアラートの数を含む E メールの件名のテンプレートを作成します。

```
1 firing alerts, 0 resolved alerts
```

**E メールの件名のテンプレートを作成するには**

1. `email.subject` というテンプレートを次の内容で作成します。

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. テンプレートは、キーワード `template` を使用して**件名**フィールドに配置して、コンタクトポイント統合を作成するときに使用します。

   ```
   {{ template "email.subject" . }}
   ```

## E メールのメッセージ用のテンプレート作成
<a name="v9-alerting-create-template-message"></a>

この例では、すべての発射アラートと解決済みアラートの概要を含む E メールのメッセージ用のテンプレートを作成します。

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**E メールのメッセージ用のテンプレートを作成するには**

1. `email` という名前の通知テンプレートを、コンテンツに `email.message_alert` と `email.message` という 2 つのテンプレートで作成します。

   `email.message_alert` テンプレートは、`email.message` テンプレートに E メールの構造が含まれている間、各発射アラートと解決済みアラートのラベルと値を印刷するために使用されます。

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. テンプレートは、キーワード `template` を使用して**テキスト本文**フィールドに配置して、コンタクトポイント統合を作成するときに使用します。

   ```
   {{ template "email.message" . }}
   ```

## Slack メッセージのタイトルのテンプレート作成
<a name="v9-alerting-create-template-slack-title"></a>

この例では、発射アラートと解決済みアラートの数を含む Slack メッセージのタイトルのテンプレートを作成します。

```
1 firing alerts, 0 resolved alerts
```

**Slack メッセージのタイトルのテンプレートを作成するには**

1. `slack.title` というテンプレートを次の内容で作成します。

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. テンプレートは、キーワード `template` を使用して**タイトル**フィールドに配置して、コンタクトポイント統合を作成するときに使用します。

   ```
   {{ template "slack.title" . }}
   ```

## Slack メッセージのコンテンツのテンプレート作成
<a name="v9-alerting-create-template-slack-message"></a>

すべての発射アラートと解決済みアラートの説明 (ラベル、注釈、ダッシュボード URL など) を含む Slack メッセージのコンテンツのテンプレートを作成します。

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Slack メッセージのコンテンツのテンプレートを作成するには**

1. コンテンツに `slack.print_alert` と`slack.message` の 2 つのテンプレートを使用して、`slack` という名前のテンプレートを作成します。

   `slack.print_alert` テンプレートはラベル、注釈、および DashboardURL の印刷に使用され、`slack.message` テンプレートには通知の構造が含まれます。

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. テンプレートは、キーワード `template` を使用して**テキスト本文**フィールドに配置して、コンタクトポイント統合を作成するときに使用します。

   ```
   {{ template "slack.message" . }}
   ```

## 共有テンプレートを使用して E メールと Slack の両方にテンプレートを作成する
<a name="v9-alerting-create-shared-templates"></a>

E メールや Slack など、コンタクトポイントごとに個別の通知テンプレートを作成する代わりに、同じテンプレートを共有できます。

例えば、この件名の E メールを送信し、このタイトル `1 firing alerts, 0 resolved alerts` の Slack メッセージを送信する場合は、共有テンプレートを作成できます。

**共有テンプレートを作成するには**

1. `common.subject_title` というテンプレートを次の内容で作成します。

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. E メールの場合は、E メールコンタクトポイント統合の件名フィールドからテンプレートを実行します。

   ```
   {{ template "common.subject_title" . }}
   ```

1. Slack の場合は、Slack コンタクトポイント統合のタイトルフィールドからテンプレートを実行します。

   ```
   {{ template "common.subject_title" . }}
   ```

## 通知テンプレートの使用
<a name="v9-alerting-use-notification-templates"></a>

コンタクトポイントのテンプレートを使用して通知をカスタマイズします。

**コンタクトポイントの作成時にテンプレートを使用するには**

1. **[アラート]**メニューから、**[コンタクトポイント]** を選択して、既存のコンタクトポイントのリストを表示します。

1. **[コンタクトポイントを追加]** を選択します。または、編集するコンタクトポイントの横にある **[編集]** アイコン (ペン) を選択して、既存のコンタクトポイントを編集することもできます。

1. **[Message]** (メッセージ) や **[Subject]** (件名) などの 1 つ以上のフィールドに、使用するテンプレートを入力します。テンプレートを入力するには、`{{ template "template_name" . }}` フォームを使用し、 *template\$1name* を使用するテンプレートの名前に置き換えます。

1. **[コンタクトポイントの保存]** をクリックします。

# テンプレートリファレンス
<a name="v9-alerting-template-reference"></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-alerting-template-data"></a>

メッセージテンプレートには、次のデータが渡されます。


| 名前 | 型 | 注意事項 | 
| --- | --- | --- | 
|  `Receiver`  |  string  |  コンタクトポイント (通知先) の名前。  | 
|  `Status`  |  string  |  少なくとも 1 つのアラートが発生している場合は「発生中」となり、それ以外の場合「解決済」となります。  | 
|  `Alerts`  |  アラート  |  この通知に含まれるアラートオブジェクトのリスト (以下を参照)。  | 
|  `GroupLabels`  |  KeyValue  |  これらのアラートがグループ化されたラベル。  | 
|  `CommonLabels`  |  KeyValue  |  この通知に含まれるすべてのアラートに共通のラベル。  | 
|  `CommonAnnotations`  |  KeyValue  |  この通知に含まれるすべてのアラートに共通する注釈。  | 
|  `ExternalURL`  |  string  |  通知の送信元である Grafana へのリンク。外部のアラートマネージャーを使用している場合、そのアラートマネージャーへのリンク。  | 

`Alerts` 型には、返されたアラートをフィルタリングするための 2 つの関数があります。
+ `Alerts.Firing` – 発生中のアラートのリストを返します。
+ `Alerts.Resolved` – 解決済みのアラートのリストを返します。

**アラート (型)**

アラート型には、次のデータがあります。


| 名前 | 型 | 注意事項 | 
| --- | --- | --- | 
|  ステータス  |  string  |  `firing` または `resolved`  | 
|  ラベル  |  KeyValue  |  アラートに付与された一連のラベル。  | 
|  ‏注釈  |  KeyValue  |  アラートに付与された一連の注釈。  | 
| 値 | KeyValue | クラシック条件を含むすべての式の値 | 
|  StartsAt  |  time.Time  |  アラートが発行された時刻。  | 
|  EndsAt  |  time.Time  |  アラートの終了時刻がわかっている場合にのみ設定されます。それ以外の場合、最後にアラートを受信してから設定可能なタイムアウト期間が適用されます。  | 
|  GeneratorURL  |  string  |  Grafana または外部アラートマネージャーへのリンク。  | 
|  SilenceURL  |  string  |  アラートをサイレンスするリンク (このアラートのラベルがあらかじめ入力されています)。Grafana 管理のアラートのみ。  | 
|  DashboardURL  |  string  |  Grafana ダッシュボードへのリンク (アラートルールが Grafana に属している場合)。Grafana 管理のアラートのみ。  | 
|  PanelURL  |  string  |  Grafana ダッシュボードパネルへのリンク (アラートルールが Grafana に属している場合)。Grafana 管理のアラートのみ。  | 
|  Fingerprint  |  string  |  アラートの識別に使用するフィンガープリント。  | 
|  ValueString  |  string  |  アラート内の各削減された式のラベルと値を含む文字列。  | 

 **ExtendedData**

ExtendedData オブジェクトには、以下のプロパティが含まれています。


| 名前 | [Kind] (種類) | 説明 | 例 | 
| --- | --- | --- | --- | 
|  レシーバー  |  `string`  |  通知を送信するコンタクトポイントの名前。  |  `{{ .Receiver }}`  | 
|  ステータス  |  `string`  |  ステータスは`firing if at least one alert is firing, otherwise resolved.`です。  |  `{{ .Status }}`  | 
|  アラート  |  `[]Alert`  |  この通知のすべての発生アラートと解決済みアラートのリスト。  |  `There are {{ len .Alerts }} alerts`  | 
|  発生アラート  |  `[]Alert`  |  この通知のすべての発生アラートのリスト。  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  解決済みアラート  |  `[]Alert`  |  この通知で解決されたすべてのアラートのリスト。  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  これらのアラートをこの通知にグループ化するラベル。  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  この通知のすべてのアラートに共通するラベル。  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  この通知のすべてのアラートに共通する注釈。  |  `{{ .CommonAnnotations }}`  | 
|  ExternalURL  |  `string`  |  この通知を送信した Grafana ワークスペースまたはアラートマネージャーへのリンク。  |  `{{ .ExternalURL }}`  | 

**KeyValue 型**

`KeyValue` 型は、キー (ラベル) 値 (注釈) の文字列を組み合わせたものです。

`KeyValue` として保存されたデータに直接アクセスするメソッドだけでなく、データをソート、削除、変換するメソッドも備えています。


| 名前 | 引数 | 戻り値 | 注意事項 | 例 | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  キーと値の文字列のソート済みのリスト  |    | `{{ .Annotations.SortedPairs }}` | 
|  削除  |  []string  |  KeyValue  |  指定したキーを除いたキー/値のマップのコピーを返します。  | `{{ .Annotations.Remove "summary" }}` | 
|  名前  |    |  []string  |  ラベル名のリスト  | `{{ .Names }}` | 
|  値  |    |  []string  |  ラベル値のリスト  | `{{ .Values }}` | 

**[時間]**

時間は Go [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time) パッケージからのものです。時間はさまざまな形式で印刷できます。例えば、アラートが発生した時刻を `Monday, 1st January 2022 at 10:00AM` 形式で出力するには、次のテンプレートを作成します。

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Go の時間形式に関するリファレンスは、[こちら](https://pkg.go.dev/time#pkg-constants)を参照してください。

## テンプレート関数
<a name="v9-alerting-template-functions"></a>

テンプレート関数を使用すると、ラベルと注釈を処理して動的に通知を生成できます。以下の機能を使用できます。


| 名前 | 引数の型 | 戻り型 | 説明 | 
| --- | --- | --- | --- | 
|  `humanize`  |  数値または文字列  |  string  |  メトリクスプレフィックスを使用して、数値をより読み取り可能な形式に変換します。  | 
|  `humanize1024`  |  数値または文字列  |  string  |  humanize と同様に、1000 ではなく 1024 を基準にします。  | 
|  `humanizeDuration`  |  数値または文字列  |  string  |  時間を秒単位のより読みやすい形式に変換します。  | 
|  `humanizePercentage`  |  数値または文字列  |  string  |  比率の値を 100 分の 1 の形に変換します。  | 
|  `humanizeTimestamp`  |  数値または文字列  |  string  |  Unix のタイムスタンプを秒単位のより読みやすい形式に変換します。  | 
|  `title`  |  string  |  string  |  strings.Title を使用すると、各単語の最初の文字が大文字になります。  | 
|  `toUpper`  |  string  |  string  |  strings.ToUpper を使用すると、文字列がすべて大文字に変換されます。  | 
|  `toLower`  |  string  |  string  |  strings.ToLower を使用すると、文字列がすべて小文字に変換されます。  | 
|  `match`  |  パターン、テキスト  |  ブール値  |  regexp.MatchString を使用すると、アンカーなしでの正規表現の一致テストを実行できます。  | 
|  `reReplaceAll`  |  パターン、置換、テキスト  |  string  |  Regexp.ReplaceAllString を使用すると、アンカーなしでの正規表現による置換が実行できます。  | 
|  `graphLink`  |  文字列 - `expr` および `datasource` フィールドを持つ JSON オブジェクト  |  string  |  指定された式とデータソースに対するグラフィカルビューへのパスを返します。  | 
|  `tableLink`  |  文字列 - `expr` および `datasource` フィールドを持つ JSON オブジェクト  |  string  |  指定された式とデータソースに対するタブ形式ビューへのパスを返します。  | 
|  `args`  |  []interface\$1\$1  |  map[string]interface\$1\$1  |  オブジェクトのリストを arg0、arg1 などのキーを持つマップに変換します。複数の引数をテンプレートに渡す場合、この関数を使用します。  | 
|  `externalURL`  |  なし  |  string  |  外部 URL を表す文字列を返します。  | 
|  `pathPrefix`  |  なし  |  string  |  外部 URL のパスを返します。  | 

次の表に、各関数の使用例を紹介します。


| 関数 | TemplateString | Input | 予想 | 
| --- | --- | --- | --- | 
|  humanize  |  \$1 humanize \$1value \$1  |  1234567.0  |  1.235M  | 
|  humanize1024  |  \$1 humanize1024 \$1value \$1  |  1048576.0  |  1Mi  | 
|  humanizeDuration  |  \$1 humanizeDuration \$1value \$1  |  899.99  |  14 分 59 秒  | 
|  humanizePercentage  |  \$1 humanizePercentage \$1value \$1  |  0.1234567  |  12.35%  | 
|  humanizeTimestamp  |  \$1 humanizeTimestamp \$1value \$1  |  1435065584.128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  title  |  \$1 \$1value \$1 title \$1  |  aa bB CC  |  Aa Bb Cc  | 
|  toUpper  |  \$1 \$1value \$1 toUpper \$1  |  aa bB CC  |  AA BB CC  | 
|  toLower  |  \$1 \$1value \$1 toLower \$1  |  aa bB CC  |  aa bb cc  | 
|  match  |  \$1 match "a\$1" \$1labels.instance \$1  |  aa  |  真  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll "localhost:(.\$1)" "my.domain:\$11" \$1labels.instance \$1\$1  |  localhost:3000  |  my.domain:3000  | 
|  graphLink  |  \$1\$1 graphLink "\$1\$1"expr\$1": \$1"up\$1", \$1"datasource\$1": \$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true\$1]  | 
|  tableLink  |  \$1\$1 tableLink "\$1\$1"expr\$1":\$1"up\$1", \$1"datasource\$1":\$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false\$1]  | 
|  args  |  \$1\$1define "x"\$1\$1\$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1\$1\$1end\$1\$1\$1\$1template "x" (args 1 "2")\$1\$1  |    |  1 2  | 
|  externalURL  |  \$1 externalURL \$1  |    |  http://localhost/path/prefix  | 
|  pathPrefix  |  \$1 pathPrefix \$1  |    |  /path/prefix  | 

# Prometheus データソースのアラート通知のサイレンス化
<a name="v9-alerting-silences"></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)」を参照してください。

外部のアラートマネージャーデータソース (Amazon Managed Service for Prometheus を含む) では、*[サイレンス]*機能を使用してアラート通知を停止できます。サイレンスは通知の作成を停止するだけで、アラートルールの評価やユーザーインターフェースへのアラートインスタンスの表示は引き続き行われます。アラートをサイレンスにする場合、停止する時間枠を指定します。

外部アラートマネージャーデータソースのサイレンスを設定できます。

**注記**  
アラート通知を一定の時間間隔、またはその他のデータソース (定期的なメンテナンス期間中など) で停止するには、サイレンスではなく [ミュートタイミング](v9-alerting-notification-muting.md) を使用します。

**サイレンスの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[サイレンス]** を選択して、既存の [コンタクトポイント (通知先) の使用](v9-alerting-contact-points.md) を一覧表示するページを開きます。

1. **[アラートマネージャー]** ドロップダウンから外部アラートマネージャーを選択します。

1. **[サイレンスの追加]** を選択します。

1. **[サイレンスの開始と終了]** でサイレンスを有効にする開始日と終了日を選択します。

   終了時刻を設定する代わりに、**[期間]** でサイレンスが適用される期間を指定します。この方法を使用すると、**[サイレンスの開始と終了]** フィールドの終了時刻が自動的に更新されます。

1. **[名前]** および **[値]** のフィールドには、1 つ以上の*一致するラベル*を入力します。照合機能により、どのルールにサイレンスを適用するかが決定されます。ラベルの照合については、この手順の後に詳しく説明します。

1. 必要に応じて、**コメント**を追加したり、**作成者**を変更してサイレンスの所有者を設定することができます。

1. **[作成]** を選択して入力を作成します。

既存のサイレンスを編集するには、**[編集]** アイコン (ペン) を選択します。

**アラート停止のラベル一致**

サイレンスの作成時に、サイレンスの一部として*一致するラベル*のセットを作成します。これは、アラートが停止されるために一致する必要があるラベルに関するルールのセットです。一致するラベルは、次の 3 つの部分で構成されます。
+ **ラベル** – 一致させるラベルの名前。アラートのラベル名と完全に一致する必要があります。
+ **[演算子]** – ラベル値と一致するラベル値の比較に使用される演算子。利用できる演算子は次のとおりです。
  + `=` 値が指定された文字列と完全に一致するラベルが選択されます。
  + `!=` 値が指定された文字列と一致しないラベルが選択されます。
  + `=~` 指定された文字列の正規表現解釈値と一致するラベルが選択されます (指定された文字列は正規表現として解釈されます)
  + `!=` 指定された正規表現と一致しないラベルが選択されます。
+ **[値])** – ラベル値と一致する値。選択した演算子に応じて、文字列または正規表現として照合させることができます。

サイレンスは指定された終了日に終了しますが、いつでも手動で停止状態を解除することができます。

**サイレンスを手動で終了する方法**

1. **[アラート]** ページで、**[サイレンス]** を選択して既存のサイレンスのリストを表示します。

1. 終了するサイレンスを選択し、**[サイレンス解除]** を選択します。この操作によりアラートの停止状態は終了します。
**注記**  
サイレンス解除を行うと、終了時刻が現在の時刻に設定されたものとして、アラートの停止状態が終了します。（自動または手動を問わず）終了したサイレンスは5 日間保持され、一覧表示されます。リストからサイレンスを手動で削除することはできません。

**サイレンス作成フォームへのリンクの作成**

詳細が既に入力されているサイレンス作成フォームへの URL を作成できます。オペレータはこれを使用して、運用上のイベントを行う際にアラームをすばやく停止することができます。

サイレンスフォームへのリンクを作成するときは、`matchers` クエリパラメータを使用して一致するラベルを指定し、`comment` クエリパラメータを使用してコメントを指定します。`matchers` パラメータには、カンマで区切られた `[label][operator][value]` 形式の 1 つ以上の値が必要です。

**URL の例**

ラベル `severity=critical` と `cluster!~europe-.*` が一致し、`Silencing critical EU alerts` というコメントが付いたサイレンスフォームにリンクするには、次のような URL を使用します。*mygrafana* を Grafana インスタンスのホスト名に置き換えてください。

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

外部アラートマネージャーの新しいサイレンスページにリンクする場合、アラートマネージャーデータソース名を含む `alertmanager` クエリパラメータを追加します (例: `alertmanager=myAlertmanagerdatasource`)。

# ミュートタイミング
<a name="v9-alerting-notification-muting"></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. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[通知ポリシー]** を選択します。

1. **[アラートマネージャー]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. **[ミュートタイミング]** セクションで、**[ミュートタイミングの追加]** ボタンを選択します。

1. ミュートタイミングを適用したい時間間隔を選択します。

1. **[送信]** を選択してミュートタイミングを作成します。

**通知ポリシーへのミュートタイミングの追加方法**

1. ミュートタイミングを追加する通知ポリシーを選択し、**[編集]** ボタンを選択します。

1. **[ミュートタイミング]** ドロップダウンから、ポリシーに追加するミュートタイミングを選択します。

   **[ポリシーを保存]** ボタンを選択します。

**時間間隔**

時間間隔には、時間範囲を指定します。この時間間隔内にアラートが発生した場合、抑制されます。範囲には `:` を使用して表現することができます (例: `monday:thursday`)。ミュートタイミングには複数の時間間隔を含めることができます。時間間隔は複数のフィールド (詳細は次のリストを参照) で構成され、アラートを抑制するには、すべてのフィールドが一致する必要があります。例えば、曜日に月曜日から金曜日 `monday:friday`、時間範囲を 8:00～9:00 と指定した場合、アラートは月曜日から金曜日の 8:00～9:00 の間は抑制されますが、土曜日の 8:00～9:00 は抑制されません。
+ **[時間範囲]** – 通知を抑制する時間帯。**[開始時刻]**と**[終了時刻]** の 2 つのサブフィールドで構成されます。時刻は `14:30` のように指定します。時刻は UTC の 24 時間表記です。
+ **[曜日]** - 曜日。単一の日 (例: `monday`)、範囲 (例: `monday:friday`)、またはカンマで区切られた複数の日のリスト (例: `monday, tuesday, wednesday`) を指定できます。
+ **[月]** - 選択する月。月は、数値で指定することも、完全な月名で指定することもできます。例えば、`1` または `january` のどちらでも 1 月を指定できます。単一の月、月の範囲、またはカンマ区切りの月のリストを指定できます。
+ **[月の日付]** – 1 か月内の日付。値は `1`～`31` の範囲で指定します。負の値は月の日を逆順で指定することを意味します。たとえば、`-1` は月の最終日を表します。日付は単一の日、日付の範囲、またはカンマで区切った日付のリストを指定できます。
+ **[年]** - 間隔の年または複数年。例えば、`2023:2025`。

これらの要素はそれぞれリストにすることができ、一致するには要素内の少なくとも 1 つの項目を満たす必要があります。したがって、年を `2023:2025, 2027` に設定すると、2023、2024、2025、2027 年 (2026 年を除く) に当てはまります。

フィールドを空白のままにすると、任意の時刻をフィールドと照合します。完全な時間間隔と一致させるには、ある時点がすべてのフィールドと一致している必要があります。

正確な期間を指定する場合は、その期間に必要なすべてのオプションを指定します。例えば、3 月、6 月、9 月、12 月の最初の月曜日の 12:00 から 24:00 UTC の時間間隔を作成する場合、時間間隔の指定は次のようになります。
+ 時間範囲：
  + 開始時間: `12:00`
  + 終了時間: `24:00`
+ 曜日: `monday`
+ 月: `3, 6, 9, 12`
+ 日: `1:7`

# アラートグループ別に表示およびフィルタリングする
<a name="v9-alerting-viewfiltergroups"></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. Grafana メニューで、**[アラート]** (ベル) アイコンをクリックしてアラートページを開いて既存のアラートを一覧表示します。

1. **[アラートグループ]** をクリックして、既存のグループを一覧表示するページを開きます。

1. **[アラートマネージャー]** ドロップダウンから、データソースとして外部アラートマネージャーを選択します。

1. **[カスタムグループ化]** ドロップダウンでラベルの組み合わせを選択して、デフォルト以外のグループを表示します。これは、通知ポリシーのグループをデバッグおよび検証するのに役立ちます。

アラートにルートポリシーのグループ化またはカスタムグループ化のいずれかで指定されたラベルが含まれていない場合、アラートは `No grouping` のヘッダーを持つ [すべてのグループを取得] に追加されます。

**ラベルでフィルタリングするには**
+ **[検索]** で既存のラベルを入力して、ラベルに一致するアラートを表示します。

  例えば、`environment=production,region=~US|EU,severity!=warning`。

**状態でフィルタリングするには**
+ **[状態]** では、Active (アクティブ)、Suppressed (抑制)、または Unprocessed (未処理) の状態を選択すると、選択した状態に一致するアラートが表示されます。他のすべてのアラートは非表示になります。

# 通知エラーの表示
<a name="v9-alerting-viewnotificationerrors"></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 メニューで、**[アラート]** (ベル) アイコンをクリックしてアラートページを開いて既存のアラートを一覧表示します。

1. **[コンタクトポイント]** を選択すると、現在設定されているコンタクトポイントのリストが表示されます。

   いずれかのコンタクトポイントが失敗した場合は、画面の右隅にメッセージが表示され、エラーが発生していることとその数がユーザーに通知されます。

1. コンタクトポイントをクリックすると、そのコンタクトポイントのエラーの詳細が表示されます。

   エラーアイコンにカーソルを合わせると、エラーの詳細が表示されます。

   コンタクトポイントに複数の統合がある場合、各統合のすべてのエラーが表示されます。

1. [正常性] 列で、通知のステータスを確認します。

   これは、[OK]、[試行なし]、または [エラー]のいずれかです。