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

# Grafana バージョン 10 での作業
<a name="using-grafana-v10"></a>

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

Grafana ワークスペースを作成するときに、使用する Grafana のバージョンを選択できます。以下のトピックでは、Grafana バージョン 10 を使用する Grafana ワークスペースの使用について説明します。

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

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

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

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

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

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

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

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

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

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

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

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



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

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

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

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

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

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

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

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

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

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

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

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

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


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

**注記**  
 Grafana アラートは、次の構文をサポートしていません。  
`now+n`: 将来のタイムスタンプ。
`now-1n/n`: *n の開始から n の終了まで* (これは絶対タイムスタンプであるため)。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**変数の追加**

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

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

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

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

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

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

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

**リンクの追加**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

# ライブラリパネルの管理
<a name="v10-dash-manage-library-panels"></a>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ダッシュボードリンクは、現在のダッシュボード名で GitHub の問題を送信するなど、外部システムへのショートカットとしても使用できます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. **[追加]** を選択します。

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

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

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

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

1. 設定を変更し、**[更新]** を選択します。

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

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

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

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

**パネルリンク**

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

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

  1. リンクを追加するパネルにカーソルを合わせます。

  1. メニューを選択し、**[編集]** を選択するか、キーボードショートカット `e` を使用します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**リージョン注釈**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

**Timepicker**

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

**USE メソッド**

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

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

**RED メソッド**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**高 – 最適化使用**

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

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

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

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

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

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

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

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

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

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

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

**監視戦略を持つ**

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

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

**書き留める**

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

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

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

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

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

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

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

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

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

**成熟度レベル**

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

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

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

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

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

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

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

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

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

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

**前提条件**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**テンプレート**

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

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

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

**例**

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**間隔変数の例**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**変数の順序**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

```
backend_01
backend_02
backend_03
backend_04
```

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

正規表現:

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

結果:

```
backend_01
backend_02
```

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

正規表現:

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

結果:

```
01
02
```

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

このオプションのリストでは、次の操作を行います。

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

次の正規表現:

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

これらの結果を返します:

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

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

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

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

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

次の正規表現を渡す:

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

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

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

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

# 変数の検査
<a name="v10-dash-variable-add-inspect"></a>

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

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

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

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

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

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

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

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

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

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

**一般的な構文**

構文: `${var_name:option}`

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

**CSV**

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

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

**分散 - OpenTSDB**

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

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

**二重引用符**

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

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

**Glob - Graphite**

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

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

**JSON**

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

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

**Lucene - Elasticsearch**

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

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

**Percentencode**

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

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

**パイプ**

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

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

**Raw**

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

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

**[正規表現]**

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

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

**一重引用符**

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

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

単一値変数と複数値の変数をカンマ区切り文字列にフォーマットし、`''` によって各値の `'` をエスケープし、`'` で各値を引用符で囲みます。

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**[テキスト]**

単一値変数と複数値変数をテキスト表現にフォーマットします。単一値の変数の場合、テキスト表現のみを返します。複数値変数の場合、テキスト表現は `+` と組み合わせて返されます。

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**クエリパラメータ**

単一値変数と複数値変数をクエリパラメータ表現にフォーマットします。例: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# ダッシュボード使用状況の評価
<a name="v10-dash-assess-dashboard-usage"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

すべてのダッシュボードとデータソースで、使用状況情報にアクセスできます。

**ダッシュボードインサイト**

ダッシュボードの使用状況情報を表示するには、上部のバーで **[ダッシュボードインサイト]** を選択します。

ダッシュボードには以下の情報が表示されます。
+ **[統計]** – 過去 30 日間の毎日のクエリとエラーの数。
+ **[ユーザーとアクティビティ]** – 過去 30 日間の日次ビュー数。ダッシュボードと最近のユーザー (制限は 20) に対する最後のアクティビティ。

**データソースインサイト**

データソースインサイトは、過去 30 日間にデータソースがどのように使用されたかに関する情報を提供します。
+ 1 日あたりのクエリ
+ 1 日あたりのエラー
+ 1 日あたりのクエリロード時間 (平均ミリ秒）

**データソースインサイトを検索するには**

1. ワークスペースのメインナビゲーションで **[接続]** を選択します。

1. **[データソース]** を選択します。

1. データソースを選択します。

1. **[インサイト]** タブを選択します。

## プレゼンスインジケータ
<a name="v10-dash-presence-indicator"></a>

サインインしてダッシュボードを表示すると、プレゼンスインジケーターによって、自分と同じダッシュボードを表示しているユーザーを知ることができます。プレゼンスインジケーターには、ダッシュボードを最近操作したユーザーのアバターが表示されます。デフォルトの時間枠は 10 分です。ユーザー名を表示するには、ユーザーのアバターにカーソルを合わせます。アバターは、ユーザーの E メールに基づいて [Gravatar](https://gravatar.com/) から取得されます。

ダッシュボードにプレゼンスインジケータに収まるユーザーよりもアクティブなユーザーがいる場合は、**[\$1X]** アイコンをクリックします。これを行うと、ダッシュボードインサイトが開きます。ダッシュボードインサイトには、最近のユーザーアクティビティに関する詳細が含まれます。

## インサイトデータを使用したダッシュボードのソート
<a name="v10-dash-sort-dashboards"></a>

検索ビューでは、インサイトデータを使用して、最も使用されているダッシュボード、壊れているダッシュボード、未使用のダッシュボードを見つけることができます。ダッシュボードは、次の項目でソートできます。
+ ビュー
+ エラー
+ ビュー
+ 作成日時
+ 更新日時

# ダッシュボードのトラブルシューティング
<a name="v10-dash-troubleshoot"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

 次の戦略を使用して、一般的なダッシュボードの問題をトラブルシューティングします。

## ダッシュボードが遅い
<a name="v10-dash-dashboard-is-slow"></a>
+ グラフに数十 (または数百または数千) の時系列をレンダリングしようとしていますか？ これにより、ブラウザが遅延する可能性があります。(Graphite で) `highestMax` のような関数を使用して、返されるシリーズの数を減らしてみてください。
+ 場合によっては、シリーズ名が非常に大きくなることがあります。これにより、レスポンスサイズが大きくなります。`alias` を使用して、返されるシリーズ名のサイズを小さくしてみてください。
+ 多くの時系列または長い時間範囲をクエリしていますか？ これらの両方の条件により、Grafana またはデータソースが大量のデータを取得し、ダッシュボードの速度が低下する可能性があります。これらの 1 つまたは両方を減らしてみてください。
+ ネットワークインフラストラクチャに高負荷が発生している場合があり、特に速度が一貫していない場合は、これが問題である可能性があります。

## ダッシュボードの更新レートの問題
<a name="v10-dash-refresh-rate-issues"></a>

デフォルトでは、Grafana は 30 秒ごとにデータソースをクエリします。ただし、ダッシュボードの更新率を低く設定すると、バックエンドに不要なストレスがかかります。多くの場合、データソースが 30 秒ごとに変更されるのに十分なほど頻繁にデータを送信していないため、このクエリを頻繁に行う必要はありません。

次の構成を推奨します。
+ 必要に応じて、ダッシュボード、パネル、または変数の自動更新のみを有効にします。ユーザーはブラウザを手動で更新できます。
+ 自動更新が必要な場合は、1 分に 1 回、10 分に 1 回、1 時間に 1 回など、更新レートをより長い期間に設定します。
+ ダッシュボードの時間範囲を確認します。ダッシュボードの時間範囲が 1 週間など長い場合、自動更新は必要なく、無効にすべきです。

## null データの処理またはレンダリングが間違っている、または混乱している
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

一部のアプリケーションは断続的にデータを公開します。例えば、イベントが発生したときにのみメトリクスを投稿します。デフォルトでは、Grafana グラフはデータポイント間で線を接続しますが、これは誤解を招く可能性があります。

**[null 値の接続]** オプションが **[常に]** に設定されているグラフは、値が欠落している線を繋げます。

これを修正する 1 つの方法は、線の代わりにバーを使用し、**[値なし]** オプション (**[標準オプション]**の下) を `0` に設定することです。この場合、欠落したデータは、データのないグラフの領域として表示されます。

# Grafana バージョン 10 でのダッシュボードの検索
<a name="v10-search"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボード名とパネルタイトルでダッシュボードを検索できます。ダッシュボードを検索すると、ダッシュボードの内容を表示するアクセス許可がない場合でも、システムは Grafana インスタンス内で使用可能なすべてのダッシュボードを返します。

## ダッシュボード名を使用してダッシュボードを検索する
<a name="v10-search-by-name"></a>

検索バーにダッシュボード名の一部を入力します。検索では、入力すると、文字列の部分一致の結果がリアルタイムで返されます。

ダッシュボード検索は次のとおりです。
+ リアルタイム
+ 大文字と小文字は*区別されません*。
+ 保存済みダッシュボードとファイルベースのダッシュボード全体で機能します。

**ヒント**  
キーボードの矢印キーを使用して結果を移動し、`Enter` を押して選択したダッシュボードを開くことができます。

## パネルタイトルを使用してダッシュボードを検索する
<a name="v10-search-by-title"></a>

ダッシュボードに表示されるパネルのタイトルでダッシュボードを検索できます。パネルのタイトルが検索クエリと一致すると、ダッシュボードが検索結果に表示されます。

## ダッシュボードの検索結果をタグでフィルタリングする
<a name="v10-search-by-tag"></a>

ダッシュボードの数が増えるほど、タグをつけることで効果的に整理することができます。ダッシュボード [**設定**] でタグを追加および管理できます。

複数のタグを選択すると、Grafana は選択したすべてのタグを含むダッシュボードを表示します。

タグでダッシュボード検索結果をフィルタリングするには、次のいずれかの手順を実行します。
+ ダッシュボードの検索結果をタグでフィルタリングするには、検索結果の右側の列に表示されるタグを選択します。

  追加のタグを選択して、フィルタリングを続行できます。
+ 使用可能なすべてのタグのリストを表示するには、**[タグでフィルタリング]**ドロップダウンメニューをクリックし、タグを選択します。

  すべてのタグが表示され、タグを選択すると、ダッシュボード検索が即座にフィルタリングされます。

**ヒント**  
キーボードのみを使用する場合は、`tab` キーを押して **[タグでフィルタリング]** ドロップダウンメニューに移動し、下矢印キーを押してメニューをアクティブ化し、タグを見つけ、`Enter` を押してタグを選択します。

## コマンドパレット
<a name="v10-search-palette"></a>

コマンドパレットを使うと、次のことができます。
+ ダッシュボードとフォルダを検索して開きます。
+ ダッシュボードとアラートルールを作成します。
+ Grafana 内のページを見つけます。
+ ダークテーマまたはライトテーマに変更します。

コマンドパレットをトップで開き、「`ctrl+k`」(MacOS では「`cmd+k`」) と入力します。Grafana ナビゲーションバーで検索入力を選択することもできます。

**注記**  
前の手順に進むには、コマンドパレットを空にして `backspace` を押します。

# Grafana バージョン 10 のパネルと視覚化
<a name="v10-panels"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

*パネル*は Grafana の基本的な視覚化構築ブロックです。各パネルには、パネルで選択されたデータソース特有のクエリエディタがあります。クエリエディタを使用すると、視覚化するデータを返すクエリを構築できます。

各パネルにはさまざまなスタイルとフォーマットのオプションがあります。パネルをドラッグ、ドロップ、サイズ変更して、ダッシュボード上で配置を変更できます。

パネルを追加する前に、データソースが設定されていることを確認してください。

追加のパネルタイプは、追加の[プラグイン](grafana-plugins.md)をワークスペースにインストールすることで使用できます。

特定のデータソース使用の詳細については「[データソースに接続する](AMG-data-sources.md)」を参照してください。

**Topics**
+ [パネルエディタの概要](v10-panels-editor-overview.md)
+ [パネル検査ビュー](v10-panels-panel-inspector.md)
+ [データのクエリと変換](v10-panels-query-xform.md)
+ [パネルオプションの設定](v10-panels-configure-panel-options.md)
+ [標準オプションを設定する](v10-panels-configure-standard-options.md)
+ [凡例を設定する](v10-panels-configure-legend.md)
+ [データリンクの設定](v10-panels-configure-data-links.md)
+ [値マッピングを設定する](v10-panels-configure-value-mappings.md)
+ [しきい値を設定する](v10-panels-configure-thresholds.md)
+ [フィールドのオーバーライドを設定する](v10-panels-configure-overrides.md)
+ [Grafana バージョン 10 で利用可能な視覚化](v10-panels-viz.md)

# パネルエディタの概要
<a name="v10-panels-editor-overview"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

パネルエディタでは、データソース、クエリ、時間範囲、表示オプションなど、視覚化のすべての要素を更新できます。

パネルを新しいダッシュボードに追加するには、ダッシュボードの中央に **[視覚化を追加]** を選択します。既存のダッシュボードにパネルを追加するには、ダッシュボードヘッダーの **[追加]** を選択し、ドロップダウンで **[視覚化]** を選択します。同じダッシュボードまたは別のダッシュボードから既存のパネルをコピーして貼り付けることもできます。

## パネルメニュー
<a name="v10-panels-editor-menu"></a>

パネルエディタにアクセスするには、任意のパネルの右上隅にカーソルを合わせます。表示されるパネルメニューアイコンを選択し、**[編集]** を選択します。

パネルメニューでは、次のアクションにもアクセスできます。
+ **[表示]** – パネルを全画面で表示します。
+ **[編集]** – パネルエディタを開いて、パネルと視覚的表現オプションを編集します。
+ **[共有]** – パネルをリンクまたはライブラリパネルとして共有します。
+ **[Explore]** – **Explore** でパネルを開き、クエリに集中できます。
+ **[Inspect]** (検査) – **Inspect** ドロワーを開き、パネルデータ、統計、メタデータ、JSON、クエリを確認できます。
  + **[Data]** (データ) – **データ**タブで **Inspect** ドロワーを開きます。
  + **[クエリ]** – **クエリ**タブで **Inspect** ドロワーを開きます。
  + **Panel JSON** – **JSON** タブで **Inspect** ドロワーを開きます。
+ **[拡張機能]** – インシデント宣言など、インストールされたアプリケーションによって提供される他のアクションにアクセスします。このオプションは、パネルメニューに拡張機能を提供するアプリケーションプラグインがインストールされている場合にのみ表示されます。
+ **[その他]** – 他のパネルアクションにアクセスします。
  + **[Duplicate]** (複製) – パネルのコピーを作成します。複製されたパネルは、元のパネルとは別にデータに対してクエリを実行します。同じクエリ結果を使用する場合は、2 番目のパネルで `Dashboard` データソースを使用できます。
  + **[Copy]** (コピー) – パネルをクリップボードにコピーします。
  + **ライブラリパネルの作成** – 他のダッシュボードにインポートできるパネルを作成します。
  + **[アラートの作成]** – **[アラート]** でアラートルール設定ページを開き、パネルクエリに基づいて [Grafana マネージドアラート](v10-alerts.md)を作成できます。
  + **[凡例を非表示]** – パネル凡例を非表示にします。
  + **[Get help]** (ヘルプを得る) – Grafana Labs テクニカルサポートにスナップショットまたはパネルデータを送信します。
+ **[削除]** – ダッシュボードからパネルを削除します。

## パネルエディタ
<a name="v10-panels-editor-view"></a>

このセクションでは、Grafana パネルエディタの領域について説明します。
+ パネルヘッダー – ヘッダーセクションには、パネルが表示されるダッシュボードと、次のコントロールが一覧表示されます。
  + **[破棄]** — ダッシュボードを最後に保存してから行ったパネルへの変更が破棄されます。
  + **[保存]** - パネルに加えた変更を保存します。
  + **[適用]** – 行った変更が適用され、パネルエディタが閉じてダッシュボードに戻ります。ダッシュボードを保存して、適用された変更を保持する必要があります。
+ 視覚化プレビュー – 視覚化プレビューセクションには、次のオプションが含まれています。
  + **[テーブルビュー]** – 視覚化をテーブルに変換して、データを表示します。テーブルビューはトラブルシューティングに役立ちます。このビューには未加工データのみが含まれます。データに適用した変換や、[テーブル](v10-panels-table.md)の視覚化で使用できる書式設定オプションは含まれません。
  + **[塗りつぶし]** – 視覚化プレビューで、使用可能なスペースを塗りつぶします。サイドペインの幅またはボトムペインの高さを変更すると、視覚化が変更され、使用可能なスペースが塗りつぶされます。
  + **[実寸]** — 視覚化プレビューが、ダッシュボードの実際のサイズで表示されます。十分なスペースがない場合、視覚化はアスペクト比が保持されたまま縮小されます。
  + **[時間範囲コントロール]** – **[デフォルト]**は、ブラウザのローカルタイムゾーンまたはより高度な設定で選択されたタイムゾーンです。
+ データセクション – データセクションには、クエリの入力、データの変換、アラートルールの作成 (該当する場合) を行うタブがあります。
  + **[クエリ] タブ** – データソースを選択し、ここにクエリを入力します。詳細については、「[データのクエリと変換](v10-panels-query-xform.md)」を参照してください。ダッシュボードを最初に作成すると、データソースを選択するように求められます。このタブでデータソースまたはクエリを更新できます。
  + **[変換 タブ]** – データ変換を適用します。詳細については、「[データのクエリと変換](v10-panels-query-xform.md)」を参照してください。
  + **[アラート] タブ** – アラートルールを入力します。詳細については、「[Grafana バージョン 10 のアラート](v10-alerts.md)」を参照してください。
+ パネル表示オプション – 表示オプションセクションには、データ視覚化のほぼすべての側面を設定するタブがあります。詳細は、選択した視覚化タイプによって異なります。

## パネル検査ドロワー
<a name="v10-panels-editor-inspect"></a>

検査ドロワーは、パネルの理解とトラブルシューティングに役立ちます。任意のパネルの未加工データの表示、データの CSV (comma-separated values: カンマ区切り) ファイルへのエクスポート、クエリリクエストの表示、JSON 形式のパネルとデータのエクスポートが可能です。

**注記**  
すべてのパネルタイプにタブがすべてあるわけではありません。例えば、ダッシュボードリストパネルには検査する未加工データがないため、[統計]、[データ]、[クエリ] タブは表示されません。

パネルインスペクターは、次のオプションで構成されます。
+ パネル検査ドロワーは、右側にドロワーとして表示されます。右上隅の矢印を選択して、ドロワーペインを展開または縮小します。
+ **[データ タブ]** – 変換が適用されたクエリによって返される未加工データを表示します。オーバーライドや値マッピングなどのフィールドオプションは、デフォルトでは適用されません。
+ **[統計タブ]** – クエリにかかる時間および返される量を示します。
+ **[JSON] タブ** – パネル JSON、パネルデータ JSON、およびデータフレーム構造 JSON を、表示およびコピーできます。これは Grafana のプロビジョニングまたは管理に役立ちます。
+ **[クエリタブ]** – Grafana がデータソースへのクエリ実行時に送信されるサーバーへのリクエストを表示します。
+ **[エラータブ]** – クエリによって返されたエラーを表示します。タブは、クエリがエラーを返す場合にのみ表示されます。

# パネル検査ビュー
<a name="v10-panels-panel-inspector"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

パネル検査ビューは、パネルメニューから開くことができ、パネルの理解とトラブルシューティングに役立ちます。Amazon Managed Grafana パネルの未加工データの検査、データの CSV (comma-separated values: カンマ区切り) ファイルへのエクスポート、クエリリクエストの表示、JSON 形式のパネルとデータのエクスポートが可能です。

**注記**  
すべてのパネルタイプにタブがすべてあるわけではありません。例えば、ダッシュボードリストパネルには検査する未加工データがないため、[統計]、[データ]、[クエリ] タブは表示されません。

パネルインスペクターは、次のオプションで構成されます。

1. パネルインスペクターでは、ペインの上部に **[Inspect: ]** が表示されます。右上隅の矢印を選択して、ペインを展開または縮小します。

1. **[データ タブ]** – 変換が適用されたクエリによって返される未加工データを表示します。オーバーライドや値マッピングなどのフィールドオプションは、デフォルトでは適用されません。

1. **[統計タブ]** – クエリにかかる時間および返される量を示します。

1. **[JSON] タブ** – パネル JSON、パネルデータ JSON、およびデータフレーム構造 JSON を、表示およびコピーできます。これは Grafana のプロビジョニングまたは管理に役立ちます。

1. **クエリタブ** – Grafana がデータソースへのクエリ実行時に送信されるサーバーへのリクエストを表示します。

1. **[エラータブ]** – エラーを表示します。クエリがエラーを返す場合にのみ表示されます。

## 未加工のクエリ結果のダウンロード
<a name="v10-panels-raw-query-results"></a>

Amazon Managed Grafana は、お使いのデータで構成される CSV ファイルを生成します。これには、そのデータに対する任意の変換も含まれます。パネルがフィールドオプションまたはフィールドオプションオーバーライドを適用する前後にデータを表示するように選択できます。

**未加工のクエリ結果をダウンロードするには**

1. ダウンロードするクエリデータを含むパネルを編集します。

1. クエリエディタで、**[Query Inspector]** を選択します。

1. **[Data]** (データ) を選択します。

   パネルに複数のクエリがある、または複数のノードにクエリを実行する場合は、追加のオプションがあります。
   + **[結果の選択]** – 表示する結果セットデータを選択します。
   + **[データを変換する]**
   + **[(時間で結合]** – すべてのクエリの生データを一度に表示し、列ごとに結果セットを 1 つ表示します。列見出しを選択して、データ順序を変更します。

1. システムがフィールドオーバーライドを適用する前にデータを表示するには、**[フォーマットされたデータ]** トグルを選択します。

1. Excel 用にフォーマットされた CSV ファイルをダウンロードするには、**[Excel 用にダウンロード]** トグルをを選択します。

1. **[CSV ダウンロード]** を選択します。

## クエリパフォーマンスの検査
<a name="v10-panels-query-performance"></a>

**[統計]** タブには、クエリにかかる時間、送信したクエリの数、返された行数を示す統計が表示されます。この情報は、特に数値が予想外に高い場合や低い場合のクエリのトラブルシューティングに役立ちます。

**クエリのパフォーマンスを検査するには**

1. クエリを含むパネルを、検査するパフォーマンスで編集します。

1. クエリエディタで、**[Query Inspector]** を選択します。

1. **[Stats]** (統計) を選択します。

統計が読み取り専用形式で表示されます。

## クエリリクエストとレスポンスの検査
<a name="v10-panels-query-request-response"></a>

予期しない結果を返すクエリ、または予想される結果を返さないクエリをトラブルシューティングする場合は、クエリリクエストとレスポンスデータを検査できます。

1. エクスポートするクエリを含むパネルを編集します。

1. クエリエディタで、**[Query Inspector]** を選択します。

1. **[更新]** を選択します。

   パネルにはレスポンスデータが入力されます。

1. 必要に応じて調整を行い、クエリを再実行します。

1. クエリリクエストとレスポンスデータをダウンロードするには、**[Copy to clipboard]** (クリップボードにコピー) アイコンをクリックし、結果を別のアプリケーションに貼り付けます。

# データのクエリと変換
<a name="v10-panels-query-xform"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Amazon Managed Grafana は、さまざまなタイプの[データソース](AMG-data-sources.md)をサポートしています。データソース*[クエリ]*は、Grafana が*変換*および視覚化できるデータを返します。各データソースは独自のクエリ言語を使用し、データソースプラグインはそれぞれクエリエディタと呼ばれるクエリ構築ユーザーインターフェイスを実装します。

**Topics**
+ [クエリについて](#v10-panels-query-xform-about)
+ [クエリタブを操作する](#v10-panels-query-xform-navigate)
+ [クエリの追加](#v10-panels-query-xform-add)
+ [クエリの管理](#v10-panels-query-xform-manage)
+ [クエリオプション](#v10-panels-query-xform-options)
+ [クエリ式の書き込み](v10-panels-query-xform-expressions.md)
+ [別のパネルとクエリ結果を共有する](v10-panels-query-share.md)
+ [[データを変換する]](v10-panels-xform.md)
+ [クエリのトラブルシューティング](v10-panels-query-troubleshoot.md)
+ [計算タイプ](v10-panels-calculation-types.md)

## クエリについて
<a name="v10-panels-query-xform-about"></a>

Grafana パネルは、クエリを介してデータソースと通信します。このクエリは、視覚化用のデータを取得します。クエリは、データソースで使用されるクエリ言語で記述された質問です。

パネルのデータソースオプションで、クエリの頻度とデータ収集の制限を設定できます。Grafana は、パネルごとに最大 26 個のクエリをサポートします。

各データソースのクエリ言語の詳細については、[「データソース」](AMG-data-sources.md)セクションを参照してください。

**クエリエディタ**

各データソースの*クエリエディタ*には、独自の機能を活用するクエリの作成に役立つカスタマイズされたユーザーインターフェイスが用意されています。

クエリ言語の違いにより、各データソースクエリエディタの外観と関数は異なります。データソースによっては、クエリエディタが自動補完機能、メトリクス名、変数の提案、ビジュアルクエリ構築インターフェイスを提供する場合があります。

クエリや構文に関する情報など、特定のデータソースの一意のクエリエディタ機能の詳細については、以下のデータソースドキュメントを参照してください。
+ Amazon Managed Grafana に含まれるデータソースについては、[「組み込みデータソース」](AMG-data-sources-builtin.md)を参照してください。
+ Grafana Enterprise に含まれるデータソースについては、「[Enterprise データソースに接続する](AMG-data-sources-enterprise.md)」を参照してください。
+ [プラグインカタログによるプラグインの検索](grafana-plugins.md#plugin-catalog) 経由でインストールする他のデータソースプラグインの場合、ドキュメントはプラグインカタログのリスト内でリンクされます。

**クエリ構文**

データソースは、異なるクエリ言語を使用してデータをリクエストします。特定のデータソースの一意のクエリ言語の詳細については、各ドキュメントを参照してください。

**[PostgreSQL の例]**:

```
SELECT hostname FROM host WHERE region IN($region)
```

**PromQL の例**:

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**[特別なデータソース]**

Grafana には、**[Grafana]**、**[混合]**、および **[ダッシュボード]** の 3 つの特別なデータソースも含まれています。詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

## クエリタブを操作する
<a name="v10-panels-query-xform-navigate"></a>

パネルの **[クエリ]** タブは、次の要素で構成されます。
+ **[データソースセレクタ]** – クエリが実行されるデータソースを選択します。
+ **[クエリオプション]** — 最大データ取得パラメータとクエリ実行時間間隔を設定します。
+ **[クエリインスペクターボタン]** — クエリインスペクターパネルを開き、クエリを表示および最適化できます。
+ **[クエリエディタリスト]** – 作成したクエリを一覧表示します。
+ **[式]** – 式ビルダーを使用してアラート式を作成します。式の詳細については、「[クエリ式の書き込み](v10-panels-query-xform-expressions.md)」を参照してください。

## クエリの追加
<a name="v10-panels-query-xform-add"></a>

クエリは、Grafana がダッシュボードパネルで視覚化するデータを返します。パネルを作成すると、Grafana は自動的にデフォルトのデータソースを選択します。

**クエリを追加するには**

1. クエリを追加するパネルを編集します。

1. **[クエリ]** タブを選択します。

1. **[データソース]** ドロップダウンメニューを選択し、データソースを選択します。

1. **[クエリオプション]** を選択して、必要なデータポイントの最大数を設定します。クエリオプションの詳細については、「[クエリオプション](#v10-panels-query-xform-options)」を参照してください。

1. クエリエディタを使用してクエリを書き込みます。

1. **[適用]** を選択します。

Grafana はデータソースにクエリを実行し、データを視覚化します。

## クエリの管理
<a name="v10-panels-query-xform-manage"></a>

Grafana は、クエリを折りたたみ可能なクエリ行に整理します。各クエリ行にはクエリエディタが含まれ、文字 (A、B、C など) で識別されます。

クエリを管理するには、クエリのコピー、クエリの非表示、クエリの削除、クエリの順序変更、クエリエディタのヘルプの切り替えを行うことができます。

## クエリオプション
<a name="v10-panels-query-xform-options"></a>

データソースセレクタの横にある **[クエリオプション]** を選択すると、選択したデータソースの設定が表示されます。ここで行った変更は、このパネルで行われたクエリにのみ影響します。

Grafana は、ダークグレーテキストで表示されるデフォルトを設定します。変更はホワイトテキストで表示されます。フィールドをデフォルト設定に戻すには、フィールドからホワイトテキストを削除します。

パネルデータソースのクエリオプションには以下が含まれます。
+ **[最大データポイント数]** – データソースがサポートしている場合、返される各系列の最大データポイント数を設定します。クエリが最大データポイント設定よりも多くのデータポイントを返す場合、データソースは、平均、最大、または別の関数でデータポイントを集約することで、返されるポイント数を減らします。

  ポイントの数を制限して、クエリのパフォーマンスを向上させたり、視覚化された行を平滑にしたりできます。デフォルト値はグラフの幅 (またはピクセル数) です。グラフパネルに表示されるスペースと同じ数のデータポイントしか視覚化できないためです。

  ストリーミングデータでは、Grafana はローリングバッファの最大データポイント値を使用します。ストリーミングはデータの継続的なフローであり、バッファリングはストリームをチャンクに分割します。
+ **[最小間隔]** – 自動計算された間隔の最小制限を設定します。これは通常、最小スクレイプ間隔です。データポイントを 15 秒ごとに保存する場合、それよりも間隔を短くしてもメリットはありません。また、スクレイプ間隔よりも低い最小値に設定して、粗く適切に機能するクエリを取得することもできます。
+ **[間隔]** – データポイントを時間別に集計またはグループ化するときに使用できる時間範囲を設定します。

  Grafana は、テンプレートクエリで変数として使用できる適切な間隔を自動的に計算します。変数は、秒 (`$__interval`) またはミリ秒 (`$__interval_ms`) で測定されます。

  間隔は通常、合計や平均などの集計関数で使用されます。例えば、これは間隔変数 `rate(http_requests_total[$__interval])` を使用する Prometheus クエリです。

  この自動間隔は、グラフの幅に基づいて計算されます。ユーザーがグラフを縮小すると、間隔が大きくなり、より粗視化された集計になります。同様に、ユーザーが拡大すると、間隔が短くなり、より高精細な集計になります。

  詳細については、「[グローバル変数](v10-dash-variable-add.md#v10-dash-variable-add-global)」を参照してください。
+ **[相対時間]** – 個々のパネルの相対時間範囲をオーバーライドします。これにより、パネルは、ダッシュボードの右上隅にあるダッシュボードタイムピッカーで選択されている時間とは異なります。これを使用して、同じダッシュボードに異なる期間または日数のメトリクスを表示できます。
**注記**  
ダッシュボードの時間範囲が絶対時間である場合、パネルの時間オーバーライドは効果がありません。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v10-panels-query-xform.html)
+ **[タイムシフト]** – タイムピッカーに対して開始と終了をシフトすることで、個々のパネルの時間範囲をオーバーライドします。例えば、パネルの時間範囲をダッシュボードのタイムピッカーより 2 時間早くシフトできます。
**注記**  
ダッシュボードの時間範囲が絶対時間である場合、パネルの時間オーバーライドは効果がありません。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v10-panels-query-xform.html)
+ **[キャッシュタイムアウト]** – *(データソースで使用可能な場合のみ表示)* 時系列ストアにクエリキャッシュがある場合、デフォルトのキャッシュタイムアウトをオーバーライドします。この値を秒単位で数値として指定します。

# クエリ式の書き込み
<a name="v10-panels-query-xform-expressions"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

サーバー側の式を使用すると、演算やその他のオペレーションでクエリから返されるデータを操作できます。式は新しいデータを作成し、データソースから返されるデータを操作しません。

## 式について
<a name="v10-panels-query-about"></a>

サーバー側の式を使用すると、演算やその他のオペレーションでクエリから返されるデータを操作できます。式は新しいデータを作成し、式のデータを許容できる入力にするためにマイナーなデータ再構築を行う以外は、データソースから返されるデータを操作しません。

**式の使用**

式は、[Grafana アラート](v10-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": "MIA", "Host": "A"}` の値は 1 です。


| Loc | ホスト | Avg\$1CPU | 
| --- | --- | --- | 
| MIA | A | 1 | 
| NYC | B | 2 | 

**オペレーション**

式には 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` 演算を使用してタイムスタンプを並べることができます。

まとめ
+ Number <Operation> number = 数値
+ Number <Operation> series = 系列
+ Series <Operation> series = 系列

式は 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="v10-panels-query-write"></a>

データソースがサポートしている場合、Grafana は **[式]** ボタンを表示し、クエリエディタリストに既存の式を表示します。

**式を記述するには**

1. パネルを開きます。

1. クエリの下で、**[式]** を選択します。

1. **[演算]** フィールドで、書き込む式のタイプを選択します。

1. 式を書き込みます。

1. **[適用]** を選択します。

## 特殊なケース
<a name="v10-panels-query-special"></a>

クエリされたデータソースが系列や数値を返さない場合、式エンジンは `NoData` を返します。例えば、式によってマージされた 2 つのデータソースクエリがリクエストに含まれている場合、`NoData` が少なくとも 1 つのデータソースクエリによって返された場合、クエリ全体で返される結果は `NoData` になります。Grafana アラートが `NoData` 結果を処理する方法の詳細については、「[Grafana マネージドアラートルールを設定する](v10-alerting-configure-grafanamanaged.md)」を参照してください。

複数のクエリで式を使用する場合、式エンジンはすべてのクエリが同一のタイムスタンプを返す必要があります。例えば、演算を使用して、それぞれが `SELECT NOW() AS "time"` を使用する複数の SQL クエリの結果を組み合わせる場合、式はすべてのクエリが `NOW()` を同一のタイムスタンプとして評価する場合にのみ機能します。これは必ずしも発生するわけではありません。これを解決するには、`NOW()` を `SELECT 1 AS "time"` などの任意の時刻、またはその他の有効な UNIX タイムスタンプに置き換えることができます。

# 別のパネルとクエリ結果を共有する
<a name="v10-panels-query-share"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana では、ダッシュボード内にある他の任意のパネルに対して、1 つのパネルからのクエリ結果を使用できます。パネル間でクエリ結果を共有すると、データソースに対して実行されるクエリの数が減少し、ダッシュボードのパフォーマンスが向上します。

*ダッシュボード*のデータソースを使用すると、結果を共有するクエリを含むダッシュボード内のパネルを選択できます。パネルごとに個別のクエリを送信する代わりに、Grafana は 1 つのクエリを送信し、他のパネルはクエリ結果を使用して視覚化を構築します。

この戦略は、例えば、同じデータを視覚化する複数のパネルがある場合に実行されるクエリの数を大幅に減らすことができます。

**クエリ結果を共有するには**

1. [ダッシュボードを作成](v10-dash-creating.md)します。

1. タイトルを「`Source panel`」に変更します。このパネルを他のパネルのソースとして使用します。

1. 共有するクエリを (複数) 定義します。

   利用可能なデータソースがない場合は、**Grafana** データソースを使用します。このデータソースは、テストに使用できるランダムな時系列を返します。

1. 2 番目のパネルを追加し、クエリエディタで **[ダッシュボード]** データソースを選択します。

1. **[パネルリストから結果を使用する]** で、最初に作成したパネルを選択します。

ソースパネルで定義されたすべてのクエリが新しいパネルで使用できるようになりました。ソースパネルで行われたクエリは、複数のパネルと共有できます。

任意のクエリをクリックして、そのクエリが定義されたパネルに移動できます。

# [データを変換する]
<a name="v10-panels-xform"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

変換は、システムが視覚化を適用する前に、クエリによって返されるデータを操作できる強力な方法です。変換を使用すると、次のことができます。
+ フィールド名の変更
+ 時系列データの結合
+ クエリ間で数学演算の実行
+ ある変換の出力を別の変換への入力として使用

同じデータセットの複数のビューに依存するユーザーにとって、変換は多数のダッシュボードを作成および維持する効率的な方法を提供します。

また、ある変換の出力を別の変換への入力として使用して、パフォーマンスを向上させることもできます。

**注記**  
システムが変換されたデータをグラフ化できない場合があります。その場合は、視覚化の上にある **[テーブルビュー]** のトグルをクリックして、データのテーブルビューに切り替えます。これは、変換の最終結果を理解するのに役立ちます。

## 変換タイプ
<a name="v10-panels-xform-types"></a>

Grafana には、データを変換するさまざまな方法があります。変換関数の完全なリストを以下に示します。

## 変換の順序
<a name="v10-panels-xform-order"></a>

複数の変換がある場合、Grafana はリスト順で変換を適用します。各変換では、処理中のパイプラインにある次の変換に渡される新しい結果セットが作成されます。

Grafana が変換を適用する順序は、結果に直接影響します。例えば、縮小変換を使用して 1 つの列のすべての結果を 1 つの値に集約する場合、変換はその 1 つの値にのみ適用できます。

## 変換関数をデータに追加する
<a name="v10-panels-xform-add"></a>

次の手順は、データに変換を追加する方法を示しています。このドキュメントには、変換のタイプごとの手順は含まれていません。

**パネルに変換を追加するには**

1. 1 つ以上の変換を追加するパネルに移動します。

1. パネルのいずれかの部分にカーソルを合わせると、右上隅にアクションメニューが表示されます。

1. アクションメニューで、**[編集]** を選択します。

1. **[変換]** タブを選択します。

1. 変換を選択します。変換オプションを設定する変換行が表示されます。

1. **[変換ルールの追加]** を選択すると、別の変換ルールを追加できます。この変換は、前の変換が返した結果セットに作用します。

## 変換をデバッグする
<a name="v10-panels-xform-debug"></a>

変換の入力と出力の結果セットを表示するには、変換行の右側にあるデバッグ (バグ) アイコンを選択します。これにより、入力データと変換の結果が出力として表示されます。

入出力の結果セットにより、変換のデバッグが可能になります。

## 変換を無効にする
<a name="v10-panels-xform-disable"></a>

変換行の右上にある表示 (目) アイコンを選択すると、変換を無効化または非表示にできます。これにより、その特定の変換に適用されたアクションが無効になり、複数の変換を次々に変更するときに問題を特定するのに役立ちます。

## 変換をフィルタリングする
<a name="v10-panels-xform-filter"></a>

変換で複数のクエリを使用している場合、これらをフィルタリングし、選択した変換を 1 つのクエリにのみ適用できます。これを行うには、変換行の右上にあるフィルターアイコンを選択します。これにより、パネルで使用されるクエリのリストを含むドロップダウンが開きます。ここから、変換するクエリを選択できます。

(例を含む) 注釈でフィルタリングして、変換を適用することもできます。これを行うと、フィールドのリストが変更され、注釈または例のツールチップに反映されます。

フィルターアイコンは、パネルに複数のクエリまたはデータソース (パネルまたは注釈データ) がある場合に常に表示されますが、クエリの出力をマージするための以前の変換が適用されている場合には機能しない場合があります。これは、1 つの変換が前の変換の出力を取得するためです。

## 変換を削除する
<a name="v10-panels-xform-delete"></a>

不要な変換を削除することをお勧めします。変換を削除すると、視覚化からデータが削除されます。

前提条件:

変換に依存するすべてのダッシュボードを特定し、影響を受けるダッシュボードのユーザーに通知します。

**変換を削除するには**

1. パネルを開いて編集します。

1. **[変換]** タブを選択します。

1. 削除する変換の横にあるごみ箱アイコンを選択します。

# 変換関数
<a name="v10-panels-xform-functions"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

データに関する次の変換を実行できます。

## 計算からのフィールドの追加
<a name="v10-panels-xform-funcs-add"></a>

この変換を使用して、他の 2 つのフィールドから計算した新しいフィールドを追加します。各変換では 1 つの新しいフィールドを追加できます。
+ **[モード]** – 以下のモードを選択します。
  + **[行を減らす]** – 選択したフィールドの各行に、選択済みの計算を個別に適用します。
  + **[二項演算]** – 選択した 2 つのフィールドから 1 行の値に基本的な二項演算 (合計や乗算など) を適用します。
  + **[単項演算]** – 選択したフィールドの 1 行の値に基本的な単項演算を適用します。使用できるオプションは、以下のとおりです。
    + **[絶対値 (abs)]** － 指定された式の絶対値を返します。これは、ゼロからの距離を正の数として表します。
    + **[Natural exponential (exp)]** (自然指数) - 特定の式の冪 *e* を返します。
    + **[Natural logarithm (ln)]** (自然対数) － 指定された式の自然対数を返します。
    + **[Floor (floor)]** (床関数) – 特定の式以下の最大整数を返します。
    + **[Ceiling (ceil)]** (天井関数) - 指定された式以上の最小整数を返します。
  + **[累積関数]** – 現在の行とそれ以前のすべての行に関数を適用します。
    + **[Total]** – 現在の行までの累積合計を計算します。
    + **[Mean]** – 現在の行までの平均を計算します。
  + **[ウィンドウ関数]** – ウィンドウ関数を適用します。ウィンドウは、*[trailing]* (末尾) または *[centered]* (中央) のいずれかになります。末尾のウィンドウでは、現在の行がウィンドウの最後の行になります。中央のウィンドウでは、ウィンドウは現在の行を中心とします。均等なウィンドウサイズの場合、ウィンドウは現在の行と前の行の中心になります。
    + **[Mean]** - 移動平均または実行平均を計算します。
    + **** – 移動標準偏差を計算します。
    + **[Variance]** – 移動分散を計算します。
  + **[行インデックス]** – 行インデックスを含むフィールドを挿入します。
+ **[Field name]** – 新しいフィールドの計算に使用する、フィールドの名前を選択します。
+ **[計算]** – **[掃き出し法]** を選択すると、**[計算]** フィールドが表示されます。フィールドを選択すると、新しいフィールドの作成に使用できる計算の選択肢が一覧で表示されます。使用可能な計算の詳細については、「[計算タイプ](v10-panels-calculation-types.md)」を参照してください。
+ **[演算]** – **[二項演算]** または **[単項演算]** モードを選択すると、**[演算]** フィールドが表示されます。これらのフィールドを使用すると、2 つの選択したフィールドから 1 行の値に対して基本的な数学演算を実行できます。二項演算に数値を使用することもできます。
+ **[As percentile]** – **[行インデックス]** モードを選択すると、**パーセンタイルとして**スイッチが表示されます。このスイッチを使用すると、行インデックスを行の合計数に対する割合で変換できます。
+ **[エイリアス]** – (オプション) 新しいフィールドの名前を入力します。このフィールドを空白のままにすると、計算に一致するようにフィールドの名前が付けられます。
+ **[すべてのフィールドを置き換え]** – (オプション) 他のすべてのフィールドを非表示にし、計算したフィールドのみを視覚化に表示する場合は、このオプションを選択します。

**注記**  
**[累積関数]**と**[ウィンドウ関数]**は、パブリックプレビューでは最新です。Grafana Labs ではサポートが限られており、この機能が一般公開される前に重要な変更が発生する可能性があります。

## 連結フィールド
<a name="v10-panels-xform-funcs-concat"></a>

**[連結フィールド]**

この変換を使用して、全フレームの全フィールドを 1 つの結果に結合します。

例えば、温度とアップタイムデータ (クエリ A) と空気品質インデックスとエラー情報 (クエリ b) を取得する個別のクエリがある場合、連結変換を適用すると、すべての関連情報が 1 つのビューに統合されたデータフレームが生成されます。

次の 2 つについて考えてみましょう。

*クエリ A*


| 温度 | アップタイム | 
| --- | --- | 
| 15.4 | 1230233 | 

*クエリ B*


| AQI | エラー | 
| --- | --- | 
| 3.2 | 5 | 

フィールドを連結すると、データフレームは次のようになります。


| 温度 | アップタイム | AQI | エラー | 
| --- | --- | --- | --- | 
| 15.4 | 1230233 | 3.2 | 5 | 

この変換により、さまざまなソースからのデータをマージするプロセスが簡素化され、分析と視覚化の包括的なビューが提供されます。

## クエリ結果から設定
<a name="v10-panels-xform-funcs-config"></a>

**[クエリ結果から設定]**

この変換を使用して、1 つのクエリを選択し、**[最小]** 、**[最大]** 、**[単位]**、**[しきい値]**などの標準オプションを抽出し、他のクエリ結果に適用します。これにより、特定のクエリによって返されるデータに基づいて、動的な視覚化設定が可能になります。

**オプション**
+ **[Config query]** (設定クエリ) – 設定として使用するデータを返すクエリを選択します。
+ **[適用先]** – 設定を適用するフィールドまたは系列を選択します。
+ **[オプションに適用]** – フィールドタイプを指定するか、**[適用先]** の選択に応じてフィールド名の正規表現を使用します。

**フィールドマッピングテーブル**

設定オプションの下に、フィールドマッピングテーブルがあります。このテーブルには、設定クエリによって返されるデータに含まれるすべてのフィールドと、**[用途]** および **[選択]** オプションが一覧表示されます。設定プロパティへのマッピングフィールドを制御でき、複数の行に対して選択する値を選べます。

次の例は、入力クエリとフィールド設定として使用されるクエリを示しています。

*入力クエリ*


| Time | 値 | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

*設定クエリ*


| Time | 値 | 
| --- | --- | 
| 1626178119127 | 100 | 
| 1626178119129 | 100 | 

*出力クエリ (入力と同じですが、値フィールドに 設定が追加されました)*


| Time | 値 (設定: Max=100) | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

各フィールドで最大設定オプションが設定されるようになりました。**[最小値]**、**[最大値]**、**[単位]**、**[しきい値]** などのオプションは、フィールド設定の一部です。設定すると、パネルエディタのオプションペインで手動で設定されたオプションではなく、視覚化によって使用されます。

**[値のマッピング]**

クエリ結果を値のマッピングに変換することもできます。このオプションでは、設定クエリ結果のすべての行で 1 つの値のマッピング行を定義します。次の例を参照してください。

*設定クエリ結果*


| 値 | テキスト | 色 | 
| --- | --- | --- | 
| L | 低 | 青 | 
| M | 中 | 緑色 | 
| H | 高 | 赤 | 

*フィールドマッピングで、以下を指定します。*


| フィールド | Use as | Select | 
| --- | --- | --- | 
| 値 | 値マッピング / Value | [すべての値] | 
| テキスト | 値マッピング / Text | [すべての値] | 
| 色 | 値マッピング / Color | [すべての値] | 

Grafana はクエリ結果から値マッピングを構築し、実際のデータクエリ結果に適用します。設定クエリの結果に従って、値がマッピングされ、色付けされているはずです。

## フィールドタイプの変換
<a name="v10-panels-xform-funcs-convert"></a>

この変換を使用して、指定されたフィールドのフィールドタイプを変更します。

この変換には、次のオプションがあります。
+ **[Field]** – 使用可能なフィールドから選択します。
+ **[as]** – 変換するフィールドタイプを選択します。
  + **[Numeric]** – 値の数値の作成を試みます。
  + **[String]** – 値の文字列を作成します。
  + **[時間]** – 値を時間として解析しようとします。
    + DateFormat を `yyyy-mm-dd` や `DD MM YYYY hh:mm:ss` などの文字列の入力として指定するオプションを表示します。
  + **[Boolean]** – 値はブール値になります。
  + **[Enum]** – 値は列挙型になります。
    + 列挙を管理するテーブルを表示します。
  + **[Other]** – 値を json として解析しようとします。

例えば、時間フィールドを **[時間]** として、日付形式を `YYYY` として選択することで変更できる次のクエリを考えてみましょう。


| Time | Mark | 値 | 
| --- | --- | --- | 
| 2017-07-01 | above | 25 | 
| 2018-08-02 | below | 22 | 
| 2019-09-02 | below | 29 | 
| 2020-10-04 | above | 22 | 

結果


| Time | Mark | 値 | 
| --- | --- | --- | 
| 2017-01-01 00:00:00 | above | 25 | 
| 2018-01-01 00:00:00 | below | 22 | 
| 2019-01-01 00:00:00 | below | 29 | 
| 2020-01-01 00:00:00 | above | 22 | 

この変換により、データタイプを柔軟に適応させ、視覚化の互換性と一貫性を確保できます。

## Extract Fields (フィールドの抽出)
<a name="v10-panels-xform-funcs-extract"></a>

この変換を使用して、データソースを選択し、さまざまな形式でそこからコンテンツを抽出します。この変換には次のフィールドがあります。
+ **[ソース]** – データソースのフィールドを選択します。
+ **[形式]** – 次のいずれかを選択します。
  + **[JSON]** – ソースから JSON コンテンツを解析します。
  + **[キーと値のペア]** – ソースからの形式 `a=b` または `c:d` にあるコンテンツを解析します。
  + **[自動]** – フィールドを自動的に検出します。
+ **[すべてのフィールドを置き換え]** – (オプション) 他のすべてのフィールドを非表示にし、計算したフィールドのみを視覚化に表示する場合は、このオプションを選択します。
+ **[時間保持]** - (オプション) **[すべてのフィールドを置き換え]** が真の場合にのみ使用できます。出力の時間フィールドを保持します。

以下のデータセットを考えてみましょう。

**データセットの例**


| Timestamp | json\$1data | 
| --- | --- | 
| 1636678740000000000 | \$1"value": 1\$1 | 
| 1636678680000000000 | \$1"value": 5\$1 | 
| 1636678620000000000 | \$1"value": 12\$1 | 

この設定を使用して、[時系列パネル](v10-panels-time-series.md)で使用されるデータを準備できます。
+ Source: json\$1data
+ 形式: JSON
  + Field: value
  + Alias: my\$1value
+ すべてのフィールドを置き換え: 真
+ 時間保持: 真

これにより、次の出力が生成されます。

**[変換されたデータ]**


| Timestamp | my\$1value | 
| --- | --- | 
| 1636678740000000000 | 1 | 
| 1636678680000000000 | 5 | 
| 1636678620000000000 | 12 | 

この変換では、さまざまな方法でデータを抽出、フォーマットできます。特定のデータニーズに基づいて抽出形式をカスタマイズできます。

## リソースからフィールドを検索
<a name="v10-panels-xform-funcs-lookup"></a>

この変換を使用して、外部ソースから追加のフィールドを検索してフィールド値を充実させます。

この変換には次のフィールドがあります。
+ **[Field]** (フィールド) – データセットからテキストフィールドを選択します。
+ **[ルックアップ]** - **[Countries]** (国)、**[USA States]** (米国の州)、および **[Airports]** (空港) から選択します。

**注記**  
この変換は空間データのみをサポートします。

例えば、以下のデータがある場合を考えてみましょう。

**データセットの例**


| ロケーション | 値 | 
| --- | --- | 
| AL | 0 | 
| AK | 10 | 
| Arizona | 5 | 
| Arkansas | 1 | 
| Somewhere | 5 | 

この設定では、次のようになります。
+ Field: location
+ Lookup: USA States

この場合、次の出力が返されます。

**[変換されたデータ]**


| ロケーション | ID | 名前 | Lng | Lat | 値 | 
| --- | --- | --- | --- | --- | --- | 
| AL | AL | Alabama | -80.891064 | 12.448457 | 0 | 
| AK | AK | Arkansas | -100.891064 | 24.448457 | 10 | 
| Arizona |  |  |  |  | 5 | 
| Arkansas |  |  |  |  | 1 | 
| Somewhere |  |  |  |  | 5 | 

この変換により、外部ソースから追加情報を取得してデータを拡張し、分析と視覚化のためのより包括的なデータセットを提供できます。

## クエリ refId によるデータのフィルタリング
<a name="v10-panels-xform-funcs-queryrefid"></a>

この変換を使用して、複数のクエリがあるパネル内の 1 つ以上のクエリを非表示にします。

Grafana では、クエリ識別文字がダークグレーテキストで表示されます。フィルタリングを切り替えるには、クエリ識別子を選択します。クエリ文字が白い場合、結果が表示されます。クエリ文字が暗い場合、結果は非表示です。

**注記**  
この変換は Graphite では使用できません。このデータソースは、返されたデータとクエリの相関関係をサポートしていないためです。

## 値によるデータのフィルタリング
<a name="v10-panels-xform-funcs-values"></a>

この変換を使用して、視覚化内で直接データポイントを選択的にフィルタリングします。この変換では、選択したフィールドに適用された 1 つ以上の条件に基づいて、データを含める、または除外するためのオプションを提供します。

この変換は、データソースが値によってネイティブにフィルタリングしない場合に非常に便利です。共有クエリを使用している場合、これを使用して値を絞り込んで表示することもできます。

すべてのフィールドで使用できる条件は次のとおりです。
+ **[Regex]** – 正規表現を照合します。
+ **[Is Null]** – 値が null の場合に照合。
+ ** [Is Not Null]** – 値が null でない場合に照合します。
+ **Equal** – 値が指定値と等しい場合に照合します。
+ **Different** – 値が指定された値と異なる場合に照合します。

数値フィールドで使用可能なその他の条件は次のとおりです。
+ **Greater** – 値が指定値より大きい場合に照合します。
+ **Lower** – 値が指定値よりも小さい場合に照合します。
+ **Greater or equal** – 値が指定値以上の場合に照合します。
+ **Lower or equal** – 値が指定値以下の場合に照合します。
+ **Range** – 指定された最小値と最大値 (最小値と最大値を含む) 間の範囲を照合します。

以下のデータセットを考えてみましょう。


| Time | 温度 | 高度 | 
| --- | --- | --- | 
| 2020-07-07 11:34:23 | 32 | 101 | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:32:24 | 31 | 95 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

温度が 30°C 未満のデータポイントを **[含める]** にすると、設定は次のようになります。
+ フィルタータイプ: [含める]
+ Condition:「温度」が [Lower Than] (未満)、「30」と一致する行

30°C 未満の温度のみが含まれる場合、次の結果が得られます。

**[変換されたデータ]**


| Time | 温度 | 高度 | 
| --- | --- | --- | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

複数の条件をフィルターに追加できます。例えば、高度が 100 を超える場合にのみデータを含めることができます。これを行うには、次の設定にその条件を追加します。
+ フィルタータイプ: 条件に [すべて一致] する [含める] 行
+ Condition 1:「温度」が [Lower Than] (未満)、「30」と一致する行
+ Condition 2:「高度」が [Greater] (超え)、「100」と一致する行

複数の条件がある場合、条件に**すべて一致**、または追加した条件の**いずれかに一致**する行にアクション (包含/除外) を適用するかを選択できます。

上記の例では、温度が 30°C 未満*かつ*高度が 100 を超える行を含めるため、**[すべて一致]** を選択しました。温度が 30°C 未満*または*高度が 100 を超える行を含める場合は、**[任意の一致]** を選択します。これには、元のデータの最初の行が含まれます。元のデータの温度は 32°C (最初の条件と一致しない) ですが、高度は 101 (2 番目の条件と一致する) であるため、含まれます。

無効または不完全な設定条件は無視されます。

この汎用的なデータフィルタリング変換により、特定の条件に基づいてデータポイントを選択的に含めたり除外したりできます。条件をカスタマイズしてデータプレゼンテーションを調整し、独自の分析ニーズを満たすことが可能です。

## Filter fields by name (名前によるフィールドのフィルタリング)
<a name="v10-panels-xform-funcs-name"></a>

この変換を使用して、クエリ結果の一部を削除します。フィールド名をフィルタリングする方法は 3 つあります。
+ 正規表現を入力します。
+ 含まれるフィールドを手動で選択します。
+ ダッシュボード変数を使用します。

*正規表現を使用*

正規表現を使用してフィルタリングすると、正規表現に一致するフィールド名が含まれます。例えば、正規表現 `'prod.*'` を使用すると、`prod` で始まるフィールドのみが返されます。

正規表現には、`${variableName}` 構文を使用して補間されたダッシュボード変数を含めることができます。

*含まれるフィールドを手動で選択*

フィールド名を選択または選択解除して、結果から削除します。正規表現も含まれている場合、チェックが入っていない場合でも、式に一致するフィールドが含まれます。

*ダッシュボード変数を使用*

**[変数から]** を選択すると、フィールドを含めるために使用されるダッシュボード変数を選択できます。複数の選択肢を持つダッシュボード変数を設定することで、同じフィールドを複数の視覚化にわたって表示できます。

この変換により、効果的な分析と視覚化に必要な特定のフィールドに焦点を当てて、クエリ結果を柔軟に調整できます。

## 文字列の形式を設定する
<a name="v10-panels-xform-funcs-string"></a>

この変換を使用して、文字列フィールドの出力をカスタマイズします。この変換には次のフィールドがあります。
+ **大文字** – 文字列全体を大文字形式にします。
+ **小文字** – 文字列全体を小文字形式にします。
+ **センテンスケース** – 文字列の最初の文字を大文字の形式にします。
+ **タイトルケース** – 文字列内の各単語の最初の文字を大文字の形式にします。
+ **パスカルケース** – 文字列内の各単語の最初の文字を大文字の形式にし、単語間のスペースは含まれません。
+ **キャメルケース** – 最初の単語を除き、文字列内の各単語の最初の文字を大文字の形式にし、単語間のスペースは含まれません。
+ **スネークケース** – 文字列内のすべての文字を小文字の形式にし、単語間のスペースの代わりにアンダースコアを使用します。
+ **ケバブケース** – 文字列内のすべての文字を小文字の形式にし、単語間のスペースの代わりにダッシュを使用します。
+ **Trim** – 文字列から先頭と末尾のすべてのスペースを削除します。
+ **文字列の単位** – 指定された開始位置と終了位置を使用して、文字列のサブ文字列を返します。

この変換により、視覚化と分析を向上させるために文字列データのプレゼンテーションを標準化して調整する便利な方法が提供されます。

**注記**  
この変換は現在パブリックプレビュー中です。Grafana Labs ではサポートが限られており、この機能が一般公開される前に重要な変更が発生する可能性があります。

## 時間形式
<a name="v10-panels-xform-funcs-time"></a>

この変換を使用して、時間フィールドの出力をカスタマイズします。出力は、[Moment.js 形式の文字列](https://momentjs.com/docs/#/displaying/)を使用してフォーマットできます。例えば、時間フィールドの年のみを表示する場合は、形式文字列「YYYY」を使用して暦年 (1999 年や 2012 年など) を表示できます。

**[変換前]**


| タイムスタンプ | イベント | 
| --- | --- | 
| 1636678740000000000 | システムスタート | 
| 1636678680000000000 | ユーザーログイン | 
| 1636678620000000000 | データ更新 | 

**「YYYY-MM-DD HH:mm:ss」を適用した後**


| タイムスタンプ | イベント | 
| --- | --- | 
| 2021-11-12 14:25:40 | システムスタート | 
| 2021-11-12 14:24:40 | ユーザーログイン | 
| 2021-11-12 14:23:40 | データ更新 | 

この変換により、視覚化の時間表現を調整し、時間データを表示する柔軟性と精度を提供できます。

**注記**  
この変換は、アルファ機能として Grafana v10 と互換性のあるワークスペースで使用できます。

## グループ化の条件
<a name="v10-panels-xform-funcs-group"></a>

この変換では、指定されたフィールド (列) 値でデータをグループ化し、各グループの計算を処理します。計算選択肢のリストの表示を選択します。

オリジナルデータの例を次に示します。


| 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 | 

この変換により、時系列からキー情報を抽出して便利な方法で表示できます。

## Grouping to matrix (マトリックスへのグループ化)
<a name="v10-panels-xform-funcs-groupmatrix"></a>

この変換を使用して、クエリ出力の **[列]**、**[行]**、**[セル値]** フィールドの入力として使用される 3 つのフィールドを組み合わせて、マトリックスを生成します。以下のようにマトリックスが計算されます。

**元のデータ**


| サーバー ID | CPU 温度 | サーバーステータス | 
| --- | --- | --- | 
| サーバー 1 | 82 | OK | 
| サーバー 2 | 88.6 | OK | 
| サーバー 3 | 59.6 | シャットダウン | 

列名として `Server Status` の値、行名として `Server ID` の値、各セルの内容として `CPU Temperature` の値を使用して、マトリックスを生成できます。既存の列 (`Server Status`) と行の組み合わせ (`Server ID`) には、各セルの内容が表示されます。残りのセルでは、**[Null]**、**[真]**、**[偽]** 、または **[空]** のどの値を表示するかを選択できます。

**出力**


| サーバー ID サーバーステータス | OK | シャットダウン | 
| --- | --- | --- | 
| サーバー 1 | 82 |  | 
| サーバー 2 | 88.6 |  | 
| サーバー 3 |  | 59.6 | 

この変換を使用して、クエリ結果からフィールドを指定してマトリックスを作成します。マトリックスの出力には、これらのフィールドの一意の値間の関係が反映されます。これにより、複雑な関係を明確で構造化されたマトリックス形式で提示できます。

## Group to nested table (ネストされたテーブルにグループ化)
<a name="v10-panels-xform-funcs-grouptable"></a>

この変換を使用して、指定されたフィールド (列) 値でデータをグループ化し、各グループの計算を処理します。同じグループ化されたフィールド値を共有するレコードが生成され、ネストされたテーブルに表示されます。

フィールドの統計を計算するには、フィールドの横にあるボックスを選択し、**[計算]**オプションを選択します。これにより、統計を選択する別の選択ボックスが追加されます。

次の表にサンプルデータを示します。


| 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 つ以上指定します。これにより、これらのフィールドの同じ値がすべて、ソートされたかのようにグループ化されます。例えば、`Server ID` フィールドでグループ化した場合、Grafana は次のようにデータをグループ化します。


| サーバー ID | データ | 
| --- | --- | 
| Time | CPU 温度 | サーバーステータス | 
| --- | --- | --- | 
| Time | CPU 温度 | サーバーステータス | 
| --- | --- | --- | 
| Time | CPU 温度 | サーバーステータス | 
| --- | --- | --- | 
| サーバー 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| サーバー 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| サーバー 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 7/7/2020 午前 11 時 34 分 20 秒 | 80 | シャットダウン | 
| 7/7/2020 午前 9 時 28 分 6 秒 | 80 | OK | 
| 7/7/2020 午前 9:23:07 | 86 | OK | 
| 7/7/2020 午前 10 時 32 分 20 秒 | 90 | オーバーロード | 
| 7/7/2020 午前 9 時 30 分 5 秒 | 88 | OK | 
| 7/7/2020 午前 9 時 25 分 5 秒 | 88 | OK | 
| 7/7/2020 午前 11 時 34 分 20 秒 | 62 | OK | 
| 7/7/2020 午前 10 時 31 分 22 秒 | 55 | OK | 
| 7/7/2020 午前 9 時 30 分 57 秒 | 62 | 再起動 | 

データをグループ化するフィールドを選択すると、他のフィールドにさまざまな計算を追加でき、その計算を行の各グループに適用できます。例えば、これらの各サーバーの平均 CPU 温度を計算できます。これを行うには、CPU 温度フィールドに適用された平均計算を追加して、次の結果を取得します。


| サーバー ID | CPU 温度 (平均) |  | 
| --- | --- | --- | 
| Time | サーバーステータス | 
| --- | --- | 
| Time | サーバーステータス | 
| --- | --- | 
| Time | サーバーステータス | 
| --- | --- | 
| サーバー 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| サーバー 2 | 88.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| サーバー 3 | 59.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 7/7/2020 午前 11 時 34 分 20 秒 | シャットダウン | 
| 7/7/2020 午前 9:28:06 | OK | 
| 7/7/2020 午前 9:23:07 | OK | 
| 7/7/2020 午前 10 時 32 分 20 秒 | オーバーロード | 
| 7/7/2020 午前 9 時 30 分 5 秒 | OK | 
| 7/7/2020 午前 9:25:05 | OK | 
| 7/7/2020 午前 11 時 34 分 20 秒 | OK | 
| 7/7/2020 午前 10 時 31 分 22 秒 | OK | 
| 7/7/2020 午前 9 時 30 分 57 秒 | 再起動 | 

## Create heatmap (ヒートマップの作成)
<a name="v10-panels-xform-funcs-heatmap"></a>

この変換を使用して、経時的な傾向を視覚化するためのヒストグラムデータを作成します。ヒートマップ視覚化と同様に、この変換はヒストグラムメトリクスを時間バケットに変換します。

**X バケット**

この設定は、X 軸をバケットに分割する方法を決定します。
+ **[サイズ]** – 入力フィールドに時間間隔を指定します。例えば、`1h` の時間範囲により、x 軸に 1 時間幅のセルが作成されます。
+ **[Count]** – 時間関連以外の系列の場合、このオプションを使用してバケット内の要素の数を定義します。

**Y バケット**

この設定は、Y 軸をバケットに分割する方法を決定します。
+ **[線形]**
+ **[対数]** – 底が 2 のログまたは底が 10 のログから選択します。
+ **[Symlog]** – 正負対象の対数目盛を使用します。負の値を許可して、底が 2 のログまたは底が 10 のログから選択します。

次のデータセットがあるとします。


| タイムスタンプ | 値 | 
| --- | --- | 
| 2023-01-01 12:00:00 | 5 | 
| 2023-01-01 12:15:00 | 10 | 
| 2023-01-01 12:30:00 | 15 | 
| 2023-01-01 12:45:00 | 8 | 
+ X バケットを `Size: 15m` に設定し、Y バケットを `Linear` に設定すると、ヒストグラムは値を X 軸で 15 分間隔、Y 軸で線形に編成します。
+ X バケットを `Count: 2`、Y バケットを `Logarithmic (base 10)` とすると、ヒストグラムは X 軸の 2 つのバケットに値をグループ化し、Y 軸の対数スケールを使用します。

## ヒストグラム
<a name="v10-panels-xform-funcs-histogram"></a>

この変換を使用して、入力データに基づいてヒストグラムを生成することで、値の分布を視覚化できます。
+ **[バケットサイズ]** – バケット内の最小項目と最大項目の範囲 (x最小 から x最大)。
+ **[バケットオフセット]** – ゼロベース以外のバケットのオフセット。
+ **[系列の結合]** – 使用可能なすべての系列を使用して統合されたヒストグラムを作成。

**元のデータ**

系列 1


| A | B | C | 
| --- | --- | --- | 
| 1 | 3 | 5 | 
| 2 | 4 | 6 | 
| 3 | 5 | 7 | 
| 4 | 6 | 8 | 
| 5 | 7 | 9 | 

系列 2


| C | 
| --- | 
| 5 | 
| 6 | 
| 7 | 
| 8 | 
| 9 | 

**出力**


| x最小 | x最大 | A | B | C | C | 
| --- | --- | --- | --- | --- | --- | 
| 1 | 2 | 1 | 0 | 0 | 0 | 
| 2 | 3 | 1 | 0 | 0 | 0 | 
| 3 | 4 | 1 | 1 | 0 | 0 | 
| 4 | 5 | 1 | 1 | 0 | 0 | 
| 5 | 6 | 1 | 1 | 1 | 1 | 
| 6 | 7 | 0 | 1 | 1 | 1 | 
| 7 | 8 | 0 | 1 | 1 | 1 | 
| 8 | 9 | 0 | 0 | 1 | 1 | 
| 9 | 10 | 0 | 0 | 1 | 1 | 

生成されたヒストグラムを使用して値の分布を視覚化し、データの広がりと密度に関するインサイトを提供します。

## Join by field (フィールドで結合)
<a name="v10-panels-xform-funcs-joinfield"></a>

この変換を使用して、複数の結果を 1 つのテーブルにマージすることで、異なるクエリからのデータを統合できます。

複数の時系列の結果を共有時間フィールドを持つ 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 | 

## Join by labels (ラベルで結合)
<a name="v10-panels-xform-funcs-joinlabel"></a>

この変換を使用して、複数の結果を 1 つのテーブルに結合します。

これは、複数の時系列の結果を共有**[ラベル]**フィールドを持つ単一のワイドテーブルに変換する場合に特に便利です。
+ **[Join]** (結合) – すべての時系列で使用可能なラベルまたは共通ラベル間で結合するラベルを選択します。
+ **[値]** – 出力結果の名前。

**例**

入力 1: `series1{what='Temp', cluster='A', job='J1'}`


| Time | 値 | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

入力 2: `series2{what='Temp', cluster='B', job='J1'}`


| Time | 値 | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

入力 3: `series3{what='Speed', cluster='B', job='J1'}`


| Time | 値 | 
| --- | --- | 
| 22 | 22 | 
| 28 | 77 | 

構成

```
value: 'what'
```

出力


| クラスター | ジョブ | 温度 | [Speed] (スピード) | 
| --- | --- | --- | --- | 
| A | J1 | 10 |  | 
| A | J1 | 200 |  | 
| B | J1 | 10 | 22 | 
| B | J1 | 200 | 77 | 

時系列データをこの変換と効果的に組み合わせて整理し、包括的なインサイトを提供します。

## フィールドへのラベル付け
<a name="v10-panels-xform-funcs-labelstofields"></a>

この変換を使用して、ラベルまたはタグを含む時系列の結果を、結果の各ラベルのキーと値を含むテーブルに変換します。ラベルを列または行の値として表示して、拡張データの視覚化を行います。

2 つの時系列のクエリ結果を示します。
+ 系列 1 – ラベル `Server=Server A`、 `Datacenter=EU`
+ 系列 2 – ラベル `Server=Server B`、 `Datacenter=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 – ラベル `Server=ServerA`
+ 系列 2 – ラベル `Datacenter=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 | 

## [制限]
<a name="v10-panels-xform-funcs-limit"></a>

この変換を使用して、表示される行数を制限し、データに対してより焦点を絞ったビューを提供します。これは、大規模なデータセットを処理する場合に特に便利です。

以下は、データソースからのレスポンスに対する**[制限]**変換の影響を示す例です。


| 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 | 

この変換により、データの視覚的な表示を調整して、最も関連性の高いデータに集中できます。

## Merge series/tables (系列/テーブルのマージ)
<a name="v10-panels-xform-funcs-merge"></a>

この変換を使用して、複数のクエリの結果を 1 つの結果に結合します。これは、テーブルパネルの視覚化を使用する場合に特に便利です。共有フィールドに同じデータが含まれている場合、変換は値を同じ行にマージします。

以下に、テーブルデータを返す 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 | 

この変換では、クエリ A とクエリ B の値を統一されたテーブルに結合し、より良いインサイトを得るためにプレゼンテーションを強化します。

## Organize fields by name (名前でフィールドを整理)
<a name="v10-panels-xform-funcs-organize"></a>

この変換を使用して、パネル内の 1 つのクエリによって返されるフィールドの名前を変更、並べ替え、または非表示にします。この変換は単一クエリを持つパネルでのみ機能します。パネルに複数のクエリがある場合は、*[外部結合]* 変換を適用するか、追加のクエリを削除する必要があります。

**[フィールドの変換]**

Grafana では、クエリが返すフィールドのリストが表示されます。以下の操作を実行できます。
+ **フィールドの順序の変更** – リスト内の新しい場所にフィールドをドラッグします。
+ **フィールドを非表示または表示** – フィールド名の横の目のアイコンを使用して、フィールドの表示を切り替えます。
+ **名前変更フィールド** – **名前変更**ボックスに新しい名前を入力します。

**例**

この最初のクエリ結果を考慮すると、次のようになります。


| Time | メトリクス | 値 | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 温度 | 25 | 
| 2020-07-07 11:34:20 | 湿度 | 22 | 
| 2020-07-07 10:32:20 | 湿度 | 29 | 

名前変更フィールドオーバーライドを適用して、以下を作成できます。


| Time | センサー | 読み取り | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 温度 | 25 | 
| 2020-07-07 11:34:20 | 湿度 | 22 | 
| 2020-07-07 10:32:20 | 湿度 | 29 | 

この変換により、クエリ結果の表示をカスタマイズし、Grafana 内のデータに対して明確で本質を突いた表現を確保できます。

## 値による分割
<a name="v10-panels-xform-funcs-partition"></a>

この変換を使用して、異なる `WHERE` 句を持つ複数のクエリを必要とせずに、複数の系列をグラフ化するプロセスを合理化します。

**注記**  
この関数は、Grafana バージョン 9 以降と互換性のあるワークスペースで使用できます。

これは、以下の例のように、メトリクス 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 | 

*[値による分割]*トランスフォーマーを使用すると、単一のクエリを発行し、選択した 1 つ以上の列 (フィールド) に対して一意の値で結果を分割できます。次の例では `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 | 

この変換により、プロセスが簡素化され、同じ時系列視覚化内で複数の系列を視覚化する柔軟性が向上します。

## Prepare times series (時系列の準備)
<a name="v10-panels-xform-funcs-preparetimeseries"></a>

この変換を使用して、データソースが目的の視覚化と互換性のない形式で時系列データを返す際の問題に対処します。この変換により、時系列データをワイド形式とロング形式との間で変換できます。

**[マルチフレーム時系列]**

このオプションを使用して、時系列データフレームをワイド形式からロング形式に変換します。これは、データソースが視覚化と最適な互換性を得るために再形成する必要がある形式で、時系列情報を配信する場合に特に役立ちます。

*例*

入力


| タイムスタンプ | 値 1 | 値 2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

次のように変換できます。


| タイムスタンプ | 変数 | 値 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 値 1 | 10 | 
| 2023-01-01 00:00:00 | 値 2 | 20 | 
| 2023-01-01 01:00:00 | 値 1 | 15 | 
| 2023-01-01 01:00:00 | 値 2 | 25 | 

**[ワイド時系列]**

このオプションを使用して、時系列データフレームをロング形式からワイド形式に変換します。これは、データソースが時系列データをロング形式で配信し、視覚化にワイド形式が必要な場合に特に役立ちます。

*例*

入力


| タイムスタンプ | 変数 | 値 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 値 1 | 10 | 
| 2023-01-01 00:00:00 | 値 2 | 20 | 
| 2023-01-01 01:00:00 | 値 1 | 15 | 
| 2023-01-01 01:00:00 | 値 2 | 25 | 

次のように変換できます。


| タイムスタンプ | 値 1 | 値 2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

## 削減
<a name="v10-panels-xform-funcs-reduce"></a>

この変換を使用すると、データフレームの各フィールドに計算が適用され、単一の値が返されます。この変換は、複数の時系列データをよりコンパクトで要約された形式に統合するために特に役立ちます。この変換を適用すると、時間フィールドは削除されます。

以下の入力を検討します。

クエリ A


| Time | Temp | アップタイム | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 12.3 | 256122 | 
| 2020-07-07 11:24:20 | 15.4 | 1230233 | 

クエリ B


| Time | AQI | エラー | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 6.5 | 15 | 
| 2020-07-07 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 | 

## [正規表現で名前を変更]
<a name="v10-panels-xform-funcs-rename"></a>

この変換を使用して、正規表現と置換パターンを使用してクエリ結果の一部の名前を変更します。

正規表現を指定できます。正規表現は、バックリファレンスをサポートする置換パターンとともに、一致にのみ適用されます。例えば、ホストあたりの CPU 使用率を視覚化し、ドメイン名を削除するとします。正規表現を `([^\.]+)\..+` に設定し、置換パターンを `$1` に設定することで、`web-01.example.com` は `web-01` になります。

この変換により、視覚化のニーズに合わせてデータをカスタマイズできるため、ダッシュボードはより有益でユーザーフレンドリーになります。

## Rows to fields (行からフィールドへ)
<a name="v10-panels-xform-funcs-row"></a>

この変換を使用して、行を別々のフィールドに変換します。これは、フィールドを個別にスタイル変更および設定できるため便利です。また、動的フィールド設定のソースとして追加のフィールドを使用したり、フィールドラベルにマッピングしたりすることもできます。その後、追加のラベルを使用して、結果フィールドにより適切な表示名を定義できます。

この変換には、設定クエリによって返されるデータ内のすべてのフィールドを一覧表示するフィールドテーブルが含まれます。このテーブルでは、各設定プロパティにマッピングするフィールドを制御できます (**[用途]** オプション)。返されるデータに複数の行がある場合、選択する値を選ぶこともできます。

この変換には以下が必要です。
+ フィールド名のソースとして使用する 1 つのフィールド。

  デフォルトでは、変換は最初の文字列フィールドをソースとして使用します。このデフォルト設定は、代わりに使用するフィールドの **[用途]** 列で **[フィールド名]** を選択してオーバーライドできます。
+ 値のソースとして使用する 1 つのフィールド。

  デフォルトでは、変換は最初の数値フィールドをソースとして使用します。ただし、このデフォルト設定は、代わりに使用するフィールドの **[用途]** 列で **[フィールド値]** を選択してオーバーライドできます。

以下にデータを視覚化する場合に役立ちます。
+ ゲージ
+ 統計
+ 円グラフ

**追加フィールドをラベルにマッピング**

フィールドが設定プロパティにマッピングされない場合、Grafana は出力フィールドのラベルのソースとして自動的に使用します。

例


| 名前 | データセンター | 値 | 
| --- | --- | --- | 
| サーバー A | 米国 | 100 | 
| サーバー B | EU | 200 | 

出力:


| サーバー A (ラベル: データセンター: US) | サーバー B (ラベル: データセンター: EU) | 
| --- | --- | 
| 100 | 200 | 

フィールド表示名で追加のラベルを使用して、より完全なフィールド名を提供できるようになりました。

あるクエリから設定を抽出して別のクエリに適用する場合は、*[クエリ結果から設定]* 変換を使用する必要があります。

**例**

入力


| 名前 | 値 | 最大 | 
| --- | --- | --- | 
| サーバー A | 10 | 100 | 
| サーバー B | 20 | 200 | 
| サーバー C | 30 | 300 | 

出力


| サーバー A (設定: 最大=100) | サーバー B (設定: 最大=200) | サーバー C (設定: 最大=300) | 
| --- | --- | --- | 
| 10 | 20 | 30 | 

ソースデータ内の各行が個別のフィールドになります。各フィールドには、最大設定オプションも設定されるようになりました。**[最小値]**、**[最大値]**、**[単位]**、**[しきい値]** などのオプションはすべてフィールド設定の一部であり、このような設定を行うと、パネルエディタのオプションペインで手動設定されるオプションではなく、視覚化によって使用されます。

この変換により、行を個々のフィールドに変換し、動的なフィールド設定を容易にし、追加のフィールドをラベルにマッピングできます。

## シリーズから行
<a name="v10-panels-xform-funcs-series"></a>

この変換を使用して、複数の時系列データクエリの結果を 1 つの結果にまとめます。これはテーブルパネルの視覚化を使用する場合に役立ちます。

この変換の結果には、時間、メトリクス、値の 3 つの列が含まれます。メトリクス列が追加されると、メトリクスのソースとなるクエリを簡単に確認できます。ソースクエリのラベルを定義して、この値をカスタマイズします。

次の例では、時系列データを返すクエリが 2 つあります。変換を適用する前に、2 つの個別のテーブルとして視覚化されます。

*クエリ A*


| Time | 温度 | 
| --- | --- | 
| 2020-07-07 11:34:20 | 25 | 
| 2020-07-07 10:31:22 | 22 | 
| 2020-07-07 09:30:05 | 19 | 

*クエリ B*


| Time | 湿度 | 
| --- | --- | 
| 2020-07-07 11:34:20 | 24 | 
| 2020-07-07 10:32:20 | 29 | 
| 2020-07-07 09:30:57 | 33 | 

シリーズから行 変換を適用した後の結果は次のとおりです。


| Time | メトリクス | 値 | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 温度 | 25 | 
| 2020-07-07 11:34:20 | 湿度 | 22 | 
| 2020-07-07 10:32:20 | 湿度 | 29 | 
| 2020-07-07 10:31:22 | 温度 | 22 | 
| 2020-07-07 09:30:57 | 湿度 | 33 | 
| 2020-07-07 09:30:05 | 温度 | 19 | 

この変換により、複数の時系列クエリの結果の統合が容易になり、効率的な分析と視覚化のための合理化された統合データセットが表形式で提供されます。

## 並べ替え
<a name="v10-panels-xform-funcs-sort"></a>

この変換を使用して、指定されたフィールドに基づいてクエリ結果内の各フレームをソートし、データを理解し分析しやすくします。ソートに必要なフィールドを設定することで、テーブルまたは視覚化にデータが表示される順序を制御できます。

**[Reverse]** (リバース) スイッチを使用して、指定されたフィールド内の値を逆に順序付けします。この機能は、分析ニーズに合わせて昇順と降順をすばやく切り替える場合に特に便利です。

例えば、時系列データがデータソースから取得されるシナリオでは、**[並べ替え]**変換を適用することで、分析要件に応じてタイムスタンプに基づいてデータフレームを昇順または降順に配置できます。この機能を使用すると、時系列データを簡単にナビゲートして解釈でき、整理された視覚的に一貫性のあるプレゼンテーションから貴重なインサイトを得られます。

## Spatial (空間)
<a name="v10-panels-xform-funcs-spatial"></a>

この変換を使用して、空間オペレーションをクエリ結果に適用します。
+ **[Action]** – アクションを選択します。
  + **[Prepare spatial field]** (空間フィールドの準備) – 他のフィールドの結果に基づいてジオメトリフィールドを設定します。
    + **[Location mode]** – ロケーションモードを選択します (これらのオプションは、**値の計算**モードと**変換**モードによって共有されます)。
      + **[Auto]** – デフォルトのフィールド名に基づいて位置データを自動的に識別します。
      + **[Coords]** (座標) – 緯度と経度フィールドを指定します。
      + **[Geohash]** – ジオハッシュフィールドを指定します。
      + **[ルックアップ]** - Gazetteer のロケーションフィールドを指定します。
  + **[計算]**– ジオメトリを使用して新しいフィールド (方位/距離/面積) を定義します。
    + **[関数]** – ジオメトリに適用する数学演算を選択します。
      + **[Heading]** (方位) – 2 つのポイント間の方位 (方向) を計算します。
      + **[面積]** – ジオメトリで定義されるポリゴンで囲まれたエリアを計算します。
      + **[Distance]** (距離) – 2 つのポイント間の距離を計算します。
  + **[変換]** - ジオメトリに空間オペレーションを適用します。
    + **[操作]** – ジオメトリに適用する操作を選択します。
      + **[線]** – 各行の頂点による単線機能を作成します。
      + **[ラインビルダー]** – 2 つのポイントの間に線を作成します。

この変換により、地理空間データを操作および分析し、ポイント間の線の作成、空間プロパティの計算などの操作が可能になります。

## 時系列のテーブル変換
<a name="v10-panels-xform-funcs-seriestotable"></a>

この変換を使用して時系列結果をテーブルに変換し、時系列データフレームを**[トレンド]**フィールドに変換します。**[トレンド]**フィールドは、[[スパークラインセルタイプ]](v10-panels-table.md#v10-panels-table-cell-type)を使用してレンダリングでき、テーブル行ごとにインラインスパークラインを生成します。複数の時系列クエリがある場合、それぞれが個別のテーブルデータフレームになります。これらは結合またはマージ変換を使用して結合し、行ごとに複数のスパークラインを持つ単一のテーブルを生成できます。

生成された**[トレンド]**フィールド値ごとに、計算関数を選択できます。デフォルトは **[最後の null 以外の値]**です。この値はスパークラインの隣に表示され、テーブル行のソートに使用されます。

## Regression analysis (回帰分析)
<a name="v10-panels-xform-funcs-regression"></a>

この変換を使用して、統計モデルによって予測された値を含む新しいデータフレームを作成します。これは、混沌としたデータの傾向を見つけるのに役立ちます。線形回帰または多項式回帰を使用して、データに数学関数を適合させることによって機能します。その後、データフレームを視覚化で使用してトレンドラインを表示できます。

これには、次のように 2 つの異なるモデルがあります。
+  **線形回帰** – 線形関数をデータに適合させます。
+  **多項式回帰** – 多項式関数をデータに適合させます。

**注記**  
この変換は現在パブリックプレビュー中です。Grafana Labs ではサポートが限られており、この機能が一般公開される前に重要な変更が発生する可能性があります。

# クエリのトラブルシューティング
<a name="v10-panels-query-troubleshoot"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

このページでは、一般的なダッシュボードの問題を解決するための情報を提供します。

**関数を再配置すると、異なる結果が得られる**

関数の順序は非常に重要です。数学と同様に、関数を配置する順序は結果に影響を与える可能性があります。

**クエリリクエストとレスポンスを検査する**

最も一般的な問題は、データソースからのクエリとレスポンスに関連しています。Grafana のバグや視覚化の問題のように見えても、ほとんどの場合、データソースクエリまたはデータソースレスポンスの問題です。まず、パネルクエリとレスポンスを検査します。

詳細については、「[リクエストとレスポンスデータの検査](v10-panels-panel-inspector.md)」を参照してください。

**クエリが遅い**

クエリが返すデータポイントの数を確認してください。多くのデータポイントを返すクエリは遅くなります。解決策は以下のとおりです。
+ **[クエリオプション]**で、返される**[最大データポイント数]**を制限します。
+ **クエリオプション**で、**最小間隔**時間を長くします。
+ クエリで、`group by` 関数を使用します。

# 計算タイプ
<a name="v10-panels-calculation-types"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

次の表に、Grafana で実行できる計算の一覧を示します。これらの計算は、**[変換]** タブと棒ゲージ、ゲージ、および統計の視覚化で確認できます。


| 計算 | 説明 | 
| --- | --- | 
| All nulls | すべての値が null のとき真 | 
| [すべての値] | すべての値を含む配列 | 
| すべての一意の値 | すべての一意の値を含む配列 | 
| All zeros | すべての値が 0 のとき真 | 
| Change count | フィールドの値が変更される回数 | 
| Count | フィールド内の値の数 | 
| Delta | 値の累積変化、カウント増分のみ | 
| Difference | フィールドの最初の値と最後の値の差 | 
| Difference percent | フィールドの最初と最後の値の変化率 | 
| Distinct count | フィールド内の一意の値の数 | 
| First | フィールドの最初の値 | 
| First\$1 (not null) | First は、フィールドの null 値ではありません (NaN も除く) | 
| Last | フィールドの最後の値 | 
| Last\$1 (not null) | Last は、フィールドの null 値ではありません (NaN も除く) | 
| 最大 | フィールドの最大値 | 
| Mean | フィールド内のすべての値の平均値 | 
| Variance | フィールド内のすべての値の分散 | 
| StdDev | フィールド内のすべての値の標準偏差 | 
| 最小 | フィールドの最小値 | 
| 最小 (above zero) | フィールドの最小値、正の値 | 
| Range | フィールドの最大値と最小値との差 | 
| Step | フィールドの値間の最小間隔 | 
| Total | フィールド内のすべての値の合計 | 

# パネルオプションの設定
<a name="v10-panels-configure-panel-options"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana パネルは、データソースクエリの定義、データの変換と書式設定、視覚化設定の構成によってカスタマイズできるデータの視覚的表現です。

パネルエディタには、クエリビルダーと、データの変換やパネルへの情報の追加に使用できる一連のオプションが含まれています。

このトピックでは、以下の方法について説明します。
+ パネルを開いて編集する
+ パネルのタイトルと説明を追加する
+ パネル JSON モデルを表示する
+ 繰り返し行とパネルを設定する

## パネルの編集
<a name="v10-panels-edit-a-panel"></a>

ダッシュボードにパネルを追加すると、いつでもパネルを開いてクエリを変更または更新したり、データ変換を追加したり、視覚化設定を変更したりできます。

**パネルを編集するには**

1. 編集するパネルを含むダッシュボードを開きます。

1. パネルのいずれかの部分にカーソルを合わせると、右上隅にアクションメニューが表示されます。

1. メニューを選択し、**[編集]** を選択します。

   キーボードショートカットを使用してパネルを開くには、パネルにカーソルを合わせ、`e` を押します。

   パネルが編集モードで開きます。

## パネルにタイトルと説明を追加する
<a name="v10-panels-add-title-description"></a>

パネルにタイトルと説明を追加して、視覚化に関する重要な情報をユーザーと共有します。例えば、説明を使用して、視覚化の目的を文書化します。

1. パネルを編集します。

1. パネル表示オプションペインで、**[パネルオプション]** セクションを見つけます。

1. **[タイトル]** を入力します。

   このフィールドに入力されたテキストは、パネルエディタとダッシュボードのツールチップに表示されます。

1. 表示するパネルとデータの説明を記入します。

   このフィールドに入力したテキストは、パネルの左上隅にあるツールチップに表示されます。

   **[タイトル]** と **[説明]** フィールドで[[定義した変数]](v10-dash-variables.md)を使用できますが、[[グローバル変数]](v10-dash-variable-add.md#v10-dash-variable-add-global)は使用できません。

## パネル JSON モデルの表示
<a name="v10-panels-json-model"></a>

パネル、パネルデータ、データフレーム JSON モデルを検索してエクスポートします。

**パネル JSON モデルを表示するには**

1. パネルを含むダッシュボードを開きます。

1. パネルのいずれかの部分にカーソルを合わせると、右上隅にアクションメニューが表示されます。

1. メニューから、**[Inspect] (検査) > [Panel JSON]** を選択します。

1. **[ソースの選択]** フィールドで、次のオプションのいずれかを選択します。
   + **Panel JSON** – パネルを表す JSON オブジェクトを表示します。
   + **[Panel data]** – パネルに渡されるデータを表す JSON オブジェクトを表示します。
   + **[データフレーム構造]** – 適用された変換、フィールド設定、オーバーライド設定など、パネルのデータ構造を表示します。

1. JSON を調べるには、**[>]** を選択して JSON モデルの一部を展開または折りたたみます。

## 繰り返しパネルの設定
<a name="v10-panels-configure-repeating-panels"></a>

パネルまたは行をダッシュボードに動的に追加するように Grafana を設定できます。動的パネルは、変数の値に基づいてシステムが作成するパネルです。変数は、ダッシュボード内のすべてのパネルでクエリを動的に変更します。繰り返しパネルの詳細については、「[ダッシュボードの作成](v10-dash-creating.md)」を参照してください。

**注記**  
パネルを繰り返すには、変数に 1 つ以上の項目を選択する必要があります。パネルを非表示にするためにパネルを 0 回繰り返すことはできません。

*前提条件*
+ クエリに複数値変数が含まれていることを確認します。

**繰り返しパネルを設定するには**

1. 繰り返すパネルを編集します。

1. 表示オプションペインで、**[パネルオプション] > [繰り返しオプション]** を選択します。

1. **[direction]** (方向) を選択します。
   + **[水平]** を選択してパネルを並べて配置します。Grafana は繰り返しパネルの幅を調整します。行上の他のパネルと繰り返しパネルを混在させることはできません。
   + **[垂直]** を選択して、列にパネルを配置します。繰り返しパネルの幅は、元の繰り返しパネルの幅と同じです。

1. すべてのパネルに変更を伝達するには、ダッシュボードを再読み込みします。

# 標準オプションを設定する
<a name="v10-panels-configure-standard-options"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana で使用されるデータモデルは、時系列とテーブルのクエリ結果の両方を統合する列指向のテーブル構造です。この構造内の各列は、*フィールド*と呼ばれます。フィールドは、単一の時系列またはテーブル列を表すことができます。

フィールドオプションを使用すると、視覚的表現でのデータの表示方法を変更できます。適用するオプションとオーバーライドはデータを変更せず、Grafana のデータの表示方法を変更します。オプションを変更すると、すべてのフィールド、つまりすべての系列または列に適用されます。例えば、単位をパーセンテージに変更すると、数値を含むすべてのフィールドがパーセンテージで表示されます。

フィールドの書式設定オプションの完全なリストは、このトピックの後半で説明します。

**注記**  
ほとんどの組み込み Grafana パネルに標準オプションを適用できます。新しいパネルとデータモデルに更新されていない古いパネルとコミュニティパネルの一部には、これらのフィールドオプションのすべてまたは一部が欠落します。

**標準オプションを設定するには**

1. ダッシュボードを開きます。パネルのいずれかの部分にカーソルを合わせると、ダッシュボードの右上隅にアクションメニューが表示されます。

1. アクションメニューで、**[編集]** を選択します。

1. パネル表示オプションペインで、**[標準オプション]** セクションを見つけます。

1. 適用する標準オプションを選択します。

1. 変更をプレビューするには、編集中のフィールドオプションボックスの外部を選択するか、**Enter** を押します。

**標準オプションの定義**

このセクションでは、使用可能なすべての標準オプションについて説明します。

ほとんどの組み込み Grafana パネルに標準オプションを適用できます。新しいパネルとデータモデルに更新されていない古いパネルとコミュニティパネルの一部には、これらのフィールドオプションのすべてまたは一部が欠落します。

ほとんどのフィールドオプションは、編集中のフィールドオプションボックスの外部をクリックするか、**Enter** キーを押すまで、視覚化には影響しません。

**注記**  
Grafana Labs は、すべての視覚化に対するオプションの追加と拡張に絶えず取り組んでいるため、すべてのオプションをすべての視覚化に対して使用できない場合があります。

## Unit
<a name="v10-panels-standard-options-unit"></a>

フィールドで使用する単位を選択できます。**[単位]** フィールドを選択し、目的の単位が見つかるまでドリルダウンします。選択した単位は、時間を除くすべてのフィールドに適用されます。

### ユーザー定義の単位
<a name="v10-panels-standard-options-custom-units"></a>

単位ドロップダウンを使用して、ユーザー定義の単位、接頭辞、または接尾辞と、日付時刻形式を指定することもできます。

ユーザー定義の単位を選択するには、単位を入力し、ドロップダウンで最後の **[カスタム: xxx]** オプションを選択します。
+ **suffix:<suffix>** 値の後に続くユーザー定義単位を指定できます。
+ **prefix:<prefix>** 値の前に置くユーザー定義単位を指定できます。
+ **time:<format>** ユーザー定義の日付時刻形式の場合は、`time:YYYY-MM-DD` のように入力します。形式の構文とオプションについては、「*Moment.js ドキュメント*」の「[形式](https://momentjs.com/docs/#/displaying/)」を参照してください。
+ **si:<base scale><unit characters>** ユーザー定義の SI 単位を指定できます。例えば、`si: mF` などです。これは、単位とソースデータスケールの両方を指定できるため、少し高度です。したがって、ソースデータがミリ (基本単位の千分の一) で表されている場合、単位の先頭にその SI スケール文字が付けられます。
+ **count:<unit>** ユーザー定義の集計単位を指定できます。
+ **currency:<unit>** ユーザー定義の通貨単位を指定できます。

単位ピッカーにネイティブ絵文字を貼り付けて、ユーザー定義単位として選択することもできます。

### [String units] (文字列の単位)
<a name="v10-panels-standard-options-string-units"></a>

Grafana は、文字列を解析して数値として表示する際に、自動で表示が変わる場合があります。元の文字列値を表示するように Grafana を設定するには、フィールドオーバーライドを作成し、**[文字列]** 単位で単位プロパティを追加します。

### スケールの単位
<a name="v10-panels-standard-options-scale-units"></a>

デフォルトでは、Grafana は値の大きさに基づいて単位を自動的にスケールします。例えば、値が 0.14 kW の場合、Grafana はそれを 140 W として表示します。別の例として、3,000 kW は 3 MW として表示されます。この動作を無効にする場合は、**[スケールの単位]** スイッチをオフにできます。

## 最小
<a name="v10-panels-standard-options-min"></a>

パーセンテージしきい値の計算に使用される最小値を設定できます。最小値を自動的に計算するには、空白のままにします。

## 最大
<a name="v10-panels-standard-options-max"></a>

パーセンテージしきい値の計算に使用される最大値を設定できます。最大値を自動的に計算するには、空白のままにします。

## フィールドの最小値/最大値
<a name="v10-panels-standard-options-fieldminmax"></a>

デフォルトでは、計算された最小値と最大値は、すべての系列とフィールドの最小値と最大値に基づきます。フィールドの最小値/最大値をオンにすると、そのフィールドの最小値または最大値に基づいて、各フィールドの最小値または最大値が個別に計算されます。

## 小数
<a name="v10-panels-standard-options-decimals"></a>

Grafana がレンダリングした値に含める小数点以下の桁数を指定します。このフィールドを空白のままにすると、Grafana は値に基づいて小数点以下の桁数を自動的に切り捨てます。例えば、1.1234 は 1.12 として表示され、100.456 は 100 として表示されます。

すべての小数を表示するには、単位を **[String]** (文字列) に設定します。

## Display name (表示名)
<a name="v10-panels-standard-options-displayname"></a>

すべてのフィールドの表示タイトルを設定できます。フィールドタイトルには[変数](v10-dash-variables.md)を使用できます。

複数の統計、フィールド、または系列が表示される場合、このフィールドは各統計のタイトルを制御します。**\$1\$1\$1\$1field.name\$1** などの式を使用して、タイトルの系列名またはフィールド名のみを使用できます。

`Temp` という名前のフィールドと、`{"Loc"="PBI", "Sensor"="3"}` のラベルが付与されます。


| 式の構文 | 例 | レンダリング先 | 説明 | 
| --- | --- | --- | --- | 
| \$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="v10-panels-standard-options-color-scheme"></a>

カラーオプションとその視覚化への影響は、作業中の視覚化によって異なります。一部の視覚化には、異なるカラーオプションがあります。

値に基づいて、単一の色を指定するか、連続 (グラデーション) カラースキームを選択できます。連続色は、最小値と最大値に対する値の割合を使用して色を補間します。

次のいずれかのパレットを選択します。


| カラーモード | 説明 | 
| --- | --- | 
| [単一色] | オーバーライドルールに役立つ単一色を指定します | 
| Shades of a color (色のシェード) | オーバーライドルールに役立つ 1 色のシェードを選択します。 | 
| [しきい値起点] | 一致するしきい値から色を取るように Grafana に通知します | 
| Classic palette (クラシックパレット) | Grafana は、系列のインデックスでパレットの色を検索して色を割り当てます。グラフや円グラフ、その他のカテゴリ別データの視覚化に役立ちます。 | 
| Classic palette (by series name) (クラシックパレット (系列名別)) | Grafana は、系列の名前に基づいて色を割り当てます。視覚化される系列名が使用可能なデータに依存する場合に便利です。 | 
| Green-Yellow-Red (by value) (緑黄赤 (値別)) | 連続色スキーム | 
| Red-Yellow-Green (by value) (赤黄緑 (値別)) | 連続色スキーム | 
| Blue-Yellow-Red (by value) (青黄赤 (値別)) | 連続色スキーム | 
| Yellow-Red (by value) (黄赤 (値別)) | 連続色スキーム | 
| Blue-Purple (by value) (青紫 (値別)) | 連続色スキーム | 
| Yellow-Blue (by value) (黄青 (値別)) | 連続色スキーム | 
| Blues (by value) (青 (値別)) | 連続色スキーム (パネルの背景を青に) | 
| Reds (by value) (赤 (値別)) | 連続色スキーム (パネルの背景色を赤に) | 
| Greens (by value) (緑 (値別)) | 連続色スキーム (パネルの背景色を緑に) | 
| Purple (by value) (紫 (値別)) | 連続色スキーム (パネルの背景色を紫に) | 

## 値なし
<a name="v10-panels-standard-options-no-value"></a>

フィールド値が空または null の場合に Grafana が表示するものを入力します。デフォルト値はハイフン (-) です。

# 凡例を設定する
<a name="v10-panels-configure-legend"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

パネルには、視覚化に表示されるデータの解釈に使用できる凡例が含まれています。各凡例オプションは、視覚化に示されているデータにコンテキストと明確さを追加します。

凡例は、次の視覚化でサポートされています。
+ [棒グラフ](v10-panels-bar-chart.md)
+ [ローソク足チャート](v10-panels-candlestick.md)
+ [ヒストグラム](v10-panels-histogram.md)
+ [円グラフ](v10-panels-piechart.md)
+ [状態タイムライン](v10-panels-state-timeline.md)
+ [ステータス履歴](v10-panels-status-history.md)
+ [時系列](v10-panels-time-series.md)
+ [[トレンド]](v10-panels-trend.md)

[ジオマップ](v10-panels-geomap.md)と[ヒートマップ](v10-panels-heatmap.md)にも凡例はありますが、凡例を表示するか表示しないかの選択のみが提供され、他の凡例オプションはサポートされていません。

## 凡例オプション
<a name="v10-panels-legend-options"></a>

次のオプションは、パネル編集ペインの **[凡例]** セクションにあります。

**注記**  
リストされているすべてのオプションが、凡例を含むすべての視覚化に適用されるわけではありません。

**[可視性]**

凡例を表示するかどうかを設定します。凡例のオン/オフを切り替えるには、スイッチを使用します。

**モード**

凡例が表示される形式を設定します。以下から選択します。
+ **リスト**
+ **[テーブル]**

凡例をテーブルとしてフォーマットすると、関連する値や視覚化内の場所など、凡例に関する他の情報も表示されることがあります。

**[配置]**

視覚化で凡例が表示される場所を設定します。以下から選択します。
+ **[Bottom]** (下)
+ **[Right]** (右)

**[幅]**

凡例の配置を**右**に設定すると、**幅**オプションが使用可能になります。フィールドを空のままにして、Grafana が凡例の幅を自動的に設定できるようにするか、フィールドに値を入力します。

**[Values]** (値)

凡例に系列データ値または[計算](v10-panels-calculation-types.md)を追加することで、視覚化にコンテキストをさらに追加できます。必要な数だけ値を追加できます。変更を適用すると、凡例をスクロールしてすべての値を表示できます。

## 系列の色の変更
<a name="v10-panels-legend-change-color"></a>

デフォルトでは、Grafana は系列データの色を設定しますが、パネル凡例を使用して変更できます。

**系列の色を変更するには**

1. 更新するパネルに移動します。

1. 凡例で、系列に関連付けられたカラーバーを選択します。

1. ピッカーまたは RGB 値を使用して、**[Colors]** タブでプリセット色を選択するか、**[カスタム]** タブでカスタム色を設定します。

1. ダッシュボードを保存します。

## 視覚化での系列データの分離
<a name="v10-panels-legend-isolate"></a>

視覚化は視覚的に複雑になることが多く、データ系列が数多く含まれている場合があります。表示したいデータを分離する凡例を使用して、視覚化から凡例データを削除することで、表示を簡素化できます。これを行うと、Grafana は **[Override]** タブに新しいオーバーライドを自動的に作成します。

**視覚化で系列データを分離するには**

1. 更新するパネルに移動します。

1. 凡例で、分離する系列のラベルを選択します。

   システムによって、他のすべての系列データ表示から削除されます。

1. 系列データを分離された系列に段階的に追加するには、**Ctrl** キーまたは **Command** キーを押して、追加する系列のラベルを選択します。

1. パネルのすべてのビューワーに表示されるように変更を保存するには、ダッシュボードを保存します。

すべてのデータを含むデフォルトの表示に戻すには、任意の系列ラベルを 2 回クリックします。

## 系列のソート
<a name="v10-panels-legend-sort"></a>

凡例をテーブルとしてフォーマットして値を追加すると、テーブル内の系列をそれらの値でソートできます。

**系列をソートするには**

1. 更新するパネルに移動します。

1. 操作するパネルの任意の部分にカーソルを合わせると、パネルの右上隅にメニューが表示されます。

1. メニューで **[編集]** を選択します。

1. パネル編集ペインの **[凡例]** セクションまでスクロールします。

1. **[Values]** (値) で、表示する値または計算を選択します。

   凡例に値が表示されるようになりました。

1. 凡例テーブルの計算名ヘッダーを選択して、テーブル内の値を昇順または降順にソートします。

**注記**  
この機能は、棒グラフ、ヒストグラム、時系列のパネルでのみサポートされています。

# データリンクの設定
<a name="v10-panels-configure-data-links"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

データリンクを使用すると、リンクへのより詳細なコンテキストを提供できます。カーソルの下に系列名または値を含むリンクを作成できます。例えば、視覚化で 4 つのサーバーが表示されている場合は、そのうちの 1 つまたは 2 つにデータリンクを追加できます。データリンクを使用してパネルをリンクすることもできます。

リンク自体には、視覚化に応じてさまざまな方法でアクセスできます。例えば、時系列の視覚化では、データポイントまたは行を選択します。統計、ゲージ、棒ゲージなどの広域視覚化では、視覚化の任意の場所を選択してコンテキストメニューを開くことができます。

視覚化にデータリンクが 1 つしかない場合、視覚化の任意の場所を選択すると、コンテキストメニューではなくリンクが開きます。

**サポートされている視覚化**
+ 棒グラフ
+ 棒ゲージ
+ ローソク足チャート
+ キャンバス
+ ゲージ
+ ジオマップ
+ ヒートマップ
+ ヒストグラム
+ 円グラフ
+ 統計
+ 状態タイムライン
+ ステータス履歴
+ [テーブル]
+ 時系列
+ トレンド

## データリンク変数
<a name="v10-panels-data-link-variables"></a>

データリンクの変数を使用すると、データフィルターが保持された詳細なダッシュボードにユーザーを送信できます。例えば、 変数を使用して、ラベル、時間範囲、系列、または変数の選択を指定できます。

使用可能な変数のリストを表示するには、データリンク **URL** フィールドに `$` を入力します。

データリンク URL のテンプレート変数も使用できます。「[変数](v10-dash-variables.md)」を参照してください。

### 時間範囲パネル変数
<a name="v10-panels-time-range-panel-variables"></a>

これらの変数を使用すると、データリンク URL に現在の時間範囲を含めることができます。
+ `__url_time_range` – 現在のダッシュボードの時間範囲 (`?from=now-6h&to=now` など)
+ `$__from` – 詳細については、「[グローバル変数](v10-dash-variable-add.md#v10-dash-variable-add-global)」を参照してください。
+ `$__to` – 詳細については、「[グローバル変数](v10-dash-variable-add.md#v10-dash-variable-add-global)」を参照してください。

### 系列変数
<a name="v10-panels-series-variables"></a>

系列固有の変数は、`__series` 名前空間で使用できます。
+ `__series.name` – URL への系統名

### フィールド変数
<a name="v10-panels-field-variables"></a>

フィールド固有の変数は、`__field` 名前空間で使用できます。
+ `__field.name` – フィールドの名前
+ `__field.labels.<LABEL>` – URL に対するラベルの値。ラベルにドットが含まれている場合は、`__field.labels["<LABEL>"]` 構文を使用します。

### 値変数
<a name="v10-panels-value-variables"></a>

値固有の変数は、`__value` 名前空間で使用できます。
+ `__value.time` – URL への値のタイムスタンプ (Unix ms エポック) (`?time=1560268814105` など)
+ `__value.raw` – raw 値
+ `__value.numeric` – 値の数値表現
+ `__value.text` – 値のテキスト表現
+ `__value.calc` – 値が計算の結果である場合の計算名

データリンクで値固有の変数を使用すると、[ツールチップ] モードの設定オプションに応じて異なる結果が表示されることがあります。

### データ変数
<a name="v10-panels-data-variables"></a>

他のフィールドの値にアクセスするには、以下を使用します。
+ `__data.fields[i]` – (同じ行にある) フィールド `i` の値。
+ `__data.fields["NameOfField"]` – インデックスの代わりに名前を使用するフィールドの値。
+ `__data.fields[i].labels.cluster` – 別のフィールドのラベルにアクセス。

### テンプレート変数
<a name="v10-panels-template-variables"></a>

テンプレート変数を使用する別のダッシュボードにリンクするときは、リンクをクリックした人の変数値を選択します。

`${var-myvar:queryparam}` - ここで、`var-myvar` は、使用する現在のダッシュボードにあるテンプレート変数と一致するテンプレート変数の名前です。


| 可変状態 | 作成された URL の結果 | 
| --- | --- | 
| 1 つの値を選択済み | var-myvar=value1 | 
| 複数の値を選択済み | var-myvar=value1&var-myvar=value2 | 
| All を選択済み | var-myvar=All | 

現在のダッシュボードのすべての変数を URL に追加する場合は、`${__all_variables}` を使用します。

## データリンクの追加
<a name="v10-panels-add-a-datalink"></a>

パネルにデータリンクを追加できます。

1. データリンクを追加するパネルに移動します。

1. パネルにカーソルを合わせると、右上隅にメニューアイコンが表示されます。

1. メニューから、**[編集]** を選択してパネルエディタを開きます。

1. **[パネル編集]** ペインで、**[データリンク]** セクションまでスクロールダウンして展開します。

1. **[リンクの追加]** を選択します。

1. 開いたダイアログボックスに、**[タイトル]**を入力します。これは、判読可能なリンクラベルで、リンクは UI に表示されます。

1. リンク先の **[URL]** または変数を入力します。

   データリンク変数を追加するには、**URL** フィールドを選択し、`$` を入力するか、Ctrl\$1Space または Cmd\$1Space を押すと、使用可能な変数のリストが表示されます。

1. リンクを新しいタブで開く場合は、**[新しいタブで開く]** を選択します。

1. **[保存]** を選択して変更を保存し、ダイアログボックスを閉じます。

1. ダッシュボードに変更を保存します。

# 値マッピングを設定する
<a name="v10-panels-configure-value-mappings"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

フィールドオーバーライドに加えて、値マッピングは、視覚化でのデータの表示方法を変更するために使用できる手法です。

値マッピングは、表示される色や小数点以下の桁数など、パネルエディタの[標準オプション](v10-panels-configure-standard-options.md)で設定された単位の書式設定を介しません。値マッピングがパネルに存在する場合、Grafana はパネルエディタの**[値マッピング]**セクションにその概要を表示します。

**サポートされている視覚化**
+ 棒グラフ
+ 棒ゲージ
+ ローソク足チャート
+ キャンバス
+ ゲージ
+ ジオマップ
+ ヒストグラム
+ 円グラフ
+ 統計
+ 状態タイムライン
+ ステータス履歴
+ [テーブル]
+ 時系列
+ トレンド

## 値マッピングの種類
<a name="v10-panels-value-mappings-types"></a>

Grafana は、次の値マッピングの種類をサポートしています。
+ **[Value]** – 特定の値をテキストと色にマッピングします。例えば、値 `10` のすべてのインスタンスが数値ではなく `Perfection!` として表示されるように値マッピングを設定できます。単一の値をフォーマットする場合は、**Value** マッピングを使用します。
+ **[Range]** – 数値範囲をテキストと色にマッピングします。例えば、値が特定の範囲内にある場合は、数値ではなく `Low` または `High` を表示するように範囲値マッピングを設定できます。複数の連続値を推定する場合は、**Range** マッピングを使用します。
+ **[Regex]** – 正規表現をテキストと色にマッピングします。例えば、値が `www.example.com` の場合、Grafana が `www` を表示し、ドメインを切り捨てるように正規表現値マッピングを設定できます。正規表現値のテキストと色をフォーマットする場合は、**Regex** マッピングを使用します。
+ **[特殊]** – `Null`、`NaN` (数値以外) などの特殊な値、`true` や `false` などのブール値をテキストと色にマッピングします。例えば、`null` 値が `N/A` として表示されるように、特殊な値マッピングを設定できます。まれな値、ブール値、または空の値をフォーマットする場合は、**[特殊]** マッピングを使用します。

## 値マッピングの追加
<a name="v10-panels-value-mappings-add"></a>

パネルに値マッピングを追加できます。

**値マッピングを追加するには**

1. 更新するパネルに移動します。

1. パネルの任意の部分にカーソルを合わせると、パネルの右上隅にメニューが表示されます。

1. メニューで **[編集]** を選択します。

1. **[値マッピング]** セクションで、**[値マッピングを追加]** を選択します。

1. **[新しいマッピングの追加]** を選択し、次のいずれかを選択します。
   + **[Value]** – 一致する単一の値を入力します。
   + **[Range]** – 一致する範囲の開始値と終了値を入力します。
   + **[Regex]** – 一致する正規表現パターンを入力します。
   + **[特殊]** – 一致する特殊な値を選択します。

1. (オプション) 表示テキストを入力します。

1. (オプション) 色を設定します。

1. **[更新]** を選択して、値マッピングを保存します。

マッピングを追加したら、**[値マッピングの編集]** ボタンが **[値マッピングの追加]** ボタンに置き換わります。マッピングを追加または更新するには、編集ボタンを選択します。

# しきい値を設定する
<a name="v10-panels-configure-thresholds"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボードでは、しきい値はメトリクスに対して設定した値または制限であり、しきい値以上となった場合に視覚的に反映されます。しきい値は、クエリ結果に基づいて視覚化を条件付きでスタイル付けおよび色付けする方法の 1 つです。

しきい値を使用すると、次のことができます。
+ 時系列の視覚化において、グリッド線またはグリッド領域を色付けします。
+ 統計の視覚化において、背景または値のテキストを色付けします。
+ 状態タイムラインで領域と領域の色を定義します。
+ 時系列の視覚化で線を色付けします。
+ ゲージにおいて、ゲージとしきい値マーカーを色付けします。
+ ジオマップのマーカーを色付けします。
+ テーブル内のセルのテキストまたは背景を色付けします。

**サポートされている視覚化**
+ 棒グラフ
+ 棒ゲージ
+ ローソク足チャート
+ キャンバス
+ ゲージ
+ ジオマップ
+ ヒストグラム
+ 統計
+ 状態タイムライン
+ ステータス履歴
+ [テーブル]
+ 時系列
+ トレンド

## デフォルトのしきい値
<a name="v10-panels-thresholds-default"></a>

しきい値をサポートする視覚化では、Grafana には以下のデフォルトのしきい値設定があります。
+ 80 = red (80 = 赤)
+ Base = green (ベース = 緑)
+ Mode = Absolute (モード = 絶対値)
+ しきい値の表示 = オフ (一部の視覚化の場合)

  詳細については、「[しきい値を表示する](#v10-panels-thresholds-show)」を参照してください。

## しきい値オプション
<a name="v10-panels-thresholds-options"></a>

以下のオプションを設定して、しきい値の外観をさらに定義できます。

### しきい値の値
<a name="v10-panels-thresholds-value"></a>

この数値は、しきい値をトリガーする値です。このフィールドでは、しきい値に関連付けられた色を設定することもできます。

**[Base]** (ベース) 値は、マイナス無限大を表します。デフォルトでは、緑色に設定されています。これは一般的に「良い」色です。

### しきい値モード
<a name="v10-panels-thresholds-mode"></a>

しきい値モードは 2 つあります。
+ **[絶対値]** しきい値は数値で定義されます。例えば、1～150 のスケールで 80 とします。
+ **[パーセンテージ]** しきい値は、最小値または最大値に対して定義されます。例えば、80% です。

### しきい値を表示する
<a name="v10-panels-thresholds-show"></a>

**注記**  
このオプションは、棒グラフ、ローソク足チャート、時系列、トレンド視覚化でのみサポートされています。

次のオプションを使用して、しきい値が視覚化時に表示されるかどうかと表示方法を設定します。
+ **[Off]** (オフ) – しきい値は表示されません。
+ **[線]** - しきい値は視覚化で水平線として表示されます。
+ **[破線]** - しきい値は、破線の水平線として表示されます。
+ **[領域の塗りつぶし]** - しきい値は水平領域として表示されます。
+ **[領域の塗りつぶしと線]** - しきい値は、線で区切られた水平領域として表示されます。
+ **[領域の塗りつぶしと破線]** - しきい値は、破線で区切られた水平領域として表示されます。

## しきい値の追加
<a name="v10-panels-thresholds-add"></a>

視覚化には、必要な数のしきい値を追加できます。Grafana はしきい値を高い順に自動的にソートします。

**しきい値を追加するには**

1. 更新するパネルに移動します。

1. パネルの任意の部分にカーソルを合わせると、右上隅にメニューが表示されます。

1. メニューから **[編集]** を選択します。

1. **[しきい値]** セクションまでスクロールするか、パネル編集ペインの上部にある検索バーに `Thresholds` と入力します。

1. **[しきい値の追加]** を選択します。

1. 新しいしきい値を入力するか、フィールドの右側にある上下の矢印を使用して、値を少しずつ増減させます。

1. しきい値の左側にある色付き円をクリックしてカラーピッカーを開くと、しきい値の色を更新できます。

1. **[しきい値モード]** で、**[絶対値]** または **[パーセンテージ]** を選択します。

1. **[しきい値の表示]** で、しきい値の表示方法を設定するか、オフにします。

しきい値を削除するには、しきい値を含むパネルに移動し、削除するしきい値の横にあるごみ箱アイコンを選択します。

# フィールドのオーバーライドを設定する
<a name="v10-panels-configure-overrides"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

オーバーライドを使用すると、特定のフィールドまたは系列に対して視覚化設定をカスタマイズできます。これは、特定のフィールドセットをターゲットとし、それぞれ複数のオプションを定義できるオーバーライドルールを追加することで実現されます。

例えば、**[正規表現と一致する名前付きフィールド]** を使用してオーバーライドを追加して、テキスト `bytes` を含むすべてのフィールドに単位を設定し、オーバーライドルールに単位オプションを追加できます。

## 例 1: 温度の形式
<a name="v10-panels-overrides-format-temperature"></a>

結果セットが、`time` と `temperature` の 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="v10-panels-overrides-format-humidity"></a>

結果セットが、`time`、`high temp`、`low temp`、`humidity` の 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="v10-panels-overrides-add-a-field"></a>

フィールドオーバーライドルールは、特定のフィールドまたは系列の視覚化設定をカスタマイズできます。

**フィールドオーバーライドの追加方法**

1. オーバーライドを追加するパネルを編集します。

1. パネルオプションサイドペインで、ペインの下部にある **[フィールドオーバーライドの追加]** を選択します。

1. オーバーライドルールが適用されるフィールドを選択します。
   + **[名前付きフィールド]** – 使用可能なすべてのフィールドの一覧からフィールドを選択します。このセレクタでルールに追加するプロパティは、この単一フィールドにのみ適用されます。
   + **[正規表現と一致する名前付きフィールド]** – 正規表現でオーバーライドするフィールドを指定します。このセレクタでルールに追加するプロパティは、フィールド名が正規表現と一致するすべてのフィールドに適用されます。これにより、オーバーライドするフィールドが選択されますが、フィールドの名前は変更されません。これを行うには、[[正規表現変換による名前の変更]](v10-panels-xform-functions.md) を使用します。
   + **[タイプ別フィールド]** – 文字列、数値などのフィールドをタイプ別に選択します。このセレクタでルールに追加するプロパティは、選択したタイプに一致するすべてのフィールドに適用されます。
   + **[クエリによって返されるフィールド]**: A、B、C など、特定のクエリによって返されるすべてのフィールドを選択します。このセレクタでルールに追加するプロパティは、選択したクエリによって返されるすべてのフィールドに適用されます。

1. **[オーバーライドプロパティの追加]** を選択します。

1. 適用するフィールドオプションを選択します。

1. フィールドに値を追加してオプションを入力します。オプションをデフォルト値に戻すには、フィールドの白い文字を削除します。

1. **[オーバーライドプロパティの追加]** を選択して、このフィールドにオーバーライドを追加し続けるか、**[オーバーライドの追加]** を選択し、オーバーライドを追加する別のフィールドを選択できます。

1. 完了したら **[保存]** を選択して、すべてのパネル編集をダッシュボードに保存します。

## フィールドオーバーライドの削除
<a name="v10-panels-overrides-delete-a-field"></a>

不要になったフィールドオーバーライドを削除します。オーバーライドを削除すると、値の外観はデフォルトで元の形式になります。この変更は、影響を受けるパネルに依存するダッシュボードとダッシュボードユーザーに影響します。

**フィールドオーバーライドを削除するには**

1. 削除するオーバーライドを含むパネルを編集します。

1. パネルオプションサイドペインで、オーバーライドが表示されるまで下にスクロールします。

1. 削除するオーバーライドを選択し、関連付けられたごみ箱アイコンを選択します。

## フィールドオーバーライドの表示
<a name="v10-panels-overrides-view"></a>

フィールドオーバーライドは、パネル表示オプションで表示できます。

1. 表示するオーバーライドを含むパネルを編集します。

1. パネルオプションサイドペインで、オーバーライドが表示されるまで下にスクロールします。

**注記**  
**[すべて]** タブに表示されるオーバーライド設定は、**[オーバーライド]** タブに表示される設定と同じです。

## フィールドオーバーライドの編集
<a name="v10-panels-overrides-edit-a-field"></a>

オーバーライド設定に変更を加える場合は、フィールドオーバーライドを編集します。加えた変更はすぐに反映されます。

**フィールドオーバーライドを編集するには**

1. 編集するオーバーライドを含むパネルを編集します。

1. パネルオプションサイドペインで、オーバーライドが表示されるまで下にスクロールします。

1. 変更するオーバーライドを見つけます。

1. 次のいずれかを実行します。
   + 既存のオーバーライドまたはフィールド選択パラメータの設定を編集します。
   + プロパティの横にある **[X]** を選択して、既存のオーバーライドプロパティを削除します。
   + **[オーバーライドプロパティの追加]** を選択して、オーバーライドプロパティを追加します。

# Grafana バージョン 10 で利用可能な視覚化
<a name="v10-panels-viz"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana は、さまざまなユースケースをサポートするさまざまな視覚化を提供します。ドキュメントのこのセクションでは、組み込まれている視覚化、そのオプション、そして一般的な使用方法について説明します。

パネルの使用の開始からその基本まで学べる一般的なパネルは、[時系列](v10-panels-time-series.md) パネルです。

**注記**  
どの視覚化を選択するかわからない場合、Grafana はパネルクエリに基づいて視覚化について提案できます。視覚化を選択すると、その視覚化が適用されたプレビューが Grafana に表示されます。
+ グラフとチャート
  + [時系列](v10-panels-time-series.md)は、デフォルトおよび主要なグラフ視覚化です。
  + [状態タイムライン](v10-panels-state-timeline.md)は、時間の経過に伴う状態変化を表します。
  + [ステータス履歴](v10-panels-status-history.md)は、時間の経過に伴う定期的な状態を表します。
  + [棒グラフ](v10-panels-bar-chart.md)は、カテゴリ別データを表示します。
  + [ヒストグラム](v10-panels-histogram.md)は、値分布を計算し、棒グラフで表示します。
  + [ヒートマップ](v10-panels-heatmap.md)は、データを 2 つのディメンションで視覚化します。通常、現象の大きさを表すのに使用されます。
  + [円グラフ](v10-panels-piechart.md)は通常、比例性が重要な場合に使用されます。
  + [ローソク足チャート](v10-panels-candlestick.md)は通常、価格/データ移動が焦点となる財務データに使用されます。
  + [ゲージ](v10-panels-gauge.md)は、単一のメトリクスがしきい値からどの程度離れているかを示す従来の丸みを帯びたビジュアルです。
  + [[トレンド]](v10-panels-trend.md)は、時間ではない連続した数値 x を持つデータセットに使用されます。
  + [XY チャート](v10-panels-xychart.md)は、グラフ内の任意の x および y 値を視覚化する方法を提供します。
+ 統計と数値
  + [[Stat]](v10-panels-stat.md) は、大規模統計とオプションのスパークラインを表示します。
  + [[ゲージサイズ]](v10-panels-bar-gauge.md) は、水平または垂直の棒ゲージです。
+ [Misc] (その他)
  + [[テーブル]](v10-panels-table.md) は、主要かつ唯一のテーブルの視覚化です。
  + [[ログ]](v10-panels-logs.md) は、ログの主要な視覚化です。
  + [[Node graph]](v10-panels-node-graph.md) は、有向性グラフまたはネットワークを表します。
  + [[Traces]](v10-panels-traces.md) は、トレースに対する主な視覚化です。
  + [[Flame graph]](v10-panels-flamegraph.md) は、プロファイリングに対する主な視覚化です。
  + [[Geomap]](v10-panels-geomap.md) は、地理空間データを視覚化できます。
  + [[Datagrid]](v10-panels-datagrid.md) を使用すると、データを作成および操作でき、他のパネルのデータソースとして機能します。
+ ウィジェット
  + [ダッシュボードリスト](v10-panels-dashboard-list.md)はダッシュボードを一覧表示できます。
  + [アラートリスト](v10-panels-alert-list.md)はアラートを一覧表示できます。
  + [テキスト](v10-panels-text.md)には、マークダウンと html を表示できます。
  + [ニュース](v10-panels-news.md)には RSS フィードが表示されます。

## 詳細を見る
<a name="v10-panels-getmore"></a>

[プラグインカタログによるプラグインの検索](grafana-plugins.md#plugin-catalog) からパネルプラグインをインストールすることで、視覚化タイプをさらに追加できます。

## 例
<a name="v10-panels-examples"></a>

以下のセクションでは、視覚化の例を示します。

## グラフ
<a name="v10-panels-ex-graphs"></a>

時間ベースの折れ線、面積、棒グラフの場合は、デフォルトの[時系列](v10-panels-time-series.md)の視覚化をお勧めします。

![\[Grafana での時系列の視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/time_series_example.png)


カテゴリ別データには、[棒グラフ](v10-panels-bar-chart.md)を使用します。

![\[Grafana での棒グラフ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/barchart_example.png)


## 大規模な数値と統計
<a name="v10-panels-ex-numbers"></a>

[統計](v10-panels-stat.md)の視覚化は、オプションのグラフスパークラインを含む 1 つの大きな統計値を表示します。しきい値またはカラースケールを使用して、背景または値の色を制御できます。

![\[Grafana の統計視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/stat_panel_example.png)


## ゲージ
<a name="v10-panels-ex-gauge"></a>

最小値と最大値に関連する値を提示する場合は、2 つのオプションがあります。1 つ目は、標準の放射状[ゲージ](v10-panels-gauge.md)です。

![\[Grafana のゲージ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/gauge_example.png)


2 つ目として、Grafana には、3 つの異なる表示モードを持つ水平または垂直の[棒ゲージ](v10-panels-bar-gauge.md)もあります。

![\[Grafana のゲージ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## [テーブル]
<a name="v10-panels-ex-table"></a>

テーブルレイアウトにデータを表示するには、[テーブル](v10-panels-table.md)の視覚化を使用します。

![\[Grafana のテーブル視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/table_example.png)


## 円グラフ
<a name="v10-panels-ex-piechart"></a>

1 つ以上のクエリから誘導された系列または値は、相互に関連するため、[円グラフ](v10-panels-piechart.md)の視覚化を用いて表示します。

![\[Grafana の円グラフ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/pie_chart_example.png)


## ヒートマップ
<a name="v10-panels-ex-heatmaps"></a>

時間の経過に伴う値の分布を表示するには、[ヒートマップ](v10-panels-heatmap.md)の視覚化を使用します。

![\[Grafana のヒートマップ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## 状態タイムライン
<a name="v10-panels-ex-state"></a>

[状態タイムライン](v10-panels-state-timeline.md)には、時間の経過に伴う個別の状態変化が表示されます。時系列で使用すると、しきい値を使用して数値を離散状態の領域に変換します。

![\[Grafana の状態タイムライン視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/state_timeline_example.png)


# アラートリスト
<a name="v10-panels-alert-list"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートリストを使用してアラートを表示します。現在の状態を表示するようにリストを設定できます。アラートの詳細については、「[Grafana バージョン 10 のアラート](v10-alerts.md)」を参照してください。　

この設定で、視覚化する内容を絞り込みます。

## オプション
<a name="v10-panels-alert-list-options"></a>
+ **グループモード** – **[デフォルトのグループ化]** から選択して、アラートルール別にグループ化されたアラートインスタンスを表示します。また、**[カスタムグループ化]** では、ラベルのカスタムセット別にアラートインスタンスをグループ化します。
+ **[最大項目数]** – 一覧表示するアラートの最大数を設定します。
+ **[ソート順序]** – アラートをどのような順番で表示するかを選択します。
  + **アルファベット (昇順)** – アルファベット順
  + **アルファベット (降順)** – 逆アルファベット順
  +  **[重要性]** – 以下を参照。1 が最も高い。
    + `alerting` または `firing`: 1
    + `no_data`: 2
    + `pending`: 3
    + `ok`: 4
    + `paused` または `inactive`: 5
  + **[時間 (昇順)]** – 最新のアクティブなアラートインスタンスが最初に表示されます。
  + **[時間 (降順]** – 最も古いアクティブなアラートインスタンスが最初に表示されます。
+  **[このダッシュボードからのアラート]** – アラートリストが含まれているダッシュボードからのみアラートを表示します。

## フィルター
<a name="v10-panels-alert-filter"></a>

これらのオプションを使用すると、表示されるアラートを、選択したクエリ、フォルダ、またはタグに一致するアラートのみに制限できます。
+ **[アラート名]** – アラート名クエリを入力します。
+ **[アラートインスタンスラベル]** – ラベルクエリを使用してアラートインスタンスをフィルタリングします。例えば、`{severity="critical", instance=~"cluster-us-.+"}` と指定します。
+ **[フォルダ]** – フォルダを選択します。選択したフォルダ内のダッシュボードからのアラートのみが表示されます。
+ **[データソース]** – 選択したデータソースからアラートをフィルタリングします。

## 状態フィルター
<a name="v10-panels-alert-state-filter"></a>

このパネルに表示するアラートの状態を選択します。
+ アラート中/発生中
+ 保留中
+ データなし
+ 普通
+ エラー

# 注釈リスト
<a name="v10-panels-annotations"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

注釈リストには、注釈付きデータの表示に使用できる注釈の一覧が表示されます。タグと現在のダッシュボードに基づいてリストをフィルタリングできるさまざまなオプションを使用できます。

## 注釈クエリ
<a name="v10-panels-annotations-query"></a>

以下のオプションは、注釈のリストに対するソースクエリを制御します。

**[クエリフィルター]**

クエリフィルターを使用して、組織内のすべてのダッシュボードまたはこのパネルがある現在のダッシュボードから注釈のリストを作成します。これには次のオプションがあります。
+ すべてのダッシュボード - 現在の組織内のすべてのダッシュボードの注釈を一覧表示します。
+ このダッシュボード - リストを現在のダッシュボードの注釈に制限します。

**[時間範囲]**

時間範囲オプションを使用して、リストを現在の時間範囲に制限するかどうかを指定します。これには次のオプションがあります。
+ [なし] - 注釈クエリの時間範囲の制限はありません。
+ このダッシュボード - リストを、注釈リストパネルが利用可能なダッシュボードの時間範囲に制限します。

**[タグ]**

タグオプションを使用して、注釈をタグでフィルタリングします。リストを絞り込むために複数のタグを追加できます。

**注記**  
必要に応じて、タグリストを空のままにして、パネル自体の結果の一部としてリストされているタグを選択して、その場でフィルタリングします。

**[制限]**

制限オプションを使用して、返される結果の数を制限します。

## [Display] (表示)
<a name="v10-panels-annotations-display"></a>

これらのオプションは、注釈パネル表示に含まれる追加のメタデータを制御します。

**[ユーザーの表示]**

このオプションを使用して、注釈を作成したユーザーを表示または非表示にします。

**[時間の表示]**

このオプションを使用して、注釈の作成時刻を表示または非表示にします。

**[タグの表示]**

このオプションを使用して、注釈に関連付けられたタグを表示または非表示にします。*[NB]*: タグを使用して、視覚化自体の注釈リストをその場でフィルタリングできます。

## リンク動作
<a name="v10-panels-annotations-links"></a>

**[リンクの対象]**

このオプションを使用して、注釈付きデータを表示する方法を選択します。これには次のオプションがあります。
+ [Panel] (パネル) - このオプションは、対応する注釈を含むパネルのフル画面表示に直接移動します。
+ ダッシュボード - このオプションは、全ダッシュボードのコンテキストで注釈に焦点を当てます。

**[前に時間指定]**

このオプションを使用して、注釈の前に時間範囲を設定します。「1h」= 1 時間、「10m」= 10 分などの期間文字列値を使用します。

**[後に時間指定]**

このオプションを使用して、注釈の後に時間範囲を設定します。

# 棒グラフ
<a name="v10-panels-bar-chart"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

棒グラフを使用すると、カテゴリ別のデータをグラフ化できます。

![\[Grafana での棒グラフ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/barchart_example.png)


## サポートされているデータ形式
<a name="v10-panels-bar-chart-formats"></a>

サポートされるデータフレームは 1 つだけで、X 軸または Y 軸の項目として使用する文字列フィールドが少なくとも 1 つ、および数値フィールドが 1 つ以上必要です。以下は、データ形式の例です。


| ブラウザ | 市場シェア | 
| --- | --- | 
| Chrome | 50 | 
| Internet Explorer | 17.5 | 

複数の数値フィールドがある場合は、パネルにグループ化されたバーが表示されます。

### 時系列または複数の結果セットの視覚化
<a name="v10-panels-bar-chart-visualization"></a>

複数の時系列またはテーブルがある場合は、まず結合を使用して結合するか、変換を減らす必要があります。例えば、複数の時系列があり、その最終値と最大値を比較する場合は、変換の **[削減]** を追加し、**[計算]** で **[最大]** と **[Last]** をオプションとして指定します。

## 棒グラフのオプション
<a name="v10-panels-bar-chart-options"></a>

これらのオプションで、視覚化する内容を絞り込みます。

**[Orientation]** (向き)
+ **[自動]** – Grafana は、パネルのディメンションに基づいてバーの向きを決定します。
+ **[水平]** – X 軸をカテゴリ軸にします。
+ **[垂直]** – Y 軸をカテゴリ軸にします。

**[X 軸の目盛ラベルの回転]**

 グラフが垂直方向の場合、この設定はバーの下のラベルを回転させます。この設定は、棒グラフラベルが長く重複している場合に役立ちます。

**[X 軸の目盛ラベルの最大長]**

棒グラフラベルの最大長を設定します。最大長を超えるラベルは省略記号で切り捨てられます。

**[バーラベルの最小間隔]**

バーラベル間の最小間隔を設定します。

**[値の表示]**

値がバーの上部または左側に表示されるかどうかを制御します。
+ **[自動]** – スペースがある場合は値が表示されます。
+ **[常に表示]** – 常に値を表示します。
+ **[常に非表示]** – 常に値を表示しません。

**[積み上げ]**

棒グラフの積み上げを制御します。
+ **[Off]** (オフ) – バーは積み重ねられません。
+ **[普通]** – バーは積み重ねられます。
+ **[パーセント]** – バーは積み重ねられ、各バーの高さは積み重ねの合計の高さの割合です。

**[グループの幅]**

グループの幅を制御します。
+ `0 = Minimum width`
+ `1 = Maximum width`

**[バーの幅]** ()

バーの幅を制御します。
+ `0 = Minimum width`
+ `1 = Maximum width`

**[Bar radius]** (バーの丸角半径)

バーの丸角半径を制御します。
+ `0 = Minimum radius`
+ `0.5 = Maximum radius`

**[カーソル上の全領域をハイライト]**

バーにカーソルを合わせると、バーの周囲全体が強調表示されるかどうかを制御します。

**[線の幅]**

棒の線幅を制御します。

**[塗りつぶしの不透明度]**

棒の塗りつぶしの不透明度を制御します。

**[グラデーションモード]**

グラデーション塗りつぶしモードを設定します。塗りつぶしグラデーションは線の色を基準にします。色を変更するには、標準のカラースキームフィールドオプションを使用します。

グラデーションの外観は**[塗りつぶしの不透明度]**設定の影響を受けます。
+ **[なし]** – グラデーションの塗りつぶしなし。これはデフォルトの設定です。
+ **[不透明度]** – グラデーションの透明度は Y 軸の値に基づいて計算されます。Y 軸の値とともに塗りつぶしの不透明度が増加します。
+ **[色相]** – グラデーション色は線の色相に基づいて生成されます。

**[ツールチップモード]**

視覚化にカーソルを合わせると、Grafana はツールチップを表示できます。ツールチップの動作を選択します。
+ **[単独]** – ツールチップには、グラフ上でカーソルを合わせている系列が 1 つだけ表示されます。
+ **[すべて]** – ツールチップには、グラフ内のすべての系列が表示されます。Grafana は、ツールチップの系列一覧で、カーソルを合わせている系列を太字で強調表示します。
+ **[非表示]** – グラフを操作するときにツールチップを表示しません。

**注記**  
オーバーライドを使用して、ツールチップから個々の系列を非表示にできます。

**[テキストサイズ]**

棒グラフのテキストのサイズを変更する値を入力します。

## 凡例オプション
<a name="v10-panels-bar-chart-legend"></a>

**[凡例モード]**

これらの設定を使用して、グラフで凡例がどのように表示されるかを定義します。詳細については、「[凡例を設定する](v10-panels-configure-legend.md)」を参照してください。
+ **[リスト]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+ **[テーブル]** – 凡例をテーブルとして表示します。
+ **[非表示]** – 凡例を非表示にします。

**[凡例の配置]**

凡例を配置する場所を選択します。
+ **[Bottom]** – グラフの下。
+ **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する系列データ値または標準計算を選択します。複数選択できます。詳細については、「[凡例を設定する](v10-panels-configure-legend.md)」を参照してください。

## 軸オプション
<a name="v10-panels-bar-chart-axis"></a>

次のフィールド設定を使用して、軸の表示方法を絞り込みます。一部のフィールドオプションは、編集するフィールドオプションボックスの外部をクリックするか、Enter キーを押すまで、視覚的表現には影響しません。

**[配置]**

Y 軸の配置を設定します。
+ **[自動]** – Grafana は、Y 軸を系列に自動的に割り当てます。異なるユニットを持つ系列が 2 つ以上ある場合、Grafana は左軸を最初のユニットに、右軸を次のユニットに割り当てます。
+ **[左]** – 左側にすべての Y 軸を表示します。
+ **[右側]** – 右側にすべての Y 軸を表示します。
+ **[非表示]** – すべての Y 軸を非表示にします。

軸を選択的に非表示にするには、特定のフィールドを対象とする[フィールドオーバーライドを追加します](v10-panels-configure-overrides.md)。

**ラベル**

Y 軸テキストラベルを設定します。複数の Y 軸がある場合は、オーバーライドで異なるラベルを割り当てることができます。

**[幅]**

軸の固定幅を設定します。デフォルトでは、Grafana は軸の幅を動的に計算します。

軸の幅を設定することで、異なる軸タイプのデータが同じ表示比率を共有できます。これにより、軸が互いに視覚的に近接して移動または伸張されないため、複数のグラフのデータの価値を簡単に比較できます。

**[ソフト最小値とソフト最大値]**

Y 軸の制限をより適切に制御するために、ソフト最小値またはソフト最大値オプションを設定します。デフォルトでは、Grafana はデータセットに基づいて Y 軸の範囲を自動的に設定します。

ソフト最小値とソフト最大値の設定により、データがほぼフラットなときに、小さな変動が大きな変動に見えるのを防ぎます。また、標準の最小値と最大値のフィールドオプションから派生したハード最小値または最大値により、定義されたポイントを超えたスパイクを切り取ることで、断続的なスパイクが有用な詳細を平坦化することを防げます。

標準最小/最大値オプションを設定して、Y 軸のハード制限を定義できます。詳細については、「[標準オプションを設定する](v10-panels-configure-standard-options.md)」を参照してください。

**[Display multiple y-axes]** (複数の Y 軸を表示)

場合によっては、複数の Y 軸を表示したい場合があります。例えば、経時的な温度と湿度の両方を示すデータセットがある場合、これらの 2 つの系列で異なる単位を持つ 2 つの y 軸を表示したいとします。

これを行うには、[フィールドオーバーライドを追加します](v10-panels-configure-overrides.md)。必要な回数だけステップに従うことで、必要な数の y 軸を追加できます。

# 棒ゲージ
<a name="v10-panels-bar-gauge"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

棒ゲージは、すべてのフィールドを 1 つの値にまとめて表示することで、データを簡素化します。Grafana がまとめるにあたり、計算方法を選択します。

このパネルには、クエリの結果によって、1 つまたは複数の棒ゲージを表示できます (データが複数の系列、行、または列で構成されている場合など)。

![\[Grafana の棒ゲージ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## 値オプション
<a name="v10-panels-bar-gauge-value"></a>

次のオプションを使用して、視覚化で値を表示する方法を絞り込みます。

**[表示]**

Grafana がデータを表示する方法を選択します。

**[計算]**

すべての行を元に計算した値を表示します。
+ **[計算]** – Grafana が多くのフィールドを 1 つの値に減らすために使用する reducer 関数を選択します。使用可能な計算の一覧については、「[計算タイプ](v10-panels-calculation-types.md)」を参照してください。
+ **[フィールド]** – パネルに表示されるフィールドを選択します。

**[すべての値]**

行ごとに個別の統計を表示します。このオプションを選択すると、表示する行数を制限することもできます。
+ **[制限]** – 表示する行の最大数。デフォルトは 5,000 です。
+ **[フィールド]** – パネルに表示されるフィールドを選択します。

## 棒ゲージオプション
<a name="v10-panels-bar-gauge-options"></a>

棒ゲージの表示方法を設定します。

**[Orientation]** (向き)

積み重ね方向を選択します。
+ **[自動]** – Grafana が最適な方向を選択します。
+ **[水平]** – バーは水平方向に左から右に伸びます。
+ **[垂直]** – バーは垂直に下から上に伸びます。

**Display mode (表示モード)**

表示モードを選択します。
+ **グラデーション]** – しきい値レベルはグラデーションを定義します。
+ **[Retro LCD]** – ゲージを小さなセルに分け、点灯または消灯させて表示します。
+ **[基本]** – 一致するしきい値に基づいて単一色で表示します。

**[Value display] (値の表示)**

値の表示モードを選択します。
+ **[Value color]** – 値の色は値によって決まります。
+ **[テキスト色]** – 値の色はデフォルトのテキスト色です。
+ **[非表示]** – 値は非表示です。

**[名前配置]**

名前配置モードを選択します。

**注記**  
このオプションは、棒ゲージの向きが水平の場合にのみ適用されます。棒ゲージが垂直方向にある場合、名前は常に各バーゲージの下に配置されます。
+ **[自動]** – Grafana が最適な配置を決定します。
+ **[Top]** – 名前は各棒ゲージの上部に配置されます。
+ **[左]** – 名前は各棒ゲージの左側に配置されます。

**[塗りつぶされていない領域を表示]**

バーの塗りつぶされていない領域を濃い灰色で表示する場合は、このオプションを選択します。Retro LCD 表示モードには適用されません。

**[Bar size] (バーサイズ)**

バーサイズモードを選択します。
+ **[自動]** – Grafana が最適な棒ゲージサイズを決定します。
+ **[Manual]** (手動) – 棒ゲージのサイズを手動で設定します。

**[最小幅]**

ゲージが垂直方向のときは、バーの列の最小幅を制限します。

大量のデータがある場合、X 軸スクロールバーを自動的に表示します。

**注記**  
このオプションは、バーサイズが手動に設定されている場合にのみ適用されます。

**[最小高さ]**

ゲージが水平方向のときは、バーの行の最小高さを制限します。

大量のデータがある場合、Y 軸スクロールバーを自動的に表示します。

**注記**  
このオプションは、バーサイズが手動に設定されている場合にのみ適用されます。

**[最大高さ]**

ゲージが水平方向のときは、バーの行の最大高さを制限します。

大量のデータがある場合、Y 軸スクロールバーを自動的に表示します。

**注記**  
このオプションは、バーサイズが手動に設定されている場合にのみ適用されます。

# ローソク足チャート
<a name="v10-panels-candlestick"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ローソク足チャートの作成により、価格変動に焦点を当てた多数の一貫したディメンションを含むデータを視覚化できます。ローソク足パネルには、OHLC (Open-High-Low-Close: 始値、高値、安値、終値) モードと、時系列データに基づく追加のディメンションのサポートが含まれています。

![\[Grafana でローソク足チャート作成の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/candlestick-panel-example.png)


ローソク足チャートの作成は、[時系列](v10-panels-time-series.md) の基礎に基づいて構築され、多くの一般的な設定が含まれています。

## モード
<a name="v10-panels-candlestick-mode"></a>

モードオプションを使用すると、視覚化に使用されるディメンションを切り替えられます。
+ **[Candles]** (ローソク) – パネルのディメンションを、ローソク足チャートの作成で使用される始値、高値、安値、終値のディメンションに制限します。
+ **[Volume]** (ボリューム) – パネルディメンションをボリュームディメンションに制限します。
+ **[Both]** (両方) - ローソク足パネルのデフォルトの動作です。これには、ローソク足とボリュームの両方の視覚化が含まれます。

## Candle style (ローソクのスタイル)
<a name="v10-panels-candlestick-style"></a>
+ **[Candles]** – デフォルトの表示スタイルでは、始値ディメンションと終値ディメンションとの間にローソクスタイルの視覚化が作成されます。
+ **[OHLC 棒]** – 4 つのコアディメンションである始値、高値、安値、終値を表示します。

## Color strategy (カラー戦略)
<a name="v10-panels-candlestick-color"></a>
+ **[始値から]** – デフォルトの動作。このモードは、期間内の料金変動が正の場合、*Up* カラー (下部) を使用します。つまり、クローズ時の値がオープン時の値以上である場合、*Up* カラーが使用されます。
+ **[前の終値以降]** は、ローソクの色が中間期の価格変動または値の変化に基づいている代替の表示方法です。つまり、オープン時の値がクローズ時の以前の値より大きい場合、*Up* カラーが使用されます。オープン時の値がクローズ時の以前の値よりも低い場合、*Down* カラーが使用されます。*このオプションでは、中空ローソク足グラフ作成モードもトリガーされます*。中空ローソク足は、期間内の変動が正 (値はオープン時よりもクローズ時が高い) であることを示します。塗りつぶされたローソク足は、期間内の変動が負 (値はオープン時よりもクローズ時が低い) であることを示します。詳細については、 「[違いの説明](https://thetradingbible.com/how-to-read-hollow-candlesticks)」を参照してください。

## アップカラーとダウンカラー
<a name="v10-panels-candlestick-updown"></a>

**[Up color]** と **[Down color]** オプションは、料金変動がアップまたはダウンするときにどの色を使用するかを選択します。上記の*カラー戦略*は、ローソクまたは OHLC バーの色を選択するために、期間内または中間期の料金変動を使用するかどうかを決定します。

## 始値、高値、安値、終値
<a name="v10-panels-candlestick-ohlc"></a>

ローソク足パネルは、フィールドを適切なディメンションにマッピングしようとします。
+ **[始値]** は、指定された期間の開始値に対応します。
+ **[高値]** は、指定された期間の最大値に対応します。
+ **[安値]** は、指定された期間の最小値に対応します。
+ **[終値]** は、指定された期間の最終 (終了) 値に対応します。
+ **[ボリューム]** は、特定の期間のサンプル数に対応します。(取引数など)

**注記**  
ローソク足の凡例は、これらの値を表示しません。

これらのディメンションを適切にマッピングするには、データからのクエリ結果テーブルに*少なくとも*次の列が含まれている必要があります。
+ `timestamp`
+ `open`
+ `high`
+ `low`
+ `close`

何らかの理由でデータをこれらのディメンションにマッピングできない場合 (列名が同じでない場合など)、パネルエディタの**ローソク足**オプションの下にある**始値**、**高値**、**安値**、および**終値**フィールドを使用して手動でマッピングできます。

## 追加フィールド
<a name="v10-panels-candlestick-other"></a>

**追加フィールド**

ローソク足パネルは時系列の視覚化に基づいています。始値、高値、安値、終値、ボリューム以外の追加のデータディメンションを視覚化できます。**[含める]** オプションと **[無視]** オプションを使用すると、[時系列](v10-panels-time-series.md) で使用できるのと同じスタイルと設定を使用して、単純な移動平均、ボリンジャーバンドなど、含まれている他のデータを視覚化できます。

# キャンバス
<a name="v10-panels-canvas"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

キャンバスは Grafana の権限とカスタム要素の柔軟性を組み合わせています。キャンバスは、静的レイアウトと動的レイアウトに要素を明示的に配置できる拡張可能なフォームビルドパネルです。これにより、Grafana の UI 内全体で、標準の Grafana パネルでは不可能な方法でカスタムビジュアライゼーションとオーバーレイデータを設計できます。一般的な UI およびウェブ設計ツールを使用したことがある場合、キャンバスパネルの設計は非常に馴染みのあるものになります。

## [Elements] (要素)
<a name="v10-panels-canvas-elements"></a>

これらの要素はキャンバスに追加できます。複数の異なる種類の要素を追加すると、他の視覚化では不可能な方法で視覚化をカスタマイズできます。

**メトリクス値**

メトリクス値要素を使用すると、キャンバスに表示するデータを簡単に選択できます。この要素には、コンテキストメニューの*編集*オプションを通じて、またはパネルをダブルクリックしてトリガーできる一意の**編集**モードがあります。編集モードでは、表示するフィールドデータを選択できます。

**[テキスト]**

テキスト要素を使用すると、キャンバスにテキストを簡単に追加できます。また、要素は、ダブルクリックまたはコンテキストメニューの編集メニューオプションによってトリガーされる編集モードもサポートします。

**[Ellipse]** (楕円)

楕円要素を使用すると、基本的な楕円をキャンバスに追加できます。楕円要素はテキスト (固定データとフィールドデータの両方) を表示でき、背景色はデータしきい値に基づいて変更できます。

**[Rectangle]** (長方形)

長方形要素を使用すると、基本的な長方形をキャンバスに追加できます。長方形要素はテキスト (固定データとフィールドデータの両方) を表示でき、背景色はデータしきい値に基づいて変更できます。

**[Icon]** (アイコン)

アイコン要素を使用すると、サポートされているアイコンをキャンバスに追加できます。アイコンは、しきい値または値マッピングに基づいて色を設定できます。

**[Server]** (サーバー)

サーバー要素を使用すると、単一のサーバー、サーバーのスタック、データベース、またはターミナルを簡単に表現できます。サーバー要素は、ステータスの色、電球の色、電球の点滅レートをサポートし、すべて固定値またはフィールド値で設定できます。

**[Button]** (ボタン)

ボタン要素を使用すると、基本的なボタンをキャンバスに追加できます。ボタン要素は、認証されていない基本的な API コールのトリガーをサポートします。API 設定は、ボタン要素エディタにあります。API エディタでテンプレート変数を渡すこともできます。

**注記**  
ボタンを選択すると、インライン編集が無効になっている場合にのみ API コールがトリガーされます。「[Canvas の編集](#v10-panels-canvas-editing)」を参照してください。

## Connections
<a name="v10-panels-canvas-connections"></a>

キャンバスを構築するときは、要素を連結してより複雑な視覚化を作成できます。ある要素の接続アンカーから別の要素の接続アンカーにドラッグすることで、接続を作成できます。キャンバスの背景への接続を作成することもできます。接続アンカーは、要素にカーソルを合わせ、インライン編集がオンになると表示されます。接続を削除するには、接続を選択し、`Delete` または `Backspace` を押します。

固定値またはフィールド値に基づいて、接続のサイズと色の両方を設定できます。これを行うには、パネル編集モードに入り、接続を選択し、パネルエディタで接続のプロパティを変更します。

## Canvas の編集
<a name="v10-panels-canvas-editing"></a>

**[インラインエディタ]**

ダッシュボードモードのコンテキストでは、キャンバスをインラインで編集できます。

**Pan and zoom (パンとズーム)**

キャンバスのパンとズームをオンにします。これにより、より複雑な設計を作成およびナビゲートできます。

**注記**  
パンとズームは現在 Grafana Labs によってプレビューされています。サポートには制限があり、一般提供の前に重要な変更が発生する可能性があります。

**コンテキストメニュー**

コンテキストメニューを使用すると、一般的なタスクを迅速かつ効率的に実行できます。サポートされている機能には、インラインエディタの開閉、要素の複製、要素の削除などがあります。

コンテキストメニューは、パネルまたは特定のキャンバス要素に対する右クリックアクション (または同等のもの) によってトリガーされます。

*パネル*を右クリックすると、背景イメージを設定し、キャンバスに要素を簡単に追加できます。

*要素*を右クリックすると、要素を編集、削除、複製したり、要素のレイヤーの位置を変更したりできます。

## キャンバスオプション
<a name="v10-panels-canvas-options"></a>

**インライン編集**

インライン編集トグルを使用すると、キャンバスパネルをロックまたはロック解除できます。オフにすると、キャンバスパネルが*ロック*され、要素が所定の位置にフリーズし、意図しない変更を防止できます。

**データリンク**

キャンバスは[データリンク](v10-panels-configure-data-links.md)をサポートしています。以下の手順に従って、メトリクス値要素のデータリンクを作成し、フィールド名を使用するすべての要素に対して表示できます。

**要素のデータリンクを作成するには**

1. フィールド値に関連付ける要素を設定します。

1. インライン編集トグルをオフにします。

1. **[名前付きフィールド]** のオーバーライドを作成し、リストから要素フィールド名を選択します。

1. **[オーバーライドプロパティの追加]** ボタンを選択します。

1. リストから **[Datalinks > Datalinks]** を選択します。

1. **[\$1 リンクを追加]** を選択し、データリンクのタイトルと URL を追加します。

1. 要素にカーソルを合わせると、データリンクのツールチップが表示されます。

1. データリンクを開くことができる要素を選択します。

複数の要素が同じフィールド名を使用し、どの要素がデータリンクを表示するかを制御したい場合は、[計算からのフィールドの追加](v10-panels-xform-functions.md#v10-panels-xform-funcs-add) 変換を使用して一意のフィールド名を作成できます。変換で作成したエイリアスは、要素とともに使用できるフィールドとして表示されます。

# ダッシュボードの一覧表示
<a name="v10-panels-dashboard-list"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ダッシュボードリストを使用すると、他のダッシュボードへの動的リンクを表示できます。リストは、スター付きダッシュボード、最近表示されたダッシュボード、検索クエリ、ダッシュボードタグを使用できるよう設定が可能です。

ダッシュボードのロードごとに、このパネルはダッシュボードリストに対してクエリを実行し、常に最新の結果を表示します。

**オプション**

これらのオプションで、視覚化する内容を絞り込みます。
+ **[現在の時間範囲を含める]** – このオプションを選択すると、現在のダッシュボードの時間範囲がダッシュボードリンクに反映されます。ユーザーがリンクを選択すると、リンクされたダッシュボードが開き、指定された時間範囲が既に設定されています。
+ **[現在のテンプレート変数値を含める]** – このオプションを選択すると、リンクに現在クエリパラメータとして使用されているテンプレート変数を含めることができます。ユーザーがリンクを選択すると、リンクされたダッシュボード内の一致するテンプレートがリストからの値に設定されます。詳細については、「[ダッシュボード URL 変数](v10-dash-dashboard-url-variables.md)」を参照してください。
+ **[Starred]** (スター付き) – スター付きダッシュボードをアルファベット順に表示します。
+ **[最近表示]** – 最近表示したダッシュボードをアルファベット順に表示します。
+ **[検索]** – 検索クエリまたはタグでダッシュボードを表示します。**クエリ**または**タグ**に少なくとも 1 つの値を入力する必要があります。**クエリ**フィールドと**タグ**フィールドでは、`$my_var` や `${my_var}` など、変数補間がサポートされています。
+ **[見出しの表示]** – 選択したリスト選択 (スター付き、最近表示、検索) が見出しとして表示されます。
+ **[最大項目数]** – セクションごとに一覧表示する項目の最大数を設定します。例えば、これをデフォルト値の 10 のままにして、スター付きダッシュボードと最近表示ダッシュボードを表示した場合、パネルには各セクションに 10 個、合計 20 個のダッシュボードが表示されます。

**[検索]**

これらのオプションは、**検索**オプションが選択されている場合にのみ適用されます。
+ **[クエリ]** – 検索するクエリを入力します。クエリでは大文字と小文字が区別されず、部分的な値も受け入れられます。
+ **[フォルダ]** – 表示するダッシュボードフォルダを選択します。
+ **[タグ]** – ここに検索するタグを入力します。既存のタグは入力時に表示されず、大文字と小文字*が*区別されます。

**注記**  
複数のタグと文字列が表示されると、ダッシュボードリストに*すべての*条件に一致するタグと文字列が表示されます。

# データグリッド
<a name="v10-panels-datagrid"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

**注記**  
データグリッドの視覚化は現在、Grafana Labs によるプレビュー段階です。サポートには制限があり、一般提供の前に重要な変更が発生する可能性があります。

データグリッドでは、Grafana 内でデータの作成、編集、ファインチューニングが可能です。そのため、このパネルはダッシュボード内の他のパネルのデータソースとして機能します。

![\[Grafana のデータグリッド視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/datagrid-panel-example.png)


これにより、任意のデータソースからクエリされたデータを操作したり、白紙状態から開始したり、ドラッグアンドドロップされたファイルからデータを取得したりできます。その後、パネルを単純な表形式の視覚化として使用したり、データを変更したり、完全に削除して白紙状態を作成したりできます。

データセットを編集すると、組み込みの **[Grafana]** データソースを使用するようにデータソースが変更され、古いデータソース設定と関連するクエリが置き換えられます。また、現在のデータセットをダッシュボードモデルにコピーします。

その後、組み込みの **ダッシュボード** データソースを使用してデータグリッドデータを取得することで、パネルを他のパネルのデータソースとして使用できます。これにより、インタラクティブなダッシュボードエクスペリエンスが提供され、データを変更したり、他のパネルに反映された変更を確認したりできます。

**Grafana** および **ダッシュボード** データソースの詳細については、「[特別なデータソース](AMG-data-sources.md#AMG-data-sources-special)」を参照してください。

## コンテキストメニュー
<a name="v10-panels-datagrid-context"></a>

より合理化されたエクスペリエンスを提供するために、データグリッドには、セル、列ヘッダー、または行セレクタを右クリックしてアクセスできるコンテキストメニューがあります。データグリッドの状態に応じて、コンテキストメニューには次のようなさまざまなオプションが用意されています。
+ すべての行と列を削除またはクリアします。
+ 既存のデータをすべて削除します (データグリッドを空白にします)。
+ トリガー検索機能により、データセット内のキーワードを検索できます。

行または列を削除するとデータグリッドからデータが削除されますが、行または列をクリアするとセルからデータのみが削除され、行または列はそのまま残ります。

**ヘッダーメニュー**

ヘッダータイトルの横にあるドロップダウンアイコンを選択して、ヘッダーメニューにアクセスすることもできます。ここから、列を削除またはクリアするだけでなく、名前の変更、フリーズ、列のフィールドタイプの変換もできます。

## 系列の選択
<a name="v10-panels-datagrid-selectseries"></a>

複数の系列がある場合は、パネルオプションの **[系列の選択]** ドロップダウンを使用して、任意のデータセットを表示するようにデータグリッドを設定できます。

## データグリッドの使用
<a name="v10-panels-datagrid-using"></a>

データグリッドは、データを操作するさまざまな方法を提供します。行と列を編集、移動、クリア、削除したり、組み込みの検索機能を使用して特定のデータを検索したり、フィールドタイプを変換したり、特定の列の水平スクロールをフリーズしたりできます。

**データの追加**

新しい列または行を作成することで、データグリッドにデータを追加できます。

**新しい列を追加するには**

1. 既存のパネルで、最後の列の後にテーブルヘッダーの **[\$1]** ボタンを選択します。

1. 新しい列の名前を追加します。

1. フィールド外の任意の場所を選択するか、`Enter` を押して列を保存します。

これで、各セルにデータを追加できます。

新しい行を追加するには、最後の行の後に **[\$1]** ボタンを選択します。ボタンは最後の行の後にある各セルに存在し、これを選択すると、選択したセルもアクティブ化しながら、新しい行の作成がトリガーされます。

**データの編集**

必要に応じて列と行を移動できます。

**列を移動するには**

1. 移動する必要がある列のヘッダーを長押しします。

1. 列を目的の場所にドラッグします。

1. 列を放して移動を確定します。

行を移動するには、グリッドの左端にある数値列から行セレクタを選択して長押しし、目的の場所にドラッグします。行を放して移動を確定します。

**複数のセルの選択**

1 つのセルを選択し、他のセル間でドラッグすることで、複数のセルを選択できます。この選択を使用して、選択したセルからデータをコピーしたり、`Delete` キーを使用して削除したりできます。

**複数の行または列の削除またはクリア**

複数の行を削除またはクリアするには、以下を実行します。

**複数の行または列を削除またはクリアするには**

1. 数値列 (グリッドの最初の列左側) にカーソルを合わせると、行チェックボックスが表示されます。

1. 操作する行のチェックボックスを選択します。複数の連続する行を選択するには、`Shift` キーを押しながら、最初と最後の行をクリックします。連続しない行を選択するには、`Ctrl` (または `Cmd`) キーを押しながら目的の行をクリックします。

1. コンテキストメニューにアクセスするには、右クリック (または対応する操作) をします。

1. **[行の削除]** または **[行のクリア]** を選択します。

列ヘッダーをクリックすると、同じルールが列に適用されます。

すべての行を削除するには、データグリッドの左上隅にある **[すべて選択]** チェックボックスを使用します。これにより、すべての行が選択され、コンテキストメニューを使用して行を削除できます。

# フレームグラフ
<a name="v10-panels-flamegraph"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

フレームグラフを使用すると、プロファイリングデータを視覚化できます。この視覚化を使用すると、プロファイルをフレームグラフ、テーブル、またはその両方として表すことができます。

![\[Grafana のフレームグラフ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/flamegraph-panel-example.png)


## フレームグラフモード
<a name="v10-panels-flamegraph-mode"></a>

フレームグラフは、プロファイリングデータの階層的な性質を活用します。データを形式に集約することで、メモリを測定するときに、CPU 時間、割り当てられたオブジェクト、スペースなど、どのコードパスが最もシステムリソースを消費しているかを簡単に確認できます。フレームグラフの各ブロックはスタック内の関数呼び出しを表し、ブロックの幅は値を表します。

グレーアウトされたセクションは、比較的小さな値を表す関数のセットであり、パフォーマンス上の理由から 1 つのセクションにまとめられます。

特定の関数にカーソルを合わせると、関数の値、合計値の割合、その関数のサンプル数など、その関数に関する追加データを示すツールチップを表示できます。

**ドロップダウンアクション**

関数をクリックして、追加のアクションを含む以下のドロップダウンメニューを表示できます。
+ **[Focus block]** (フォーカスブロック) - **フォーカスブロック**を選択すると、ブロックまたは関数はフレームグラフの幅の 100% に設定され、そのすべての子関数が親関数の幅に対して更新された幅で表示されます。これにより、フレームグラフの小さな部分にドリルダウンしやすくなります。
+ **[コピー関数名]** - **[コピー関数名]**を選択すると、ブロックが表す関数のフルネームがコピーされます。
+ **[サンドウィッチビュー]** – サンドウィッチビューでは、クリックされた関数のコンテキストを表示できます。関数のすべての呼び出し元が上部に表示され、すべての呼び出し先が下部に表示されます。これは関数の集約コンテキストを示すため、関数がフレームグラフの複数の場所に存在する場合、すべてのコンテキストがサンドウィッチビューに表示され、集約されます。

**ステータスバー**

 ステータスバーには、フレームグラフと現在適用されている変更に関するメタデータが表示されます。例えば、グラフのどの部分がフォーカスされているか、どの関数がサンドイッチビューに表示されるかなどです。ステータスバーのプルダウンにある **[X]** をクリックして、その変更を削除します。

## ツールバー
<a name="v10-panels-flamegraph-toolbar"></a>

**[検索]**

検索フィールドを使用して、特定の名前の関数を検索できます。検索に一致するフレームグラフのすべての関数では色はそのままで、残りの関数はグレーアウトされます。

**Color schema picker** (カラースキーマピッカー)

色付け関数を値またはパッケージ名で切り替えて、同じパッケージから関数を視覚的に結び付けることができます。

**[テキスト配置]**

ブロックに収まらない場合、テキストを左または右に揃えて、関数名のより重要な部分を表示できます。

**視覚化ピッカー**

フレームグラフのみ、テーブルのみ、またはその両方を同時に表示することを選択できます。

## トップテーブルモード
<a name="v10-panels-flamegraph-toptablemode"></a>

トップテーブルは、プロファイルの関数を表形式で示しています。テーブルには、symbols、self、total (記号、自己、合計) の 3 つの列があります。テーブルはデフォルトでセルフタイムでソートされますが、列ヘッダーをクリックして合計時間またはシンボル名で並べ替えることができます。関数がプロファイル内の複数の場所に表示される場合、各行は特定の関数の集計値を表します。

行ごとに左側にアクションボタンもあります。最初のボタンは関数名を検索し、2 番目のボタンは関数のサンドウィッチビューを表示します。

## Data API
<a name="v10-panels-flamegraph-dataapi"></a>

フレームグラフをレンダリングするには、[[ネストされたセットモデル]](https://wikipedia.org/wiki/Nested_set_model)を使用してデータフレームのデータをフォーマットする必要があります。

ネストされたセットモデルは、フレームグラフの各項目が整数値、メタデータ、およびデータフレーム内の順序としてネストレベルによってのみエンコードされるようにします。つまり、項目の順序は重要であり、正しい必要があります。順序付けは、フレームグラフ内の項目の深さ優先探索であり、子配列のようにデータフレームに可変長値を使用せずにグラフを再作成します。

必須フィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
| level | 数値 | 項目のネストレベル。つまり、この項目とフレームグラフの上位項目の間にある項目の数。 | 
| 値 | 数値 | 項目の絶対値または累積値。これは、グラフ内の項目の幅に変換される。 | 
| ラベル | string | 特定の項目に表示されるラベル。 | 
| self | 数値 | 通常、項目の累積値から直近の子の累積値の合計を引いた自己値。 | 

# ゲージ
<a name="v10-panels-gauge"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ゲージは、各系列、列、または行に対してゲージを繰り返すことができる単一値の視覚化です。

![\[Grafana のゲージ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/gauge_example.png)


## 値オプション
<a name="v10-panels-gauge-value"></a>

次のオプションを使用して、視覚化で値を表示する方法を絞り込みます。

**[表示]**

Grafana がデータを表示する方法を選択します。

*[計算]*

すべての行を元に計算した値を表示します。
+ **[計算]** – Grafana が多くのフィールドを 1 つの値に減らすために使用する reducer 関数を選択します。使用可能な計算のリストについては、「[計算タイプ](v10-panels-calculation-types.md)」を参照してください。
+ **[フィールド]** – パネルに表示するフィールドを選択します。

*[すべての値]*

行ごとに個別の統計を表示します。このオプションを選択すると、表示する行数を制限することもできます。
+ **[制限]** – 表示する行の最大数。デフォルトは 5,000 です。
+ **[フィールド]** – パネルに表示するフィールドを選択します。

## ゲージ
<a name="v10-panels-gauge-gauge"></a>

ゲージの表示方法を設定します。

**[Orientation]** (向き)

積み重ね方向を選択します。
+ **[自動]** – ゲージは行と列で表示されます。
+ **[水平]** – ゲージは上から下に表示されます。
+ **[垂直]** – ゲージは左から右に表示されます。

**[しきい値ラベルの表示]**

しきい値を表示するかどうかを制御します。

**[しきい値マーカーの表示]**

しきい値バンドを内部ゲージ値バンドの外部に表示するかどうかを制御します。

**[ゲージサイズ]**

ゲージサイズモードを選択します。
+ **[自動]** – Grafana が最適なゲージサイズを決定します。
+ **[Manual]** (手動) – ゲージサイズを手動で設定します。

**[最小幅]**

垂直方向ゲージの最小幅を設定します。

最小幅を設定すると、大量のデータがある場合、X 軸スクロールバーが自動的に表示されます。

**注記**  
このオプションは、ゲージサイズが手動に設定されている場合にのみ適用されます。

**[最小高さ]**

水平方向のゲージの最小高さを設定します。

最小高さを設定すると、大量のデータがある場合、Y 軸スクロールバーが自動的に表示されます。

**注記**  
このオプションは、ゲージサイズが手動に設定されている場合にのみ適用されます。

**[Neutral]** (ニュートラル)

すべてのゲージを埋める開始値を設定します。

## テキストサイズ
<a name="v10-panels-gauge-textsize"></a>

ゲージテキストのサイズを調整します。
+ **[タイトル]** – ゲージタイトルサイズの数値を入力します。
+ **[値]** – ゲージ値サイズの数値を入力します。

# ジオマップ
<a name="v10-panels-geomap"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ジオマップを使用すると、地理空間データを用いて世界地図を表示、カスタマイズできます。さまざまなオーバーレイスタイルとマップビュー設定を設定して、データの重要な位置情報に注目しやすくすることができます。

**注記**  
が提供するベースマップレイヤーの上に独自の地理空間データを追加できます AWS。ベースマップレイヤーはすべて [https://tiles.maps.search-services.aws.a2z.com](https://tiles.maps.search-services.aws.a2z.com) から取得する必要があります。

![\[Grafana のジオマップ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/geomap-panel-example.png)


## マップビュー
<a name="v10-panels-geomap-view"></a>

マップビューは、ダッシュボードのロード時にマップの初期ビューを制御します。

**[初期ビュー]**

初期ビューは、パネルが最初にロードされたときに GeoMap パネルがどのようにレンダリングされるかを設定します。
+ **[ビュー]** は、パネルが最初にロードされたときにマップの中心を設定します。
  + **[Fit to data]** は、データが変更されたときのマップレイヤーと更新のデータ範囲に基づいてマップビューに適合します。
    + **[データ]** オプションでは、*[すべてのレイヤー]* のデータ、単一の *[レイヤー]*、または選択したレイヤーの *[最後の値]* に基づいて範囲を選択できます。
    + **[レイヤー]** において、単一の *[Layer]* (レイヤー) またはレイヤーの *[最後の値]* からデータをフィッティングする場合に選択できます。
    + **[パディング]** は、データ範囲を超えた相対的な割合でパディングを設定します (*[最後の値]* のみを参照する場合は使用できません)。
    + **[Max Zoom]** は、データをフィッティングするときに最大ズームレベルを設定します。
  + **[座標]** は、以下に基づいてマップビューを設定します。
    + **Latitude** (緯度)
    + **Longitude** (経度)
  + デフォルトビューには、以下を含むものもあります。
    + **(0°, 0°)**
    + **北米**
    + **南米**
    + **欧州**
    + **アフリカ**
    + **西アジア**
    + **南アジア**
    + **東南アジア**
    + **東アジア**
    + **オーストラリア**
    + **オセアニア**
+ **[Zoom]** は、初期ズームレベルを設定します。

## レイヤーのマッピング
<a name="v10-panels-geomap-layers"></a>

ジオマップでは、複数のレイヤーの表示がサポートされています。各レイヤーは、ベースマップ上に地理空間データをどのように表示するかを決定します。

**タイプ**

ジオマップの視覚的表現では、3 つのマップレイヤータイプを選択できます。
+ [マーカーレイヤー](#v10-panels-geomap-markers) は、各データポイントにマーカーをレンダリングします。
+ [ヒートマップレイヤー](#v10-panels-geomap-heatmap) はデータのヒートマップを視覚化します。
+ [GeoJSON レイヤー](#v10-panels-geomap-geojson) は GeoJSON ファイルから静的データをレンダリングします。
+ [夜間/昼間レイヤー (アルファ）](#v10-panels-geomap-nightday) は夜間または昼間のリージョンをレンダリングします。
+ [ルートレイヤー (プレビュー)](#v10-panels-geomap-route) データポイントをルートとしてレンダリングします。
+ [写真レイヤー (プレビュー)](#v10-panels-geomap-photos) は、各データポイントに写真をレンダリングします。
+ [ネットワークレイヤー (プレビュー)](#v10-panels-geomap-network) は、データからネットワークグラフを視覚化します。

また、実験 (またはアルファ) レイヤータイプも 2 つあります。
+ **[Icon at last point (alpha)]** は、最後のデータポイントにアイコンをレンダリングします。
+ **[Dynamic GeoJSON (alpha)]** は、クエリ結果に基づいて GeoJSON ファイルをスタイルします。

**注記**  
パブリック*プレビュー*でプレビューまたは*アルファ*とマークされたレイヤーです。Grafana Labs ではサポートが限られており、この機能が一般公開される前に重要な変更が発生する可能性があります。

**[レイヤーコントロール]**

レイヤーコントロールを使用すると、レイヤーの作成、名前の変更、レイヤーの順序の変更、削除を行うことができます。
+ **[レイヤーの追加]** で、ジオマップ用に設定可能な追加のデータレイヤーを作成できます。レイヤーを追加すると、レイヤータイプを選択するように求められます。レイヤータイプは、パネル設定中にいつでも変更できます。
+ レイヤーコントロールを使用すると、パネルのレイヤーの名前変更、削除、順序変更をすることができます。
  + **[レイヤー名の編集]** (鉛筆アイコン) でレイヤーの名前を変更できます。
  + **[Trash Bin]** (ごみ箱) でレイヤーを削除できます。
  + **[Reorder]** (順序変更) (6 つのドット/グラブハンドル) では、レイヤーの順序を変更できます。上位レイヤーのデータは、下位レイヤーのデータの上に表示されます。視覚化では、レイヤーの順序の選択を簡素化するために、ドラッグアンドドロップするとレイヤーの順序が更新されます。

1 つのジオマップパネルに複数のデータレイヤーを追加して、リッチで詳細な視覚化を作成できます。

**場所**

ジオマップには、地理的データの情報源が必要です。このデータには 4 つのマッピングオプションがあり、データベースクエリを使用して取得します。
+ **[自動]** でロケーションデータを自動的に検索します。クエリがデータフィールドの次のいずれかの名前に基づいている場合は、このオプションを使用します。
  + *geohash*: `geohash`
  + *latitude*: `latitude`, `lat` 
  + *longitude*: `longitude`, `lng`, `lon` 
  + *[ルックアップ]*: `lookup`
+ **Coords** (座標): クエリに座標データが含めることを指定します。データベースクエリから、緯度と経度の数値データフィールドを選択するよう求められます。
+ **Geohash** (ジオハッシュ): クエリがジオハッシュデータが含めることを指定します。データベースクエリから、ジオハッシュの文字列データフィールドを選択するよう求められます。
+ **[ルックアップ]**: クエリに値にマッピングする必要があるロケーション名データが含めることを指定します。データベースクエリと地名索引からルックアップフィールドを選択するよう求められます。地名索引は、クエリされたデータを地理的ポイントにマッピングするために使用されるディレクトリです。

## マーカーレイヤー
<a name="v10-panels-geomap-markers"></a>

マーカーレイヤーを使用すると、データポイントを円、正方形、三角形、星などのさまざまな形のマーカーとして表示することができます。

マーカーには多くのカスタマイズオプションがあります。
+ **[サイズ]** ではマーカーのサイズを設定します。デフォルトは `Fixed size` です。これにより、すべてのマーカーサイズはデータに関係なく同じになります。ただし、選択したフィールドに対応するデータに基づいてマーカーのサイズを変更するオプションもあります。マーカーレイヤーがこの範囲内でスケールできるように、`Min` と `Max` のマーカーサイズを設定する必要があります。
+ **[Symbol]** を使用すると、データに追加のビジュアルコンテキストを提供するのに役立つシンボル、アイコン、またはグラフィックを選択できます。シンプルな記号や Unicon ライブラリなど、Grafana に含まれているアセットから選択します。画像アセットを含む URL を指定することもできます。画像は SVG (Scalable Vector Graphics: スケーラブルベクトルグラフィック) である必要があります。
+ **[Symbol Vertical Align]** では、データポイントに対するシンボルの垂直配置を設定します。なお、シンボルの回転角度は、まずデータポイントの周囲に適用され、次に垂直方向のアライメントがシンボルの回転に対して適用されます。
+ **[Symbol Horizontal Align]** では、データポイントに対するシンボルの水平配置を設定します。シンボルの回転角度は、まずデータポイントの周囲に適用され、次に水平方向のアライメントがシンボルの回転に対して適用されます。
+ **Color** ではマーカーの色を設定します。デフォルト `Fixed color` では、すべてのマーカーを特定の色に設定します。**標準オプション**セクションで選択したフィールドデータポイント値とカラースキーム設定に応じて、条件付き色を使用するオプションもあります。
+ **[塗りつぶしの透明度]**: 各マーカーの透明度を設定します。
+ **[Rotation angle]** では、各マーカーの回転角度を設定します。デフォルトは **[Fixed value]** (固定値) です。これにより、データに関係なくすべてのマーカーが同じ角度で回転しますが、選択したフィールドに対応するデータに基づいてマーカーの回転を設定するオプションもあります。
+ **[テキストラベル]** では、マーカーごとにテキストラベルを設定します。
+ **[凡例の表示]** を使用すると、レイヤーの凡例を切り替えることができます。
+ **[Display tooltip]** (ツールチップの表示) を使用すると、レイヤーのツールチップを切り替えることができます。

## ヒートマップレイヤー
<a name="v10-panels-geomap-heatmap"></a>

ヒートマップレイヤーは、さまざまなデータポイントをクラスター化して、密度の異なる場所を視覚化します。

![\[Grafana のジオマップ視覚化を使用したヒートマップの例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/geomap-heatmap-example.png)


ヒートマップレイヤーを追加するには

[Data レイヤー] のドロップダウンメニューを選択し、`Heatmap` を選択します。

`Markers` と同様に、視覚化するデータポイントとその視覚化方法を決定するオプションが表示されます。
+ **[重み値]** では、ヒートマップクラスターの強度を設定します。**[固定値]** を選択すると、すべてのデータポイントに対して一定の重みが適用されます。この値は 0～1 の範囲で設定します。マーカーと同様に、ドロップダウンには、データ値に応じて重み値を自動的にスケールする代替オプションがあります。
+ **[Radius]** (半径): ヒートマップクラスターのサイズを設定します。
+ **[Blur]** (ぼかし) では、各クラスターのぼかしの量を設定します。
+ **[不透明度]** では、各クラスターの不透明度を設定します。
+ **[Display tooltip]** (ツールチップの表示) を使用すると、レイヤーのツールチップを切り替えることができます。

## GeoJSON レイヤー
<a name="v10-panels-geomap-geojson"></a>

GeoJSON レイヤーを使用すると、ファイルシステムから静的 GeoJSON ファイルを選択してロードできます。
+ **[GeoJSON URL]** では、Grafana に付属する GeoJSON ファイルを選択できます。
+ **[デフォルトのスタイル]** では、上記のルールが一致しない場合に適用するスタイルを制御します。
  + **[色]** ではデフォルトのスタイルの色を設定します
  + **[不透明度]** ではデフォルトの不透明度を設定します
+ **[スタイルルール]** では、機能のプロパティに基づいてスタイルを適用します
  + **[ルール]** を使用すると、GeoJSON ファイルから*特徴量*、*条件*、および*[値]*を選択して、ルールを定義できます。ごみ箱アイコンを使用して、現在のルールを削除できます。
  + **[色]** では、現在のルールに対するスタイルの色を設定します
  + **[不透明度]** では、現在のルールの透明性レベルを設定します。
+ **[スタイルルールの追加]** で、追加のスタイルルールを作成できます。
+ **[Display tooltip]** (ツールチップの表示) を使用すると、レイヤーのツールチップを切り替えることができます。

## 夜間/昼間レイヤー (アルファ）
<a name="v10-panels-geomap-nightday"></a>

夜間/昼間レイヤーには、現在の時間範囲に基づいて夜間および昼間の領域が表示されます。

![\[Grafana のジオマップ視覚化を使用した夜間/昼間のレイヤーの例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/geomap-day-night-example.png)


**オプション**
+ **[表示]** では、パネルの時間範囲から時間ソースを切り替えます。
+ **Night region color** では、夜間領域の色を選択します。
+ **[Display sun]** (太陽の表示) で太陽アイコンが切り替えられます。
+ **[不透明度]** は 0 (透明) から 1 (不透明) です。
+ **[Display tooltip]** (ツールチップの表示) を使用すると、レイヤーのツールチップを切り替えることができます。

**注記**  
詳細については、「[OpenLayers の拡張機能 - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)」を参照してください。

## ルートレイヤー (プレビュー)
<a name="v10-panels-geomap-route"></a>

ルートレイヤーは、データポイントをルートとしてレンダリングします。

**注記**  
ルートレイヤーは現在パブリックプレビュー中です。Grafana Labs ではサポートが限られており、この機能が一般公開される前に重要な変更が発生する可能性があります。

![\[Grafana のジオマップ視覚化を使用したルートレイヤーの例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/geomap-route-layer-example.png)


**オプション**
+ **[サイズ]** ではルートの厚さを設定します。デフォルトでは値が固定されています。フィールドデータを選択すると、フィールドデータがスケールすることができる [最小] 範囲と [最大] 範囲を設定できます。
+ **[Color]** ではルートの色を設定します。デフォルトでは固定色に設定されています。色をフィールドデータに関連付けることもできます。
+ **[塗りつぶしの不透明度]** は、ルートの不透明度を設定します。
+ **[テキストラベル]** では、ルートごとにテキストラベルを設定します。
+ **[Arrow]** (矢印) では、データ順にルートに沿って表示する矢印スタイルを設定します。
  + **[なし]**
  + **[前進]**
  + **[Reverse]** (逆順)
+ **[Display tooltip]** (ツールチップの表示) を使用すると、レイヤーのツールチップを切り替えることができます。

**注記**  
詳細については、「[OpenLayers の拡張機能 - 動線スタイル](http://viglino.github.io/ol-ext/examples/style/map.style.gpxline.html)」を参照してください。

## 写真レイヤー (プレビュー)
<a name="v10-panels-geomap-photos"></a>

写真レイヤーは、各データポイントに写真をレンダリングします。

**注記**  
写真レイヤーは現在パブリックプレビュー中です。Grafana Labs ではサポートが限られており、この機能が一般公開される前に重要な変更が発生する可能性があります。

**オプション**
+ **[Image Source Field]** (画像ソースフィールド) では、画像データを Base64 でエンコードされた画像バイナリ (`data:image/png;base64,...`) として含む文字列フィールドを選択できます。
+ **[Kind]** (種類) では、画像の周りにフレームスタイルを設定します。以下から選択します。
  + **[Square]** (平方)
  + **[Circle]** (円形)
  + **[Anchored]** (アンカー)
  + **[Folio]** (フォリオ)
+ **[Crop]** (トリミング) では、画像がフィットするようにトリミングされるかどうか切り替えます。
+ **[Shadow]** (シャドウ) では、画像の背後にあるボックスシャドウを切り替えます。
+ **[Border]** (境界線) では、画像の周囲の境界サイズを設定します。
+ **[Border color (境界線の色)]** では、画像の周囲の境界線の色を設定します。
+ **[Radius]** (範囲) では、画像の全体的なサイズをピクセル単位で設定します。
+ **[Display tooltip]** (ツールチップの表示) を使用すると、レイヤーのツールチップを切り替えることができます。

**注記**  
詳細については、「[OpenLayers の拡張機能 - 画像写真スタイル](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)」を参照してください。

## ネットワークレイヤー (プレビュー)
<a name="v10-panels-geomap-network"></a>

ネットワークレイヤーはネットワークグラフをレンダリングします。このレイヤーは、ノードグラフの視覚化でサポートされているのと同じデータ形式をサポートし、ノードデータには地理空間データが追加されています。地理空間データは、マップ上のノードを見つけてレンダリングするために使用されます。

**注記**  
ネットワークレイヤーは現在パブリックプレビュー中です。Grafana Labs ではサポートが限られており、この機能が一般公開される前に重要な変更が発生する可能性があります。

![\[Grafana のジオマップ内のネットワーク視覚化例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/geomap-network-layer-example.png)


**注記**  
ネットワークレイヤーは現在パブリックプレビュー中です。Grafana Labs ではサポートが限られており、この機能が一般公開される前に重要な変更が発生する可能性があります。

**オプション**
+ **[Arrow]** (矢印) では、各エッジに表示する矢印の方向を設定します。これは、ソースからターゲットへの方向を前進とします。以下から選択します。
  + **[なし]**
  + **[前進]**
  + **[Reverse]** (逆順)
  + **[Both]** (両方)
+ **[凡例の表示]** を使用すると、レイヤーの凡例を切り替えることができます。凡例はノードデータのみをサポートします。
+ **[Display tooltip]** (ツールチップの表示) を使用すると、レイヤーのツールチップを切り替えることができます。

**ノードスタイル**
+ **[サイズ]** ではノードのサイズを設定します。デフォルトは **[Fixed size]** (固定サイズ) です。これにより、データに関係なくすべてのノードサイズが同じになりますが、選択したフィールドに対応するデータに基づいてノードのサイズを変更するオプションもあります。**[最小]** ノードサイズと **[最大]** ノードサイズは、ノードがこの範囲内でスケールできるように設定する必要があります。
+ **Color** ではノードの色を設定します。デフォルトは **[Fixed color]** (固定色) で、すべてのノードを特定の色に設定します。**標準オプション**セクションで選択したフィールドデータポイント値とカラースキーム設定に応じて、条件付き色を使用するオプションもあります。
+ **[Symbol]** を使用すると、データに追加のビジュアルコンテキストを提供するのに役立つシンボル、アイコン、またはグラフィックを選択できます。シンプルな記号や Unicon ライブラリなど、Grafana に含まれているアセットから選択します。画像アセットを含む URL を指定することもできます。画像は SVG (Scalable Vector Graphics: スケーラブルベクトルグラフィック) である必要があります。
+ **[塗りつぶしの不透明度]** は、各ノードの透明度を設定します。
+ **[Rotation angle]** (回転角度) では、各ノードの回転角度を設定します。デフォルトは **[Fixed value]** (固定値) です。これにより、すべてのノードはデータに関係なく同じ角度で回転しますが、選択したフィールドに対応するデータに基づいてノードの回転を設定するオプションもあります。
+ **[テキストラベル]** では、ノードごとにテキストラベルを設定します。

**エッジスタイル**
+ **[サイズ]** はエッジの線幅を設定します。デフォルトは **[Fixed size]** (固定サイズ) です。これにより、データに関係なくすべてのエッジの線幅が同じになりますが、選択したフィールドに対応するデータに基づいてエッジのサイズを変更するオプションもあります。**[最小]** ノードサイズと **[最大]** ノードサイズは、ノードがこの範囲内でスケールできるように設定する必要があります。
+ **Color** ではエッジの色を設定します。デフォルトは **[Fixed color]** (固定色) で、すべてのエッジを特定の色に設定します。**標準オプション**セクションで選択したフィールドデータポイント値とカラースキーム設定に応じて、条件付き色を使用するオプションもあります。
+ **[塗りつぶしの不透明度]** では、各エッジの透明度を設定します。
+ **[テキストラベル]** では、エッジごとにテキストラベルを設定します。

## CARTO レイヤー
<a name="v10-panels-geomap-carto"></a>

CARTO レイヤーは Amazon Managed Grafana ではサポートされていません。

## XYZ タイルレイヤー
<a name="v10-panels-geomap-xyz"></a>

XYZ タイルレイヤーは Amazon Managed Grafana ではサポートされていません。

## Open Street Map レイヤー
<a name="v10-panels-geomap-osm"></a>

Open Street Map レイヤー (デフォルトのベースマップを除く) は、Amazon Managed Grafana ではサポートされていません。

## ArcGIS レイヤー
<a name="v10-panels-geomap-arcgis"></a>

ArcGIS レイヤーは Amazon Managed Grafana ではサポートされていません。

## マップコントロール
<a name="v10-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="v10-panels-heatmap"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ヒートマップパネルの視覚化により、ヒストグラムを経時的に表示できます。ヒストグラムの詳細については、「[ヒストグラムおよびヒートマップの概要](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)」を参照してください。

![\[Grafana のヒートマップ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## データから計算する
<a name="v10-panels-heatmap-calculate"></a>

この設定は、データが既に計算されたヒートマップ (データソース/トランスフォーマーから) であるか、パネルで計算する必要があるヒートマップであるかを決定します。

**X バケット**

この設定は、X 軸をバケットに分割する方法を決定します。**サイズ**入力で時間間隔を指定できます。例えば、`1h` の時間範囲により、セルは X 軸で 1 時間幅になります。

**Y バケット**

この設定は、Y 軸をバケットに分割する方法を決定します。

**Y バケット目盛**

次のいずれかの Y 軸値目盛を選択します。
+ **[線形]** – 線形目盛。
+ **[log (base 2)]** – 底が 2 の対数目盛。
+ **[log (base 10)]** – 底が 10 の対数目盛。
+ **[symlog]** – 正負対象の対数目盛。

## Y 軸
<a name="v10-panels-heatmap-y-axes"></a>

Y 軸の表示方法を定義します。

**[配置]**
+ **[左]** – 左側
+ **[Right]** – 右側
+ **[非表示]** – 非表示

**[単位]**

単位設定

**[小数]**

この設定により、小数点以下の設定が決まります。

**[最小/最大値]**

この設定では、軸範囲を設定します。

**[Reverse]** (逆順)

選択すると、軸は逆の順序で表示されます。

**[Display multiple y-axes]** (複数の Y 軸を表示)

場合によっては、複数の Y 軸を表示したい場合があります。例えば、経時的な温度と湿度の両方を示すデータセットがある場合、これらの 2 つの系列で異なる単位を持つ 2 つの y 軸を表示したいとします。

これを行うには、[フィールドオーバーライドを追加します](v10-panels-configure-overrides.md)。必要な回数だけステップに従うことで、必要な数の y 軸を追加できます。

## カラー
<a name="v10-panels-heatmap-colors"></a>

色のスペクトルは、値の数 (各バケット内) と各バケットに割り当てられた色間とのマッピングを制御します。スペクトルの左端の色は最低数を表し、右端の色は最大数を表します。一部のカラースキームは、ライトテーマを使用するときに自動的に反転されます。

また、カラーモードを [不透明度]‭ に変更することもできます。この場合、色は変わりませんが、不透明度はバケット数に応じて変化します。
+ **モード**
  + **[Scheme]** (スキーム) – セルの色で表されるバケット値。
    + **[Scheme]** – モードが**スキーム**の場合、カラースキームを選択します。
  + **[不透明度]** – セルの不透明度で表されるバケット値。[Opaque] (不透明) セルは最大値を意味します。
    + **[Color]** – セルのベース色。
    + **[Scale]** (目盛) – バケット値を不透明度にマッピングするための目盛。
      + **[線形]** – 線形目盛。バケット値は不透明度に対して直線的にマッピングされます。
      + **[sqrt]** (平方根) – 対数目盛。セルの不透明度は `value ^ k` として計算され、`k` は設定された**指数**値です。指数が `1` より小さい場合、対数スケールが表示されます。指数が `1` より大きい場合、指数スケールが表示されます。`1` の場合、目盛は線形と同じになります。
    + **[Exponent]** – 指数の値 (`0` より大きい場合)。

**[値を元にした開始/終了の色]**

デフォルトでは、Grafana は最小および最大バケット値に基づいてセルの色を計算します。[最小値] と [最大値] では、これらの値を上書きできます。バケット値は Z 軸、最小値と最大値はそれぞれ Z の最小値と Z の最大値と考えてください。
+ **[開始値]** – セルの色の計算に使用される最小値。バケット値が最小値より小さい場合、「最小値」の色にマッピングされます。系列の最小値はデフォルト値です。
+ **[終了値]** – セルの色の計算に使用される最大値。バケット値が最大値より大きい場合、「最大値」の色にマッピングされます。系列の最大値はデフォルト値です。

## セル表示
<a name="v10-panels-heatmap-cell"></a>

この設定で、視覚化する内容を絞り込みます。

## 追加の表示オプション
<a name="v10-panels-heatmap-options"></a>

**Tooltip** (ツールチップ)
+ **[Show tooltip]** - ヒートマップのツールチップを表示します。
+ **[Show Histogram]** – ツールチップに Y 軸のヒストグラムを表示します。ヒストグラムは、特定のタイムスタンプにおけるバケット値の分布を表します。
+ **Show color scale** – ツールチップにカラースケールを表示します。カラースケールは、バケットの値と色との間のマッピングを表します。

**[凡例]**

視覚化にヒートマップの凡例を表示するかどうかを選択します。

**Exemplars** (見本)

見本データの表示に使用する色を設定します。

# ヒストグラム
<a name="v10-panels-histogram"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ヒストグラムの視覚化は値の分布を計算して棒グラフとして表示します。Y 軸と各バーの高さは各括弧に含まれる値の数を表し、X 軸は値の範囲を表します。

![\[Grafana でのヒストグラム視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/histogram-example.png)


## サポートされる形式
<a name="v10-panels-histogram-formats"></a>

ヒストグラムの視覚化では、1 つ以上の数値フィールドを持つ時系列とテーブル結果をサポートしています。

## 表示オプション
<a name="v10-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 軸の値とともに塗りつぶしの不透明度が増加します。
+  **[色相]** – グラデーション色は線の色相に基づいて生成されます。

## 凡例オプション
<a name="v10-panels-histogram-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの [カラースキーム] オプションを [単一色] または [クラシックパレット] に設定することが重要です。凡例にしきい値の括弧を表示するには、カラースキームを [しきい値起点] に設定します。凡例の詳細については、「[凡例の設定](v10-panels-configure-legend.md)」を参照してください。

**[凡例モード]**

これらの設定を使用して、グラフで凡例がどのように表示されるかを定義します。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

**[凡例の配置]**

凡例を配置する場所を選択します。
+  **[Bottom]** – グラフの下。
+  **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する標準計算を選択します。複数選択できます。詳細については、「[計算タイプ](v10-panels-calculation-types.md)」を参照してください。

**[凡例計算]**

凡例に表示する計算を選択します。複数選べます。

# ログ
<a name="v10-panels-logs"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ログパネルの視覚化では、Elastic、Influx、Loki などのログをサポートするデータソースのログ行が表示されます。通常、グラフパネルの横のこのパネルを使用して、関連するプロセスのログ出力を表示します。

ログパネルには、**[Query]** タブに入力されたクエリの結果が表示されます。複数のクエリ結果がマージされ、時間別にソートされます。表示可能な行よりも多くの行がデータソースから返される場合は、パネル内でスクロールできます。

レンダリングされる行数を制限するには、**[クエリオプション]**で **[最大データポイント数]** の設定を使用できます。設定しない場合、データソースは通常デフォルトの制限を適用します。

## ログレベル
<a name="v10-panels-logs-level"></a>

**レベル**ラベルが指定されているログの場合、ラベルの値を使用してログレベルを決定し、それに応じて色を更新します。ログに指定されたレベルラベルがない場合、そのコンテンツが、サポートされている表現のいずれかと一致するかどうかを調べます (詳細については、下記を参照してください)。ログレベルは常に最初の一致によって決まります。Grafana がログレベルを判別できない場合、**不明な**ログレベルとして視覚化されます。詳細については、「[ログレベル](v10-explore-logs.md#v10-explore-log-level)」を参照してください。

## ログの詳細
<a name="v10-panels-logs-details"></a>

各ログ行には、より堅牢なインタラクションのために、ラベルと検出されたフィールドを含む拡張可能な領域があります。各フィールドまたはラベルには、表示されているすべてのログに関連する統計を表示する統計アイコンがあります。

**データリンク**

データリンクを使用すると、ログメッセージの任意の部分を内部リンクまたは外部リンクに変換できます。作成されたリンクは、**[ログの詳細]** ビュー内の **[リンク]** セクションにボタンとして表示されます。

**表示オプション**

以下の設定を使用して、視覚化する内容を絞り込みます。
+ **[時間]** – 時間列を表示または非表示にします。これはデータソースから報告されたログ行と関連するタイムスタンプです。
+ **[一意のラベル]** – 一意のラベル列を表示または非表示にします。この列には、共通ではないラベルのみが表示されます。
+ **[共通ラベル]** - を表示または非表示にします
+ **[行の折り返し]** – 行の折り返しを切り替えます。
+ **[Prettify JSON]** – すべての JSON ログを pretty print (整形表示) するには、これを `true` に設定します。この設定は、JSON 以外の形式のログには影響しません。
+ **[ログ詳細の有効化]** – オプションを切り替えて、各ログ行のログ詳細ビューを表示します。デフォルトの設定は `true` です。
+ **[Order]** (順序) – 結果を降順または昇順で表示します。デフォルトは **[降順]** で、最新のログが最初に表示されます。**[昇順]** に設定すると最も古いログ行が最初に表示されます。

# ニュース
<a name="v10-panels-news"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ニュースの視覚化には RSS フィードが表示されます。デフォルトでは、Grafana Labs のブログ記事が表示され、ユーザーは別の RSS フィード URL を入力してこれを変更できます。

**[表示]** セクションに RSS の URL を入力します。この視覚化タイプは他のクエリを受け入れず、ユーザーはこの視覚化を使用して RSS フィードデータを改ざんまたは検索できるとは想定しないでください。

**注記**  
RSS フィードは、プロキシなしで Grafana フロントエンドによって読み込まれます。その結果、適切な [CORS ヘッダー](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)で設定された RSS フィードのみが読み込まれます。表示しようとしている RSS フィードが読み込みに失敗する場合は、RSS フィードを再ホストするか、独自のプロキシ作成を検討してください。

# ノードグラフ
<a name="v10-panels-node-graph"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ノードグラフは、有向グラフまたはネットワークを視覚化できます。有向フォースレイアウトを使用してノードを効果的に配置し、複雑なインフラストラクチャマップ、階層、または実行図の表示に役立ちます。

## データ要件
<a name="v10-panels-node-graph-requirements"></a>

ノードグラフでは、ノードとエッジを表示するためにデータの特定の形状が必要です。このグラフでは、すべてのデータソースまたはクエリを視覚化できるわけではありません。これをデータソースデベロッパーとして使用する場合は、データ API に関するセクションを参照してください。

ノードグラフは、*ノード*と*エッジ*で構成されます。
+ ある*ノード*は円として表示されます。あるノードは、アプリケーション、サービス、またはアプリケーションの観点から関連するその他のものを表す場合があります。
+ ある*エッジ*は、2 つのノードを接続する線として表示されます。接続は、リクエスト、オペレーション、または 2 つのノード間の他の関係である場合があります。

ノードとエッジの両方にメタデータまたは統計を関連付けることができます。データソースは、表示される情報と値を定義するため、異なるデータソースが異なるタイプの値を表示したり、一部の値を表示しなかったりすることができます。

## ノード
<a name="v10-panels-node-graph-nodes"></a>

通常、ノードには、ノード内の 2 つの統計値とノードのすぐ下の 2 つの識別子、通常は名前とタイプが表示されます。ノードでは、ノードの周囲に一連の別の値を色付きの円として表示することもできます。異なる色のセクションは、合計が 1 になる異なる値を表します。例えば、円の赤い部分によってエラーの割合を表すことができます。

ノードを選択すると表示されるコンテキストメニューには、さらに詳細を表示できます。Grafana ワークスペースの他の部分または外部リンクをターゲットにできる追加のリンクを、コンテキストメニューに含めることもできます。

**注記**  
ノードグラフには 1,500 個のノードしか表示できません。この制限を超えると、右上隅に警告が表示され、一部のノードは非表示になります。グラフ内の **[非表示ノード]** マーカーをクリックすると、グラフの非表示部分を展開できます。

## エッジ
<a name="v10-panels-node-graph-edges"></a>

エッジでは、エッジにカーソルを合わせると統計を表示することもできます。ノードと同様に、エッジを選択すると、追加の詳細とリンクを含むコンテキストメニューを開けます。

この視覚化をサポートする最初のデータソースは、サービスマップ機能の AWS X-Ray データソースです。詳細については、「[AWS X-Ray データソースに接続する](x-ray-data-source.md)」を参照してください。

## ノードグラフの操作方法
<a name="v10-panels-node-graph-navigation"></a>

**Pan**

ノードグラフ内でパンするには、ノードまたはエッジの外部を選択してポインタをドラッグします。

**拡大または縮小**

ノードグラフの左上隅にあるボタンを使用してズームするか、マウスホイールまたは `Ctrl` (または `Cmd`) キーで他のスクロール入力を使用できます。

**非表示ノードを調べる**

特定の時間に表示されるノードの数は、合理的なパフォーマンスを維持するために制限されます。この制限外のノードは、そのエッジに接続されている非表示ノードのおよその数を示す選択可能なマーカーの背後に隠されます。マーカーを選択して、そのノードの周りのグラフを展開できます。

**グリッドビュー**

グリッドビューに切り替えて、グラフ内の最も興味深いノードの概要を把握できます。グリッドビューは、エッジのないグリッド内のノードを表示し、ノード内に表示される統計、またはノードの色付き境界で表される統計でソートできます。

ノードをソートするには、凡例内の統計を選択します。統計名 (`˄` または `˅`) の横にあるマーカーは、ソートおよびソート方向に現在使用されている統計を示します。

ノードを選択し、**[Show in Graph layout (グラフレイアウトで表示)]** オプションを選択すると、選択したノードに焦点を当ててグラフレイアウトに切り替え、グラフ全体のコンテキストで表示します。

## Data API
<a name="v10-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` を使用します。 | 
| color | 文字列/数値 | `arc__` フィールドを使用して色セクションを指定する代わりに、単一の色を指定するために使用できます。文字列 (許容可能な HTML カラー文字列である必要があります) でも、数値でもかまいません。この場合、動作は `field.config.color.mode` 設定によって異なります。例えば、これはフィールド値によって制御されるグラデーション色の作成に使用できます。 | 
| icon | string | デフォルトの統計ではなく、ノード内に表示されるアイコンの名前。Grafana 組み込みアイコンのみが許可されます (使用可能なアイコンについては、[こちら](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview)を参照してください)。 | 
| nodeRadius | 数値 | ピクセル単位の半径値。ノードサイズを管理するために使用されます。 | 
| highlighted | ブール値 | ノードを強調表示するかどうかを設定します。例えば、複数のノードとエッジを強調表示してグラフ内の特定のパスを表すために使用します。デフォルトは `false` です。 | 

# 円グラフ
<a name="v10-panels-piechart"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

![\[Grafana の円グラフ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/pie_chart_example.png)


円グラフには、1 つ以上のクエリから誘導された系列、または系列内の値が、円グラフのスライスで相互に関連して表示されます。スライスの円弧の長さ、面積、中心角度は、すべての値の合計に関連するため、すべてスライス値に比例します。この種類のグラフは、一連の小規模な値を見た目がきれいな形ですばやく比較する場合に最適です。

## 値オプション
<a name="v10-panels-piechart-value"></a>

次のオプションを使用して、視覚化に使う値を絞り込みます。

**[表示]**

表示する情報量を選択します。
+ **[計算]** – 各値を系列ごとに単一の値に減らします。
+ **[すべての値]** – 1 つの系列におけるすべての値を表示します。

**計算**

**[計算]**を選択すると、各系列を削減する計算を選択できます。使用可能な計算の詳細については、「[計算タイプ](v10-panels-calculation-types.md)」を参照してください。

**[制限]**

1 つの系列におけるすべての値を表示する場合、表示される値の数には制限があります。

**フィールド**

視覚化に表示するフィールドを少なくとも 1 つ選択します。各フィールド名はリストで確認できます。または、次のいずれかのオプションを選択できます。
+ **[数値フィールド]** – 数値を持つすべてのフィールド。
+ **[すべてのフィールド]** – 変換によって削除されないすべてのフィールド。
+ **[時間]** – 時間値を持つすべてのフィールド。

## 円グラフオプション
<a name="v10-panels-piechart-options"></a>

これらのオプションで、視覚化の見え方を調整します。

**円グラフタイプ**

円グラフの表示スタイルを選択します。次のいずれかになります。
+ **[Pie]** (円) – 標準円グラフ
+ **[Donut]** (ドーナツ) – 中央に穴がある円グラフ

**ラベル**

円グラフに表示するラベルを選択します。複数選べます。
+ **[名前]** – 系列名またはフィールド名。
+ **[パーセント]** – 全体の割合。
+ **[Value]** – 未加工の数値。

デフォルトでは、ラベルはグラフ部分の上に白で表示されます。グラフの色を濃く選択して、より見やすくすることができます。長い名前や数字は文字切れする可能性があります。

**[ツールチップモード]**

視覚化にカーソルを合わせると、Grafana はツールチップを表示できます。ツールチップの動作を選択します。
+ **[単独]** – ツールチップには、グラフ上でカーソルを合わせている系列が 1 つだけ表示されます。
+ **[すべて]** – ツールチップには、グラフ内のすべての系列が表示されます。Grafana は、ツールチップの系列一覧で、カーソルを合わせている系列を太字で強調表示します。
+ **[非表示]** – グラフを操作するときにツールチップを表示しません。

オーバーライドを使用して、ツールチップから個々の系列を非表示にします。

## 凡例オプション
<a name="v10-panels-piechart-legend"></a>

これらの設定を使用して、グラフで凡例がどのように表示されるかを定義します。凡例の詳細については、「[凡例の設定](v10-panels-configure-legend.md)」を参照してください。

**凡例の可視性**

**[Visibility]** (可視性) トグルを使用して、凡例を表示または非表示にします。

**[凡例モード]**

凡例の表示モードを設定します。
+ **[リスト]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+ **[テーブル]** – 凡例をテーブルとして表示します。

**[凡例の配置]**

凡例を表示する場所を選択します。
+ **[Bottom]** – グラフの下。
+ **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する値を選択します。複数選べます。
+ **[パーセント]** – 全体の割合。
+ **[Value]** – 未加工の数値。

凡例の詳細については、「[凡例の設定](v10-panels-configure-legend.md)」を参照してください。

# 統計
<a name="v10-panels-stat"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

統計は、オプションのグラフスパークラインを含む 1 つの大きな統計値を表示します。しきい値またはオーバーライドを使用して、背景または値の色を制御できます。

![\[Grafana の統計視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/stat_panel_example.png)


デフォルトでは、統計パネルには次のいずれかが表示されます。
+ 単一の系列またはフィールドの値のみ。
+ 複数の系列またはフィールドの値と名前の両方。

**テキストモード**を使用して、テキストが表示されるかどうかを制御できます。

## 自動レイアウト調整
<a name="v10-panels-stat-automatic-adjust"></a>

パネルは、ダッシュボードで使用可能な幅と高さに応じてレイアウトを自動的に調整します。パネルが小さすぎると、グラフ (スパークライン) が自動的に非表示になります。

## 値オプション
<a name="v10-panels-stat-value"></a>

次のオプションを使用して、視覚化で値を表示する方法を絞り込みます。

**[表示]**

Grafana がデータを表示する方法を選択します。
+ **[計算]**

  すべての行を元に計算した値を表示します。
  + **[計算]** – Grafana が多くのフィールドを 1 つの値に減らすために使用する reducer 関数を選択します。使用可能な計算のリストについては、[「標準計算」](v10-panels-calculation-types.md)を参照してください。
  + **[Fields]** (フィールド) – 視覚化に表示するフィールドを選択します。
+ **[すべての値]**

  行ごとに個別の統計を表示します。このオプションを選択すると、表示する行数を制限することもできます。
  + **[制限]** – 表示する行の最大数。デフォルトは 5,000 です。
  + **[Fields]** (フィールド) – 視覚化に表示するフィールドを選択します。

## 統計スタイル
<a name="v10-panels-stat-styles"></a>

視覚化のスタイルを変更します。

**[Orientation]** (向き)

積み重ね方向を選択します。
+ **[自動]** – Grafana が最適な方向を選択します。
+ **[水平]** – バーは水平方向に左から右に伸びます。
+ **[垂直]** – バーは垂直に上から下に伸びます。

**テキストモード**

テキストモードオプションを使用して、視覚化がレンダリングするテキストを制御できます。値が重要ではなく、名前と色のみが重要である場合は、**[テキストモード]** を **[名前]** に変更します。値は色を決定するために引き続き使用され、ツールチップに表示されます。
+ **[自動]** – データに複数の系列またはフィールドが含まれている場合は、名前と値の両方を表示します。
+ **[値]** – 値のみを表示し、名前は表示しません。代わりに、カーソルのツールチップに名前が表示されます。
+ **[値と名前]** – 常に値と名前を表示します。
+ **[名前]** – 値の代わりに名前を表示します。値はカーソルのツールチップに表示されます。
+ **[なし]** – 何も表示しません (空)。名前と値は、カーソルのツールチップに表示されます。

**ワイドレイアウト**

ワイドレイアウトを有効にするかどうかを設定します。ワイドレイアウトはデフォルトで有効になっています。
+ **[On]** - ワイドレイアウトはオンになっています。
+ **[Off]** – ワイドレイアウトはオフになっています。

**注記**  
このオプションは、**テキストモード**が**値と名前**に設定されている場合にのみ適用されます。ワイドレイアウトをオンにすると、パネルが十分に広い場合、値と名前が右側の値と並行して表示されます。ワイドレイアウトをオフにすると、値は常に名前の下にレンダリングされます。

**カラーモード**

カラーモードを選択します。
+ **[なし]** – 値には色は適用されません。
+ **[値]** – 値とグラフ領域に色を適用します。
+ **[Background Gradient]** (背景グラデーション) – わずかな背景グラデーションで、値、グラフ領域、背景に色を適用します。
+ **[Background Solid]** (無地背景) – 無地の背景色で、値、グラフ領域、背景に色を適用します。

**グラフモード**

グラフとスパークラインモードを選択します。
+ **[なし]** – グラフを非表示にし、値のみを表示します。
+ **[エリア]** – 値の下に面グラフを表示します。これには、クエリが時間列を返す必要があります。

**テキストの整列**

アライメントモードを選択します。
+ **[自動]** – 値が 1 つだけ表示されている場合 (繰り返しなし)、値は中央に配置されます。複数の系列または行が表示されている場合、値は左揃えになります。
+ **[Center]** (中央) – 統計値は中央にあります。

**変化率の表示**

変化率を表示するかどうかを設定します。デフォルトでは表示されていません。

**注記**  
このオプションは、**値オプション**の**表示**設定が**すべての値**に設定されている場合は適用されません。

## テキストサイズ
<a name="v10-panels-stat-textsize"></a>

ゲージテキストのサイズを調整します。
+ **[タイトル]** – ゲージタイトルサイズの数値を入力します。
+ **[値]** – ゲージ値サイズの数値を入力します。

# 状態タイムライン
<a name="v10-panels-state-timeline"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

状態タイムラインには、時間の経過に伴う個別の状態の変化が表示されます。各フィールドまたは系列は、一意の水平バンドとしてレンダリングされます。状態領域は、値の有無にかかわらずレンダリングできます。このパネルは、文字列またはブール値の状態とうまく連携しますが、時系列でも使用できます。時系列で使用すると、しきい値を使用して数値を離散状態の領域に変換します。

![\[Grafana の状態タイムライン視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/state_timeline_example.png)


## 状態タイムラインオプション
<a name="v10-panels-state-timeline-options"></a>

これらのオプションで、視覚的表現の内容を絞り込みます。

**[Merge equal consecutive values] (等しい連続値をマージする)**

Grafana は、互いに隣接する同じ値をマージするかどうかを制御します。

**[値の表示]**

値が状態領域内でレンダリングされるかどうかを制御します。**[自動]** は、十分なスペースがある場合に値をレンダリングします。

**[値の整列]**

状態領域内の値のアライメントを制御します。

**[Row height]** (行の高さ)

行間のスペースを制御します。1 = スペースなし = 0.5 = 50% のスペース。

**[線の幅]**

状態領域の線幅を制御します。

**[塗りつぶしの不透明度]**

状態領域の不透明度を制御します。

**[null 値の接続]**

null 値 (データ内のギャップ) をグラフに表示する方法を選択します。null 値は、連続線を形成するために接続することも、超えるとデータ内のギャップが接続されなくなるしきい値を設定することもできます。
+ **[なし]** – データにギャップがある時系列データポイントは接続されません。
+ **[常に表示]** – データにギャップがある時系列データポイントは常に接続されます。
+ **[しきい値]** – データ内のギャップが接続されなくなるしきい値を指定します。これは、データ内の接続されたギャップが既知のサイズまたは既知の範囲内であり、この範囲外のギャップが接続されなくなった場合に便利です。

**値の切断**

超えるとデータ内の値を切断するしきい値を設定するかどうかを選択します。
+ **[なし]** - データ内の時系列データポイントは切断されません。
+ **[しきい値]** – データ内の値が切断されるしきい値を指定します。これは、データ内の目的の値が既知のサイズまたは既知の範囲内であり、この範囲外の値が接続されないようにする場合に便利です。

## 値のマッピング
<a name="v10-panels-state-timeline-valuemap"></a>

ブール値または文字列値に色を割り当てるには、[値マッピングを設定する](v10-panels-configure-value-mappings.md) を使用します。

## しきい値を含む時系列データ
<a name="v10-panels-state-timeline-threshold"></a>

視覚化は時系列データでも使用できます。この場合、しきい値を使用して時系列を個別の色付き状態領域に変換します。

## 凡例オプション
<a name="v10-panels-state-timeline-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの **[カラースキーム]** オプションを **[単一色]** または **[クラシックパレット]** に設定することが重要です。凡例にしきい値の括弧を表示するには、**[カラースキーム]** を **[しきい値起点]** に設定します。

**[凡例モード]**

これらの設定を使用して、グラフで凡例がどのように表示されるかを定義します。凡例の詳細については、[「凡例の設定」](v10-panels-configure-legend.md)を参照してください。
+ **[リスト]** – 凡例を一覧として表示します。これはデフォルトモードです。
+ **[テーブル]** – 凡例をテーブルとして表示します。
+ **[非表示]** – 凡例を非表示にします。

**[凡例の配置]**

凡例を表示する場所を選択します。
+ **[Bottom]** – グラフの下。
+ **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する[標準計算](v10-panels-calculation-types.md)を選択します。複数選択できます。

# ステータス履歴
<a name="v10-panels-status-history"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ステータス履歴は、時間の経過とともに周期的な状態を表示します。各フィールドまたは系列は、横の列としてレンダリングされます。ボックスがレンダリングされ、各値を中央に配置します。

## サポートされているデータ
<a name="v10-panels-status-history-supporteddata"></a>

ステータス履歴は、文字列、ブーリアン値、数値フィールドまたは時系列で機能します。時間フィールドは必須です。値マッピングを使用して、文字列の色付け、またはテキスト値の数値範囲への割り当てができます。

## 表示オプション
<a name="v10-panels-status-history-options"></a>

これらのオプションで、視覚化する内容を絞り込みます。

**[値の表示]**

値が値ボックス内でレンダリングされるかどうかを制御します。**[自動]** は、十分なスペースがある場合に値をレンダリングします。

**[列幅]**

ボックスの幅を制御します。1 = 最大スペース、0 = 最小スペース。

**[線の幅]**

状態領域の線幅を制御します。

**[塗りつぶしの不透明度]**

状態領域の塗りつぶしの不透明度を制御します。

## 値のマッピング
<a name="v10-panels-status-history-valuemap"></a>

ブール値または文字列値に色を割り当てるには、[値マッピングを設定する](v10-panels-configure-value-mappings.md) を使用します。

## しきい値を含む時系列データ
<a name="v10-panels-status-history-threshold"></a>

パネルは時系列データでも使用できます。この場合、しきい値を使用してボックスを色付けします。グラデーションのカラースキームを使用して値を色付けすることもできます。

## 凡例オプション
<a name="v10-panels-status-history-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの **[カラースキーム]** オプションを **[単一色]** または **[クラシックパレット]** に設定することが重要です。凡例にしきい値の括弧を表示するには、**[カラースキーム]** を **[しきい値起点]** に設定します。

**[凡例モード]**

これらの設定を使用して、グラフで凡例がどのように表示されるかを定義します。凡例の詳細については、[「凡例の設定」](v10-panels-configure-legend.md)を参照してください。
+ **[リスト]** – 凡例を一覧として表示します。これはデフォルトモードです。
+ **[テーブル]** – 凡例をテーブルとして表示します。
+ **[非表示]** – 凡例を非表示にします。

**[凡例の配置]**

凡例を表示する場所を選択します。
+ **[Bottom]** – グラフの下。
+ **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する[標準計算](v10-panels-calculation-types.md)を選択します。複数選択できます。

# [テーブル]
<a name="v10-panels-table"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

テーブルは非常に柔軟で、時系列やテーブルの複数のモード、注釈、未加工 JSON データをサポートしています。また、この視覚化では、日付の書式設定、値の書式設定、色付けオプションも可能です。

![\[Grafana のテーブル視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/table_example.png)


**注記**  
注釈とアラートはテーブルではサポートされていません。

## 列の並べ替え
<a name="v10-panels-table-sort"></a>

列タイトルを選択して、ソート順序をデフォルトから降順、昇順に変更できます。列を選択するたびに、ソート順序がサイクルの次のオプションに変わります。追加で列を選択するときは、`shift` キーを長押しして複数の列をソートできます。

## テーブルオプション
<a name="v10-panels-table-options"></a>

**ヘッダーの表示**

データソースからインポートされた列名を表示または非表示にします。

## 列幅
<a name="v10-panels-table-width"></a>

デフォルトでは、Grafana はテーブルサイズと最小列幅に基づいて列幅を自動的に計算します。このフィールドオプションは、設定をオーバーライドし、すべての列の幅をピクセル単位で定義できます。

例えば、`100` と入力すると、すべての列の幅が 100 ピクセルに設定されます (フィールドを終了すると変更が行われます)。

## [最小列幅]
<a name="v10-panels-table-min"></a>

デフォルトでは、テーブル列の最小幅は 150 ピクセルです。このフィールドオプションでは、デフォルトを上書きでき、テーブルパネルの新しい最小列幅をピクセル単位で定義します。

例えば、最小値を `75` に設定すると、すべての列は幅 75 ピクセル以上でスケールされます。

スマートフォンやタブレットなどのスモールスクリーンデバイスの場合、デフォルトの `150` ピクセル値を `50` に減らして、テーブルベースのパネルをダッシュボードで正しくレンダリングできます。

## [列の配置]
<a name="v10-panels-table-alignment"></a>

Grafana がセルの内容を調整する方法を選択します。
+ Auto (デフォルト)
+ Left (左)
+ Center (中央)
+ Right (右)

## セルタイプ
<a name="v10-panels-table-cell-type"></a>

デフォルトでは、Grafana は表示設定を自動的に選択します。以下のオプションのいずれかを選択して、すべてのフィールドのデフォルトを設定することで、設定を上書きできます。一部のセルタイプでは、追加の設定を使用できます。

**注記**  
**フィールド**タブでこれらを設定すると、時間フィールドを含むすべてのフィールドにタイプが適用されます。**オーバーライド**タブで設定して、変更を 1 つ以上のフィールドに適用できます。

**[文字色]**

しきい値が設定されている場合、フィールドテキストは適切なしきい値の色で表示されます。

**Color background (gradient or solid) (背景色 (グラデーションまたは無地))**

しきい値が設定されている場合、フィールドの背景は適切なしきい値の色で表示されます。

**ゲージ**

セルは、複数の異なるプレゼンテーションタイプでグラフィカルゲージとして表示できます。
+ *[Basic]* (基本) – 基本モードでは、ゲージの色を定義するしきい値レベルを含むシンプルなゲージが表示されます。
+ *グラデーション]* – しきい値レベルはグラデーションを定義します。
+ *LCD* – ゲージを小さなセルに分け、点灯または消灯させて表示します。

さらに、ゲージの横に表示されるラベルに対して、値で色付けするように設定したり、テーマテキストの色と一致させたり、非表示にしたりできます。
+ **Value color (値の色)**
+ **[テキスト色]**
+ **[非表示]**

**[JSON ビュー‭]**

コードとしてフォーマットされた値を表示します。値がオブジェクトの場合、カーソルを合わせると JSON オブジェクトのブラウジングができる JSON ビューが表示されます。

**スパークライン**

スパークラインとしてレンダリングされた値を表示します。テーブルのデータ変換には[時系列](v10-panels-xform-functions.md#v10-panels-xform-funcs-series)が必要です。

## セル値の検査
<a name="v10-panels-table-cell-value"></a>

テーブルセルから値の検査を有効にします。raw 値はモーダルウィンドウに表示されます。

**注記**  
セル値の検査は、セル表示モードが [Auto]、[文字色]、[Color background]、または [ビュー‭] に設定されている場合にのみ使用できます。

## [Column filter] (列フィルター)
<a name="v10-panels-table-col-filter"></a>

列データの表示方法を一時的に変更できます。例えば、最大から最小までの値を順序付けたり、特定の値を非表示にしたりできます。詳細については、「[テーブル列のフィルタリング](#v10-panels-table-filter)」を参照してください。

## Pagination (ページ分割)
<a name="v10-panels-table-pagination"></a>

ページ分割を有効または無効にするには、このオプションを使用します。これは、クエリに影響を与えないフロントエンドオプションです。有効にすると、ページサイズはテーブルの高さに自動的に調整されます。

## テーブル列のフィルタリング
<a name="v10-panels-table-filter"></a>

**列フィルター**をオンにすると、テーブルオプションをフィルタリングできます。

**列のフィルタリングを有効にするには**

1. Grafana で、フィルタリングする列を含むテーブルを使用してダッシュボードに移動します。

1. フィルタリングするテーブルパネルで、パネルエディタを開きます。

1. **[フィールド]** タブを選択します。

1. **[テーブル]** オプションで、**[列フィルター]** オプションをオンにします。

各列タイトルの横にフィルター (ファネル) アイコンが表示されます。

**列の値のフィルタリング**

列の値をフィルタリングするには、列タイトルの横にあるフィルター (ファネル) アイコンを選択します。Grafana にその列のフィルターオプションが表示されます。

表示する値の横にあるチェックボックスを選択します。上部の検索フィールドにテキストを入力してそれらの値をディスプレイに表示すると、スクロールして探さずに選択できます。

複数の演算子から選択して、列の値を表示します。
+ **[Contains]** (含む) – 正規表現パターン (デフォルトでは演算子) に一致します。
+ **[式]** - ブール式を評価します。文字 `$` は、式にある列の値を表します (例: `$ >= 10 ≈& $ <= 12`)。
+ **[比較演算子]** – 一般的な比較演算子 `=`、`!=`、`<`、`<=`、`>`、`>=` を使用できます。

**[OK]** ボタンと **[Cancel]** ボタンの上にあるチェックボックスを選択して、表示されているすべての値をフィルターに追加または削除します。

**列フィルターのクリア**

フィルターが適用された列では、タイトルの横に青い漏斗が表示されます。

フィルターを削除するには、青いファネルアイコンを選択し、**[Clear filter]** (フィルターのクリア) を選択します。

## テーブルフッター
<a name="v10-panels-table-footer"></a>

テーブルフッターを使用して、フィールドの[計算](v10-panels-calculation-types.md)を表示できます。

テーブルフッターを有効にしたら、**[計算]** を選択し、計算する**フィールド**を選択します。

フィールドを選択しない場合、システムはすべての数値フィールドに計算を適用します。

**行のカウント**

選択したフィールドの値の数ではなく、データセット内の行数を表示する場合は、**[カウント]** 計算を選択し、**[カウント行]** を有効にします。

# テキスト
<a name="v10-panels-text"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

テキスト視覚化を使用すると、ダッシュボードにテキストまたは HTML を直接含めることができます。これは、コンテキスト情報と説明の追加や、複雑な HTML を埋め込むために使用できます。

**モード**

**モード**は、埋め込みコンテンツの表示方法を決定します。これには次のオプションがあります。
+ **[Markdown]** – このオプションはコンテンツをマークダウンとしてフォーマットします。
+ **[HTML]** – この設定では、コンテンツをサニタイズされた HTML としてレンダリングします。
+ **[Code]** – この設定では、読み取り専用コードエディタ内でコンテンツをレンダリングします。適切な言語を選択して、埋め込みテキストに構文強調表示を適用します。

**[変数]**

コンテンツの変数が展開されて表示されます。

# 時系列
<a name="v10-panels-time-series"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

![\[Grafana での時系列の視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/time_series_example.png)


時系列の視覚化は、時系列データをグラフとして視覚化するデフォルトかつ主要な方法です。系列を、線、ポイント、またはバーとしてレンダリングできます。ほぼすべての時系列データを表示するのに十分な汎用性を備えています。

**注記**  
グラフパネルの視覚化は時系列の視覚化に移行できます。移行するには、**[パネル]**タブで **[時系列の視覚化]** を選択します。Grafana は該当するすべての設定を転送します。

**Topics**
+ [ツールチップオプション](v10-time-series-panel-tooltip.md)
+ [凡例オプション](v10-time-series-panel-legend.md)
+ [グラフスタイル](v10-time-series-graph.md)
+ [軸オプション](v10-time-series-axis.md)
+ [色オプション](v10-time-series-color.md)

# ツールチップオプション
<a name="v10-time-series-panel-tooltip"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ツールチップオプションは、グラフのデータポイントにカーソルを合わせたときに表示される情報オーバーレイを制御します。

**[ツールチップモード]**
+ **[単独]** – ツールチップには、カーソルを合わせている系列が 1 つだけ表示されます。
+ **[すべて]** – ツールチップには、グラフ内のすべての系列が表示されます。Grafana は、ツールチップの系列一覧で、カーソルを合わせている系列を太字で強調表示します。
+ **[非表示]** – グラフを操作するときにツールチップを表示しません。

# 凡例オプション
<a name="v10-time-series-panel-legend"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

凡例オプションは、グラフの下または右側に表示される系列名と統計を制御します。

**[凡例モード]**

これらの設定を使用して、グラフで凡例がどのように表示されるかを定義します。凡例の詳細については、「[凡例を設定する](v10-panels-configure-legend.md)」を参照してください。
+ **[リスト]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+ **[テーブル]** – 凡例をテーブルとして表示します。
+ **[非表示]** – 凡例を非表示にします。

**[凡例の配置]**

凡例を表示する場所を選択します。
+ **[Bottom]** – グラフの下。
+ **[右側]** – グラフの右側。

**[凡例値]**

凡例に表示する[標準計算](v10-panels-calculation-types.md)を選択します。複数選択できます。

# グラフスタイル
<a name="v10-time-series-graph"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

このオプションを使用して、時系列データを表示する方法を定義します。オーバーライドを使用して、同じグラフに複数のスタイルを組み合わせることができます。
+ **[折れ線]** – 時系列をグラフに折れ線で表示します。
+ **[棒]** – 時系列をグラフに一連の棒で表示し、データポイントごとに 1 つずつ表示します。
+ **[ポイント]** – 時系列をグラフに点で表示し、データポイントごとに 1 つずつ表示します。

## [棒の配置]
<a name="v10-time-series-graph-bar"></a>

グラフ上に描画されるデータポイントに対して棒の位置を設定します。棒には幅があるため、棒をデータポイントの前、後、または中央に配置することができます。このオプションの選択肢は次のとおりです。
+ ![\[An image showing a bar graph aligned before a point.\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/bar-alignment-before.png) **[前]** – 棒はポイントの前に描画されます。ポイントは棒の後端の隅に配置されます。
+ ![\[An image showing a bar graph aligned around a point.\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/bar-alignment-center.png) **Center** – 棒はポイントの周りに描画されます。ポイントは棒の中央に配置されます。これがデフォルトです。
+ ![\[An image showing a bar graph aligned after a point.\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/bar-alignment-after.png) **After** – 棒はポイントの後に描画されます。ポイントは棒の先頭隅に配置されます。

## [線の幅]
<a name="v10-time-series-graph-linewidth"></a>

線幅は、系列線の太さまたは棒のアウトラインを制御するスライダーです。

## [塗りつぶしの不透明度]
<a name="v10-time-series-graph-fill"></a>

塗りつぶし色の不透明度を設定します。塗りつぶしは、折れ線グラフの線の下にある領域を表示したり、棒グラフの棒の色として表示したりするために使用します。

## [グラデーションモード]
<a name="v10-time-series-graph-gradient"></a>

グラデーションモードでは、系列の色に基づいてグラデーションの塗りつぶしを指定します。色を変更するには、標準のカラースキームフィールドオプションを使用します。詳細については、「[カラースキーム](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme)」を参照してください。

グラデーションモードのオプションは次のとおりです。
+ **[なし]** – グラデーションの塗りつぶしなし。これはデフォルトの設定です。
+ **[不透明度]** – Y 軸の値が増加するにつれて、塗りつぶしの不透明度が増加する不透明度グラデーション。
+ **[色相]** – 系列の色相に基づく繊細なグラデーション。
+ **[Scheme]** (スキーム) – カラースキームによって定義されるカラーグラデーション。この設定は、塗りつぶしエリアと線で使用できます。詳細については、「[色オプション](v10-time-series-color.md)」を参照してください。

グラデーションの外観は**[塗りつぶしの不透明度]**設定の影響を受けます。

## [ポイント表示]
<a name="v10-time-series-graph-showpoints"></a>

以下のオプションを使用して、線または棒にポイントを追加するように視覚化を設定できます。
+ **[自動]** – Grafana はデータの密度に基づいてポイントを表示するかどうかを決定します。密度が低い場合、ポイントが表示されます。
+ **[常に表示]** – データ密度に関係なく、ポイントが表示されます。
+ **[常に非表示]** – ポイントを表示しません。

## [ポイントサイズ]
<a name="v10-time-series-graph-pointsize"></a>

ポイントのサイズを、直径 1～40 ピクセルに設定します。

## 線形補間
<a name="v10-time-series-graph-interpolation"></a>

Grafana が系列の線形を補間する方法を選択します。

![\[Grafana のポイント間で線を描画するさまざまな方法を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/line-interpolation.png)


オプションは以下のとおりです。
+ **[線形]** – ポイントは直線で結合されます。
+ **[Smooth]** (滑らか) – ポイントは、ポイント間の移行が滑らかな曲線で結合されます。
+ **[前のステップ]** – 線はポイント間のステップとして表示されます。ポイントはステップの最後にレンダリングされます。
+ **[Step after]** – 線はポイント間のステップとして表示されます。ポイントはステップの最初にレンダリングされます。

## 線のスタイル
<a name="v10-time-series-graph-linestyle"></a>

線のスタイルを設定します。色を変更するには、標準のカラースキームフィールドオプションを使用します。

線のスタイルの選択肢は次のとおりです。
+ **[Solid]** – 実線を表示します。これはデフォルトの設定です。
+ **[Dash]** – 破線を表示します。このオプションを選択すると、線ダッシュの長さとギャップ (長さ, ギャップ) を選択するためのリストが表示されます。ダッシュ間隔はデフォルトで (10, 10) に設定されています。
+ **[Dots]** - 点線を表示します。このオプションを選択すると、点の間隔のギャップ長を選択するためのリストが表示されます。点の間隔はデフォルトで 10 に設定されています。

## null 値の接続
<a name="v10-time-series-graph-null"></a>

null 値 (データ内のギャップ) をグラフに表示する方法を選択します。null 値は、連続線を形成するために接続することも、超えるとデータ内のギャップが接続されなくなるしきい値を設定することもできます。

null 値を接続する方法の選択肢は次のとおりです。
+ **[なし]** – データにギャップがある時系列データポイントは接続されません。
+ **[常に表示]** – データにギャップがある時系列データポイントは常に接続されます。
+ **[しきい値]** – データ内のギャップが接続されなくなるしきい値を指定します。これは、データ内の接続されたギャップが既知のサイズまたは既知の範囲内であり、その範囲外のギャップは接続されないようにする場合に便利です。

## 値の切断
<a name="v10-time-series-graph-disconnect"></a>

指定されたしきい値を超える時間があるデータの値との間に、ギャップを追加するかどうかを選択します。

切断値の選択肢は次のとおりです。
+ **[なし]** – 時系列データポイントは切断されません。
+ **[しきい値]** データ内の値が切断されるしきい値を指定します。これは、データ内の目的の値が既知のサイズまたは既知の範囲内であり、この範囲外の値が接続されないようにする場合に便利です。

## [Stack series] (系列の積み上げ)
<a name="v10-time-series-graph-stack"></a>

*積み上げ*により、Grafana は系列の上に別の系列を表示できます。視覚化で積み上げを使用すると、誤解を招くグラフを簡単に作成できるため、注意が必要です。積み上げが最適な手段ではない理由の詳細については、[「積み上げに関する問題」](https://www.data-to-viz.com/caveat/stacking.html)を参照してください。

積み上げの選択肢は次のとおりです。
+ **[Off]** (オフ) – 系列の積み上げをオフにします。
+ **[普通]** – 系列の上に別の系列を積み上げます。
+ **[100%]** – パーセンテージで積み上げるため、すべての系列の合計が 100% になります。

**グループ内の系列の積み上げ**

積み上げ動作をオーバーライドして、グループ内で系列を積み上げることができます。オーバーライドの作成の詳細については、「[フィールドのオーバーライドを設定する](v10-panels-configure-overrides.md)」を参照してください。

**グループ内の系列を積み上げるには**

1. パネルを編集し、**[オーバーライド]** を選択します。

1. **[Stack series (系列の積み上げ)]** オプションのフィールドオーバーライドを作成します。

1. 積み上げモードで**[普通]** を選択します。

1. 系列を表示する積み上げグループに名前を付けます。

   積み上げグループ名オプションは、オーバーライドを作成する場合にのみ使用できます。

## [下を塗りつぶす]
<a name="v10-time-series-graph-fillbelow"></a>

**[下を塗りつぶす]**オプションは、2 つの系列間の領域を塗りつぶします。このオプションは、系列またはフィールドのオーバーライドとしてのみ使用できます。

このオプションを使用すると、系列の折れ線から 0 までではなく、2 つの系列間の領域を塗りつぶすことができます。たとえば、*Max* と *Min* という 2 つのシリーズがある場合、*Max* シリーズを選択し、**それを以下のフィル**に上書きして *Min* シリーズにすることができます。これにより、2 つの折れ線間の領域のみが塗りつぶされます。

# 軸オプション
<a name="v10-time-series-axis"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

軸カテゴリのオプションにより、x 軸と y 軸のレンダリング方法が変わります。一部のオプションは、編集するフィールドオプションボックスの外部をクリックするまで有効になりません。`Enter` キーを押す方法もあります。

## [Time zone] (タイムゾーン)
<a name="v10-time-series-axis-timezone"></a>

X 軸に沿って表示するタイムゾーンを設定します。

## [配置]
<a name="v10-time-series-axis-placement"></a>

Y 軸の配置を選択します。オプションは以下のとおりです。
+ **[自動]** – Y 軸を系列に自動的に割り当てます。異なるユニットを持つ系列が 2 つ以上ある場合、Grafana は左軸を最初のユニットに、右軸を次のユニットに割り当てます。
+ **[左]** – 左側にすべての Y 軸を表示します。
+ **[右側]** – 右側にすべての Y 軸を表示します。
+ **[非表示]** – すべての Y 軸を非表示にします。

軸を選択的に非表示にするには、特定のフィールドを対象とする[フィールドオーバーライドを追加します](v10-panels-configure-overrides.md)。

## ラベル
<a name="v10-time-series-axis-label"></a>

Y 軸テキストラベルを設定します。複数の Y 軸がある場合は、オーバーライドで異なるラベルを割り当てることができます。

## [幅]
<a name="v10-time-series-axis-width"></a>

軸の固定幅を設定します。デフォルトでは、Grafana は軸の幅を動的に計算します。

軸の幅を設定することで、異なる軸タイプのデータが同じ表示比率を共有できます。この設定により、軸が互いに視覚的に近接して移動または伸張されないため、複数のグラフのデータの価値を簡単に比較できます。

## [グリッド線の表示]
<a name="v10-time-series-axis-gridlines"></a>

軸グリッド線の可視性を設定します。
+ **[自動]** – データの密度に基づいてグリッド線を自動的に表示します。
+ **[On]** - 常にグリッド線を表示します。
+ **[Off]** – 常にグリッド線を表示しません。

## [色]
<a name="v10-time-series-axis-color"></a>

軸の色を設定します。
+ **[テキスト]** – テーマテキストの色に基づいて色を設定します。
+ **[系列]** – 系列の色に基づいて色を設定します。

## [境界線の表示]
<a name="v10-time-series-axis-border"></a>

軸の境界の可視性を設定します。

## スケール
<a name="v10-time-series-axis-scale"></a>

Y 軸値のスケール方法を設定します。
+ **[線形]** – 目盛を等分します。
+ **[対数]** – 対数目盛を使用します。このオプションを選択すると、二進対数 (底 2) または常用対数 (底 10) スケールを選択するためのリストが表示されます。
+ **[Symlog]** – 正負対象の対数目盛を使用します。このオプションを選択すると、二進対数 (底 2) または常用対数 (底 10) スケールを選択するためのリストが表示されます。線形しきい値オプションを使用すると、スケールが線形から対数に変化するしきい値を設定できます。

## [Centered zero] (中央ゼロ)
<a name="v10-time-series-axis-centered"></a>

Y 軸においてゼロが中央になるように設定します。

## [ソフト最小値とソフト最大値]
<a name="v10-time-series-axis-softminmax"></a>

Y 軸の制限をより適切に制御するために、**ソフト最小値**または**ソフト最大値**オプションを設定します。デフォルトでは、Grafana はデータセットに基づいて y 軸の範囲を自動的に設定します。

ソフト最小値とソフト最大値の設定により、データがほぼフラットな場合に、データの小さな変化が拡大されるのを防げます。対照的に、ハード最小値とハード最大値は、特定のポイントを超える断続的なスパイクを切り取ることで、データ内の有用な詳細が不明瞭になるのを防げます。

Y 軸のハード制限を定義するには、標準の最小/最大オプションを設定します。詳細については、「[標準オプションの設定](v10-panels-configure-standard-options.md)」を参照してください。

## 変換
<a name="v10-time-series-axis-transform"></a>

このオプションを使用して、ツールチップ、コンテキストメニュー、または凡例に表示される値に影響を与えずに系列の値を変換します。変換オプションは 2 つあります。
+ **[負の Y 変換]** – 結果を Y 軸の負の値に反転します。
+ **[Constant]** (定数) – 最初の値を定数線として表示します。

**注記**  
変換オプションはオーバーライドとしてのみ使用できます。

## [Display multiple y-axes] (複数の Y 軸を表示)
<a name="v10-time-series-axis-multiple"></a>

複数の Y 軸を表示したい場合もあります。例えば、経時的な温度と湿度の両方を示すデータセットがある場合、これらの 2 つの系列で異なる単位を持つ 2 つの y 軸を表示できます。

複数の Y 軸を表示するには、[フィールドオーバーライドを追加します](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field)。必要な回数だけステップに従うことで、必要な数の y 軸を追加できます。

# 色オプション
<a name="v10-time-series-color"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

デフォルトでは、グラフは標準の[カラースキーム](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme)オプションを使用して系列の色を割り当てます。凡例にある系列の色アイコンを選択することで、凡例を使用してカラーピッカーを開くこともできます。この方法で色を設定すると、特定の系列に特定の色を設定するオーバーライドルールが自動的に作成されます。

以下は、系列の色のデフォルトを変更するために使用できる追加オプションです。

## Classic palette (クラシックパレット)
<a name="v10-time-series-color-classic"></a>

最も一般的なセットアップは、グラフに**クラシックパレット**を使用することです。このスキームは、その順序に基づいて、各フィールドまたは系列に色を自動的に割り当てます。クエリでフィールドの順序が変更されると、色も変わります。オーバーライドルールを使用して、特定のフィールドの色を手動で設定できます。

## [単一色]
<a name="v10-time-series-color-single"></a>

このモードを使用して色を指定します。凡例の各系列の横にある色付き線アイコンを選択して、カラーピッカーを開くこともできます。これにより、カラースキームを単一色と選択した色に設定する新しいオーバーライドが自動的に作成されます。

## 値別カラースキーム
<a name="v10-time-series-color-byvalue"></a>

**[しきい値起点: 値別]** や **[緑黄赤: 値別]** などの値別カラースキームを選択すると、**[系列に使用する色]** オプションが表示されます。このオプションは、系列に色を割り当てるためにどの値 (最終値、最小値、最大値) を使用するかを管理します。

## スキームグラデーションモード
<a name="v10-time-series-color-gradient"></a>

**グラフスタイルの**下にある**グラデーションモード**オプションには、**Scheme** という名前のモードがあります。**スキーム**を有効にすると、折れ線または棒グラフは、選択した**カラースキーム**から定義されたグラデーション色を受け取ります。

**[しきい値起点]**

**[カラースキーム]** が **[しきい値起点 (値別)]** に設定され、**[グラデーションモード]** が **[スキーム]** に設定されている場合、折れ線または棒グラフの色は定義されたしきい値を超えると変化します。スキームで選択された正確な色のみが表示されます。

**グラデーションカラースキーム**

**グラデーションモード**を**スキーム**に設定*せずに*グラデーションカラースキームを使用すると、系列内の値がしきい値セット間を移動するにつれて、選択した色間でグラデーションを形成します。

# トレース
<a name="v10-panels-traces"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

トレースの視覚化により、インフラストラクチャ内のサービスを横断するリクエストに従うことができます。トレースの視覚化は、トレースデータを簡単に解釈できる図でトレースデータを表示します。

トレースとその使用方法の詳細については、次のドキュメントを参照してください。
+ [Explore でのトレース](v10-explore-tracing.md)
+ [Tempo データソース](tempo-data-source.md)
+ *Grafana Labs Tempo ドキュメント*の「[Tempo での使用開始](https://grafana.com/docs/tempo/latest/getting-started/)」。

## トレースの視覚化を含むパネルの追加
<a name="v10-panels-traces-add"></a>

Grafana スタックでトレースデータが利用可能になると、Grafana ダッシュボードにトレースパネルを追加できます。

ダッシュボード変数 `traceID` を使用すると、特定のトレース ID に対する特定のトレースを表示するクエリを作成できます。ダッシュボード変数の詳細については、「[ 変数ドキュメント](v10-dash-variables.md)」を参照してください。

**前提条件**

開始するには、以下が必要です。
+ Amazon Managed Grafana ワークスペース。
+ ワークスペースに接続された [Tempo データソース](tempo-data-source.md)。

ダッシュボード内のトレースデータを表示および分析するには、ダッシュボードにトレースの視覚化を追加し、パネルエディタを使用してクエリを定義する必要があります。クエリは、視覚化に表示されるデータを決定します。パネルエディタの詳細については、「[パネルエディタのドキュメント](v10-panels-editor-overview.md)」を参照してください。

この手順では、ダッシュボード変数とテンプレートを使用して、視覚化できるトレース ID を入力できます。`traceId` という変数を使用して、テンプレートクエリとして追加します。

**トレース視覚化クエリを追加するには**

1. ワークスペースで、新しいダッシュボードを作成するか、トレースの視覚化を追加する既存のダッシュボードに移動します。

1. 新しいダッシュボードから **[視覚化を追加]** を選択するか、既存のダッシュボードで**[パネルの追加]** を選択します。

1. 適切なトレースデータソースを選択します。

1. パネルエディタの右上で **[視覚化]** タブを選択し、**トレース**を選択します。

1. **パネルオプション**で、トレースパネルの**タイトル**を入力します。パネルエディタの詳細については、「[パネルオプションの設定](v10-panels-configure-panel-options.md)」を参照してください。

1. クエリエディタで、**TraceQL** クエリタイプタブを選択します。

1.  TraceQLクエリフィールドに `${traceId}` を入力して、ダッシュボード変数を作成します。この変数はテンプレートクエリとして使用されます。

1. パネルエディタで **[適用]** を選択して、ダッシュボードにパネルを追加します。

1. 必要に応じて、ダッシュボードの**設定**に移動し、`traceId` という名前の新しい変数を変数タイプ**カスタム**で追加し、ラベルを付与します。**[適用]** を選択して、ダッシュボードに変数を追加します。

1. トレースパネルに使用されるデータソースに有効なトレース ID を使用し、ダッシュボード変数で ID を編集して、パネルが機能することを確認します。

## テーブルの視覚化による TraceQL の追加
<a name="v10-panels-traces-traceql"></a>

ダッシュボードにトレースの視覚化を追加することはできますが、ダッシュボード変数としてトレース ID を手動で追加しなければならないのは面倒です。代わりに、TraceQL クエリを使用して特定のタイプのトレースを検索し、一致する結果から適切なトレースを選択できる方が便利です。

**前提条件**

この手順は、前の手順を完了したことを前提としています。

**テーブル視覚化で TraceQL を追加するには**

1. トレース視覚化を追加したのと同じダッシュボードで、**[パネルの追加]** を選択して新しい視覚化パネルを追加します。

1. 前のセクションで使用したのと同じトレースデータソースを選択します。

1. パネルエディタの右上で **[視覚化]** タブを選択し、**テーブル**を選択します。

1. クエリエディタで、**[TraceQL]** タブを選択します。

1. **パネルオプション**で、トレースパネルの**タイトル**を入力します。

1. ダッシュボードで視覚化するトレースを検索するには、適切な TraceQL クエリを追加します。例えば、*my-server* は、サーバーからのシンプルで静的なクエリです。

   ```
   { .service.name = "my-server" && .http.status_code=500 }
   ```

   TraceQL クエリは、他のダッシュボード変数が存在する場合、それらを利用するテンプレートクエリとして記述できます。これにより、これらの変数に基づいて動的クエリを作成できます。

クエリから結果が返されると、結果はパネルのテーブルにレンダリングされます。

トレース視覚化の結果には、トレースをレンダリングする **Explore** ページへのリンクが含まれます。選択時に `traceId` ダッシュボード変数を埋めるテーブル内のトレースに他のリンクを追加して、トレースが同じダッシュボードで視覚化されるようにできます。

パネルに一連のデータリンクを作成するには、次の手順を使用します。

**変数を使用してトレースに他のリンクを追加するには**

1. 右側のメニューにある **[データリンク]** で、**[リンクの追加]** を選択します。

1. データリンクの**タイトル**を追加します。

1. 完全なダッシュボードがレンダリングされているときにブラウザのアドレスバーを見て、ダッシュボードへのパスを見つけます。これは同じ Grafana スタック内のダッシュボードへのリンクであるため、ダッシュボードのパスのみが必要です。

   例えば、パスが以下の場合:

   ```
   https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
   ```

   ダッシュボードへのパスは次のとおりです。

   ```
   /d/1234abcd5/my-dashboard?orgId=1
   ```

1. **URL** フィールドで、両方のパネルを含むダッシュボードを自己参照します。この自己参照では、テーブル内の選択したトレースの値を使用してダッシュボード変数を入力します。前のステップで見つけたダッシュボードのパスを使用して、TraceQL テーブルから選択した結果を使用する `traceId` の値を入力します。トレース ID は、返された結果の `traceID` データフィールドを使用して公開されるため、ダッシュボード変数の値として使用します。例:

   ```
   /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
   ```

1. **[保存]** を選択すると、データリンクを保存できます。

1. パネルエディタから **[適用]** を選択すると、ダッシュボードにパネルを適用できます。

1. ダッシュボードを保存します。

これで、テーブルの視覚化に一致するトレースのリストが表示されます。**TraceID** フィールドまたは **SpanID** フィールドを選択すると、トレースを視覚化する **Explore** ページを開くか、データリンクをたどるオプションが表示されます。他のフィールド (`Start time`、`Name`、 `Duration`など) を選択すると、自動的にデータリンクが続き、`traceId` ダッシュボード変数に入力されることで、トレースパネルに関連するトレースが表示されます。

# トレンド
<a name="v10-panels-trend"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

トレンドの視覚化は、時間ではない連続した数値 X を持つデータセットに使用する必要があります。例としては、関数グラフ、rpm/トルク曲線、供給/需要関係、レースコースに沿った上昇または心拍数プロット (x は開始からの距離または期間) などがあります。

トレンドの視覚化は、以下の例外を除いて、[時系列の視覚化](v10-panels-time-series.md)で利用可能なすべてのビジュアルスタイルとオプションをサポートします。
+ 注釈や時間リージョンなし
+ 共有カーソル (または十字線) なし
+ マルチタイムゾーン x 軸なし
+ ドラッグ選択によりダッシュボードの時間範囲の変更不可

**X フィールドの選択**

このオプションを使用して、増加する数値を含むフィールドを選択します。

 例えば、回転速度を x 軸にプロットし、出力とトルクを y 軸にプロットすることで、エンジンの回転速度に対する出力とトルクを表すことができます。

# XY チャート
<a name="v10-panels-xychart"></a>

XY チャートは、グラフ内の任意の x 値と y 値を視覚化する方法を提供し、2 つの変数間の関係を簡単に表示できます。XY チャートは通常、散布図の作成に使用されます。また、それらを使用してバブルチャートの作成も可能です。ここでは、フィールド値によって各バブルのサイズが決まります。

![\[Grafana の XY チャート視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/xy-chart-example.png)


## サポートされているデータ形式
<a name="v10-panels-xychart-formats"></a>

XY チャートには、少なくとも 2 つの数値フィールドを持つ任意の表形式データタイプを使用できます。このタイプの視覚化には時間データは必要ありません。

## パネルオプション
<a name="v10-panels-xychart-paneloptions"></a>

パネルエディタペインの **[パネルオプション]** セクションで、パネルのタイトルや説明などの基本的なオプションを設定します。このセクションで繰り返しパネルの設定もできます。詳細については、「[パネルオプションの設定](v10-panels-configure-panel-options.md)」を参照してください。

## XY チャートオプション
<a name="v10-panels-xychart-options"></a>

**系列マッピング**

チャートで系列データをマッピングする方法を設定します。
+ **[自動]** – 使用可能なすべてのデータフレーム (またはデータセット) から系列を自動的に生成します。フィルタリングして 1 つのフレームのみを選択できます。
+ **[手動]** – 使用可能なデータフレームから選択して、系列を明示的に定義します。

系列マッピングの選択に応じて、**フレーム**、**X フィールド**、および **Y フィールド**オプションが異なります。自動および手動の系列マッピングセクションでは、これらのさまざまなオプションについて説明します。

**自動系列マッピングオプション**

系列マッピングモードとして**自動**を選択すると、以下のオプションが事前設定されますが、自分で定義することもできます。
+ **[Frame]** – デフォルトでは、XY チャートにすべてのデータフレームが表示されます。フィルタリングして 1 つのフレームのみを選択できます。
+ **[X-field]** – X が表すフィールドを選択します。デフォルトでは、各データフレームの最初の数値フィールドです。
+ **[Y-field]** – X フィールドが設定されると、デフォルトでは、データフレーム内の残りのすべての数値フィールドが Y フィールドとして指定されます。このオプションを使用して、Y に使用するフィールドを明示的に選択できます。

  一連のチャートは Y フィールドから生成されます。XY チャートの系列を変更するには、Y フィールドをオーバーライドします。サイズフィールドまたは色フィールドで使用するフィールドは、系列を生成しません。

  オーバーライドを使用して Y フィールドを個別に除外することもできます。これを行うには、削除する各 Y フィールドに対して、次のプロパティを持つオーバーライドを追加します。
  + オーバーライドタイプ: **[名前付きフィールド]**
  + オーバーライドプロパティ: **[系列 > エリアで非表示]**
  + エリア: **Viz**

**手動系列マッピングオプション**

系列モードとして**手動**を選択すると、系列を追加、編集、削除できます。系列を管理するには、**[Series]** (系列) フィールドを選択します。系列の名前を変更するには、系列名を選択します。

**手動**モードでは、次のオプションを設定する必要があります。
+ **[Frame]** – データフレームまたはデータセットを選択します。フレームは必要な数だけ追加できます。
+ **[X-field]** – X が表すフィールドを選択します。
+ **[Y-field]** – Y が表すフィールドを選択します。

**[サイズフィールド]**

このオプションを使用して、チャート内のポイントのサイズを制御するフィールドの値を設定します。この値は、データフレーム内のすべての値の最小値と最大値に関連しています。

このオプションを選択すると、最小および最大ポイントサイズオプションを設定できます。

**[色フィールド]**

このオプションを使用して、チャート内のポイントの色を制御するフィールドの値を設定します。**[標準オプション]**で色値オプションを使用するには、このフィールドを設定する必要があります。

通常、このオプションは、チャートに 1 つの系列しか表示されていない場合に使用されます。

**[表示]**

視覚化で値がどのように表されるかを設定します。
+ **[ポイント]** – 値をポイントとして表示します。このオプションを選択すると、ポイントサイズオプションも表示されます。
+ **[線]** – 値の間に線を追加します。このオプションを選択すると、線のスタイルと線幅のオプションも表示されます。
+ **[Both]** (両方) - ポイントと線の両方を表示します。

**[ポイントサイズ]**

チャート内のすべてのポイントのサイズを、直径 1～100 ピクセルに設定します。デフォルトのサイズは 5 ピクセルです。オーバーライドを設定して、系列 (Y フィールド) ごとにピクセルサイズを設定できます。

**最小/最大ポイントサイズ**

これらのオプションを使用して、**サイズフィールド**オプションを設定するときに、最小または最大ポイントサイズを制御できます。これらのオプションを特定の系列に対してオーバーライドできます。

**[線のスタイル]**

線のスタイルを設定します。色を変更するには、標準のカラースキームフィールドオプションを使用します。
+ **[Solid]** – 実線を表示します。これはデフォルトの設定です。
+ **[Dash]** – 破線を表示します。このオプションを選択すると、ドロップダウンリストが表示され、ダッシュ線の長さとギャップの設定を選べます。デフォルトでは、長さとギャップは `10, 10` に設定されます。
+ **[Dots]** - 点線を表示します。このオプションを選択すると、点の間隔を選択できるドロップダウンリストが表示されます。デフォルトでは、点の間隔は `0, 10` に設定されています (最初の数値はドット長を表し、常にゼロです)。

**[線の幅]**

線の幅をピクセル単位で設定します。

## ツールチップオプション
<a name="v10-panels-xychart-tooltipoptions"></a>

ツールチップオプションは、グラフのデータポイントにカーソルを合わせたときに表示される情報オーバーレイを制御します。

**[ツールチップモード]**
+ **[単独]** – ツールチップには、カーソルを合わせている系列が 1 つだけ表示されます。
+ **[非表示]** – グラフを操作するときにツールチップを表示しません。

オーバーライドを使用して、ツールチップから個々の系列を非表示にします。

**[最大高さ]**

ツールチップボックスの最大高さを設定します。デフォルトは 600 ピクセルです。

## 凡例オプション
<a name="v10-panels-xychart-legendoptions"></a>

凡例オプションは、グラフの下または右側に表示される系列名と統計を制御します。凡例の詳細については、「[凡例を設定する](v10-panels-configure-legend.md)」を参照してください。

**[可視性]**

スイッチを切り替えて、凡例をオンまたはオフにします。

**[モード]**

これらの設定を使用して、グラフで凡例がどのように表示されるかを定義します。
+ **[リスト]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+ **[テーブル]** – 凡例をテーブルとして表示します。

**[配置]**

凡例を表示する場所を選択します。
+ **[Bottom]** – グラフの下。
+ **[右側]** – グラフの右側。

**[値]**

凡例に表示する[標準計算](v10-panels-calculation-types.md)を選択します。複数選択できます。

**[幅]**

凡例を視覚化の右側に配置するときの幅を制御します。このオプションは、凡例の配置を**右**に設定した場合にのみ表示されます。

## 軸オプション
<a name="v10-panels-xychart-axis"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

軸カテゴリのオプションにより、x 軸と y 軸のレンダリング方法が変わります。一部のオプションは、編集するフィールドオプションボックスの外部をクリックするまで有効になりません。`Enter` キーを押す方法もあります。

**y 軸の配置**

Y 軸の配置を選択します。オプションは以下のとおりです。
+ **[自動]** – Y 軸を系列に自動的に割り当てます。異なるユニットを持つ系列が 2 つ以上ある場合、Grafana は左軸を最初のユニットに、右軸を次のユニットに割り当てます。
+ **[左]** – 左側にすべての Y 軸を表示します。
+ **[右側]** – 右側にすべての Y 軸を表示します。
+ **[非表示]** – すべての Y 軸を非表示にします。

軸を選択的に非表示にするには、特定のフィールドを対象とする[フィールドオーバーライドを追加します](v10-panels-configure-overrides.md)。

**ラベル**

Y 軸テキストラベルを設定します。複数の Y 軸がある場合は、オーバーライドで異なるラベルを割り当てることができます。

**[幅]**

軸の固定幅を設定します。デフォルトでは、Grafana は軸の幅を動的に計算します。

軸の幅を設定することで、異なる軸タイプのデータが同じ表示比率を共有できます。この設定により、軸が互いに視覚的に近接して移動または伸張されないため、複数のグラフのデータの価値を簡単に比較できます。

**[グリッド線の表示]**

軸グリッド線の可視性を設定します。
+ **[自動]** – データの密度に基づいてグリッド線を自動的に表示します。
+ **[On]** - 常にグリッド線を表示します。
+ **[Off]** – 常にグリッド線を表示しません。

**[色]**

軸の色を設定します。
+ **[テキスト]** – テーマテキストの色に基づいて色を設定します。
+ **[系列]** – 系列の色に基づいて色を設定します。

**[境界線の表示]**

軸の境界の可視性を設定します。

**[Scale]** (スケール)

Y 軸値のスケール方法を設定します。
+ **[線形]** – 目盛を等分します。
+ **[対数]** – 対数目盛を使用します。このオプションを選択すると、二進対数 (底 2) または常用対数 (底 10) スケールを選択するためのリストが表示されます。
+ **[Symlog]** – 正負対象の対数目盛を使用します。このオプションを選択すると、二進対数 (底 2) または常用対数 (底 10) スケールを選択するためのリストが表示されます。線形しきい値オプションを使用すると、スケールが線形から対数に変化するしきい値を設定できます。

*[Centered zero]* (中央ゼロ)

Y 軸においてゼロが中央になるように設定します。

**[ソフト最小値とソフト最大値]**

Y 軸の制限をより適切に制御するために、**ソフト最小値**または**ソフト最大値**オプションを設定します。デフォルトでは、Grafana はデータセットに基づいて y 軸の範囲を自動的に設定します。

ソフト最小値とソフト最大値の設定により、データがほぼフラットな場合に、データの小さな変化が拡大されるのを防げます。対照的に、ハード最小値とハード最大値は、特定のポイントを超える断続的なスパイクを切り取ることで、データ内の有用な詳細が不明瞭になるのを防げます。

Y 軸のハード制限を定義するには、標準の最小/最大オプションを設定します。詳細については、「[標準オプションの設定](v10-panels-configure-standard-options.md)」を参照してください。

**[Transform]** (変換)

このオプションを使用して、ツールチップ、コンテキストメニュー、または凡例に表示される値に影響を与えずに系列の値を変換します。変換オプションは 2 つあります。
+ **[負の Y 変換]** – 結果を Y 軸の負の値に反転します。
+ **[Constant]** (定数) – 最初の値を定数線として表示します。

**注記**  
変換オプションはオーバーライドとしてのみ使用できます。

**[Display multiple y-axes]** (複数の Y 軸を表示)

複数の Y 軸を表示したい場合もあります。例えば、経時的な温度と湿度の両方を示すデータセットがある場合、これらの 2 つの系列で異なる単位を持つ 2 つの y 軸を表示できます。

複数の Y 軸を表示するには、[フィールドオーバーライドを追加します](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field)。必要な回数だけステップに従うことで、必要な数の y 軸を追加できます。

## 標準オプション
<a name="v10-panels-xychart-standard"></a>

パネルエディタの **[標準オプション]** を使用すると、視覚化でのフィールドデータの表示方法を変更できます。標準オプションを設定すると、すべてのフィールドまたは系列に変更が適用されます。フィールドの表示をより詳細に制御するには、「[フィールドのオーバーライドを設定する](v10-panels-configure-overrides.md)」を参照してください。

以下の標準オプションをカスタマイズできます。
+ **[フィールドの最小値/最大値]** – **[フィールドの最小値/最大値]** を有効にすると、フィールドの最小値または最大値に基づいて、Grafana が各フィールドの最小値または最大値を個別に計算できるようになります。
+ **カラースキーム** – 視覚化全体に単一または複数の色を設定します。

詳細については、「[標準オプションを設定する](v10-panels-configure-standard-options.md)」を参照してください。

## データリンク
<a name="v10-panels-xychart-datalinks"></a>

データリンクを使用すると、ソースパネルのコンテキストを維持しながら、他のパネル、ダッシュボード、外部リソースにリンクできます。カーソルの下に系列名または値を含むリンクを作成できます。

データリンクごとに、次のオプションを設定します。
+ **タイトル**
+ **[URL]**
+ **[新しいタブで開く]**

詳細については、「[データリンクの設定](v10-panels-configure-data-links.md)」を参照してください。

## フィールドのオーバーライド
<a name="v10-panels-xychart-fieldoverrides"></a>

オーバーライドを使用すると、特定のフィールドまたは系列に対して視覚化設定をカスタマイズできます。オーバーライドルールを追加すると、特定のフィールドセットをターゲットにし、それらのフィールドの表示方法に複数のオプションを定義できます。

以下のオーバーライドオプションから 1 つ選択してください。
+ **[名前付きフィールド]** – 使用可能なすべてのフィールドの一覧からフィールドを選択します。
+ **[正規表現と一致する名前付きフィールド]** – 正規表現でオーバーライドするフィールドを指定します。
+ **[タイプ別フィールド]** – 文字列、数値などのフィールドをタイプ別 (文字列、数値、時間) に選択します。
+ **[クエリによって返されるフィールド** – 特定のクエリによって返されるすべてのフィールドを選択します。
+ **[値を持つフィールド)]** - **最小値**、**最大値**、**カウント**、**合計** など、定義された reducer 条件によって返されるすべてのフィールドを選択します。

詳細については、「[フィールドのオーバーライドを設定する](v10-panels-configure-overrides.md)」を参照してください。

# Grafana バージョン 10 で探索する
<a name="v10-explore"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana のダッシュボード UI は、視覚化用のダッシュボードを構築する機能を提供します。*Explore* は、クエリに集中できるように、ダッシュボードとパネルのオプションを取り除きます。これにより、クエリが動作するまで反復処理を行い、クエリからダッシュボードを構築できます。

**注記**  
ダッシュボードを作成せず単にデータを探索したい場合は、Explore を使用するとはるかに簡単になります。データソースがグラフとテーブルのデータをサポートしている場合、Explore は結果をグラフとテーブルの両方で表示します。これにより、データの傾向と詳細を同時に確認できます。

このページでは、データの探索を開始します。以下のトピックでは、Explore の特定の機能と使用方法について詳しく説明します。
+ [Explore でのクエリ管理](v10-explore-manage.md)
+ [Explore のログ](v10-explore-logs.md)
+ [Explore でのトレース](v10-explore-tracing.md)
+ [Explore の相関エディタ](v10-explore-correlations.md)
+ [Explore の Inspector](v10-explore-inspector.md)

## 探索を開始する
<a name="v10-explore-start"></a>

**注記**  
Explore にアクセスするには、エディタまたは管理者ロールが必要です。

**Explore にアクセスするには**

1. Grafana ワークスペースで、左側のメニューバーから Explore メニュー項目を選択します。

   空の Explore タブが開きます。

   または、パネル内の既存のクエリから開始するには、パネルメニューから Explore オプションを選択します。これにより、パネルからのクエリを含む Explore タブが開き、ダッシュボードの外部でクエリを微調整または反復できます。

1. 左上のドロップダウンからデータソースを選択します。

   また、**[Open advanced data source picker(高度なデータソースピッカーを開く)]** を選択して、データソースの追加 (管理者のみ可能) など、その他のオプションを表示することもできます。

1. 選択したデータソースから提供されたクエリエディタを使用してクエリを書き込みます。

   クエリの詳細については、「[データのクエリと変換](v10-panels-query-xform.md)」を参照してください。

1. 右上隅のボタンを使用してクエリを実行します。

## 分割して比較する
<a name="v10-explore-compare"></a>

分割ビューを使用すると、簡単に視覚化を並べて比較したり、関連データを 1 ページでまとめて確認したりできます。

**上部で分割ビューを開く**

1. Explore ビューで、**[分割]** ボタンを選択して現在のクエリを複製し、ページを 2 つの並列クエリに分割します。
**注記**  
新しいクエリには別のデータソースを選択できます。例えば、2 つの異なるサーバーに対して同じクエリを比較したり、ステージング環境を本番環境と比較したりできます。

   分割ビューでは、いずれかのタイムピッカーにある時刻同期ボタンを選択することで、両方のパネルのタイムピッカーを連携できます (一方を変更すると、他方も変更されます)。タイムピッカーを連携すると、分割ビュークエリの開始時刻と終了時刻が同期されます。これにより、両方の分割パネルで同じ時間間隔を確認できます。

1. 新しく作成したクエリを閉じるには、**[分割を閉じる]** ボタンを選択します。

## コンテンツ概要
<a name="v10-explore-outline"></a>

コンテンツ概要は、Explore で作成したクエリと視覚化を追跡するサイドナビゲーションバーです。これにより、クエリと視覚化との間をすばやく移動できます。

コンテンツ概要は、分割ビューでも機能します。分割ビューでは、コンテンツ概要がペインごとに生成されます。

**コンテンツ概要を開くには**

1. **Explore** 画面の左上隅にある **[概要]** ボタンを選択します。

1. コンテンツ概要でパネルアイコンを選択して、そのパネルに移動します。

## Explore の URL を共有する
<a name="v10-explore-shareurl"></a>

Explore を使用すると、クエリを変更した際にブラウザのアドレスバーの URL が更新されます。この URL を共有またはブックマークできます。

**注記**  
Explore は比較的長い URL を生成する場合があります。URL がお使いのツールに対して長すぎる場合は、[短縮リンク](#v10-explore-share)を生成して共有することもできます。

**外部ツールから Explore の URLを生成する**

Explore URL には定義された構造があるため、外部ツールから URL を構築し、Grafana で開くことができます。URL 構造は次のとおりです。

```
http://<workspace_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>
```

各パラメータの意味は次のとおりです。
+ `org_id` は組織 ID です。
+ `schema_version` はスキーマバージョンです (最新バージョン `1` に設定する必要があります)。
+ `panes` はペインの URL エンコードされた JSON オブジェクトで、各キーはペイン ID、各値は次のスキーマに一致するオブジェクトです。

  ```
  {
    datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
    queries: {
      refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
      datasource: {
        uid: string; // the query's datasource UID ie: "AD7864H6422"
        type: string; // the query's datasource type-id, i.e: "loki"
      }
      // ... any other datasource-specific query parameters
    }[]; // array of queries for this pane
    range: {
      from: string; // the start time, in milliseconds since epoch
      to: string; // the end time, in milliseconds since epoch
    }
  }
  ```
**注記**  
`from` および `to` フィールドは、[ダッシュボードの時間範囲の設定](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) トピックで説明されている相対範囲も受け入れます。

## 短縮リンクを共有する
<a name="v10-explore-share"></a>

短縮リンクの共有機能を使用すると、クエリパラメータで長い URL を使用する代わりに、/goto/:uid 形式のより短くてシンプルな URL を作成できます。クエリ結果への短縮リンクを作成するには、Explore ツールバーで **[共有]** オプションを選択します。使用されない短縮リンクは、7 日後に自動的に削除されます。リンクが 1 回以上使用されている場合は削除されません。

**短縮リンクを絶対時間で共有する**

短縮リンクには、相対時間 (2 時間前から現在の時刻など) または絶対時間 (午前 8 時から午前 10 時など) の 2 つのオプションがあります。デフォルトでは短縮リンクを共有すると、選択した相対時間範囲または絶対時間範囲がコピーされます。短縮リンクの共有ボタン横にあるドロップダウンボタンを選択し、**[Time-Sync URL Links]** (時刻同期 URL リンク) でオプションのいずれかを選択すると、絶対時間で短縮リンクを作成できます。つまり、リンクを受け取ったすべてのユーザーには、別の時間にリンクを開いても、現在ご覧のものと同じデータが表示されます。このオプションは、Explore ビューで選択した時間範囲には影響しません。

# Explore でのクエリ管理
<a name="v10-explore-manage"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Explore で作成したクエリを管理できます。これには、実行したクエリの履歴や、スターを付けたクエリが含まれます。

## クエリ履歴
<a name="v10-explore-manage-history"></a>

クエリ履歴は、Explore で使用したクエリのリストです。履歴は Grafana データベースに保存され、他のユーザーと共有されません。履歴内のクエリの保持期間は 2 週間です。2 週間以上経過したクエリは自動的に削除されます。履歴を開いて操作するには、Explore の **[クエリ履歴]** ボタンを選択します。

**注記**  
スター付き (お気に入り) クエリは 2 週間の保持期間の対象ではなく、削除されません。

## クエリ履歴の表示
<a name="v10-explore-manage-history-view"></a>

クエリ履歴を使用すると、クエリの履歴を表示できます。個々のクエリごとに、次のことができます。
+ クエリを実行します。
+ コメントを作成および/または編集します。
+ クエリをクリップボードにコピーする。
+ クエリを含む短縮リンクをクリップボードにコピーする。
+ クエリをスター付き (お気に入り) にする。

## お気に入りのクエリを管理する
<a name="v10-explore-manage-history-favorites"></a>

[クエリ履歴] タブにあるスター付きのすべてのクエリは、[スター付き] タブに表示されます。これにより、お気に入りのクエリにすばやくアクセスし、ゼロから入力することなくこれらのクエリを再利用できます。

## [クエリ履歴の並べ替え]
<a name="v10-explore-manage-history-sort"></a>

デフォルトでは、クエリ履歴には最新のクエリが表示されます。履歴は日付またはデータソース名で、昇順または降順に並べ替えることができます。

**クエリ履歴を並べ替えるには**

1. **[クエリの並べ替え順序]** フィールドを選択します。

1. 以下のオプションのいずれかを選択します。
   + **[新しい順]**
   + **[古い順]**

## クエリ履歴のフィルタリング
<a name="v10-explore-manage-history-filter"></a>

クエリ履歴とスター付きタブで、クエリ履歴を特定のデータソースに対してフィルタリングできます。

**データソースに対して履歴をフィルタリングするには**

1. **[特定のデータソースのクエリをフィルタリング]** フィールドを選択します。

1. 履歴をフィルタリングするデータソースを選択します。複数のデータソースを選択することもできます。

**注記**  
混合データソースを使用して実行されたクエリは、[混合] をフィルタリングする場合にのみ表示され、個々のデータソースでフィルタリングする場合は表示されません。

**[クエリ履歴]** タブでは、スライダーを使用して日付でクエリをフィルタリングすることもできます。
+ 垂直スライダーを使用して、クエリを日付でフィルタリングします。
+ 下部のハンドルをドラッグして開始日を設定します。
+ 上部のハンドルをドラッグして終了日を設定します。

## クエリ履歴の検索
<a name="v10-explore-manage-history-search"></a>

クエリとコメントをまたいで履歴を検索できます。クエリ履歴タブとスター付きタブでクエリを検索できます。

**クエリ履歴で検索するには**

1. **[クエリ検索]** フィールドを選択します。

1. 検索する用語を検索フィールドに入力します。

## クエリ履歴設定
<a name="v10-explore-manage-history-settings"></a>

[設定] タブでクエリ履歴をカスタマイズできます。次の表にオプションの説明を示します。


| 設定 | デフォルトの 値 | 
| --- | --- | 
| デフォルトのアクティブタブを変更する | [クエリ履歴] タブ | 

**注記**  
クエリ履歴設定は全体に及び、分割モードで両方のパネルに適用されます。

# Explore のログ
<a name="v10-explore-logs"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Explore を使用すると、次のようなさまざまなデータソースのログを調査できます。
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

インフラストラクチャのモニタリングとインシデント対応中に、メトリクスとログをより深く掘り下げて原因を見つけることができます。Explore では、ログを並行して表示することで、メトリクス、トレース、プロファイルなどの他のテレメトリシグナルとログを関連付けることもできます。

ログクエリの結果は、個々のログ行として表示され、選択した期間のログボリュームを示すグラフとして表示されます。

## ログボリューム
<a name="v10-explore-logs-volume"></a>

フルレンジのログボリュームをサポートするデータソースを操作すると、Explore には、入力されたすべてのログクエリのログ分布を示すグラフが自動的に表示されます。この機能は、現在 OpenSearch および Loki データソースでサポートされています。

**注記**  
Loki では、このフルレンジのログボリュームをメトリクスクエリによってレンダリングします。このクエリは、クエリされた時間範囲に応じてコストがかかる可能性があります。このクエリは、小規模な Loki インストールで処理するのが特に難しい場合があります。これを軽減するには、Loki の前に [nginx](https://www.nginx.com/) などのプロキシを使用して、これらのクエリにおけるユーザー定義のタイムアウト (10 秒など) を設定できます。ログボリュームヒストグラムクエリは、値 `Source=logvolhist` の HTTP ヘッダー `X-Query-Tags` を持つクエリを検索することで識別できます。これらのヘッダーは、Grafana によってすべてのログボリュームヒストグラムクエリに追加されます。

データソースがフルレンジのログボリュームの読み込みに対応していない場合、ログモデルはログ行をカウントし、自動的に計算された時間間隔に基づいてバケットに整理することで時系列を計算します。最初のログ行のタイムスタンプは、結果のログボリュームの開始を固定するために使用されます。時系列の終了点は、タイムピッカーの **To** 範囲に固定されます。これにより、データソースがフルレンジのサポートを提供していない場合でも、ログデータを効率的に分析および視覚化できます。

## ログ
<a name="v10-explore-logs-overview"></a>

以下のセクションでは、Explore で個々のログを視覚化して操作する詳細な方法を説明します。

## ログナビゲーション
<a name="v10-explore-logs-navigation"></a>

ログ行の右側にあるログナビゲーションを使用して、追加のログを簡単にリクエストできます。これを行うには、ナビゲーションの下部にある **[古いログ]** ボタンをクリックします。これは、行の制限に達した際に、さらにログを表示する場合に特に便利です。ナビゲーションから実行される各リクエストは、ナビゲーションに個別のページとして表示されます。各ページには、受信ログ行のタイムスタンプ `from` と `to` が表示されます。各ページをクリックすると、以前の結果を確認できます。Explore がログナビゲーションから実行された過去 5 つのリクエストをキャッシュすることで、ページをクリックしたときに同じクエリを再実行しないようにでき、時間とリソースを節約できます。

## 視覚的表現オプション
<a name="v10-explore-log-visualization-options"></a>

 ログの表示方法をカスタマイズしたり、表示する列を選択することができます。


| オプション | 説明 | 
| --- | --- | 
| [時間] | 時間列を表示または非表示にします。これはデータソースから報告されたログ行と関連するタイムスタンプです。 | 
| [一意のラベル] | 非共通ラベルのみを含む一意のラベル列を表示または非表示にします。すべての一般的なラベルが上に表示されます。 | 
| [行の折り返し] | ディスプレイで行の折り返しを使用する場合は、これを true に設定します。false に設定すると、水平スクロールになります。 | 
| Prettify JSON (JSONの整形) |  すべての JSON ログを pretty print (整形表示) するには、これを true に設定します。この設定は、JSON 以外の形式のログには影響しません。 | 
| Deduplication (重複排除) | ログデータは非常に反復的であり、Explore は重複するログ行を非表示にすることで役立ちます。使用できる重複排除アルゴリズムはいくつかあります。[完全] 一致は、日付フィールドを除き、行全体で行われます。[数値] の一致は、期間、IP アドレスなどの数値を除外した後に行で行われます。Signature (署名) は、残りの空白と句読点のすべての文字、数字、一致を削除するため、最も積極的な重複排除です。 | 
| Display results order (結果の順序の表示) | 受信したログの順序は、デフォルトの降順 (新しい順) から昇順 (古い順) に変更できます。 | 

## ログ行のダウンロード
<a name="v10-explore-download-log-lines"></a>

ログ結果を `txt` または `json` 形式でダウンロードするには、**[Download]** ボタンを使用します。この機能を使用すると、ログデータを保存して詳細な分析を行ったり、便利でアクセスしやすい形式で他のユーザーと共有したりできます。

## ログ結果のメタ情報
<a name="v10-explore-log-result-meta-information"></a>

受信したログ行の上には、次のような重要なメタ情報があります。
+ **[受信したログの数]** – 現在のクエリまたは時間範囲に対して受信したログの合計数を示します。
+ **[エラー]** – ログ結果に考えられるエラーを表示します。
+ **[共通ラベル]** - 共通ラベルを表示します。
+ **Total bytes processed** (処理された合計バイト数) – 処理されたログデータの累積サイズをバイト単位で表します。

**注記**  
特定のメタ情報の可用性はデータソースに依存する場合があり、その結果、特定のデータソースに対する詳細の一部しか表示されない場合があります。

## 改行のエスケープ
<a name="v10-explore-log-escaping-newlines"></a>

Explore は、改行 (`\n`、`\r`) やタブ (`\t`) など、ログ行で誤ってエスケープされたシーケンスを自動的に検出します。このようなシーケンスを検出すると、Explore は **[改行のエスケープ]** オプションを提供します。

**Explore が検出した誤ってエスケープされたシーケンスを自動的に修正するには**

1. **[改行のエスケープ]** を選択してシーケンスを置き換えます。

1. 置き換えを手動で確認し、その正確性を確認します。

Explore はこれらのシーケンスを置き換えます。そうすると、オプションは **[改行のエスケープ]** から **[エスケープの削除]** に変更されます。受信した入力に基づいて解析が正確ではない可能性があるため、変更を評価します。**[エスケープの削除]** を選択すると、置き換えを元に戻すことができます。

## ログレベル
<a name="v10-explore-log-level"></a>

`level` ラベルが指定されているログについては、このラベルの値を使用してログレベルを決定し、それに応じて各ログ行の色を更新します。ログに指定されたレベルラベルがない場合、そのコンテンツが、サポートされている表現のいずれかと一致するかどうかを調べます (詳細については、次の表を参照してください)。ログレベルは常に最初の一致によって決まります。Grafana がログレベルフィールドを推測できない場合、不明なログレベルで視覚化されます。

**注記**  
Loki データソースを使用し、`level` がログラインの一部である場合は、パーサー (JSON、logfmt、regex など) を使用して、レベル情報をレベル値の決定に使用されるレベルラベルに抽出できます。これにより、ヒストグラムはさまざまなログレベルを個別のバーとして表示できます。

**サポートされているログレベルと、ログレベルの略記と表現のマッピング** 


| ログレベル | 色 | サポートされている式 | 
| --- | --- | --- | 
| critical | 紫色 | emerg、fatal、alert、crit、critical | 
| エラー | 赤 | err、eror、error | 
| 警告 | 黄色 | warn、warning | 
| 情報 | 緑色 | info、information、informational、notice | 
| デバッグ | 青 | dbug、debug | 
| トレース | 水色 | トレース | 
| 不明 | 灰色 | \$1 | 

## 検索された単語を強調表示する
<a name="v10-explore-highlight-searched-words"></a>

クエリに検索する特定の単語または式が含まれている場合、Explore は可視性を高めるためにログ行でこれらを強調表示します。この強調表示機能により、ログ内の関連コンテンツを簡単に特定して注目できます。

**注記**  
検索語を強調表示する機能は、データソースによって異なります。一部のデータソースでは、検索語の強調表示が使用できない場合があります。

## ログの詳細を表示する
<a name="v10-explore-log-details-view"></a>

Explore では、各ログ行には *[ログの詳細]* という拡張可能なセクションがあり、ログ行を選択して開くことができます。ログの詳細ビューには、ログ行にある*フィールド*と*リンク*の形式で追加情報と探索オプションが用意されており、より堅牢なインタラクションと分析が可能になります。

**[フィールド]**

ログの詳細ビューでは、表示されたフィールドを次の 2 つの方法でフィルタリングできます。ポジティブフィルター (特定のフィールドに焦点を当てる) とネガティブフィルター (特定のフィールドを除外する) です。これらのフィルターは、ログ行を生成した対応するクエリを更新し、それに応じて等式と不等式を追加します。データソースがサポートしている場合、Loki および OpenSearch の場合と同様に、ログの詳細によって、フィールドが現在のクエリ表示およびアクティブ状態 (ポジティブフィルターの場合のみ) に既に存在しているかどうかが確認されます。その際、クエリをオフにしたり、フィルター式をポジティブからネガティブに変更したりできます。

目のアイコンをクリックすると、完全なログ行ではなく、ログリストで視覚化するフィールドのサブセットを選択できます。各フィールドには、表示されているすべてのログに関連する統計を表示する統計アイコンがあります。

**リンク**

Grafana は、データリンクまたは相関機能を提供し、ログメッセージの任意の部分を内部または外部のリンクに変換できます。これらのリンクを使用して、関連するデータや外部リソースに移動し、シームレスで便利な方法で詳細情報を確認できます。

## ログのコンテキスト
<a name="v10-explore-log-context"></a>

ログコンテキストは、特定の検索クエリに一致するログエントリを囲む追加のコンテキスト行を表示します。これはログエントリのコンテキストを理解するのに役立ちます。また、`grep` コマンドの `-C` パラメータに似ています。

テキスト行が長いため、各ログエントリ全体のコンテキストの読み取りと分析が困難になる場合があります。ここでは、**[行の折り返し]** の切り替えが役に立つ場合があります。この切り替えを有効にすると、Grafana は長いテキスト行を自動的に折り返して、ビューワーの可視幅に収まるようにします。これにより、ログエントリの読み取りと理解が容易になります。

 **[分割ビューで開く]** ボタンを使用すると、Explore ビューの分割画面でログエントリのコンテキストクエリを実行できます。このボタンを選択すると、ログエントリとともにコンテキストクエリが表示される新しい Explore ペインが開き、周囲のコンテキストの分析と理解が容易になります。

ログコンテキストクエリは、 `Ctrl` (または `Cmd`) キーを押しながらボタンを選択してコンテキストモーダルを開くことで、新しいブラウザタブで開くこともできます。新しいタブで開くと、以前に選択したフィルターも適用されます。

## ログ行のコピー
<a name="v10-explore-copy-log-line"></a>

選択したログ行の内容を簡単にクリップボードにコピーするには、**[Cログ行のコピー]** ボタンを選択します。

## リンクをログ行にコピーする
<a name="v10-explore-copy-link-to-log-line"></a>

Grafana でログ行をリンクすると、特定のログエントリにすばやく移動して正確な分析を行うことができます。ログ行に対して **[ショートリンクをコピー]** ボタンを選択すると、絶対時間範囲内の正確なログエントリに直接アクセスできる短縮 URL を生成してコピーできます。リンクを開くと、Grafana は対応するログ行まで自動的にスクロールし、青色の背景でログ行が強調表示されるため、関連情報を簡単に特定して注目できます。

**注記**  
これは、`id` フィールドを提供する Loki およびその他のデータソースでのみサポートされています。

## ライブテーリング
<a name="v10-explore-log-live-tailing"></a>

サポートされているデータソースからのリアルタイムログを表示するには、Explore のライブテーリング機能を活用できます。

**ライブテーリングを使用してログをリアルタイムで表示するには**

1. Explore ツールバーの **[Live]** ボタンを選択して、Live Tail ビューに切り替えます。

1. Live Tail ビューでは、新しいログが画面の下部に表示され、背景が淡いコントラストになるため、最新情報を簡単に追跡できます。

1. ライブテーリングを一時停止し、中断することなく以前のログを調べる場合は、**[一時停止]** ボタンを選択するか、ログビューをスクロールするだけで確認できます。

1. ビューをクリアし、すべてのログを画面から削除するには、**[ログのクリア]** ボタンを選択します。このアクションによりログビューがリセットされ、白紙の状態となってログ分析を続行できます。

1. ライブテーリングを再開し、リアルタイムログの表示を続けるには、**[再開]** ボタンを選択します。

1. ライブテーリングを終了して標準の Explore ビューに戻る場合は、**[停止]** ボタンを選択します。

ライブテーリング機能を使用すると、最新のログが入ってきたときに注視できるため、リアルタイムイベントのモニタリングや問題の迅速な検出が容易になります。

**[ログサンプル]**

選択したデータソースがログサンプルを実装し、ログクエリとメトリクスクエリの両方をサポートしている場合、メトリクスクエリの場合は、視覚化されたメトリクスに寄与したログ行のサンプルを自動的に表示できます。この機能は、現在 Loki データソースでサポートされています。

**メトリクスからログに切り替える**

 `DataSourceWithQueryExportSupport` を実装するメトリクスデータソース (Prometheus など) から `DataSourceWithQueryImportSupport` をサポートするログデータソース (Loki など) に移行する場合、ログに存在するクエリのラベルは保持され、それらを使用してログストリームに対してクエリを実行します。

例えば、Loki データソースに切り替えた後の次の Prometheus クエリ `grafana_alerting_active_alerts{job='grafana'}` は、`{job='grafana'}` に変更されます。これにより、パターン一致検索/テキスト検索できる選択した時間範囲内のログのチャンクが返されます。

# Explore でのトレース
<a name="v10-explore-tracing"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Explore を使用して、トレース中のデータソースからトレースを視覚化できます。

以下のデータソースがサポートされています。
+ [Tempo](tempo-data-source.md) (サポートされている取り込み形式: OpenTelemetry 、Jaeger、Zipkin)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

上記のデータソースのクエリを設定する方法については、特定のデータソースのドキュメントを参照してください。

## クエリエディタ
<a name="v10-explore-trace-queryeditor"></a>

データソースのクエリエディタを使用して、トレース中のデータをクエリおよび検索できます。

各データソースには、独自のクエリエディタを使用できます。Tempo データソースのクエリエディタは、Jaeger データソースのクエリエディタとは若干異なります。

各データソースのクエリについては、各ドキュメントを参照してください。
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## トレースビューの説明
<a name="v10-explore-trace-view"></a>

このセクションでは、Trace View ダッシュボードの要素について説明します。

**ヘッダー**

トレースビューのヘッダーには、次の要素があります。
+ ヘッダータイトル – ルートスパンの名前とトレース ID を表示します。
+ 検索 – 検索されたテキストを含むスパンを強調表示します。
+ メタデータ – トレースに関するさまざまなメタデータを表示します。

**ミニマップ**

要約ビューまたはトレースタイムラインを表示します。ポインタをミニマップにドラッグして、より短い時間範囲にズームインできます。ズームはメインタイムラインも更新するため、短いスパンを簡単に確認できます。ミニマップにカーソルを合わせ、ズームすると、ズームをリセットする **[選択のリセット]** ボタンが表示されます。

**スパンフィルター**

スパンフィルターを使用すると、トレースタイムラインビューワーでスパンをフィルタリングできます。追加するフィルターが多いほど、フィルターされたスパンがより具体的になります。

次の 1 つ以上のフィルターを追加できます。
+ リソースサービス名
+ スパン名
+ 時間
+ タグ (タグ、プロセスタグ、ログフィールドを含む)

一致したスパンのみを表示するには、**[Show matches only]** (一致のみを表示) トグルを選択します。

**タイムライン**

トレース内のスパンのリストを表示します。各スパン行は、次の要素で構成されます。
+ [Expand children] (子を展開) ボタン – 選択したスパンのすべての子スパンを展開または折りたたみます。
+ サービス名 – スパンをログに記録したサービスの名前。
+ オペレーション名 – このスパンが表すオペレーションの名前。
+ スパン期間バー – トレース内のオペレーション期間の視覚的表現。

**スパンの詳細**

スパン行を選択すると、以下を含むスパンの詳細が表示されます。
+ オペレーション名
+ スパンメタデータ
+ タグ – このスパンに関連付けられている任意のタグ。
+ プロセスメタデータ – このスパンをログに記録したプロセスに関するメタデータ。
+ ログ – このスパンおよび関連するキー値によってログに記録されたログのリスト。Zipkin ログの場合、セクションには Zipkin 注釈が表示されます。

**ログへのトレース**

トレースビューのスパンから、そのスパンに関連するログに直接移動できます。これは、Tempo、Jaeger、および Zipkin データソースで使用できます。各データソースの設定方法については、関連するドキュメントを参照してください。

ドキュメントアイコンを選択して、設定されたデータソースを使用して Explore で分割ビューを開き、スパンに関連するログに対してクエリを実行します。

**メトリクスへのトレース**

**注記**  
現在、この機能はベータモードです。

トレースビューのスパンから、そのスパンに関連するメトリクスに直接移動できます。この機能は、Tempo、Jaeger、および Zipkin データソースで使用できます。設定の詳細については、関連するドキュメントを参照してください。

**プロファイルへのトレース**

[Trace to profiles] (プロファイルへのトレース) を使用すると、トレースとプロファイルをリンクする機能を追加することで、さまざまなシグナルを関連付けられる Grafana の機能を利用できます。

## ノードグラフ
<a name="v10-explore-trace-node-graph"></a>

オプションで、表示されたトレースのノードグラフを展開できます。データソースによっては、トレースのスパンをグラフ内のノードとして表示したり、現在のトレースに基づくサービスグラフなどのコンテキストを追加したりできます。

## サービスグラフビュー
<a name="v10-explore-trace-graph"></a>

Service Graph ビューは、スパンメトリクス (レート、エラーレート、期間 (RED) のデータを追跡) とサービスグラフを視覚化します。要件が設定されると、この事前設定されたビューがすぐに利用できます。

詳細については、[Tempo](tempo-data-source.md) データソースのページを参照してください。[サービスグラフビューページ](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)は、「*Grafana Labs Tempo ドキュメント*」でも確認できます。

## Data API
<a name="v10-explore-trace-dataapi"></a>

この視覚化では、正しく表示するために、データソースから返されるデータの特定の形状が必要です。

データソースはデータフレームを返し、`frame.meta.preferredVisualisationType = 'trace'` を設定する必要があります。

**データフレーム構造**

必須フィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
| traceID | string | トレース全体の識別子。データフレームには 1 つのトレースのみが必要です。 | 
| spanID | string | 現在のスパンの識別子。SpanID はトレースごとに一意である必要があります。 | 
| parentSpanID | string | トレースビューで子親関係を作成するための親スパンの SpanID。親のないルートスパンでは undefined になる場合があります。 | 
| serviceName | string | このスパンが属するサービスの名前。 | 
| serviceTags | TraceKeyValuePair[] | サービスに関連するタグのリスト。 | 
| startTime | 数値 | スパンの開始時刻をミリ秒エポック時間で表します。 | 
| duration | 数値 | スパンの期間 (ミリ秒)。 | 

 オプションのフィールド 


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
| ログ | TraceLog[] | 現在のスパンに関連付けられたログのリスト。 | 
| タグ | TraceKeyValuePair[] | 現在のスパンに関連付けられたタグのリスト。 | 
| warnings | string[] | 現在のスパンに関連付けられた警告のリスト。 | 
| stackTraces | string[] | 現在のスパンに関連付けられたスタックトレースのリスト。 | 
| errorIconColor | string | スパンに error: true がタグ付けされている場合のエラーアイコンの色。 | 

タイプの詳細については、GitHub の [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28)、[TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)、および [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12) を参照してください。

# Explore の相関エディタ
<a name="v10-explore-correlations"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

相関関係により、ユーザーは 2 つのデータソース間のリンクを構築できます。相関関係の概要などの詳細については、「[Grafana バージョン 10 の相関関係](v10-correlations.md)」を参照してください。

## 相関関係の作成
<a name="v10-explore-corr-create-a-correlation"></a>

相関関係は、Explore ページから作成できます。

**相関を作成するには**

1. Amazon Managed Grafana ワークスペースで、Explore ページに移動します。

1. 新しい相関のソースにするデータソースを選択します。

1. サポートされている視覚化でデータを生成するクエリを実行します。
**注記**  
サポートされている視覚化は、[ログ](v10-panels-logs.md)と[テーブル](v10-panels-table.md)です。

1. 上部のツールバーで **[\$1 追加]** を選択し、**[相関の追加]** を選択します ([[コマンドパレット]](v10-search.md#v10-search-palette) から **[相関エディタ]** を選択することもできます)。

   Explore が相関エディタモードになりました。このモードは青い境界線と上部のバーで示されます。上部のバーで **[Exit]** (終了) を選択すると、相関エディタを終了できます。

1. 新しいクエリの構築に使用できるデータのリンクを使用して、視覚化に次の新しい相関関係を作成できるようになりました。
   + *[ログ]* – 各ログ行におけるログ詳細内のフィールド値の横にリンクが表示されます。
   + *[テーブル]* – テーブルセルはすべてリンクです。

1. リンクを選択して、新しい相関関係を追加します。リンクは、相関の結果フィールドとして使用されるフィールドに関連付けられます。詳細については、[相関関係の設定](v10-correlations-config.md)を参照してください。

1. 開いた分割ビューで、右側のペインを使用して相関のターゲットクエリソースを設定します。詳細については、[ターゲットクエリ](v10-correlations-config.md#v10-correlations-config-target-query)を参照してください。

1. ペイン上部のリストにある変数を有する[変数構文](v10-dash-variable-syntax.md)を使用して、ターゲットクエリを構築します。リストには、選択したデータ行のサンプル値が含まれます。

1. ラベルと説明を入力します (任意)。ラベルは、視覚化内のリンク名として使用され、変数を含めることができます。

1. 変換を指定します (任意。詳細については、以下を参照してください）。

1. 上部のツールバーで **[保存]** を選択して相関を保存し、相関エディタモードを終了します。相関関係の作成に使用されるリンクは、各行のデータリンクに置き換えられます。リンクを選択すると、定義したクエリが別のペインで実行され、変数は選択した行の値で動的に置き換えられます。

## 変換
<a name="v10-explore-corr-transformations"></a>

変換を使用すると、他のデータを含むフィールドにある値を抽出できます。例えば、変換を使用すると、ログ行の一部を抽出して相関関係に使用できます。相関関係の変換の詳細については、「[相関関係の変換](v10-correlations-config.md#v10-correlations-config-transformations)」を参照してください。

エディタモードで生成されたリンクの 1 つを選択したのち、**[変換]** ドロップダウンメニューで **[変換の追加]** を選択すると、変換を追加できます。

**相関関係で変換を使用するには**

1. 変換を適用するフィールドを選択します。変換に使用するフィールドの一部を選択します。例えば、ログ行です。選択すると、このフィールドの値が変換の構築に使用されます。

1. 変換のタイプを選択します。オプションと関連する設定については、「[相関関係の変換](v10-correlations-config.md#v10-correlations-config-transformations)」を参照してください。

1. 選択に基づいて、1 つ以上の変数の入力や、表示されるオプションでさらに仕様を指定する必要がある場合があります。

1. **[相関に変換を追加]** を選択して、指定した変数を使用可能な変数のリストに追加します。

**注記**  
このダイアログボックスにある正規表現の場合、他のドキュメントで参照されている `mapValue` は、ここでは `Variable Name` と呼び出されます。Grafana は、フィールド値の式に一致する任意のテキストを強調表示します。正規表現キャプチャグループを使用して、抽出する一致部分を選択します。有効な正規表現を指定すると、 変数とその変数の値が `Variable Name` フィールドの下に表示されます。

## 相関の例
<a name="v10-explore-corr-examples"></a>

次の例は、Explore の相関エディタを使用して相関を作成する方法を示しています。これらの例に従う場合は、必ず[テストデータソース](testdata-data-source.md)を設定してください。

### テキストとグラフの相関関係の作成
<a name="v10-explore-corr-text-to-graph"></a>

この例では、Explore の相関エディタを使用して相関を作成する方法を示しています。

相関関係を使用すると、1 つのクエリの結果を使用して、任意のデータソースで新しいクエリを実行できます。この例では、表形式データをレンダリングするクエリを実行します。データは、グラフ結果を生成する別のクエリを実行するために使用されます。

この例に従うには、必ず[テストデータソース](testdata-data-source.md)を設定してください。

**テキストとグラフの相関関係を作成するには**

1. Grafana で、**Explore** に移動します。

1. ページの左上にあるドロップダウンメニューから**テストデータソース**を選択します。

1. 右側のドロップダウンメニューで **[\$1 追加]** を選択し、**[相関の追加]** を選択します。

1. Explore が相関エディタモードになり、青い境界線で示されます。

1. シナリオドロップダウンメニューから **CSV ファイル**シナリオを選択します。

1. ファイル **population\$1by\$1state.csv** を選択します。各セルは、新しい相関関係の作成を開始するためにクリックできるリンクです。

1. `State` 列内の任意のセルをクリックして、そのエントリにデータリンクが付属する新しい相関関係を作成します。例えば、`California` を選択します。

1. 分割ビューで、左側のペインで選択したのと同じデータソースを選択します。クエリエディタの上にあるヘルパーには、ターゲットクエリを使用できる利用可能な変数がすべて含まれています。変数には、選択した行のすべてのデータフィールド (テーブル列) が含まれます。

1. **[シナリオ]** メニューで、**[CSV メトリクス値]** を選択します。クエリエディタの `String Input` フィールドには、各年の母集団値を持つ変数 `${1980},${2000},${2020}` が表示されます。これにより、変数値を使用してグラフが生成されます。

1. クエリエディタの **[Alias]** (エイリアス) フィールドに、`${State}` と入力します。

   クエリを実行して、変数のサンプル値を使用してグラフが生成されることを確認します。

1. **[保存]** を選択して相関を保存し、相関エディタを終了します。

   相関が保存されると、Explore は左側のペインでクエリを再実行します。状態名をクリックすると、右側のクエリが CSV に挿入された行の値で再実行され、グラフが変更されます。クエリは、状態名をクリックするたびに更新された値で再実行されます。

同じステップを任意のデータソースに適用できます。相関関係を使用すると、選択したデータに基づいて動的クエリを実行するためのリンクを視覚化で作成できます。この例では、クエリによって返されるデータを使用して、同じデータソースを使用して異なる視覚化を生成する新しいクエリを構築しました。ただし、任意のデータソース間に相関関係を作成して、カスタム探索フローを作成することもできます。

### ログとテーブルの相関関係の作成
<a name="v10-explore-corr-logs-to-table"></a>

この例では、相関関係を作成して、変換を使用してログ行と別のフィールドから値を抽出する方法を示します。

この例に従うには、必ず[テストデータソース](testdata-data-source.md)を設定してください。

**ログとテーブルの相関関係を作成するには**

1. Grafana で、**Explore** に移動します。

1. ページの左上にあるドロップダウンメニューから**テストデータソース**を選択します。

1. 右側のドロップダウンメニューで **[\$1 追加]** を選択し、**[相関の追加]** を選択します。

1. Explore が相関エディタモードになり、青い境界線で示されます。

1. **[Scenario]** メニューで、**[ログ]** を選択します。

1. ログ行を展開して、相関リンクを確認します。`Correlate with hostname` を選択します。

1. Explore が分割ビューで開きます。左側のペインで選択したのと同じデータソースを選択します。クエリエディタの上にあるヘルパーには、ターゲットクエリを使用できる利用可能な変数がすべて含まれています。

1. 変換セクションを展開し、**[変換の追加]** をクリックします。

1. **フィールド**ドロップダウンメニューで**メッセージ**を選択します。ログ行がサンプルデータとして表示されます。

1. **タイプ**で **[Logfmt]** を選択します。これにより、変数のリストが入力されます。

1. **[相関に変換を追加]** を選択します。

1. 再度 **[変換の追加]** を選択し、**[フィールド]**で**[ホスト名]**を選択します。

1. **タイプ**で**[正規表現]** を選択します。

1. **[式]** に `-([0-9]\*)` と入力します。これにより、ダッシュの右側にある任意の数値が選択されます。

1. **[変数名)]** に `hostNumber` と入力します。これにより、変数のリストが入力されます。

1. **[相関に変換を追加]** を選択して、他の変数に追加します。

1. データソースエディタで **[Scenario]** (シナリオ) ドロップダウンメニューを開き、**[CSV Content]** (CSV コンテンツ) を選択します。

1. 下にあるテキストボックスに以下を入力し、相関関係を保存します。

   ```
   time,msg,hostNumber,status
   ${time},${msg},${hostNumber},${status}
   ```

   これにより、分割ビューが閉じ、左側のクエリが再実行されます。任意のログ行を展開して、相関ボタンを確認します。相関ボタンを選択すると、分割ビューが開き、`time` (フィールド)、`msg` (ログ行から *logfmt* で抽出)、`host number` (`hostname` から*正規表現*で抽出)、`status` (ログ行から *logfmt* で抽出) が表示されます。

# Explore の Inspector
<a name="v10-explore-inspector"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

インスペクターは、クエリの理解とトラブルシューティングに役立ちます。未加工データを検査し、そのデータをカンマ区切り値 (CSV) ファイルにエクスポートし、ログ結果を TXT 形式でエクスポートし、クエリリクエストを表示できます。

## Inspector UI
<a name="v10-explore-inspector-ui"></a>

インスペクターには次のタブがあります。
+ **[統計タブ]** – クエリにかかる時間および返される量を示します。
+ **[クエリタブ]** – Grafana がデータソースへのクエリ実行時に送信されるサーバーへのリクエストを表示します。
+ **[JSON] タブ** – データ JSON とデータフレーム構造 JSON を表示およびコピーできます。
+ **[データタブ]** – クエリによって返される未加工データを表示します。
+ **[エラータブ]** – エラーを表示します。クエリがエラーを返す場合にのみ表示されます。

## Inspector タスク
<a name="v10-explore-inspector-tasks"></a>

Explore Inspector では、さまざまなタスクを実行できます。

**Inspector を開く**

検査するクエリを実行したら、**[Inspector]** ボタンを選択します。

画面の下部にインスペクターペインが開きます。

**未加工クエリ結果の検査**

未加工のクエリ結果、つまりクエリによって返されるデータをテーブルに表示できます。

**[Inspector]** タブで、**[Data]** タブをクリックします。

複数のクエリまたは複数のノードのクエリには、追加のオプションがあります。
+ **[データフレームを表示する]:** 表示する結果セットデータを選択します。
+ **[時間で結合された系列]**: すべてのクエリの未加工データを一度に表示し、列ごとに結果セットを 1 つ表示します。列見出しをクリックしてデータをソートできます。

**未加工のクエリ結果を CSV としてダウンロード**

Grafana は、ブラウザのデフォルトのダウンロード場所に CSV ファイルを生成します。お好みのビューワーで開くことができます。

1. **[Inspector]** タブで、上記の手順に従って未加工のクエリ結果を取得します。

1. エクスポートする未加工データが表示されるまで、クエリ設定を絞り込みます。

1. **[CSV のダウンロード]** を選択します。

Excel 用にフォーマットされた CSV ファイルをダウンロードするには、**[データオプション]** を展開して **[Excel 用にダウンロード]** トグルをオンにしてから、**[CSV のダウンロード]** オプションを選択します。

**ログ結果を TXT としてダウンロード**

**[Inspector]** タブで **[ログのダウンロード]** を選択すると、現在表示しているログの TXT ファイルを生成できます。

**トレース結果のダウンロード**

データソースタイプに基づいて、Grafana は、サポートされている形式 (Jaeger、Zipkin、または OTLP 形式) のいずれかでトレース結果の JSON ファイルを生成します。

1. [Inspector] を開きます。

1. ログクエリの結果を検査します。エクスポートする未加工ログが表示されるまで、結果を絞り込みます。

1. **[ログのダウンロード** を選択します。

**クエリパフォーマンスの検査**

**[統計]** タブには、クエリにかかる時間、送信したクエリの数、返された行数を示す統計が表示されます。この情報は、特に数値が予想外に高い場合や低い場合のクエリのトラブルシューティングに役立ちます。

統計が読み取り専用形式で表示されます。

**[JSON モデルの表示]**

データだけでなく、データフレーム JSON モデルも探索してエクスポートできます。

**JSON モデルを表示するには**

1. インスペクターパネルで、**[JSON]** タブをクリックします。

1. **[ソースの選択]** ドロップダウンから、以下のいずれかのオプションを選択します。
   + **[データ]** – Explore に返されたデータを表す JSON オブジェクトを表示します。
   + **[データフレーム構造]** – 未加工の結果セットを表示します。

1. JSON の一部を展開または折りたたんで、個別のセクションを表示できます。**[クリップボードにコピー]** オプションを選択して、JSON 本文をコピーし、別のアプリケーションに貼り付けることもできます。

**データソースへの未加工リクエストとレスポンスの表示**

Explore と Inspector タブを操作すると、クエリで生成する未加工のリクエストとレスポンスデータを表示できます。Inspector で **[クエリ]** タブを選択し、**[更新]** を選択して未加工データを表示します。

Grafana はクエリをサーバーに送信し、結果を表示します。クエリの特定の部分をドリルダウン、そのすべてを展開または折りたたみ、またはデータをクリップボードにコピーして他のアプリケーションで使用できます。

# Grafana バージョン 10 の相関関係
<a name="v10-correlations"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

相関を設定することで、Explore ビジュアライゼーションのインタラクティブリンクを作成して、提示されたデータに関連するクエリを実行できます。

相関は、あるデータソース内のデータを使用して別のデータソース内のデータをクエリする方法を定義します。例:
+ ログデータソースで返されるアプリケーション名を使用して、メトリクスデータソース内のそのアプリケーションに関連するメトリクスをクエリできます。
+ SQL データソースから返されるユーザー名を使用して、ログデータソース内の特定のユーザーに関連するログをクエリできます。

Explore では、ユーザー定義の相関関係を使用して、視覚化内のリンクを表示します。リンクをクリックすると、関連するクエリが実行され、Explore Split View で結果を確認できます。

相関関係に基づくリンクの表示を現在サポートしている視覚化について説明します。
+ [ログ](v10-panels-logs.md)
+ [[テーブル]](v10-panels-table.md)

相関関係は、Grafana で **[管理] > [プラグインとデータ] > [相関]** ページを使用するか、[[Explore]](v10-explore-correlations.md) で直接設定できます。

**Topics**
+ [相関関係の設定](v10-correlations-config.md)
+ [新しい相関関係を作成する](v10-correlations-create.md)

# 相関関係の設定
<a name="v10-correlations-config"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

 各相関関係は、次のオプションを使用して設定できます。

**ラベル**  
視覚化に表示されるリンクラベル。

**説明**  
オプションの説明。

**ソースデータソース**  
リンクが表示される結果のソース。

**結果フィールド**  
視覚化でリンクが表示される場所を定義します。

**ターゲットクエリ**  
ターゲットクエリは、リンクがクリックされたときに実行されます。

**[変換]**  
ターゲットクエリに渡される、含まれるソースデータへのオプションの操作。

相関関係の作成の詳細については、「[相関関係の作成](v10-correlations-create.md)」を参照してください。

## ソースデータソースと結果フィールド
<a name="v10-correlations-config-source-and-result"></a>

リンクは、相関関係のソースデータソースからの結果に関して、Explore の視覚化に表示されます。リンクは、相関設定で提供された結果 (結果フィールド) のフィールドの 1 つに割り当てられます。各視覚化では、異なる方法でリンクを含むフィールドが表示されます。

## ターゲットクエリ
<a name="v10-correlations-config-target-query"></a>

ターゲットクエリは、視覚化でリンクがクリックされたときに実行されます。選択したターゲットデータソースのクエリエディタを使用して、ターゲットクエリを指定できます。ソースデータの結果は、変数を使用してターゲットクエリ内でアクセスできます。

### 相関変数
<a name="v10-correlations-config-variables"></a>

ターゲットクエリ内の変数を使用して、クエリに関連するソースデータにアクセスできます。相関関係は [Grafana 変数構文](v10-dash-variable-syntax.md)を使用します。リンクが選択されると、変数にソース結果の値が入力されます。使用できる変数には 2 種類あります。
+ [フィールド変数](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (フィールド値とラベルへのアクセスのため）。
+ 相関変数 (フィールド値と変換へのアクセスのため）。

例: ソース結果に `employee` というフィールドが含まれている場合、フィールドの値には以下を使用してアクセスできます。
+ フィールド変数 `${__data.fields.employee}`。
+ 上記のフィールド値を `${employee}` にマッピングする相関変数。

フィールド値を短い変数名にマッピングするだけでなく、既存のフィールドに変換を適用することで、より多くの相関変数を作成できます。

相関関係は、すべての変数が選択したデータ行に値を持つ場合にのみデータリンクを作成します。[[グローバル変数]](v10-dash-variable-add.md#v10-dash-variable-add-global)はこのルールの例外であり、返されたデータから入力する必要はありません。これらの変数は、データソースによって自動的に補間されます。

### 相関関係の変換
<a name="v10-correlations-config-transformations"></a>

変換を使用すると、フィールド値からより多くの変数を抽出できます。変換の出力は、他の変数としてアクセスできる一連の新しい変数です。

変換には logfmt と正規表現の 2 種類があります。

各変換では、選択したフィールド値が入力として使用されます。変換の出力は、変換のタイプとオプションに基づく一連の新しい変数です。

### Logfmt 変換
<a name="v10-correlations-config-logfmt-transformation"></a>

logfmt 変換は、[[logfmt キーと値のペア]](https://brandur.org/logfmt) でフォーマットされたテキストを含むフィールド値を分解します。各ペアは変数になり、キーは変数の名前になります。

logfmt 変換では、結果フィールドとは異なるフィールドに変換を適用する場合にのみ、入力フィールド名を指定する必要があります。`field = "host=srv001 endpoint=/test app=foo"` の出力変数の例:


| 名前 | 値 | 
| --- | --- | 
| ホスト | srv001 | 
| エンドポイント | /test | 
| アプリケーション | foo | 

### 正規表現変換
<a name="v10-correlations-config-regular-expression-transformation"></a>

正規表現変換は、指定された正規表現に基づいてフィールド値を分解します。

正規表現変換オプション：

**field**  
入力フィールド名

**expression**  
正規表現 名前付きのキャプチャグループは、グループ名に一致する変数にマッピングされます。名前のない一致グループが使用されている場合、最初の一致から変数が作成されます。この値は、入力フィールドに一致する変数を上書きするか、mapValue が指定されている場合は新しい変数が作成されます (次の表の例を参照）。

**mapValue**  
一致する名前付きのグループのない単純な正規表現グループで使用されます。デフォルトでは、最初の一致は、入力として使用されるフィールドの名前で変数をオーバーライドします。デフォルトの動作を変更するには、mapValue プロパティを指定します。指定された名前は、新しい変数の作成に使用されます。これは、対象のクエリで、正確な値と変換で抽出された値の一部の両方が必要な場合に役立ちます。

例: 選択したフィールド名が `employee`で、フィールド値が `John Doe` であると仮定します。

式および mapValue オプションに基づくさまざまな出力変数：


| expression | mapValue | 出力変数 | コメント | 
| --- | --- | --- | --- | 
| /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | mapValue が指定されていません。最初の一致は、既存のフィールド名変数 (employee) にマッピングされます。 | 
| /(\$1w\$1) (\$1w\$1)/ | 名前 | name=John | 最初のマッチングは、name という新しい変数にマッピングされます。 | 
| /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | 名前付きグループを使用すると、出力変数の名前になり、mapValue は無視されます。 | 
| /(?\$1w\$1) (?\$1w\$1)/ | 名前 | firstName=John, lastName=Doe | 上記と同じ | 

# 新しい相関関係を作成する
<a name="v10-correlations-create"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

相関関係は、Explore の相関関係エディタで作成することも、Amazon Managed Grafana ワークスペースの Grafana **[管理]**ページを使用して作成することもできます。

**前提条件**

新しい相関関係を追加するアクセス許可が必要です。データソースへの書き込み権限を持つユーザーのみが、新しい相関関係を定義できます。

## Explore の相関関係エディタでの相関関係の作成
<a name="v10-correlations-create-explore"></a>

相関関係は、Explore 相関関係エディタで作成できます。詳細については、[相関関係の作成](v10-explore-correlations.md#v10-explore-corr-create-a-correlation)を参照してください。

## 管理ページでの相関関係の作成
<a name="v10-correlations-create-administration"></a>

Grafana コンソールの**[管理]**ページを使用して相関関係を作成できます。

**管理ページで相関関係を作成するには**

1. Grafana の**[管理]**セクションに移動します。

1. **[プラグインとデータ]** で、**[相関関係]** を開きます。

1. 右上隅の **[追加]** ボタンを選択します。

1. 相関の**ラベル**を指定します。

1. (オプション) **[説明]**を入力します。

1. 次のページに移動します。

1. **ターゲットデータソース**を指定します。

1. 変数を使用して**ターゲットクエリ**を指定します。

1. 次のページに移動します。

1. **ソースデータソース**を指定します。

1. **結果フィールド**を指定します。

1. ソースデータソースのフィールドではない変数が必要な場合は、変換を追加します。

1. **[追加]** を選択して新しい変換を追加します。

1. 変換のタイプを選択します。

1. 選択したタイプに応じて変換を設定します。

1. 相関関係を保存します。

相関関係は同じ方法で編集できますが、編集時に選択したデータソースを変更することはできません。

# Grafana バージョン 10 のアラート
<a name="v10-alerts"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana バージョン 10 において、Amazon Managed Grafana には最新のアラートシステム *[Grafana アラート]*が含まれており、アラート情報を一元的に管理、検索できるビューが用意されています。Grafana アラートは Grafana バージョン 8 のオプション機能として導入され、GrafanaLabs はバージョン 11 でレガシーアラートの削除を発表しました。

**注記**  
このドキュメントでは、Grafana アラートについて説明します。レガシーアラートの詳細については、「[従来のダッシュボードアラート](old-alerts-overview.md)」を参照してください。

Grafana アラートを使用すると、システムの問題が発生した直後にその問題を把握できます。

受信メトリクスデータまたはログエントリをモニタリングし、アラートシステムをセットアップして特定のイベントや状況を監視し、問題が見つかったときに通知を送信します。

これにより、手動モニタリングが不要になり、重大なインシデントにつながる可能性のあるシステム停止や変更に対する防御策を講じることができます。

Grafana アラートを使用すると、データがどこに保存されていても、複数のデータソースからクエリと式を作成できます。これにより、データを柔軟に結合し、メトリクスとログを新しく独自の方法でアラートを送信できます。それに続いて、単一の統合されたビューからアラートを作成、管理、およびアクションを実行し、チームが問題をすばやく特定して解決する能力を向上させることができます。

Mimir と Loki のアラートルールを使用すると、データ周囲で大規模なアラート式を実行できます。これらはすべて、お使いの Grafana UI によって管理されます。

**注記**  
レガシー Grafana アラートを使用した以前のバージョンの Grafana から移行する場合は、[レガシーアラートと新しい Grafana アラートの違い](v10-alerting-use-grafana-alerts.md#v10-alerting-diff-old-new)を確認すると役立つ場合があります。

## 主な特徴と利点
<a name="v10-alerting-key-features"></a>

**すべてのアラートを単一のページに**

Grafana が管理するアラートと、Prometheus 互換データソースに存在するアラートの両方が 1 つの Grafana アラートページに統合されます。

**多次元アラート**

アラートルールは、「多次元アラート」と呼ばれるアラートルールごとに複数の個別のアラートインスタンスを作成できるため、1 つのアラートルールだけでシステム全体の可視性を得るための機能と柔軟性が得られます。多次元ルールを作成するには、クエリにラベルを追加して、モニタリング対象のコンポーネントを指定し、単一のアラートルールに対して複数のアラートインスタンスを生成します。例えば、クラスター内の各サーバーをモニタリングする場合、各 CPU で多次元アラートがアラートされ、サーバー全体で標準アラートがアラートされます。

**ルートアラート**

定義したラベルに基づいて、各アラートインスタンスを特定のコンタクトポイントにルーティングします。通知ポリシーは、アラートがどこで、いつ、どのようにコンタクトポイントにルーティングされるかを定義するルールのセットです。

**サイレンスアラート**

サイレンスは、通知の作成を停止し、指定された期間だけ継続します。サイレンスを使用すると、1 つ以上のアラートルールからの永続通知の受信を停止できます。また、特定の基準に基づいてアラートを部分的に一時停止することもできます。サイレンスには、整理と可視性を向上させるための独自の専用セクションがあるため、メインアラートビューを乱すことなく一時停止したアラートルールをスキャンできます。

**ミュートタイミング**

ミュートタイミングとは、ポリシーの新しい通知が生成されたり送信されないようにする繰り返しの時間間隔です。定期的なメンテナンス期間など、アラートが特定の期間や繰り返し発生するのを防ぐために使用されます。

サイレンスと似ていますが、ミュートタイミングはアラートルールの評価や、ユーザーインターフェースへのアラート表示を停止せず、通知の作成のみを防ぎます。

## アラートシステムを設計する
<a name="v10-alerting-design"></a>

複雑な IT システムを監視し、すべてが正しく動作しているかどうかを理解することは難しい作業です。したがって、効果的なアラート管理システムを設定して、問題が発生したときにビジネスの成果に影響を与える前に通知することが不可欠です。

機能するアラート管理設定の設計と構成には時間がかかります。

ここでは、ビジネスに効果的なアラート管理の設定を作成する方法に関するヒントをいくつか紹介します。

**監視およびアラートを行うビジネスの主要なメトリクスはどれですか？**
+ 受信者が無視するほど些細で頻繁ではない、知っておくべき重要なイベントを見つけます。
+ アラートは、即時の対応や介入を必要とする大きなイベントに対してのみ作成すべきです。
+ 量よりも質を考慮してください。

**どのタイプのアラートを使用しますか？**
+ Grafana が管理するアラート、Grafana Mimir または Loki が管理するアラート、またはその両方を選択します。

**アラートと通知をどのように整理しますか？**
+ アラートを受信するように設定するユーザーを選択します。対応中のユーザーまたは特定の Slack チャネルに送信することを検討してください。
+ アラート API またはコードとしてのアラート (Terraform) として使用して、可能な限り自動化します。

**アラート疲れを減らすにはどうすればよいですか？**
+ サイレンス、ミュートタイミング、アラートルール評価の一時停止を使用して、ノイズの多い不要なアラートを回避します。
+ アラートルールを継続的に調整して、有効性を確認します。アラートルールを削除して、重複や無効なアラートを防ぎます。
+ 優先度と重要度レベルを慎重に検討してください。
+ しきい値と評価ルールを継続的に確認します。

## Grafana アラートの制約事項
<a name="v10-alerting-limitations"></a>
+ 他のシステムからルールを集約する場合、Grafana アラートシステムは、利用可能なすべての Amazon Managed Service for Prometheus、Prometheus、Loki、およびアラートマネージャーデータソースからルールを取得できますが、他のサポートされているデータソースからはルールを取得できない場合があります。

**Topics**
+ [主な特徴と利点](#v10-alerting-key-features)
+ [アラートシステムを設計する](#v10-alerting-design)
+ [Grafana アラートの制約事項](#v10-alerting-limitations)
+ [概要:](v10-alerting-overview.md)
+ [アラートの設定](v10-alerting-setup.md)
+ [アラートを設定する](v10-alerting-configure.md)
+ [アラートの管理](v10-alerting-manage.md)

# 概要:
<a name="v10-alerting-overview"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

始めたばかりのユーザーでも、Grafana アラートの経験豊富なユーザーでも、アラートの作成、管理、対応に役立つ基本と利用可能な機能の詳細を確認することで、問題を迅速に解決するチームの能力を向上させることができます。

## Principles
<a name="v10-alerting-overview-principles"></a>

Prometheus ベースのアラートシステムでは、アラートを作成するアラートジェネレーターと、アラートを受信するアラートレシーバーがあります。たとえば、Prometheusはアラートジェネレーターであり、アラートルールの評価を担当します。アラートマネージャーはアラートレシーバーであり、発射アラートと解決済みアラートに関する通知のグループ化、禁止、サイレンシング、送信を担当します。

Grafana アラートは、アラートシステムを設計する Prometheus モデルに基づいて設計されています。アラートルールのスケジュールと評価を担当する内部アラートジェネレーターと、通知のグループ化、禁止、サイレンシング、送信を担当する内部アラートレシーバーがあります。Grafana は Prometheus をアラートジェネレーターとして使用しません。これは、Grafana アラートが Prometheus に加えて他の多くのデータソースと連携する必要があるためです。ただし、アラートマネージャーをアラートレシーバーとして使用します。

アラートはアラートレシーバーに送信され、ルーティング、グループ化、禁止、サイレンシング、通知されます。Grafana アラートでは、デフォルトのアラートレシーバーは Grafana 内に埋め込まれたアラートマネージャーであり、Grafana アラートマネージャーと呼ばれます。ただし、他のアラートマネージャーを使用することもできます。これらは[外部アラートマネージャー](v10-alerting-setup-alertmanager.md)と呼ばれます。

## 基礎
<a name="v10-alerting-overview-fundamentals"></a>

以下に、Grafana アラートのさまざまな部分の概要を示します。

### アラートルール
<a name="v10-alerting-overview-alert-rules"></a>

アラートルールは、アラートがいつ発生するかを決定する一連の基準です。これは、1つ以上のクエリと式、満たす必要がある条件、アラートルールを評価する頻度を決定する間隔、およびアラートを発射するために条件を満たす必要がある期間で構成されます。

アラートルールはその間隔で評価され、各アラートルールは一度に0、1、または任意の数のアラートを発射できます。アラートルールの状態は、通常、保留中、または発射のいずれかの `severe` アラートによって決まります。例えば、アラートルールのアラートの少なくとも 1 つが発射されている場合、アラートルールも発射されます。アラートルールの状態は、最新の評価のステータスによって決まります。これらは、OK、Error、NoData のいずれかです。

アラートルールの非常に重要な特徴は、カスタム注釈とラベルをサポートすることです。これにより、概要や説明などの追加のメタデータを使用してアラートを計測し、特定の通知ポリシーにアラートをルーティングするためのラベルを追加できます。

### アラート
<a name="v10-alerting-overview-alerts"></a>

アラートは、ラベルと呼ばれるキーと値のペアのセットによって一意に識別されます。各キーはラベル名、各値はラベル値です。例えば、あるアラートにはラベル `foo=bar` があり、別のアラートにはラベル `foo=baz` がある場合があります。アラートには `foo=bar,bar=baz` などの多くのラベルを含めることができますが、`foo=bar,foo=baz` などの同じラベルを 2 回持つことはできません。2 つのアラートに同じラベルを付けることもできず、2 つのアラートに `foo=bar,bar=baz` と `foo=bar,bar=baz` などの同じラベルがある場合、いずれかのアラートが破棄されます。アラートは、アラートルールの条件が満たされなくなるか、アラートルールが削除されると解決されます。

Grafana マネージドアラートでは、アラートは、正常、保留中、アラート中、データなし、エラー状態のいずれかになります。Mimir や Loki などのデータソースマネージドアラートでは、アラートは正常、保留中、アラートにすることができますが、NoData やエラーにすることはできません。

### コンタクトポイント
<a name="v10-alerting-overview-contact-points"></a>

コンタクトポイントは、通知の送信先を決定します。例えば、E メールアドレス、Slack、Grafana OnCall や Pagerduty などのインシデント管理システム (IRM)、またはウェブフックに通知を送信するコンタクトポイントがあるとします。

コンタクトポイントから送信される通知は、通知テンプレートを使用してカスタマイズできます。通知テンプレートを使用して、通知の件名、メッセージ、構造を変更できます。通知テンプレートは、個々の統合やコンタクトポイントに固有のものではありません。

### 通知ポリシー
<a name="v10-alerting-overview-notification-policies"></a>

通知ポリシーはアラートをグループ化し、コンタクトポイントにルーティングします。通知が送信されるタイミングと、通知を繰り返す頻度を決定します。

アラートは、ラベルマッチャーを使用して通知ポリシーとマッチングされます。これらは、アラートのラベルが完全に一致するかどうか、完全に一致しないかどうか、予期されるテキストが含まれているかどうか、または含まれていないかどうかを示す、人間が判読できる式です。例えば、マッチャー `foo=bar` はアラートをラベル `foo=bar` に一致させ、マッチャー `foo=~[a-zA-Z]+` は foo という名前のラベルを正規表現 `[a-zA-Z]+` に一致する値に一致させます。

デフォルトでは、アラートは 1 つの通知ポリシーにのみ一致できます。ただし、 `continue` 機能を使用すると、任意の数の通知ポリシーを同時に一致させるようにアラートを作成できます。通知ポリシーの詳細については、[「通知ポリシー」](v10-alerting-explore-notifications-policies-details.md)を参照してください。

### サイレンスとミュートタイミング
<a name="v10-alerting-overview-silences-and-mute-timings"></a>

サイレンスとミュートタイミングを使用すると、特定のアラートまたは通知ポリシー全体の通知を一時停止できます。アラートの修正作業中など、サイレンスを使用してアドホックベースで通知を一時停止し、定期的なメンテナンスウィンドウ中など、ミュートタイミングを使用して定期的に通知を一時停止することができます。

**Topics**
+ [Principles](#v10-alerting-overview-principles)
+ [基礎](#v10-alerting-overview-fundamentals)
+ [データソースと Grafana アラート](v10-alerting-overview-datasources.md)
+ [数値データのアラート](v10-alerting-overview-numeric.md)
+ [ラベルと注釈](v10-alerting-overview-labels.md)
+ [アラートルールについて](v10-alerting-explore-rules.md)
+ [アラートマネージャー](v10-alerting-explore-alertmanager.md)
+ [コンタクトポイント](v10-alerting-explore-contacts.md)
+ [通知](v10-alerting-explore-notifications.md)
+ [高可用性のアラート](v10-alerting-explore-high-availability.md)

# データソースと Grafana アラート
<a name="v10-alerting-overview-datasources"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana アラートと互換性のあるデータソースは多数あります。各データソースはプラグインでサポートされています。Grafana アラートでは、評価エンジンがバックエンドで実行されるため、データソースを使用してルールを評価するために、データソースプラグインを*バックエンド*プラグインにする必要があります。プラグインは、Grafana アラートと互換性があることも指定する必要があります。

データソースは時間の経過とともに追加および更新されます。以下のデータソースは、Grafana アラートと互換性があるものをご紹介しています。
+ [Amazon CloudWatch データソースへの接続](using-amazon-cloudwatch-in-AMG.md)
+ [Azure Monitor データソースへの接続](using-azure-monitor-in-AMG.md)
+ [Amazon OpenSearch Service データソースへの接続](using-Amazon-OpenSearch-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)
+ [Amazon Managed Service for Prometheus およびオープンソースの Prometheus データソースへの接続](prometheus-data-source.md)
+ [Jaeger データソースへの接続](jaeger-data-source.md)
+ [Zipkin データソースへの接続](zipkin-data-source.md)
+ [Tempo データソースへの接続](tempo-data-source.md)
+ [テスト用 TestData データソースの設定](testdata-data-source.md)

Amazon Managed Grafana のデータソースとデータソースプラグインの詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

# 数値データのアラート
<a name="v10-alerting-overview-numeric"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

このトピックでは、Grafana が時系列データではなく数値データのアラートを処理する方法について説明します。

特定のデータソースでは、時系列ではない数値データをサーバーサイド式 (SSE) で直接アラートしたり、渡したりすることができます。これにより、データソース内の処理と効率が向上し、アラートルールを簡素化することができます。時系列データではなく数値データを基にアラートを送信する場合、ラベル付きの各時系列を 1 つの数値に集約する必要はありません。代わりに、ラベル付き番号が Grafana に返されます。

## 表形式のデータ
<a name="v10-alerting-numeric-tabular"></a>

この機能は、表形式データをクエリするバックエンドデータソースでサポートされています。
+ 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 など) 列と、オプションで追加の文字列列のみが含まれている。

文字列がある場合、それらの列はラベルになります。列の名前がラベル名になり、各行の値が対応するラベルの値になります。複数の行が返された場合、各行はラベルによって一意に識別される必要があります。

## 例
<a name="v10-alerting-numeric-tabexample"></a>

「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="v10-alerting-overview-labels"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ラベルと注釈には、アラートに関する情報が含まれています。ラベルと注釈はどちらも同じ構造であり、名前付き値のセットですが、用途は異なります。ラベルまたは同等の注釈の例は、`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%."` などの各アラートに説明を追加することもできます (これを行う方法については、[ラベルと注釈のテンプレート作成](v10-alerting-overview-labels-templating.md) のドキュメントを参照してください）。このような説明は、注釈としてより適しています。

## ラベル
<a name="v10-alerting-overview-labels-labels"></a>

ラベルには、アラートを識別する情報が含まれます。ラベルの例は `server=server1` です。各アラートには複数のラベルを含めることができ、アラートのラベルの完全なセットはラベルセットと呼ばれます。アラートを識別するのはこのラベルセットです。

例えば、アラートにラベルセット `{alertname="High CPU usage",server="server1"}` が設定されているのに対し、別のアラートにラベルセット `{alertname="High CPU usage",server="server2"}` が設定されている場合があります。`alertname` ラベルは同じですが、`server` ラベルは異なるため、これらは 2 つの別々のアラートです。

アラートのラベルセットは、データソースのラベル、アラートルールのカスタムラベル、`alertname` などの予約済みラベルの組み合わせです。

**カスタムラベル**

カスタムラベルは、アラートルールからの追加ラベルです。注釈と同様に、カスタムラベルには名前が必要です。その値には、アラートが発射したときに評価されるテキストコードとテンプレートコードの組み合わせを含めることができます。カスタムラベルをテンプレート化する方法については、 [こちら](v10-alerting-overview-labels-templating.md)を参照してください。

テンプレートでカスタムラベルを使用する場合、多数の個別のアラートが生成されるのを避けるため、ラベルの値がアラートルールの連続した評価間で変化しないようにすることが重要です。ただし、テンプレートが異なるアラートに対して異なるラベル値を生成しても問題ありません。例えば、値が変更されるたびに新しいアラートセットが作成されてしまうため、クエリの値をカスタムラベルに入れないでください。代わりに注釈を使用します。

また、アラートのラベルセットに同じ名前のラベルが 2 つ以上ないことを確認することも重要です。カスタムラベルの名前がデータソースのラベルと同じ場合は、そのラベルが置き換えられます。ただし、カスタムラベルの名前が予約済みラベルと同じ場合、カスタムラベルはアラートから省略されます。

## ‏注釈
<a name="v10-alerting-overview-labels-annotations"></a>

注釈は、既存のアラートに追加情報を追加する名前付きペアです。Grafana には、`description`、`summary`、`runbook_url`、`dashboardUId`、`panelId` など、推奨される注釈が多数あります。カスタムラベルと同様に、注釈には名前が必要です。その値には、アラートが発射したときに評価されるテキストコードとテンプレートコードの組み合わせを含めることができます。注釈にテンプレートコードが含まれている場合は、アラートが発生したときにテンプレートが 1 回評価されます。アラートが解決されても、再評価されません。注釈をテンプレートする方法については、[こちら](v10-alerting-overview-labels-templating.md)を参照してください。

**Topics**
+ [ラベル](#v10-alerting-overview-labels-labels)
+ [‏注釈](#v10-alerting-overview-labels-annotations)
+ [ラベル一致の仕組み](v10-alerting-overview-labels-matching.md)
+ [Grafana アラートのラベル](v10-alerting-overview-labels-alerting.md)
+ [ラベルと注釈のテンプレート作成](v10-alerting-overview-labels-templating.md)

# ラベル一致の仕組み
<a name="v10-alerting-overview-labels-matching"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ラベルとラベルマッチャーを使用して、アラートルールを通知ポリシーとサイレンスにリンクできます。これにより、アラートインスタンスを柔軟に管理し、処理するポリシーとサイレンスするアラートを指定できます。

ラベルマッチャーは、**ラベル**、**値**、**演算子** の 3 つの異なる部分で構成されます。
+ **[ラベル]**フィールドは、一致するラベルの名前です。ラベル名と完全に一致する必要があります。
+ **[値]**フィールドは、指定された**ラベル**名の対応する値と一致します。一致方法は、**演算子**の値によって異なります。
+ **[演算子]** フィールドは、ラベル値と一致させる演算子です。利用できる演算子は次のとおりです。


| 演算子 | 説明 | 
| --- | --- | 
| `=` | 値と完全に等しいラベルを選択します。 | 
| `!=` | 値と等しくないラベルを選択します。 | 
| `=~` | 値と正規表現が一致するラベルを選択します。 | 
| `!~` | 値と正規表現が一致しないラベルを選択します。 | 

複数のラベルマッチャーを使用している場合は、AND 論理演算子を使用して組み合わせられます。つまり、ルールをポリシーにリンクするには、すべてのマッチャーが一致する必要があります。

## 例
<a name="v10-alerting-overview-labels-matching-ex"></a>

アラートに次のラベルセットを定義する場合：

```
{ foo=bar, baz=qux, id=12 }
```

次に：
+ `foo=bar` として定義されたラベルマッチャーは、このアラートルールと一致します。
+ `foo!=bar` として定義されたラベルマッチャーがこのアラートルールと一致*しません*。
+ `id=~[0-9]+` として定義されたラベルマッチャーは、このアラートルールと一致します。
+ `baz!~[0-9]+` として定義されたラベルマッチャーは、このアラートルールと一致します。
+ `foo=bar`と`id=~[0-9]+`として定義された 2 つのラベルマッチャーは、このアラートルールと一致します。

## ラベルを除外する
<a name="v10-alerting-overview-labels-matching-exclude"></a>

また、ラベルを除外するためにラベルマッチャーを記述することもできます。

ラベル`team`を除外する方法を示す例を次に示します。これらの値のいずれかを選択して、ラベルを除外できます。
+ `team=""`
+ `team!~.+`
+ `team=~^$`

# Grafana アラートのラベル
<a name="v10-alerting-overview-labels-alerting"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

このトピックでは、ラベルがアラートの基本コンポーネントである理由について説明します。
+ アラートの完全なラベルセットは、Grafana アラート内のアラートを一意に識別するものです。
+ アラートマネージャーはラベルを使用して、通知ポリシーのサイレンスとアラートグループのアラートを照合します。
+ アラート UI には、そのルールの評価中に生成されたすべてのアラートインスタンスのラベルが表示されます。
+ コンタクトポイントには、通知を生成する際にラベルにアクセスして、そのアラートに固有の情報を含めることができます。
+ [アラートルール](v10-alerting-configure.md)にラベルを追加できます。ラベルは手動で設定でき、テンプレート関数を使用し、他のラベルを参照できます。アラートルールに追加されたラベルは、ラベル間で競合が発生した場合に優先されます (Grafana の予約済みラベルの場合を除きます。詳細については、以下を参照してください)。

## 外部アラートマネージャーの互換性
<a name="v10-alerting-overview-labels-alerting-external"></a>

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 予約済みラベル
<a name="v10-alerting-overview-labels-alerting-reserved"></a>

**注記**  
`grafana_` のプレフィックスがついたラベルは、Grafana によって特別な用途のために予約されています。`grafana_` で始まる手動で設定されたラベルが追加されると、競合時に上書きされます。

Grafana 予約済みラベルは、手動で設定されたラベルと同じ方法で使用できます。利用可能な予約済みラベルの現在のリストは次のとおりです。


| ラベル | 説明 | 
| --- | --- | 
| grafana\$1folder | アラートを含むフォルダのタイトル。 | 

# ラベルと注釈のテンプレート作成
<a name="v10-alerting-overview-labels-templating"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

テンプレートを使用して、クエリや式からのデータをラベルや注釈に含めることができます。たとえば、クエリの値に基づいてアラートの重大度ラベルを設定したり、クエリのインスタンスラベルをサマリー注釈で使用して、CPU使用率が高いサーバーを特定したりできます。

すべてのテンプレートは、[テキスト/テンプレート ](https://pkg.go.dev/text/template)で記述する必要があります。ラベルと注釈のどちらをテンプレート化するかにかかわらず、テンプレート化するラベルまたは注釈内に各テンプレートをインラインで記述する必要があります。つまり、ラベルと注釈間でテンプレートを共有することはできません。代わりに、テンプレートを使用する場所を問わず、テンプレートをコピーする必要があります。

各テンプレートは、アラートルールが評価されるたびに評価され、アラートごとに個別に評価されます。例えば、アラートルールにテンプレート作成されたサマリー注釈があり、アラートルールに 10 個の起動アラートがある場合、テンプレートはアラートごとに 10 回実行されます。テンプレートで高価な計算をできるだけ行わないようにする必要があります。

## 例
<a name="v10-alerting-overview-labels-templating-examples"></a>

次の例では、テキスト/テンプレートに関する完全なチュートリアルを記述するのではなく、テンプレートに関連する最も一般的なユースケースを示しています。これらの例を逐語的に使用したり、ユースケースに合わせて必要に応じて変更したりできます。テキスト/テンプレートの記述方法の詳細については、[テキスト/テンプレート](https://pkg.go.dev/text/template)のドキュメントを参照してください。

**すべてのラベルをカンマ区切りで印刷する**

すべてのラベルをカンマ区切りで印刷するには、`$labels` 変数を出力します:

```
{{ $labels }}
```

例えば、ラベル `alertname=High CPU usage`、`grafana_folder=CPU alerts`、および `instance=server1` を含むアラートがあると、以下が印刷されます: 

```
alertname=High CPU usage, grafana_folder=CPU alerts, instance=server1
```

**注記**  
クラシック条件を使用している場合、 `$labels` にはクエリからのラベルは含まれません。詳細については、[\$1labels 変数](#v10-alerting-overview-labels-templating-the-labels-variable)を参照してください。

**すべてのラベルを 1 行に 1 つずつ印刷する**

すべてのラベルを 1 行に 1 つずつ印刷するには、 `range` を使用して各キーと値のペアを反復し、個別に印刷します。ここでは、`$k` の名前と現在のラベルの値 `$v` を参照します。

```
{{ range $k, $v := $labels -}}
{{ $k }}={{ $v }}
{{ end }}
```

例えば、ラベル `alertname=High CPU usage`、`grafana_folder=CPU alerts`、および `instance=server1` を含むアラートがあると、以下が印刷されます:

```
alertname=High CPU usage
grafana_folder=CPU alerts
instance=server1
```

**注記**  
クラシック条件を使用している場合、 `$labels` にはクエリからのラベルは含まれません。詳細については、[\$1labels 変数](#v10-alerting-overview-labels-templating-the-labels-variable)を参照してください。

**個々のラベルの印刷**

個々のラベルを印刷するには、`$labels` 変数で `index` 関数を使用します。

```
The host {{ index $labels "instance" }} has exceeded 80% CPU usage for the last 5 minutes
```

例えば、ラベル `instance=server1` のアラートがあると、以下が印刷されます:

```
The host server1 has exceeded 80% CPU usage for the last 5 minutes
```

**注記**  
クラシック条件を使用している場合、 `$labels` にはクエリからのラベルは含まれません。詳細については、[\$1labels 変数](#v10-alerting-overview-labels-templating-the-labels-variable)を参照してください。

**クエリの値を印刷する**

インスタントクエリの値を印刷するには、`index` 関数と `$values` 変数を使用して Ref ID を印刷します。

```
{{ index $values "A" }}
```

例えば、値 81.2345 を返すインスタントクエリがあると、次の内容が印刷されます:

```
81.2345
```

範囲クエリの値を印刷するには、まず縮小式を使用して時系列からインスタントベクトルに値を変換する必要があります。その後、代わりに Ref ID を使用して、縮小式の結果を印刷できます。例えば、縮小式が A の平均を取得し、Ref ID B がある場合、次のように記述します: 

```
{{ index $values "B" }}
```

**クエリのヒューマナイズされた値を印刷する**

インスタントクエリのヒューマナイズされた値を印刷するには、 `humanize` 関数を使用します:

```
{{ humanize (index $values "A").Value }}
```

例えば、値 81.2345 を返すインスタントクエリがあると、次の内容が印刷されます: 

```
81.234
```

範囲クエリのヒューマナイズされた値を印刷するには、まず時系列から、縮小式を使用してインスタントベクトルに減らす必要があります。その後、代わりに Ref ID を使用して、縮小式の結果を印刷できます。例えば、縮小式が A の平均を取得し、Ref ID B がある場合、次のように記述します: 

```
{{ humanize (index $values "B").Value }}
```

**クエリの値をパーセンテージで印刷する**

インスタントクエリの値をパーセンテージで印刷するには、 `humanizePercentage` 関数を使用します:

```
{{ humanizePercentage (index $values "A").Value }}
```

この関数は、値が 0 から 1 までの 10 進数であることを想定しています。代わりに、値が 0 から 100 までの 10 進数の場合、クエリまたは数式を使用して 100 で割ることができます。クエリが範囲クエリである場合は、まず、時系列から縮小式を使用してインスタントベクトルにクエリを減らす必要があります。

**クエリの値から重要度を設定する**

クエリの値から重要度ラベルを設定するには、if ステートメントと greater than 比較関数を使用します。テキスト/テンプレートは型強制をサポートしていないため、`$values` と比較するときは、必ず小数点 (`80.0`、`50.0`、`0.0` など) を使用してください。サポートされているすべての比較関数のリストは、[こちら](https://pkg.go.dev/text/template#hdr-Functions)で確認できます。

```
{{ if (gt $values.A.Value 80.0) -}}
high
{{ else if (gt $values.A.Value 50.0) -}}
medium
{{ else -}}
low
{{- end }}
```

**クラシック条件からすべてのラベルを印刷する**

従来の条件を使用している場合、 `$labels` を使用してクエリからラベルを印刷することはできません。代わりに `$values` を使用する必要があります。これは、クラシック条件がこれらのラベルを破棄して一次元動作を適用するためです (アラートルールごとに最大 1 つのアラート）。クラシック条件でこれらのラベルが破棄されない場合、多くの時系列を返すクエリでは、アラートルールが評価されるたびにラベルが変更されるため、アラートの発射と解決の間でアラートが頻繁に発生します。

代わりに、 `$values` 変数には、発射するすべての条件のすべての時系列の減算値が含まれます。例えば、2 つの時系列を返すクエリ A と、2 つの条件を持つクラシック条件 B を持つアラートルールがある場合、 `$values` には、`B0`、`B1`、`B2`、`B3` が含まれます。クラシック条件 B に 1 つの条件しかない場合、 `$values` には `B0` と `B1` のみが含まれます。

すべての発射時系列のすべてのラベルを印刷するには、次のテンプレートを使用します (正規表現の `B` を、異なる場合はクラシック条件の Ref ID に置き換えてください)。

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Labels }}{{ end }}
{{ end }}
```

例えば、1 つの条件を超える 2 つの時系列のクラシック条件が出力されます。

```
B0: instance=server1
B1: instance=server2
```

クラシック条件に2つ以上の条件があり、時系列が同時に複数の条件を超える場合、超過した条件ごとにラベルが重複します。

```
B0: instance=server1
B1: instance=server2
B2: instance=server1
B3: instance=server2
```

一意のラベルを印刷する必要がある場合は、代わりにアラートルールを一次元から多次元に変更することを検討する必要があります。これを行うには、クラシック条件を縮小式と数式に置き換えます。

**クラシック条件のすべての値を印刷する**

クラシック条件のすべての値を印刷するには、前の例を取って `$v.Labels` を `$v.Value` に置き換えます。

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Value }}{{ end }}
{{ end }}
```

例えば、1 つの条件を超える 2 つの時系列のクラシック条件が出力されます。

```
B0: 81.2345
B1: 84.5678
```

クラシック条件に 2 つ以上の条件があり、時系列が同時に複数の条件を超える場合、`$values` にはすべての条件の値が含まれます。

```
B0: 81.2345
B1: 92.3456
B2: 84.5678
B3: 95.6789
```

## [変数]
<a name="v10-alerting-overview-labels-templating-variables"></a>

ラベルと注釈をテンプレート化する場合、次の変数を使用できます:

### ラベル変数
<a name="v10-alerting-overview-labels-templating-the-labels-variable"></a>

`$labels` 変数には、クエリのすべてのラベルが含まれます。たとえば、すべてのサーバーの CPU 使用率を返すクエリがあり、いずれかのサーバーの CPU 使用率が過去 5 分間に 80% を超えたときに起動するアラートルールがあるとします。どのサーバーで CPU 使用率が高いかを知らせるサマリー注釈をアラートに追加します。`$labels` 変数を使用すると、次のような判読可能な文を印刷するテンプレートを記述できます: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes
```

**注記**  
クラシック条件を使用している場合、 `$labels` にはクエリからのラベルは含まれません。クラシック条件は、一次元動作 (アラートルールごとに最大 1 つのアラート) を適用するために、これらのラベルを破棄します。テンプレートでクエリのラベルを使用する場合は、前の「*クラシック条件からすべてのラベルを印刷する*」の例に従います。

### 値変数
<a name="v10-alerting-overview-labels-templating-the-value-variable"></a>

`$value` 変数は、アラートルールのすべてのインスタントクエリのラベルと値、しきい値、縮小式と数式、およびクラシック条件を含む文字列です。範囲クエリの結果は、10 から 10,000 行またはメトリクスのどれかを返す可能性があるため、含まれていません。そうした場合、特に大きなクエリでは、1 つのアラートで 10 MB のメモリが使用され、Grafana でメモリが非常に迅速に不足する可能性があります。

サマリーで `$value` 変数を印刷するには、次のような内容を作成します。

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ $value }}
```

次のように表示されます。

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: [ var='A' labels={instance=instance1} value=81.234 ]
```

ここで `var='A'` は、Ref ID A を使用したインスタントクエリを参照し、ラベル `labels={instance=instance1}` を参照し、過去 5 分間の平均 CPU 使用率 `value=81.234` を参照します。

完全な文字列ではなく一部の文字列のみを印刷する場合は、 `$values` 変数を使用します。`$value` と同じ情報が含まれていますが、構造化されたテーブルの形態をとっており、必要なテキストのみに一致する正規表現を記述するよりもはるかに使いやすくなっています。

### 値変数
<a name="v10-alerting-overview-labels-templating-the-values-variable"></a>

`$values` 変数は、すべてのインスタントクエリと式のラベルと浮動小数点値を含むテーブルで、Ref ID でインデックス化されます。

Ref ID A でインスタントクエリの値を印刷するには:

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "A" }}
```

例えば、ラベル `instance=server1` 付きのアラートと値 `81.2345` のインスタントクエリがあるとすると、次の内容が出力されます。

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: 81.2345
```

Ref ID A のクエリがインスタントクエリではなく範囲クエリである場合は、縮小式を Ref ID B に追加し、`(index $values "A")` を `(index $values "B")` に置き換えます。

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "B" }}
```

## 関数
<a name="v10-alerting-overview-labels-templating-functions"></a>

ラベルと注釈をテンプレート化するときは、次の関数を使用できます。

**args**

`args` 関数は、オブジェクトのリストをキー arg0、arg1 などのマップに変換します。これは、複数の引数をテンプレートに渡せるようにすることを目的としています。

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**externalURL**

`externalURL` 関数は Grafana サーバーの外部 URL を返します。

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**graphLink**

`graphLink` 関数は、指定された式とデータソースの [Grafana バージョン 10 で探索する](v10-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` 関数は Grafana サーバーのパスを返します。

```
{{ pathPrefix }}
```

```
/grafana
```

**tableLink**

`tableLink` 関数は、指定された式とデータソースの [Grafana バージョン 10 で探索する](v10-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="v10-alerting-explore-rules"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートルールは、アラートインスタンスを起動するかどうかを決定する一連の評価基準です。このルールは、1 つ以上のクエリと式、条件、評価の頻度、発射を開始するために条件を満たす必要がある期間で構成されます。

評価するデータセットを「クエリと式」で選択し、*「条件」*にデータがアラートを発行するための基準 (しきい値) を設定します。

*[間隔]*は、アラートルールが評価される頻度を指定します。「*持続時間*」を設定した場合、その条件下にある状態の継続時間を示します。また、アラートルールでは、データがない場合のアラート動作も設定できます。

**Topics**
+ [アラートルールタイプ](v10-alerting-explore-rules-types.md)
+ [記録ルール](v10-alerting-explore-rule-recording.md)
+ [クエリと条件](v10-alerting-explore-rules-queries.md)
+ [アラートインスタンス](v10-alerting-rules-instances.md)
+ [名前空間、フォルダ、グループ](v10-alerting-rules-grouping.md)
+ [アラートルールの評価](v10-alerting-rules-evaluation.md)
+ [アラートルールの状態と正常性](v10-alerting-explore-state.md)
+ [通知テンプレートの作成](v10-alerting-rules-notification-templates.md)

# アラートルールタイプ
<a name="v10-alerting-explore-rules-types"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana は複数のアラートルールタイプをサポートしています。各アラートルールタイプ、その仕組みおよびユースケースに最適なルールタイプの決定を説明します。

## Grafana マネージドルール
<a name="v10-alerting-explore-rule-types-grafana"></a>

Grafana マネージドルールは、最も柔軟なアラートルールの種類です。これにより、既存の任意のデータソースのデータに対して動作するアラートを作成できます。

複数のデータソースをサポートするだけでなく、[[式]](v10-panels-query-xform-expressions.md)を追加してデータを変換し、アラート条件を表現できます。

Grafana マネージドアラート:
+ アラートルールは、1 つ以上のデータソースに基づいて Grafana 内に作成されます。
+ アラートルールは、Grafana 内からアラートルール評価エンジンによって評価されます。
+ アラートは、内部 Grafana アラートマネージャーを使用して配信されます。

**注記**  
また、外部アラートマネージャーを使用して配信するようにアラートを設定したり、内部アラートマネージャーと外部アラートマネージャーの両方を使用したりできます。詳細については、「[外部アラートマネージャーの追加](v10-alerting-setup-alertmanager.md)」を参照してください。

## データソースマネージドルール
<a name="v10-alerting-explore-rule-types-datasource"></a>

データソースマネージドアラートルールを作成するには、互換性のある Prometheus または Loki データソースが必要です。データソースをテストし、Ruler API がサポートされているかどうかを観察することで、データソースが Grafana 経由でルール作成をサポートしているかどうかを確認できます。

データソースマネージドアラートでは、次のようになります。
+ アラートルールが作成され、データソース自体に保存されます。
+ アラートルールは、Prometheus データに基づいてのみ作成できます。
+ アラートルールの評価と配信は、高可用性と耐障害性のために複数のノードに分散されます。

## アラートルールタイプを選択する
<a name="v10-alerting-explore-rule-types-choose"></a>

使用するアラートルールタイプを選択するときは、Grafana マネージドアラートルールとデータソースマネージドアラートルールにおける以下の比較を考慮してください。


| 機能 | Grafana マネージドアラートルール | Loki/Mimir マネージドアラートルール | 
| --- | --- | --- | 
| サポートされているデータソースのデータに基づいてアラートルールを作成する | あり | 不可: Prometheus データに基づくアラートルールのみを作成できます。データソースで Ruler API が有効になっている必要があります。  | 
| データソースを組み合わせる | あり | なし | 
| 記録ルールへの対応 | なし | あり | 
| 式を追加してデータを変換し、アラート条件を設定する | あり | 不可 | 
| アラート通知でイメージを使用する | あり | なし | 
| スケーリング | リソースを大量に消費し、データベースに依存し、一時的なエラーが発生する可能性があります。垂直方向にのみスケーリングされます。 | アラートルールをデータソース自体に保存し、「無限」スケーリングを許可します。データの場所からアラート通知を生成して送信します。 | 
| アラートルールの評価と配信 | アラートルールの評価と配信は Grafana 内、外部アラートマネージャー、またはその両方を使用して行われます。 | アラートルールの評価とアラート配信は分散されます。つまり、単一障害点はありません。 | 

# 記録ルール
<a name="v10-alerting-explore-rule-recording"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

*記録ルールは、互換性のある Prometheus または Loki データソースでのみ使用できます。*

記録ルールでは、頻繁に必要になる式や計算負荷の高い式を事前に計算し、その結果を新しい時系列セットとして保存できます。これは、集計データに対してアラートを実行する場合や、計算コストの高い式を繰り返しクエリするダッシュボードがある場合に便利です。

この新しい時系列のクエリは、特にダッシュボードでは、ダッシュボードが更新されるたびに同じ式をクエリするため、より高速になります。

Prometheus での[記録ルール](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/)の詳細については、こちらを参照してください。

# クエリと条件
<a name="v10-alerting-explore-rules-queries"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana では、クエリは、MySQL や PostgreSQL などのデータベース、Prometheus、InfluxDB、Graphite などの時系列データベース、OpenSearch 、Amazon CloudWatch 、Azure Monitor、Google Cloud Monitoring などのサービスなど、サポートされているデータソースからのデータの取得と変換に重要な役割を果たします。

サポートされているデータソースの詳細については、「[データソースと Grafana アラート](v10-alerting-overview-datasources.md)」を参照してください。

クエリを実行するプロセスには、データソースの定義、取得するデータの特定、関連するフィルターまたは変換の適用が含まれます。選択したデータソースに固有のクエリ言語または構文は、これらのクエリのコンストラクトに使用されます。

アラートでは、測定するデータと、アラートルールを起動する前に満たす必要がある条件を取得するクエリを定義します。

アラートルールは、測定するデータを選択する 1 つ以上のクエリと式で構成されます。

クエリと式の詳細については、「[データのクエリと変換](v10-panels-query-xform.md)」を参照してください。

## データソースクエリ
<a name="v10-alerting-explore-rules-queries-data-source-queries"></a>

Grafana のクエリは、使用するデータソースとクエリ言語に応じて、さまざまな方法で適用できます。各データソースのクエリエディタには、独自の機能を活用するクエリの作成に役立つカスタマイズされたユーザーインターフェイスが用意されています。

クエリ言語の違いにより、各データソースクエリエディタの外観と関数は異なります。データソースによっては、クエリエディタが自動補完機能、メトリクス名、変数の提案、ビジュアルクエリ構築インターフェイスを提供する場合があります。

一般的なタイプのクエリコンポーネントには、次のようなものがあります。

**メトリクスまたはデータフィールド** – CPU 使用量、ネットワークトラフィック、センサー読み取りなど、取得する特定のメトリクスまたはデータフィールドを指定します。

**時間範囲** – 過去 1 時間、特定の日、カスタム時間範囲など、データを取得する時間範囲を指定します。

**フィルター** – フィルターを適用して、特定のタグ、ホスト、またはアプリケーションでデータをフィルタリングするなど、特定の基準に基づいてデータを絞り込みます。

**集計** - データを集計して、特定の期間の平均、合計、カウントなどのメトリクスを計算します。

**グループ分け** – データを特定のディメンションまたはタグでグループ化して、集計ビューまたは内訳を作成します。

**注記**  
Grafana は、テンプレート変数を使用したアラートクエリはサポートしていません。詳細については、Grafana Labs フォーラム内の[こちら](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514)を参照してください。

## クエリ式
<a name="v10-alerting-explore-rules-queries-expression-queries"></a>

Grafana では、式を使用して、クエリされたデータソースデータに対して計算、変換、または集計を実行します。これにより、数学演算、関数、または論理式に基づいてカスタムメトリクスを作成したり、既存のメトリクスを変更したりできます。

クエリ式を活用することで、ユーザーは 2 つの値間の変化率の計算、対数関数や三角関数などの関数の適用、特定の時間範囲やディメンションにわたるデータの集約、さまざまなシナリオを処理するための条件ロジックの実装などのタスクを実行できます。

アラートでは、Grafana 管理のアラートルールにのみ式を使用できます。式ごとに、Math、Reduce、リサンプリング式を選択できます。これらは、シリーズごとに個別のアラートを生成するため、多次元ルールと呼ばれます。

クラシック条件を使用して、条件が満たされたときに単一のアラートをトリガーするアラートルールを作成することもできます。そのため、複数のシリーズでアラート条件が満たされた場合でも、Grafana が送信するアラートは 1 件のみです。

**注記**  
クラシック条件は主に互換性上の理由から存在するため、可能であれば避けるようにしてください。

**[削減]**

選択した時間範囲の時系列値を 1 つの値に集約します。

**数値演算**

時系列および数値データに対して自由形式の数学関数/オペレーションを実行します。時系列データの事前処理や、数値データのアラート条件の定義に使用できます。

**[リサンプリング]**

時間範囲を新しいタイムスタンプのセットに再調整します。これは、タイムスタンプが一致しない異なるデータソースからの時系列データを比較する場合に役立ちます。

**Threshold**

時系列データがしきい値条件と一致するかどうかを確認します。

しきい値式を使用すると、2 つの単一の値を比較できます。条件が偽の場合 `0` と、条件が真の場合に `1` が返されます。次のしきい値関数が使用可能です。
+ Is above (x > y)
+ Is below (x < y)
+ Is within range (x > y1 AND x < y2)
+ Is outside range (x < y1 AND x > y2)

**クラシック条件**

時系列データがアラート条件と一致するかどうかを確認します。

**注記**  
クラシック条件クエリ式は、条件を満たす時系列の数に関係なく、常に 1 つのアラートインスタンスのみを生成します。クラシック条件は主に互換性上の理由から存在するため、可能であれば避けるようにしてください。

## 集計
<a name="v10-alerting-explore-rules-queries-aggregations"></a>

Grafana アラートでは、クエリをさらに絞り込むために、次の集計関数が用意されています。

これらの関数は、**削減** 式と**クラシック条件**式でのみ使用できます。


| 関数 | 式 | その内容 | 
| --- | --- | --- | 
| avg | 削減/クラシック | 値の平均を表示します | 
| min | 削減/クラシック | 最小値を表示します | 
| max | 削減/クラシック | 最大値を表示します | 
| sum | 削減/クラシック | すべての値の合計を表示します | 
| count | 削減/クラシック | 結果の値の数をカウントします | 
| last | 削減/クラシック | 最後の値を表示します | 
| median | 削減/クラシック | 中央値を表示します。 | 
| diff | クラシック | 最も新しい値と最も古い値の差を表示します。 | 
| diff\$1abs | クラシック | diff の絶対値を表示します。 | 
| percent\$1diff | Classic | 最も新しい値と最も古い値の差の割合値を表示します。 | 
| percent\$1diff\$1abs | Classic | percent\$1diff の絶対値を表示します | 
| count\$1non\$1null | Classic | 結果セット内の値のうち、null でない値の数を表示します。 | 

## アラート条件
<a name="v10-alerting-explore-rules-queries-alert-condition"></a>

アラート条件は、アラートが発射するかどうかを決定するクエリまたは式です。この条件は、アラートが生成する値に応じて決定されます。アラートのトリガーを決定する条件は 1 つだけです。

クエリや式を定義したら、そのいずれかをアラートルール条件として選択します。

クエリされたデータが定義された条件を満たすと、Grafana は関連付けられたアラートをトリガーします。このアラートは、E メール、Slack、PagerDuty などのさまざまなチャネルを介して通知を送信するように設定できます。通知は、満たされている条件について通知するため、適切なアクションを実行したり、根本的な問題を調査したりできます。

デフォルトでは、最後に追加された式がアラート条件として使用されます。

## 復旧しきい値
<a name="v10-alerting-explore-rules-queries-recovery-threshold"></a>

アラートのフラッピングのノイズを減らすには、アラートしきい値とは異なる復旧しきい値を設定します。

アラートのフラッピングは、メトリクスがアラートのしきい値条件を超えた場合に発生し、頻繁な状態の変化につながる可能性があり、生成される通知が多すぎます。

Grafana 管理のアラートルールは、特定の期間にわたって評価されます。各評価中、クエリの結果はアラートルールで設定されたしきい値に対してチェックされます。メトリクスの値がしきい値を超えると、アラートルールが生成され、通知が送信されます。値がしきい値を下回り、このメトリクスに対してアクティブなアラートがある場合、アラートが解決され、別の通知が送信されます。

ノイズの多いメトリクスのアラートルールを作成するのは難しい場合があります。つまり、メトリクスの値が継続的にしきい値を上回ったり下回ったりする場合です。これはフラッピングと呼ばれ、一連の発射 - 解決 - 発射通知とノイズの多いアラート状態履歴になります。

例えば、しきい値が 1000 ミリ秒のレイテンシーのアラートがあり、その数が 1000 の周囲 (例えば、980 ->1010 -> 990 -> 1020 など) で変動すると、それぞれが通知をトリガーします。

この問題を解決するには、 (カスタム) 復旧しきい値を設定できます。これは基本的に、1 つのしきい値ではなく 2 つのしきい値を持つことを意味します。アラートは、最初のしきい値を超えたときにトリガーされ、2 番目のしきい値を超えたときにのみ解決されます。

例えば、しきい値を 1000 ミリ秒、復旧しきい値を 900 ミリ秒に設定することができます。これにより、アラートルールは 900 ミリ秒未満になり、フラッピングが軽減された場合にのみ発射を停止します。

# アラートインスタンス
<a name="v10-alerting-rules-instances"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana マネージドアラートは、多次元アラートをサポートします。各アラートルールは、複数のアラートインスタンスを作成できます。これは、1 つの式で複数のシリーズを観察する場合に強力です。

次の PromQL 式を検討してください。

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

この式を使用するルールは、最初の評価後に監視している CPU の数と同じ数のアラートインスタンスを作成し、単一のルールで各 CPU のステータスをレポートできるようにします。

# 名前空間、フォルダ、グループ
<a name="v10-alerting-rules-grouping"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートは、Grafana マネージドルールのフォルダと、Mimir、Loki、または Prometheus のルールとグループ名の名前空間を使用して整理できます。

**名前空間とフォルダ**

Grafana マネージドルールを作成する場合、 フォルダを使用してアクセス制御を実行し、特定のフォルダ内のすべてのルールへのアクセスを許可または拒否できます。

名前空間には 1 つ以上のグループが含まれます。グループ内のルールは、一定の間隔で順番に実行されます。デフォルトの間隔は 1 分です。Grafana Mimi または Loki ルールの名前空間とグループの名前を変更したり、グループ評価間隔を編集したりできます。

**グループ**

グループ内のルールは、一定の間隔で順番に実行されます。つまり、ルールは同時に評価されず、出現順に評価されません。デフォルトの間隔は 1 分です。Grafana Mimir または Loki ルールの名前空間または Loki ルールの名前空間とグループの名前を変更したり、グループ評価間隔を編集したりできます。

**ヒント**  
ルールを異なる間隔で同時に評価したい場合は、異なるグループに保存することを検討してください。

**注記**  
Grafana マネージドアラートルールは、順番ではなく同時に評価されます。

# アラートルールの評価
<a name="v10-alerting-rules-evaluation"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートルールの評価を使用して、アラートルールを評価する頻度と状態の変更速度を決定します。

これを行うには、アラートルールが適切な評価グループにあることを確認し、ユースケースに最適な保留期間を設定する必要があります。

## 評価グループ
<a name="v10-alerting-rules-evaluation-group"></a>

すべてのアラートルールは評価グループの一部です。各評価グループには、アラートルールをチェックする頻度を決定する評価間隔が含まれます。

同じグループ内の**データソースマネージド**アラートルールは順番に評価されますが、異なるグループのアラートルールは同時に評価できます。この機能は、アラートルールの前に記録ルールを評価したい場合に特に便利です。

**Grafana マネージド**アラートルールは、アラートルールグループに関係なく同時に評価されます。デフォルトの評価間隔は 10 秒に設定されています。つまり、Grafana が管理するアラートルールは、10 秒ごとに順番に (例えば 10:00:00、10:00:10、10:00:20 などに) 評価されます。必要に応じて、独自の評価間隔を設定することもできます。

**注記**  
通知ポリシー内の評価グループとアラートのグループ化は異なるものです。通知ポリシーでグループ化すると、同じラベルを共有する複数のアラートを同じ時刻メッセージで送信できます。

## 保留期間
<a name="v10-alerting-rules-evaluation-pending-period"></a>

保留期間を設定することで、一時的な問題に対する不要なアラートを回避できます。

保留期間では、条件に違反している可能性があるためにアラートルールを発射するまでの期間を選択します。

**例**

アラートルールの評価間隔が 30 秒ごとに設定され、保留期間が 90 秒であるとします。

評価は次のように行われます。

[00:30] 最初の評価 - 条件が満たされていない。

[01:00] 2 回目の評価 - 条件に違反している、保留カウンターが開始。**アラートの保留が開始**

[01:30] 3 回目の評価 - 条件に違反している。保留カウンター = 30 秒。**保留中の状態。**

[02:00] 4 回目の評価 - 条件に違反している。保留カウンター = 60 秒**保留中の状態。**

[02:30] 5 回目の評価 - 条件に違反している。保留カウンター = 90 秒。**アラートの発射開始**

アクションを実行する前に一定時間違反状態である必要がある条件がアラートルールにある場合、その状態は次のように変化します。
+ 条件が最初に違反すると、ルールは「保留中」状態になります。
+ ルールは、条件が保留期間という必要な期間にわたって中断されるまで、「保留」状態のままになります。
+ 必要な時間が過ぎると、ルールは「発射」状態になります。
+ 保留期間中に条件の違反が解消された場合、ルールは通常の状態に戻ります。

**注記**  
保留状態をスキップする場合は、保留期間を 0 に設定します。これにより、保留期間を効果的にスキップし、条件が満たされるとすぐにアラートルールの発射が開始されます。

アラートルールが発射されると、アラートインスタンスが生成され、アラートマネージャーに送信されます。

# アラートルールの状態と正常性
<a name="v10-alerting-explore-state"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートルールの状態と正常性は、アラートに関するいくつかの主要なステータスインジケータを理解するのに役立ちます。

*アラートルールの状態 *、*アラートインスタンスの状態*、*アラートルールの正常性*の 3 つの主要なコンポーネントがあります。それぞれに関連はありますが、各コンポーネントは微妙に異なる情報を伝達します。

**アラートルールの状態**

アラートルールは、次に示す状態のいずれかになります。


| State | 説明 | 
| --- | --- | 
| 普通 | 評価エンジンによって返される時系列のいずれも `Pending` または `Firing` 状態ではありません。 | 
| 保留中 | 評価エンジンから返される少なくとも 1 つの時系列は `Pending` です。 | 
| 発射 | 評価エンジンから返される少なくとも 1 つの時系列は `Firing` です。 | 

**注記**  
アラートは最初に `pending` に移行し、次に `firing` に移行します。そのため、アラートが発生する前に少なくとも 2 つの評価サイクルが必要になります。

**アラートインスタンスの状態**

アラートインスタンスは、次に示す状態のいずれかになります。


| State | 説明 | 
| --- | --- | 
| 普通 | 発射も保留中もなく、すべてが正しく機能しているアラートの状態。 | 
| 保留中 | 設定されたしきい値期間未満でアクティブであったアラートの状態。 | 
| [アラート] | 設定されたしきい値期間よりも長くアクティブであったアラートの状態。 | 
| NoData | 設定された時間枠のデータを受信しない状態。 | 
| エラー | アラートルールの評価を試みたときに発生したエラー。 | 

**最後の状態を保持する**

アラートルールは、 `NoData` または `Error` 状態が発生したときに最後の状態を保持するように設定できます。これにより、アラートの発射、解決と再発射の両方が防止されます。通常の評価と同様に、アラートルールは保留期間が経過すると `Pending` から `Firing` に移行します。

**アラートルールの正常性**

アラートルールは、次のいずれかの正常性ステータスとなります。


| State | 説明 | 
| --- | --- | 
| Ok | アラートルールを評価するときにエラーがありません。 | 
| エラー | アラートルールの評価中にエラーが発生しました。 | 
| NoData | ルール評価中に返される少なくとも 1 つの時系列にデータがありません。 | 

**`NoData` および `Error` [の特別なアラート]**

アラートルールの評価で状態 `NoData` または `Error` が生成されると、Grafana アラートは、次の追加ラベルを含むアラートインスタンスを生成します。


| ラベル | 説明 | 
| --- | --- | 
| AlertName | 状態に応じて、`DatasourceNoData` または `DatasourceError` のいずれか。 | 
| datasource\$1uid | 状態の原因となったデータソースの UID。 | 

これらのアラートは、サイレンスを追加したり、コンタクトポイントにルーティングしたりすることで、通常のアラートと同じ方法で処理できます。

# 通知テンプレートの作成
<a name="v10-alerting-rules-notification-templates"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

コンタクトポイントを介して送信される通知は、通知テンプレートを使用して構築されます。Grafana のデフォルトテンプレートは [Go テンプレートシステム](https://golang.org/pkg/text/template)に基づいており、一部のフィールドはテキストとして評価され、他のフィールドは HTML (エスケープに影響する可能性があります) として評価されます。

デフォルトのテンプレート [[default\$1template.go]](https://github.com/grafana/alerting/blob/main/templates/default_template.go) は、カスタムテンプレートの便利なリファレンスとして機能します。

コンタクトポイントに使用するほとんどのフィールドはテンプレート化できるため、再利用可能なカスタムテンプレートを作成し、複数のコンタクトポイントで使用すると良いでしょう。テンプレートを使用したカスタム通知の詳細については、「[通知のカスタマイズ](v10-alerting-manage-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="v10-alerting-explore-alertmanager"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートマネージャーを使用すると、アラートを迅速かつ効率的に管理して対応できます。E メールや Slack など選択したチャネルを介して通知を送信することで、アラートを受信し、ミュート、抑制、グループ化、ルーティングを処理します。

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="v10-alerting-explore-contacts"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

コンタクトポイントには、通知を送信するための設定が含まれています。コンタクトポイントは統合のリストであり、それぞれが特定の E メールアドレス、サービス、または URL に通知を送信します。コンタクトポイントには、同じ種類の複数の統合、または異なる種類の統合の組み合わせを含めることができます。例えば、コンタクトポイントには、Pagerduty 統合、Amazon SNS と Slack 統合、または Pagerduty 統合、Slack 統合、および 2 つの Amazon SNS 統合を含めることができます。統合なしでコンタクトポイントを設定することもできますが、その場合、通知は送信されません。

コンタクトポイントは、通知ポリシーに追加されるまで通知を送信できません。通知ポリシーは 1 つのコンタクトポイントにのみアラートを送信できますが、複数の通知ポリシーに同時にコンタクトポイントを追加できます。アラートが通知ポリシーと一致すると、アラートはその通知ポリシーのコンタクトポイントに送信され、その通知ポリシーはその設定の各統合に通知を送信します。

Grafana アラートマネージャーと外部アラートマネージャーのコンタクトポイントを設定できます。

通知テンプレートを使用して、コンタクトポイントタイプの通知メッセージをカスタマイズすることもできます。

**サポートされているコンタクトポイントタイプ**

次の表に、Grafana でサポートされているコンタクトポイントのタイプを示します。


| 名前 | タイプ | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Pager Duty | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

コンタクトポイントの詳細については、「[コンタクトポイントの設定](v10-alerting-configure-contactpoints.md)」と「[通知のカスタマイズ](v10-alerting-manage-notifications.md)」を参照してください。

# 通知
<a name="v10-alerting-explore-notifications"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラート通知を送信する方法、タイミング、および場所を選択することは、アラートシステムを設定する上で重要です。これらの決定は、問題を迅速に解決し、重要なものを見逃さない能力に直接影響します。

最初のステップとして、アラート通知の送信先を定義する[コンタクトポイント](v10-alerting-explore-contacts.md)を定義します。コンタクトポイントは、通知の配信に使用される 1 つ以上の統合のセットです。通知テンプレートをコンタクトポイントに追加して、通知の再利用と一貫したメッセージングを行います。

次に、アラートがコンタクトポイントにルーティングされる場所、タイミング、方法に関する一連のルールである通知ポリシーを作成します。通知ポリシーでは、作成したコンタクトポイントのいずれかを選択して、アラート通知を送信する場所を定義します。

## アラートマネージャー
<a name="v10-alerting-explore-notifications-alertmanager"></a>

Grafana はアラートマネージャーを使用して、アラートの発射と解決の通知を送信します。Grafana には、ユーザーインターフェイスで **Grafana** と呼ばれる独自のアラートマネージャーがありますが、[Prometheus アラートマネージャー](https://prometheus.io/docs/alerting/latest/alertmanager/)などの他のアラートマネージャーからの通知の送信もサポートしています。Grafana アラートマネージャーは、通知ポリシーと問い合わせポイントを使用して、通知の送信方法と送信先、通知の送信頻度、アラートをすべて同じ通知で送信するか、ラベルのセットに基づいてグループ化された通知で送信するか、個別の通知として送信するかを設定します。

## 通知ポリシー
<a name="v10-alerting-explore-notifications-policies"></a>

通知ポリシーは、通知の送信日時と送信場所を制御します。通知ポリシーでは、すべてのアラートを同じ通知でまとめて送信するか、ラベルのセットに基づいてグループ化された通知でアラートを送信するか、個別の通知としてアラートを送信するかを選択できます。各通知ポリシーを設定して、通知の送信頻度を制御するだけでなく、1 日の特定時刻および特定の曜日に通知を禁止するための 1 つ以上のミュートタイミングを設定することもできます。

通知ポリシーは、ツリーのルートにデフォルトポリシーと呼ばれる通知ポリシーがあるツリー構造で構成されています。デフォルトポリシーは 1 つだけ設定でき、削除できません。

特定のルーティングポリシーはルートポリシーの子であり、一致するラベルのセットに基づいてすべてのアラートまたはアラートのサブセットを照合するために使用できます。通知ポリシーは、一致するラベルがアラート内のラベルと一致するときにアラートと一致します。

ネストされたポリシーには独自のネストされたポリシーを含めることができ、アラートの追加マッチングが可能になります。ネストされたポリシーの例としては、Ops チームにインフラストラクチャアラートを送信する場合があります。子ポリシーは、Pagerduty に高優先度アラートを送信し、Slack に低優先度アラートを送信することができます。

ラベルに関係なく、すべてのアラートはデフォルトのポリシーと一致します。ただし、デフォルトのポリシーがアラートを受信すると、ネストされた各ポリシーが調査され、アラートに一致する最初のネストされたポリシーにアラートが送信されます。ネストされたポリシーにさらにネストされたポリシーがある場合、ネストされたポリシーの 1 つとアラートとのマッチングを試行できます。ネストされたポリシーがアラートと一致しない場合、ポリシー自体が一致するポリシーになります。ネストされたポリシーがない場合、またはネストされたポリシーがアラートと一致しない場合、デフォルトのポリシーは一致するポリシーです。

通知ポリシーの詳細については、「[通知ポリシー](v10-alerting-explore-notifications-policies-details.md)」を参照してください。

## 通知テンプレート
<a name="v10-alerting-explore-notifications-templating"></a>

テンプレートを使用して通知をカスタマイズできます。例えば、テンプレートを使用して、Slack に送信される通知のタイトルとメッセージを変更することができます。

テンプレートは個々の統合やコンタクトポイントに限定されず、同じコンタクトポイント内の多数の統合や、異なるコンタクトポイント間の統合でも使用できます。例えば、Grafana ユーザーは、`custom_subject_or_title` というテンプレートを作成し、2 つの個別のテンプレートを作成することなく、Pager Duty のテンプレート件名と Slack メッセージのタイトルの両方に使用できます。

すべての通知テンプレートはアラートページの [コンタクトポイント] タブにあり、[[Go のテンプレート言語]](https://pkg.go.dev/text/template)で記述されます。

通知のカスタマイズの詳細については、「[通知のカスタマイズ](v10-alerting-manage-notifications.md)」を参照してください。

## サイレンス
<a name="v10-alerting-explore-notifications-silences"></a>

サイレンスを使用して、1 つ以上の発射ルールからの通知をミュートできます。サイレンスは、アラートの発射や解決を停止したり、ユーザーインターフェイスで発射アラートを非表示にしたりしません。サイレンスは、分、時間、日、月、または年で設定し、その期間だけ続きます。

サイレンスの使用の詳細については、「[アラート通知のサイレンシング](v10-alerting-silences.md)」を参照してください。

# 通知ポリシー
<a name="v10-alerting-explore-notifications-policies-details"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

通知ポリシーにより、さまざまな受信者にアラートをルーティングする柔軟な方法が提供されます。ラベルマッチャーを使用すると、個々のアラートルールをすべて更新することなく、アラート通知配信を変更できます。

このセクションでは、通知ポリシーの設定を最大限に活用できるように、通知ポリシーの仕組みと構造について詳しく説明します。

## ポリシーツリー
<a name="v10-alerting-explore-notifications-policy-tree"></a>

通知ポリシーはリスト*ではなく*、ツリー構造に従って構造化されます。つまり、各ポリシーに子ポリシーなどを含めることができます。通知ポリシーツリーのルートは、**デフォルトの通知ポリシー**と呼ばれます。

各ポリシーは、処理に関心がないラベルを指定する一連のラベルマッチャー (0 以上) で構成されます。

ラベルの一致の詳細については、「[ラベル一致の仕組み](v10-alerting-overview-labels-matching.md)」を参照してください。

**注記**  
通知ポリシーにラベルマッチャーを設定していない場合、通知ポリシーは*すべての*アラートインスタンスと一致します。これにより、通知ポリシーで **[兄弟の照合の続行]** を有効にしない限り、子ポリシーが評価されない場合があります。

## ルーティング
<a name="v10-alerting-explore-notifications-routing"></a>

どの通知ポリシーがどのアラートインスタンスを処理するかを決定するには、既定の通知ポリシーから開始して、既存の通知ポリシーのセットを確認する必要があります。

デフォルトポリシー以外のポリシーが設定されていない場合は、デフォルトポリシーがアラートインスタンスを処理します。

デフォルトポリシー以外のポリシーが定義されている場合は、それらの通知ポリシーが表示される順序で評価されます。

通知ポリシーにアラートインスタンスのラベルと一致するラベルマッチャーがある場合、通知ポリシーは子ポリシーに降りてきます。子ポリシーがある場合は、ラベルのセットをさらに絞り込むラベルマッチャーを持つ可能性のある子ポリシーを探し続け、子ポリシーが見つからなくなるまで続行されます。

通知ポリシーで子ポリシーが定義されていない場合、またはアラートインスタンスのラベルに一致するラベルマッチャーが子ポリシーにない場合、親通知ポリシーが使用されます。

一致するポリシーが見つかるとすぐに、システムは他の一致するポリシーの検索を中止します。一致する可能性のある他のポリシーを引き続き検索する場合は、その特定のポリシーで **[兄弟の照合の続行]**を有効にします。

最後に、どの通知ポリシーも選択されていない場合は、デフォルトの通知ポリシーが使用されます。

### ルーティングの例
<a name="v10-alerting-explore-notifications-routing-example"></a>

以下は、比較的単純な通知ポリシーツリーといくつかのアラートインスタンスの例です。

![\[ツリー構造内の通知ポリシーのセットと、ポリシーに一致するラベルが異なるアラートインスタンスのセットを示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/notification-routing.png)


これらのポリシーの選択方法の内訳を次に示します。

**[CrashLoop でスタックされた Pod]**には `severity` ラベルがないため、子ポリシーは一致しません。`team=operations` ラベルが付いているため、最初のポリシーは一致します。

一致が既に見つかり、**[兄弟の照合の続行]**がそのポリシーに設定されていないため、`team=security` ポリシーは評価されません。

**ディスク使用量 – 80%** には `team` と `severity` の両方のラベルがあり、オペレーションチームの子ポリシーと一致します。

**許可されていないログエントリ**には `team` ラベルがありますが、値が同じではないことを理由として最初のポリシー (`team=operations`) と一致しないため、検索が続行され、`team=security` ポリシーと一致します。子ポリシーがないため、追加の `severity=high` ラベルは無視されます。

## 継承
<a name="v10-alerting-explore-notifications-inheritance"></a>

子ポリシーは、アラートインスタンスのルーティングに役立つ概念であるだけでなく、親ポリシーからプロパティを継承します。これは、デフォルトの通知ポリシーの子ポリシーであるポリシーにも適用されます。

次のプロパティは子ポリシーによって継承されます。
+ コンタクトポイント
+ オプションのグループ化
+ タイミングオプション
+ ミュートタイミング

継承されたプロパティを上書きする場合は、これらのプロパティを個々のポリシーで上書きします。

親ポリシーからコンタクトポイントを継承するには、空白のままにします。継承されたグループ化オプションを上書きするには、**[グループ化の上書き]** を有効にします。継承されたタイミングオプションを上書きするには、**[一般的なタイミングの上書き]** を有効にします。

### 継承の例
<a name="v10-alerting-explore-notifications-inheritance-example"></a>

次の例は、前の例の通知ポリシーツリーで `team=operations` の子ポリシーがコンタクトポイントを継承する方法を示しています。

これにより、子ポリシーごとに同じコンタクトポイントを複数回指定する必要を回避できます。

![\[ツリー構造内の一連の通知ポリシーを示す画像。一部のポリシーにはコンタクトポイントが割り当てられますが、一部の子ポリシーは、独自のポリシーを定義するのではなく、親のコンタクトポイントを継承します。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/notification-inheritance.png)


## 追加設定のオプション
<a name="v10-alerting-explore-notifications-additional-configuration-options"></a>

### グループ化
<a name="v10-alerting-explore-notifications-grouping"></a>

グループ化は Grafana アラートの重要な機能です。これにより、関連するアラートをバッチ処理して通知の数を減らすことができます。これは、エンジニアオンコールなどのファーストレスポンダーに通知が配信される場合に特に重要であります。ファーストレスポンダーが短期間に多くの通知を受信すると圧倒され、場合によってはインシデントに対応する能力に悪影響を及ぼす可能性があります。例えば、多くのシステムがダウンしている大規模な障害を考えてみましょう。この場合、グループ化は、1 回の通話と 100 回の通話の受信の違いになります。

通知ポリシーの Group by オプションを使用して、アラートをグループ分けする方法を選択します。デフォルトでは、Grafana グループの通知ポリシーは、`alertname` および `grafana_folder` ラベルを使用してアラートルールによって一緒にアラートを発します (アラート名は複数のフォルダで一意ではないため)。アラートルール以外の方法でアラートをグループ分けする場合は、グループ化をラベルの他の組み合わせに変更します。

#### グループ化を無効にする
<a name="v10-alerting-explore-notifications-disable-grouping"></a>

すべてのアラートを個別の通知として受信する場合は、 `...` という特別なラベルでグループ化することで受信できます。これは、アラートがファーストレスポンダーではなく自動システムに配信される場合に便利です。

#### すべてのアラートを含む単一のグループ
<a name="v10-alerting-explore-notifications-a-single-group-for-all-alerts"></a>

すべてのアラートを 1 つの通知でまとめて受信する場合は、グループを空のままにすると受信できます。

### タイミングオプション
<a name="v10-alerting-explore-notifications-timing-options"></a>

タイミングオプションは、アラートグループごとに通知が送信される頻度を決定します。知っておくべきタイマーは、グループ待機、グループ間隔、繰り返し間隔の 3 つです。

#### グループ待機
<a name="v10-alerting-explore-notifications-group-wait"></a>

グループ待機は、新しいアラートグループの最初の通知を送信するまでに Grafana が待機する時間です。グループの待機時間が長いほど、他のアラートが到着する時間が長くなります。グループの待機時間が短いほど、最初の通知は早く送信されますが、不完全な通知を送信するリスクがあります。ユースケースに最も適したグループ待機を常に選択するようにするべきです。

**デフォルト**: 30 秒

#### グループ間隔
<a name="v10-alerting-explore-notifications-group-interval"></a>

アラートの新しいグループに対して最初の通知が送信されると、Grafana はグループ間隔タイマーを開始します。これは、変更に関する通知をグループに送信する前に Grafana が待機する時間です。例えば、既存のアラートが解決されている間に、別の発射アラートがグループに追加される場合があります。グループの待機が原因でアラートが最初の通知に含めるのに遅すぎる場合、グループの間隔が過ぎた後の後続の通知に含まれます。グループ間隔が経過すると、Grafana はグループ間隔タイマーをリセットします。これは、グループが削除された後にグループ内にアラートがなくなるまで繰り返されます。

**デフォルト**: 5 分

#### 繰り返し間隔
<a name="v10-alerting-explore-notifications-repeat-interval"></a>

繰り返し間隔は、最後の通知以降にグループが変更されていない場合に通知を繰り返す頻度を決定します。これらは、一部のアラートがまだ発せられていることのリマインダーと考えることができます。繰り返し間隔はグループ間隔と密接に関連しています。つまり、繰り返し間隔はグループ間隔以上であるだけでなく、グループ間隔の倍数である必要があります。繰り返し間隔がグループ間隔の倍数でない場合、1 に強制されます。例えば、グループ間隔が 5 分で、繰り返し間隔が 9 分の場合、繰り返し間隔は最も近い 5 の倍数である 10 分に切り上げられます。

**デフォルト**: 4 時間

# 高可用性のアラート
<a name="v10-alerting-explore-high-availability"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Amazon Managed Grafana は、作成するワークスペースごとに複数のアベイラビリティーゾーンで複数のインスタンスを実行するなど、高可用性用に設定されています。

Grafana アラートは、通知の配信からアラートルールの評価を分離する Prometheus モデルを使用しています。このモデルでは、アラートルールの評価はアラートジェネレーターで行われ、通知の配信はアラートレシーバーで行われます。Grafana アラートでは、アラートジェネレーターはスケジューラで、レシーバーはアラートマネージャーです。

高可用性設定では、すべてのアラートルールがすべてのインスタンスで評価されます。アラートルールの評価は、重複していると考えることができます。これにより、Grafana アラートは、少なくとも 1 つの Grafana インスタンスが動作している限り、アラートルールが評価され、アラートの通知が送信されることを保証します。この重複は状態履歴に表示され、高可用性を使用しているかどうかを判別するのに役立ちます。

# アラートの設定
<a name="v10-alerting-setup"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートの作成と管理に必要な機能と統合を設定します。

**前提条件**

アラートを設定する前に、以下を実行する必要があります。
+ [データソース](AMG-data-sources.md)を設定します。
+ 選択したデータソースが [Grafana アラート](v10-alerting-overview-datasources.md)と互換性があり、サポートされていることを確認します。

**アラートを設定するには**

1. [アラートルール](v10-alerting-configure.md)を設定します。
   + Grafana 管理またはデータソース管理のアラートルールと記録ルールを作成します。

1. [コンタクトポイント](v10-alerting-configure-contactpoints.md)を設定します。
   + デフォルトのコンタクトポイントを確認し、システムのコンタクトを更新します。
   + オプションで、新しいコンタクトポイントと統合を追加します。

1. [通知ポリシー](v10-alerting-explore-notifications-policies-details.md)を設定する
   + デフォルトの通知ポリシーを確認し、システムの通知ポリシーを更新します。
   + 必要に応じて、ネストされたポリシーを追加します。
   + また、ラベルとラベルマッチャーを追加してアラートルーティングを制御することもできます。

以下のトピックでは、外部アラートマネージャーの設定や Grafana マネージドアラートを Grafana の外部にルーティングする方法など、追加の設定オプションについて詳しく説明します。

**Topics**
+ [従来のダッシュボードアラートを Grafana アラートに移行する](v10-alerting-use-grafana-alerts.md)
+ [外部アラートマネージャーの追加](v10-alerting-setup-alertmanager.md)
+ [Grafana アラートリソースのプロビジョニング](v10-alerting-setup-provision.md)

# 従来のダッシュボードアラートを Grafana アラートに移行する
<a name="v10-alerting-use-grafana-alerts"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana アラートを使用ししないワークスペースは、[従来のダッシュボードアラート](old-alerts-overview.md) を使用します。新しい Grafana アラートに切り替えるには、 機能にオプトインする必要があります。クラシックダッシュボードアラートと Grafana アラートの違いの詳細については、「[Grafana アラートとレガシーダッシュボードアラート](#v10-alerting-diff-old-new)」を参照してください。GrafanaLabs は、クラシックダッシュボードアラートがバージョン 11 で削除されることを発表しました。

クラシックダッシュボードアラートを使用している場合、Amazon Managed Grafana には Grafana アラートのプレビューが表示され、アップグレードを完了する前にアップグレードされたアラートを確認および変更できます。

## Grafana アラートのプレビュー
<a name="v10-alerting-preview-grafana-alerts"></a>

移行前に Grafana アラートでアラートをプレビューできます。プレビューでは、移行を変更するアラートを変更できます。

**Grafana アラートの移行をプレビューするには**

1. Grafana ワークスペースにサインインします。

1. 左側のメニューから **[アラート (レガシー))]** を選択して、現在のアラートを表示します。

1. 左側のメニューから、**[アラートのアップグレード]** を選択して、Grafana アラートでアラートを表示します。

   このビューから、移行後のアラートの状態を確認できます。

**注記**  
このビューから、移行に影響する変更を加えることもできます。変更を元に戻すには、[Upgrade] (アップグレード) ページの右上にある **[アップグレードをリセット]** を選択します。

アラートをアップグレードする準備ができたら、次のセクションを参照してください。

## Grafana アラートシステムへの移行
<a name="v10-alerting-use-grafana-alerts-opt-in"></a>

、、 AWS CLIまたは Amazon Managed Grafana API を使用して AWS マネジメントコンソール、Grafana アラートを使用するように Amazon Managed Grafana インスタンスを設定できます。Grafana アラートのオン/オフの切り替えなど、Amazon Managed Grafana の設定方法の詳細については、「[Amazon Managed Grafana ワークスペースを設定する](AMG-configure-workspace.md)」を参照してください。

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="v10-alerting-use-grafana-alerts-limitations"></a>
+ Grafana アラートシステムは、利用可能なすべての Prometheus、Loki、およびアラートマネージャーデータソースからルールを取得できますが、他のサポートされているデータソースからアラートルールを取得できない場合があります。
+ Grafana アラートと従来のダッシュボードアラートを交互に移行すると、どちらか一方でのみサポートされる機能のデータが失われる可能性があります。
**注記**  
従来のダッシュボードアラートに戻した場合、Grafana アラートが有効になっている間に新たに作成されたアラートルールやアラート設定に加えられたすべての変更は失われます。

## Grafana アラートとレガシーダッシュボードアラート
<a name="v10-alerting-diff-old-new"></a>

Grafana 8 で導入された Grafana アラートでは、従来のダッシュボードアラートと比較していくつかの機能強化が行われています。

### 多次元アラート
<a name="v10-alerts-diff-multi-dimensional"></a>

単一のアラートルールでシステム全体の可視性を提供するアラートを作成できるようになりました。複数のアラートインスタンスを 1 つのアラートルールから作成できます。例えば、1 つのルールで 1 台のホスト上に存在する複数のマウントポイントのディスク使用量をモニタリングするルールを作成できます。評価エンジンは 1 つのクエリから複数の時系列を返し、各時系列データはラベルセットで識別されます。

### ダッシュボード外のアラートの作成
<a name="v10-alerts-diff-alerts-outside-of-dashboards"></a>

レガシーダッシュボードアラートとは異なり、Grafanaのアラート機能では複数のデータソースからのデータを独自に組み合わせたクエリや式を作成できます。また、ID を使用してダッシュボードとパネルをアラートルールにリンクし、観察中のシステムのトラブルシューティングをすばやく行うことができます。

統合アラートはパネルクエリに直接関連付けられなくなるため、通知メールに画像やクエリ値は含まれませんが、カスタマイズされた通知テンプレートを使用して、クエリ値を表示できます。

### Loki および Grafana Mimir アラートルールの作成
<a name="v10-alerts-diff-loki-mimir-alerting-rules"></a>

Grafana アラートでは、Grafana 管理のアラートと同じ UI と API を使用して Loki および Grafana Mimir のアラートルールを管理することができます。

### Prometheus 互換データソースからのアラートの表示と検索
<a name="v10-alerts-diff-view-alerts-from-prometheus"></a>

Prometheus 互換データソースのアラートが Grafana アラートセクションに表示されるようになりました。これにより、複数のデータソースでラベルを検索して、関連するアラートをすばやく見つけることができます。

### 特別な (NoData、Error アラート状態) アラート
<a name="v10-alerts-diff-special-alerts"></a>

Grafana アラートでは、アラート状態の新しい概念が導入されています。アラートルールの評価によって状態 NoData またはエラーが発生すると、Grafana アラートは、次のラベルを含む特別なアラートを生成します。
+ `alertname` (状態に応じて DatasourceNoData または DatasourceError の値を伴う)。
+ `rulename` (特別なアラートが属するアラートルールの名前)
+ `datasource_uid` は、 状態の原因となったデータソースの UID を持ちます。
+ 元のアラートルールのすべてのラベルと注釈

これらのアラートは、サイレンスを追加したり、コンタクトポイントにルーティングしたりすることで、通常のアラートと同じ方法で処理できます。

**注記**  
ルールが複数のデータソースを使用し、そのうち 1 つ以上がデータを返さない場合、アラート状態の原因となったデータソースごとに特別なアラートが作成されます。

# 外部アラートマネージャーの追加
<a name="v10-alerting-setup-alertmanager"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana を設定して、外部のアラートマネージャーを単一のアラートマネージャーとして使用してすべてのアラートを受信するようにできます。この外部アラートマネージャーは、Grafana 内から設定および管理できます。

**注記**  
Amazon Managed Service for Prometheus を外部アラートマネージャーとして使用することはできません。

アラートマネージャーを追加したら、Grafana アラート UI を使用して、サイレンス、コンタクトポイント、通知ポリシーを管理できます。これらのページのドロップダウンオプションを使用すると、アラートマネージャーを切り替えることができます。

外部アラートマネージャーは、メインの Grafana ナビゲーションメニューから Grafana 設定を使用してデータソースとして設定されます。これにより、Grafana 内から外部アラートマネージャーの連絡先と通知ポリシーを管理できるようになり、以前は URL で外部アラートマネージャーを構成するときに表示されていた HTTP 基本認証資格情報も暗号化されます。

**注記**  
Grafana 9.2 以降、アラートページの [管理] タブからの外部アラートマネージャーの URL 設定は廃止されました。これは、今後のリリースで削除されます。

**外部アラートマネージャーを追加するには**

1. 左のメインメニューから、**[接続]** を選択します。

1. `Alertmanager` を検索します。

1. **[新しいデータソースの作成]** ボタンを選択します。

1. 必要に応じて、ページのフィールドに入力します。

   データソースをプロビジョニングする場合は、`jsonData` フィールドの `handleGrafanaManagedAlerts` フラグを `true` に設定して、Grafana が管理するアラートをこのアラートマネージャーに送信します。
**注記**  
アラートマネージャーの Prometheus、Grafana Mimir、および Cortex 実装がサポートされています。Prometheus の場合、Grafana アラート UI のコンタクトポイントと通知ポリシーは読み取り専用です。

1. **[保存してテスト]** を選択します。

# Grafana アラートリソースのプロビジョニング
<a name="v10-alerting-setup-provision"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

多くの場合、アラートインフラストラクチャは複雑で、パイプラインの多くの部分が異なる場所に存在することがよくあります。これを複数のチームや組織にまたがってスケールすることは、特に難しい作業です。Grafana アラートプロビジョニングを使用すると、組織に最適な方法でアラートデータを作成、管理、維持できるため、このプロセスが容易になります。

選択できるオプションは 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 を使用したアラートリソースの作成と管理](v10-alerting-setup-provision-terraform.md)
+ [Grafana でのプロビジョニングされたアラートリソースの表示](v10-alerting-setup-provision-view.md)

# Terraform を使用したアラートリソースの作成と管理
<a name="v10-alerting-setup-provision-terraform"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

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="v10-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="v10-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="v10-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="v10-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="v10-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="v10-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="v10-alerting-setup-provision-tf-rules"></a>

[アラートルール](v10-alerting-configure.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="v10-alerting-setup-provision-view"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートリソースが Grafana で作成されたことを確認できます。

**Grafana でプロビジョニングされたリソースを表示するには**

1. Grafana インスタンスを開きます。

1. アラートに移動します。

1. アラートルールなど、アラートリソースフォルダをクリックします。

   プロビジョニング済みのリソースには **[プロビジョニング済み]** というラベルが付けられているため、手動で作成されていないことがわかります。

**注記**  
Grafana からプロビジョニングされたリソースを編集することはできません。リソースプロパティを変更するには、プロビジョニングファイルを変更して Grafana を再起動するか、ホットリロードを実行します。これにより、ファイルが再度プロビジョニングされた場合やホットリロードが実行された場合に上書きされるリソースへの変更を防止します。

# アラートを設定する
<a name="v10-alerting-configure"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートの作成と管理に必要な機能と統合を設定します。

**Topics**
+ [Grafana マネージドアラートルールを設定する](v10-alerting-configure-grafanamanaged.md)
+ [データソースマネージドアラートルールを設定する](v10-alerting-configure-datasourcemanaged.md)
+ [記録ルールを設定する](v10-alerting-configure-recordingrules.md)
+ [コンタクトポイントの設定](v10-alerting-configure-contactpoints.md)
+ [通知ポリシーを設定する](v10-alerting-configure-notification-policies.md)

# Grafana マネージドアラートルールを設定する
<a name="v10-alerting-configure-grafanamanaged"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana マネージドルールは、最も柔軟なアラートルールの種類です。これにより、サポートされている任意のデータソースのデータに対して動作するアラートを作成できます。複数のデータソースをサポートするだけでなく、式を追加してデータを変換し、アラート条件を設定することもできます。アラート通知での画像の使用もサポートされています。これは、単一のルール定義で複数のデータソースからのアラートを許可する唯一のルールタイプです。

1 つのアラートルール (多次元アラートとも呼ばれます) の結果として、複数のアラートインスタンスを作成できます。

Grafana マネージドアラートルールは、ルールを保存するフォルダの編集権限を持つユーザーのみが編集または削除できます。

UI で作成されたアラートリソースを削除すると、そのリソースを取得できなくなります。設定のバックアップを作成し、削除されたアラートリソースを復元できるようにするには、Terraform またはアラート API を使用してアラートリソースを作成します。

以下の手順では、Grafana マネージドアラートルールを作成するプロセスについて説明します。

Grafanaマネージドアラートルールを作成するには、ワークスペース内のアラート作成フローを使用し、以下の手順に従います。

**アラートルール名を設定する**

1. **[アラート]** -> **[アラートルール]** -> **[\$1 新しいアラートルール]** を選択します。

1. アラートルールを識別する名前を入力します。

   この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。

次に、測定するデータと、アラートルールを起動する前に満たす必要がある条件を取得するクエリを定義します。

**クエリと条件の定義方法**

1. データソースの選択。

1. **[オプション]** ドロップダウンから、[[時間範囲]](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) を指定します。
**注記**  
Grafana アラートは、`now-24hr: now` などの固定相対時間範囲のみをサポートします。  
絶対時間範囲 `2021-12-02 00:00:00 to 2021-12-05 23:59:592` または半相対時間範囲 `now/d to: now` はサポートされていません。

1. クエリを追加します。

   複数の[クエリ](v10-panels-query-xform.md#v10-panels-query-xform-add)を追加するには、**[クエリの追加]** を選択します。

   すべてのアラートルールは、デフォルトで Grafana が管理します。データソース管理のアラートルールに切り替える場合は、**[データソースマネージドアラートルールに切り替える]** をクリックします。

1. 1 つ以上の[式](v10-panels-query-xform-expressions.md)を追加します。

   1. 式ごとに **[クラシック条件]**を選択して単一のアラートルールを作成するか、**[Math]**、**[削減]**、**[リサンプリング]** オプションから選択して、各シリーズに個別のアラートを作成します。
**注記**  
Prometheus を使用する場合、インスタントベクトルと組み込み関数を使用できます。そのため、式を追加する必要はありません。

   1. **[プレビュー]** を選択して、式が成功したことを確認します。

1. [オプション] 復旧しきい値を追加するには、**[カスタム復旧しきい値]** のトグルをオンにして、アラートルールが発射を停止するタイミングの値を入力します。

   クエリに追加できる復旧しきい値は 1 つだけで、アラート条件である必要があります。

1. アラート条件を設定するクエリまたは式で **[Set as alert condition (アラート条件として設定)]** を選択します。

アラートルールの評価を使用して、アラートルールを評価する頻度と状態の変更速度を決定します。

これを行うには、アラートルールが適切な評価グループにあることを確認し、ユースケースに最適な保留期間を設定する必要があります。

**アラート評価の動作の設定方法**

1. フォルダを選択するか、**[\$1 新しいフォルダ]** を選択します。

1. 評価グループを選択するか、**[\$1 新しい評価グループ]** を選択します。

   新しい評価グループを作成するには、グループの間隔を指定します。

   同じグループ内のすべてのルールは、同じ時間間隔で同時に評価されます。

1. 保留期間を入力します。

   保留期間は、アラートルールが発射するまで条件に違反している可能性がある期間です。

   条件が満たされると、アラートは**保留**状態になります。指定された期間、条件がアクティブなままの場合、アラートは**発射**状態に移行します。アクティブでない場合は**[普通]**状態に戻ります。

1. 必要に応じて、アラート通知の一時停止を有効にします。
**注記**  
アラートルールの評価を一時停止して、アラートの調整中にノイズの多いアラートが発生しないようにします。一時停止すると、アラートルールの評価が停止し、アラートインスタンスは作成されません。これは、通知の配信を停止するミュートのタイミングとは異なりますが、アラートルールの評価とアラートインスタンスの作成は可能です。  
アラートの調整中にアラートルールの評価を一時停止して、ノイズの多いアラートを防ぐことができます。一時停止すると、アラートルールの評価が停止し、アラートインスタンスは作成されません。これは、通知の配信を停止するミュートのタイミングとは異なりますが、アラートルールの評価とアラートインスタンスの作成は可能です。

1. **[Configure no data and error handling]** (データなしとエラー処理の設定) で、データがない場合のアラート動作を設定します。

   このセクションの後半のガイドラインに従います。

アラートルールにラベルを追加して、発射アラートインスタンスを処理する通知ポリシーを設定します。

ラベルに関係なく、すべてのアラートルールとインスタンスはデフォルトの通知ポリシーと一致します。ネストされたポリシーがない場合、またはネストされたポリシーがアラートルールまたはアラートインスタンスのラベルと一致しない場合、デフォルトの通知ポリシーは一致するポリシーです。

**通知を設定するには**

1. 通知のルーティング方法を変更するには、ラベルを追加します。

   ドロップダウンから既存のキーと値のペアを選択してカスタムラベルを追加するか、新しいキーまたは値を入力して新しいラベルを追加します。

1. アラートインスタンスのルーティング設定をプレビューします。

   追加されたラベルに基づいて、アラートインスタンスは表示された通知ポリシーにルーティングされます。

   各通知ポリシーを展開して、詳細を表示します。

1. **[詳細を表示]** を選択して、アラートルーティングの詳細とプレビューを表示します。

[注釈](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations)を追加して、アラート通知メッセージにアラートに関するコンテキストをさらに提供できます。

注釈は、アラート通知メッセージのアラートに関する詳細情報を提供するメタデータを追加します。例えば、アラートが発生した値や発生したサーバーを示す**サマリー**注釈を追加します。

**注釈を追加するには**

1. [オプション] 概要を追加します。

   何が起こったのか、その理由の簡単な概要。

1. (オプション) 説明を追加します。

   アラートルールの動作の説明。

1. [オプション] ランブック URL を追加します。

   アラートのランブックを保持するウェブページ

1. [オプション] カスタム注釈を追加します

1. [オプション] ダッシュボードとパネルリンクを追加します。

   アラートをダッシュボードのパネルにリンクします。

1. **[ルールを保存]** を選択します。

**1 次元ルールと多次元ルール**

Grafana マネージドアラートの場合、従来の条件を使用してルールを作成することも、多次元ルールを作成することもできます。
+ **クラシック条件のルール**

  従来の条件式を使用して、条件が満たされたときに単一のアラートを発射するルールを作成します。複数のシリーズを返すクエリの場合、Grafana は各シリーズのアラート状態を追跡しません。そのため、複数のシリーズでアラート条件が満たされた場合でも、Grafana が送信するアラートは 1 件のみです。
+ **多次元ルール**

  シリーズごとに個別のアラートを生成するには、多次元ルールを作成します。`Math`、`Reduce`、または `Resample` 式を使用して、多次元ルールを作成します。例:
  + 各クエリの `Reduce` 式を追加して、選択した時間範囲の値を 1 つの値に集計します ([数値データを使用するルール](v10-alerting-overview-numeric.md)には必要ありません)。
  + ルールの条件を含む `Math` 式を追加します。クエリまたは縮小式が、ルールが発射されない場合に `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](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) を参照してください。

**データなしまたはエラー処理の設定**

アラートルールの評価がデータなしまたはエラーを返すアラートルール評価時のアラート行動を設定します。

**注記**  
評価がデータなしまたはエラーを返したときに発射するように設定されているアラートルールは、評価期間全体が終了したときにのみ発動します。つまり、アラートルール条件に違反した場合にすぐに発射するのではなく、アラートルールは **For** フィールドとして設定された時間が終了するまで待機してから発車することで、アラートノイズを減らし、一時的なデータ可用性の問題を回避します。

アラートルールの評価でデータなしが返される場合は、次のようにアラートルールの状態を設定できます。


| データなし | 説明 | 
| --- | --- | 
| データなし | アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用した新しいアラート DatasourceNoData を作成します。 | 
| [アラート] | アラートルールの状態を Alerting に設定します。アラートルールは、For フィールドで設定された時間が終わるまで待機してから発射します。 | 
| OK | アラートルールの状態を Normal に設定します。 | 

評価でエラーが返された場合は、アラートルールの状態を次のように設定できます。


| エラー | 説明 | 
| --- | --- | 
| エラー | アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用したアラートインスタンス DatasourceError を作成します。 | 
| [アラート] | アラートルールの状態を Alerting に設定します。アラートルールは、For フィールドで設定された時間が終わるまで待機してから発射します。 | 
| OK | アラートルールの状態を Normal に設定します。 | 

**古いアラートインスタンスを解決する**

アラートインスタンスのディメンションまたはシリーズが 2 つの評価間隔でクエリ結果から完全に消えた場合、アラートインスタンスは「古い」と見なされます。

`Alerting`/`NoData`/`Error` 状態にある古いアラートインスタンスは、自動的に `Resolved` とマークされ、`grafana_state_reason` 注釈が理由 `MissingSeries` でアラートインスタンスに追加されます。

**パネルからアラートを作成する**

任意のパネルタイプからアラートを作成します。つまり、パネル内のクエリを再利用し、それに基づいてアラートを作成できます。

1. ダッシュボードセクションの**[ダッシュボード]** に移動します。

1. パネルの右上隅で、3 つのドット (楕円) を選択します。

1. ドロップダウンメニューから、**[More...]** (その他...) を選択し、**[新しいアラートルール]** を選択します。

これにより、アラートルールフォームが開き、現在のパネルのクエリーに基づいてアラートを設定および作成できます。

# データソースマネージドアラートルールを設定する
<a name="v10-alerting-configure-datasourcemanaged"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Ruler API が有効になっている外部 Grafana Mimir または Loki インスタンスのアラートルールを作成します。これらは、データソースマネージドアラートルールと呼ばれます。

**注記**  
外部 Grafana Mimir または Loki インスタンスのアラートルールは、エディタまたは管理者ロールを持つユーザーが編集または削除できます。  
UI で作成されたアラートリソースを削除すると、そのリソースを取得できなくなります。設定のバックアップを作成し、削除されたアラートリソースを復元できるようにするには、Terraform またはアラート API を使用してアラートリソースを作成します。

**前提条件**
+ Prometheus または Loki データソースへの書き込みアクセス権限があることを確認します。それ以外の場合、Grafana Mimir 管理のアラートルールを作成または更新することはできません。
+ Grafana Mimir および Loki データソースの場合、それぞれのサービスを設定して Ruler API を有効にします。
  + **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集するには、他のルールストレージタイプのいずれかを設定します。
  + **Grafana Mimir** - `/prometheus` プレフィックスを使用します。Prometheus データソースは Grafana Mimir と Prometheus の両方に対応しており、Grafana は[クエリ API](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) と [Ruler API](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#ruler) の両方が同じ URL にあることを想定しています。Ruler API に別の URL を指定することはできません。

**注記**  
特定の Loki または Prometheus データソースのアラートルールを管理しない場合は、その設定に移動し、**[Manage alerts via alerting UI]** (アラート UI 経由でアラートを管理する) チェックボックスをオフにします。

次の手順では、データソースマネージドアラートルールを作成するプロセスについて説明します。

データソース管理のアラートルールを作成するには、ワークスペース内のアラート作成フローを使用し、以下の手順に従います。

**アラートルール名の設定方法**

1. **[アラート]** -> **[アラートルール]** -> **[\$1 新しいアラートルール]** を選択します。

1. アラートルールを識別する名前を入力します。

   この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。

測定するデータと、アラートルールを起動する前に満たす必要がある条件を取得するクエリを定義します。

**クエリと条件の定義方法**

1. すべてのアラートルールは、デフォルトで Grafana が管理します。データソースマネージドアラートルールに切り替えるには、**[データソースマネージドアラートルールに切り替える]** を選択します。

1. ドロップダウンリストからデータソースを選択する。

   **[高度なデータソースピッカーを開く]** を選択して、データソースの追加 (管理者のみ可能) など、その他のオプションを表示することもできます。

1. PromQL または LogQL クエリを入力します。

1. **[アラートのプレビュー]** を選択します。

アラートルールの評価を使用して、アラートルールを評価する頻度と状態の変更速度を決定します。

**アラート評価の動作の設定方法**

1. 名前空間を選択するか、**[\$1 新しい名前空間]** を選択します。

1. 評価グループを選択するか、**[\$1 新しい評価グループ]** を選択します。

   新しい評価グループを作成するには、グループの間隔を指定します。

   同じグループ内のすべてのルールは、同じ時間間隔で順番に評価されます。

1. 保留期間を入力します。

   保留期間は、アラートルールが発射するまで条件に違反している可能性がある期間です。

   条件が満たされると、アラートは `Pending` 状態に入ります。指定された期間、条件がアクティブなままの場合、アラートは `Firing` 状態に移行します。アクティブでない場合は `Normal` 状態に戻ります。

アラートルールにラベルを追加して、発射アラートインスタンスを処理する通知ポリシーを設定します。

ラベルに関係なく、すべてのアラートルールとインスタンスはデフォルトの通知ポリシーと一致します。ネストされたポリシーがない場合、またはネストされたポリシーがアラートルールまたはアラートインスタンスのラベルと一致しない場合、デフォルトの通知ポリシーは一致するポリシーです。

**通知の設定**
+ 通知のルーティング方法を変更するには、ラベルを追加します。

  ドロップダウンから既存のキーと値のペアを選択してカスタムラベルを追加するか、新しいキーまたは値を入力して新しいラベルを追加します。

[注釈](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations)を追加して、アラート通知にアラートに関するコンテキストをさらに提供できます。

注釈は、アラート通知のアラートに関する詳細情報を提供するメタデータを追加します。例えば、アラートが発生した値や発生したサーバーを示す `Summary` 注釈を追加します。

**注釈を追加するには**

1. [オプション] 概要を追加します。

   何が起こったのか、その理由の簡単な概要。

1. (オプション) 説明を追加します。

   アラートルールの動作の説明。

1. [オプション] ランブック URL を追加します。

   アラートのランブックを保持するウェブページ

1. [オプション] カスタム注釈を追加します

1. [オプション] ダッシュボードとパネルリンクを追加します。

   アラートをダッシュボードのパネルにリンクします。

1. **[ルールを保存]** を選択します。

# 記録ルールを設定する
<a name="v10-alerting-configure-recordingrules"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

外部 Grafana Mimir または Loki インスタンスの記録ルールを作成および管理することができます。記録ルールは、頻繁に必要になる式や計算負荷の高い式を事前に計算し、その結果を新しい時系列セットとして保存します。この新しい時系列のクエリは、特にダッシュボードでは、ダッシュボードが更新されるたびに同じ式をクエリするため、より高速になります。

**注記**  
記録ルールはインスタンスルールとして実行され、10 秒ごとに実行されます。

**前提条件**
+ Prometheus または Loki データソースへの書き込みアクセス権限があることを確認します。データソースでアラートルールを作成または更新します。
+ Grafana Mimir および Loki データソースの場合、それぞれのサービスを設定して Ruler API を有効にします。
  + **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集する場合、他のストレージタイプを設定してください。
  + **Grafana Mimir** – `/prometheus` プレフィックスを使用します。Prometheus データソースは Grafana Mimir と Prometheus の両方に対応しており、Grafana はクエリ API と Ruler API の両方が同じ URL にあることを想定しています。Ruler API に別の URL を指定することはできません。

**注記**  
特定の Loki または Prometheus データソースのアラートルールを管理しない場合は、その設定に移動し、**[アラート UI 経由でアラートを管理する]** チェックボックスをオフにします。

**記録ルールを作成するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]**、**[アラートルール]** を選択します。

1. **[新しい記録ルール]** を選択します。

1. ルール名を設定します。

   記録ルール名は Prometheus メトリクス名で、空白を含まない必要があります。

1. クエリの定義
   + Loki または Prometheus データソースを選択します。
   + クエリを入力します。

1. 名前空間とグループを追加します。
   + **[名前空間]** ドロップダウンから、既存のルール名前空間を選択するか、新しいルール名前空間を追加します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。
   + **[グループ]** ドロップダウンから、選択した名前空間内の既存のグループを選択するか、新しいものを作成します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。

1. ラベルを追加します。
   + ドロップダウンから既存のキーと値のペアを選択してカスタムラベルを追加するか、新しいキーまたは値を入力して新しいラベルを追加します。

1. **[ルールを保存]** を選択してルールを保存するか、**[ルールを保存して終了]** を選択してルールを保存し、アラートページに戻ります。

# コンタクトポイントの設定
<a name="v10-alerting-configure-contactpoints"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

コンタクトポイントを使用して、アラートルールが発生したときにコンタクトに通知する方法を定義します。

**注記**  
Grafana で管理されるアラートの通知先 (コンタクトポイント) は、作成および編集が可能です。データソース管理アラートのコンタクトポイントは読み取り専用です。

## コンタクトポイント (通知先) の使用
<a name="v10-alerting-configure-contactpoints-working"></a>

次の手順では、通知先 (コンタクトポイント) を追加、編集、削除、テストする方法について説明します。

**コンタクトポイントの追加方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[コンタクトポイント]** を選択します。

1. **[アラートマネージャーの選択]** ドロップダウンから、アラートマネージャーを選択します。デフォルトでは、Grafana アラートマネージャーが選択されています。

1. **[コンタクトポイント]** タブで、 **[\$1 コンタクトポイントの追加]** を選択します。

1. コンタクトポイントの** [名前]** を入力します。

1. **[統合]** からタイプを選択し、そのタイプに基づいて必須フィールドを入力します。例えば、Slack を選択した場合は、Slack チャネルと通知先となるユーザーを入力します。

1. 選択したコンタクトポイントで利用可能な場合は、任意の**オプション設定**を選択して追加の設定を指定します。

1. **[通知設定]**で**[解決済みメッセージの無効化]**を選択すると、アラートが解決した際に通知を受け取らないようにすることができます (任意)。

1. 別のコンタクトポイント統合を追加するには、**[コンタクトポイント統合を追加]** を選択し、必要なコンタクトポイントタイプごとにステップを繰り返します。

1. 変更内容を保存します。

**コンタクトポイントの編集方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[コンタクトポイント]**を選択すると、現在設定されているコンタクトポイントのリストが表示されます。

1. 編集する連絡先を選択し、**[編集]** を選択します。

1. 連絡先を更新し、変更を保存します。

使用されていないコンタクトポイントは、通知ポリシーで削除できます。

**連絡先の削除方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。

1. **コンタクトポイント** で、削除するコンタクトポイントを選択し、**[詳細]**、**[削除]** を選択します。

1. 確認ダイアログボックスで、**[はい、削除]** を選択します。

**注記**  
コンタクトポイントが通知ポリシーで使用されている場合、コンタクトポイントを削除する前に、通知ポリシーを削除するか、別のコンタクトポイントを使用するように編集する必要があります。

コンタクトポイントを作成したら、テスト通知を送信して、正しく設定されていることを確認します。

**テスト通知の送信方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。

1. **コンタクトポイント** で、テストするコンタクトポイントを選択し、**[編集]** を選択します。必要に応じて、新しいコンタクトポイントを作成することもできます。

1. **[テスト]** を選択して、コンタクトポイントテストダイアログを開きます。

1. 事前定義されたテスト通知を送信するか、**[カスタム]** を選択してテスト通知に独自の注釈とラベルを追加するかを選択します。

1. **[テスト通知を送信]**を選択して、指定されたコンタクトポイント宛にアラートをテストします。

## コンタクトポイント統合の設定
<a name="v10-alerting-configure-contactpoints-integration"></a>

アラートルールの発射時に通知を受信するための優先通信チャネルを選択するように Grafana でコンタクトポイント統合を設定します。各統合には、独自の設定オプションとセットアッププロセスがあります。ほとんどの場合、これには API キーまたは Webhook URL の提供が含まれます。

設定が完了すると、コンタクトポイントの一部として統合を使用して、アラートの状態が変化するたびに通知を受け取ることができます。このセクションでは、PagerDuty を例として使用して統合を設定する基本的な手順について説明します。これにより、リアルタイムアラートの受信を開始し、モニタリングデータを常に把握できます。

**サポートされている統合のリスト**

次の表に、Grafana でサポートされているコンタクトポイントのタイプを示します。


| 名前 | タイプ | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Pager Duty | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**アラート用の PagerDuty の設定**

PagerDuty を設定するには、統合キーを指定する必要があります。次の詳細情報を入力します：


| 設定 | 説明 | 
| --- | --- | 
| 統合キー | PagerDuty の統合キー | 
| 緊急度 | 動的通知のレベル。デフォルトは critical です。 | 
| カスタムの詳細 | イベントに関するその他の詳細 | 

`CustomDetails` フィールドは、任意のキーと値のペアを含むオブジェクトです。ユーザー定義の詳細が、デフォルトで使用されている詳細とマージされます。

`CustomDetails` のデフォルト値は次のとおりです。

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

キーが重複している場合、ユーザー定義の詳細がデフォルトのキーを上書きします。

# 通知ポリシーを設定する
<a name="v10-alerting-configure-notification-policies"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

通知ポリシーでは、アラートがコンタクトポイント (通知先) にどのように配信されるかを指定します。

ポリシーにはツリー構造があり、1 つ以上のネストされたポリシーを各ポリシーに含めることができます。デフォルトポリシーを除く各ポリシーは、特定のアラートラベルと一致させることもできます。

各アラートは、デフォルトのポリシーによって評価され、それに続き、ネストされた各ポリシーによって評価されます。

ネストされたポリシーの `Continue matching subsequent sibling nodes` オプションを有効にすると、1 つ以上一致があった後も評価が続行されます。子ポリシーのいずれとも一致しない場合、親ポリシーの設定とコンタクトポイント (通知先) の情報によってアラートの動作が制御されます。デフォルトのポリシーは、ネストされたポリシーと一致しないアラートを管理します。

これらの通知ポリシーの詳細については、「[通知](v10-alerting-explore-notifications.md)」を参照してください。

以下に、通知ポリシーを作成および管理するための手順を紹介します。

**デフォルトの通知ポリシーの編集方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[通知ポリシー]** を選択します。

1. **[アラートマネージャーの選択]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. **[デフォルトポリシー]** セクションで、 **[...]**、**[編集]** を続けて選択します。

1. **[デフォルトのコンタクトポイント]** で、アラートルールが特定のポリシーと一致しない場合に通知を送信するコンタクトポイント (通知先) を更新します。

1. **[グループ化]** で、アラートをグループ化するラベルを選択します。このポリシーに複数のアラートが一致すると、それらのアラートはこれらのラベルでグループ化されます。グループごとに通知が送信されます。フィールドが空 (デフォルト) の場合、すべての通知は 1 つのグループで送信されます。特別なラベル `...` を使用して、すべてのラベルでアラートをグループ化します (グループ化を効果的に無効にします）。

1. **[タイミングオプション]** で、以下のいずれかを選択します。
   + **[グループ待機]** – 同じグループのアラートをバッファリングしてから、最初の通知を送信するまでの待機時間。デフォルト値は 30 秒です。
   + **[グループ間隔]** – グループ内の 2 つの通知の最小時間間隔。デフォルト値は 5 分です。
   + **[繰り返し間隔]** – グループに新しいアラートが追加されなかった場合に、通知を再送信するまでの最小時間間隔。デフォルトは 4 時間です。

1. **[保存]** を選択して変更を保存します。

新しい通知ポリシーを作成するには、ツリー構造を考慮する必要があります。ツリーのトランクに作成された新しいポリシー (デフォルトポリシー) は、ツリーブランチです。各ブランチには、独自のネストされたポリシーを含めることができます。そのため、デフォルトのポリシーまたは既にネストされたポリシーのいずれかで、常に新しい**ネストされた**ポリシーを追加します。

**新しいネストされたポリシーを追加するには**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[通知ポリシー]** を選択します。

1. **[アラートマネージャーの選択]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. 最上位の特定のポリシーを追加するには、[特定のルーティング] セクション (デフォルトポリシー、または新しいネストされたポリシーを追加する既存の別のポリシーのいずれか) に移動し、**[\$1 新しいネストされたポリシー]** を選択します。

1. 一致するラベルセクションで、アラートラベルを照合するための 1 つ以上のルールを追加します。

1. **[コンタクトポイント]** ドロップダウンで、アラートがこの特定のポリシーのみに一致し、ネストされたポリシーのいずれにも一致しない場合に通知を送信するコンタクトポイントを選択します。

1. オプションで、アラートが現在のポリシーと一致した後でも、**[後続の兄弟ノードを照合し続ける]** を有効にして、兄弟ポリシーの照合を続行します。このオプションを有効にすると、1 つのアラートに対して複数の通知を取得できます。

1. オプションで、**[グループ化の上書き]** を有効にして、デフォルトポリシーと同じグループ化を指定します。オプションが有効になっていない場合、デフォルトのポリシーグループが使用されます。

1. オプションで、**[一般的なタイミングの上書き]** を有効にして、グループ通知ポリシーで設定されているタイミングオプションを上書きします。

1. **[Save policy(ポリシーの保存]** を選択して変更を保存します。

**ネストされたポリシーを編集するには**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[通知ポリシー]** を選択します。

1. 編集するポリシーを選択したら、**[...]**、**[編集]** を続けて選択します。

1. 変更を加えます (ネストされたポリシーを追加する場合と同様)。

1. 変更内容を保存します。

**ポリシーの検索**

ポリシーのツリー内では、*ラベルマッチャー*または*コンタクトポイント*で検索できます。
+ コンタクトポイントで検索するには、**[コンタクトポイントで検索]** フィールドにコンタクトポイントの部分的な名前または完全な名前を入力します。そのコンタクトポイントを使用するポリシーは、ユーザーインターフェイスで強調表示されます。
+ ラベルで検索するには、**[ラベルマッチャーによる検索]** 入力フィールドに有効なラベルマッチャーを入力します。複数のマッチャーをカンマで区切って入力できます。有効なマッチャー入力の例は `severity=high, region=~EMEA|NA` です。
**注記**  
ラベルで検索する場合、一致するすべてのポリシーは完全一致になります。部分一致と正規表現形式の一致はサポートされていません。

# アラートの管理
<a name="v10-alerting-manage"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートルール、コンタクトポイント、通知ポリシーを設定したら、Grafana アラートを使用してアラートを実際に管理できます。

**Topics**
+ [通知のカスタマイズ](v10-alerting-manage-notifications.md)
+ [コンタクトポイントの管理](v10-alerting-manage-contactpoints.md)
+ [アラート通知のサイレンシング](v10-alerting-silences.md)
+ [アラートルールの表示とフィルタリング](v10-alerting-manage-rules-viewfilter.md)
+ [ミュートタイミング](v10-alerting-manage-muting.md)
+ [アラートルールの状態と正常性を表示する](v10-alerting-manage-rulestate.md)
+ [アラートグループ別に表示およびフィルタリングする](v10-alerting-manage-viewfiltergroups.md)
+ [通知エラーの表示](v10-alerting-manage-viewnotificationerrors.md)

# 通知のカスタマイズ
<a name="v10-alerting-manage-notifications"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

通知テンプレートを使用して、通知をカスタマイズします。

通知テンプレートを使用して、通知内のメッセージのタイトル、メッセージ、形式を変更できます。

通知テンプレートは、Amazon SNS や Slack などの特定のコンタクトポイント統合には関連付けられていません。ただし、異なるコンタクトポイント統合用に個別の通知テンプレートを作成することもできます。

通知テンプレートを使用すると、次のことができます。
+ 概要、説明、ラベルと注釈、値、リンクなど、通知内の情報を追加、削除、または並べ替える
+ テキストを太字と斜体で書式設定し、改行を追加または削除する

通知テンプレートを次の目的には使用できません。
+ Slack や Microsoft Teams などのインスタントメッセージングサービスで通知のデザインを変更する

**Topics**
+ [Go のテンプレート言語の使用](v10-alerting-notifications-go-templating.md)
+ [通知テンプレートの作成](v10-alerting-create-templates.md)
+ [通知テンプレートの使用](#v10-alerting-use-notification-templates)
+ [テンプレートリファレンス](v10-alerting-template-reference.md)

# Go のテンプレート言語の使用
<a name="v10-alerting-notifications-go-templating"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Go のテンプレート言語である [text/template](https://pkg.go.dev/text/template) で通知テンプレートを書き込みます。

このセクションでは、Go のテンプレート言語の概要と、text/template でのテンプレートの作成について説明します。

## dot
<a name="v10-go-dot"></a>

text/template には dot と呼ばれる特別なカーソルがあり、`.` として記述されます。このカーソルは、テンプレート内の使用場所に応じて値が変化する変数と考えることができます。例えば、通知テンプレートの開始時に `.` は、`Alerts`、`Status`、`GroupLabels`、`CommonLabels`、`CommonAnnotations` および `ExternalURL` を含む多数のフィールドを含む `ExtendedData` オブジェクトを参照します。ただし、dot は、リスト上の `range` で使用される場合、`with` 内で使用される場合、または他のテンプレートで使用する機能テンプレートを記述する場合、他の何かを参照する場合があります。これの例は [通知テンプレートの作成](v10-alerting-create-templates.md) で、すべてのデータと関数は [テンプレートリファレンス](v10-alerting-template-reference.md) で確認できます。

## 開始と終了のタグ
<a name="v10-go-openclosetags"></a>

テキスト/テンプレートでは、テンプレートが変数を印刷するか、if ステートメントなどのコントロール構造を実行するかに関係なく、テンプレートは `{{`で始まり、`}}` で終わります。これは、変数の出力に `{{` と `}}` を使用し、制御構造に `{%` と `%}` を使用する Jinja などの他のテンプレート言語とは異なります。

## 印刷
<a name="v10-go-print"></a>

何かの値を印刷するには、`{{` と `}}` を使用します。dot の値、dot のフィールド、関数の結果、[[変数]](#v10-go-variables)の値を印刷できます。例えば、dot が `ExtendedData` を参照する `Alerts` フィールドを印刷するには、次のように記述します。

```
{{ .Alerts }}
```

## アラートを反復処理する
<a name="v10-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="v10-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 }}
```

## インデックス関数
<a name="v10-go-index"></a>

特定の注釈またはラベルを出力するには、 `index` 関数を使用します。

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## If ステートメント
<a name="v10-go-if"></a>

テンプレートでは if ステートメントを使用できます。例えば、`.Alerts` にアラートがない場合に `There are no alerts` を出力するには、次のように記述します。

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## With
<a name="v10-go-with"></a>

With は if ステートメントと似ていますが、if ステートメントとは異なり、`with` は dot を更新して with の値を参照します。

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## [変数]
<a name="v10-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="v10-go-rangeindex"></a>

範囲の開始時にインデックス変数と値変数を定義することで、範囲内の各アラートのインデックスを取得できます。

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## テンプレートの定義
<a name="v10-go-define"></a>

`define` とテンプレートの名前を二重引用符で囲むことで、他のテンプレート内で使用できるテンプレートを定義できます。`__subject`、`__text_values_list`、`__text_alert_list`、`default.title`、`default.message` などのデフォルトテンプレートを含め、他のテンプレートと同じ名前のテンプレートを設定しないでください。デフォルトテンプレートと同じ名前のテンプレート、または別の通知テンプレート内のテンプレートと同じ名前で作成されている場合、Grafana はいずれかのテンプレートを使用することになり、混乱が生じます。Grafana は、同じ名前のテンプレートが 2 つ以上ある場合、エラーメッセージを返しません。

```
{{ define "print_labels" }}
{{ end }}
```

## テンプレートの実行
<a name="v10-go-execute"></a>

`template`、二重引用符で囲まれたテンプレートの名前、およびテンプレートに渡されるカーソルを使用して、テンプレート内で定義されたテンプレートを実行できます。

```
{{ template "print_labels" . }}
```

## テンプレートにデータを渡す
<a name="v10-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="v10-go-comments"></a>

`{{/*` および `*/}}` を使用してコメントを追加できます。

```
{{/* This is a comment */}}
```

コメントが改行を追加しないようにするには、以下を使用します。

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## インデント
<a name="v10-go-indentation"></a>

タブとスペースの両方のインデントと改行を使用して、テンプレートをより読みやすくすることができます。

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

ただし、テンプレートのインデントはテキストにも適用されます。次に、削除する方法を説明します。

## スペースと改行を削除する
<a name="v10-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="v10-alerting-create-templates"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

コンタクトポイントに送信するため、再利用可能な通知テンプレートを作成できます。

通知テンプレートには 1 つ以上のテンプレートを追加できます。

通知テンプレート名は、一意である必要があります。同じ通知テンプレートまたは異なる通知テンプレートに、同じ名前のテンプレートを 2 つ使用することはできません。`__subject`、`__text_values_list`、`__text_alert_list`、`default.title`、`default.message` などのデフォルトテンプレートと同じ名前のテンプレートを定義しないでください。

[コンタクトポイント] タブには、通知テンプレートのリストが表示されます。

## 通知テンプレートの作成
<a name="v10-alerting-creating-templates"></a>

**通知テンプレートを作成するには**

1. **[アラート]**、**[コンタクトポイント]** を続けて選択します。

1. **[通知テンプレート]** タブを選択し、**[\$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. **[通知テンプレート]** タブを選択し、**[\$1 通知テンプレートの追加]** を選択します。

1. 通知テンプレート全体の名前を入力します。例えば、`email`。

1. 各テンプレートの最初と最後に `{{ define "name-of-template" }}` と `{{ end }}` を含む各テンプレートをコンテンツフィールドに書き込みます。`email.subject` や `email.message` など、通知テンプレート内の各テンプレートにわかりやすい名前を使用できます。この場合、上記で入力した通知テンプレートの名前は再度使用しないでください。

   後のセクションでは、作成するテンプレートの詳細な例を示します。

1. 保存をクリックします。

## 通知テンプレートをプレビューする
<a name="v10-alerting-preview-templates"></a>

コンタクトポイントで使用する前に通知テンプレートの外観をプレビューすると、作成するテンプレートの結果を理解しやすくなり、テンプレートを保存する前にエラーを修正することができます。

**注記**  
通知プレビューは Grafana アラートマネージャーでのみ使用できます。

**通知テンプレートをプレビューするには**

1. **[アラート]**、**[コンタクトポイント]** を続けて選択します。

1. **[通知テンプレート]** タブを選択し、**[\$1 通知テンプレートの追加]** を選択するか、既存のテンプレートを編集します。

1. テンプレートコンテンツを追加または更新します。

   デフォルトのデータが提供され、アラートデータとアラートインスタンスを追加または編集できます。アラートデータは、ペイロードデータウィンドウ自体に直接追加するか、**[アラートインスタンスの選択]** または**[カスタムアラートの追加]** をクリックします。

1. [オプション] 既存のアラートインスタンスからアラートデータを追加するには:

   1. **[アラートインスタンスの選択]** を選択します。

   1. アラートインスタンスにカーソルを合わせると、各アラートインスタンスに関する詳細情報が表示されます。

   1. **[Confirm]** (確認) を選択して、アラートインスタンスをペイロードに追加します。

1. [オプション] アラートデータエディタを使用してアラートデータを追加するには、**[カスタムデータの追加]** を選択します。

   1. 注釈/カスタムラベルを追加するか、ダッシュボードまたはパネルを設定します。

   1. 通知に発射アラートを追加するか、解決済みアラートを追加するかに応じて、発射または解決を切り替えます。

   1. **[アラートデータの追加]** を選択します。

   1. **[プレビューの更新]** を選択して、テンプレートの内容と対応するペイロードデータを確認します。

   テンプレートにエラーがある場合はプレビューに表示され、保存する前に修正できます。

1. 変更内容を保存します。

## メッセージの件名のテンプレートの作成
<a name="v10-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="v10-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="v10-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 "slack.title" . }}
   ```

## Slack メッセージのコンテンツのテンプレート作成
<a name="v10-alerting-create-template-slack-message"></a>

すべての発射アラートと解決済みアラートの説明 (ラベル、注釈、ダッシュボード URL など) を含む Slack メッセージのコンテンツのテンプレートを作成します。

**注記**  
このテンプレートは Grafana マネージドアラート専用です。データソースマネージドアラートに テンプレートを使用するには、DashboardURL と SilenceURL への参照を削除します。Prometheus 通知の設定に関する詳細については、「[通知に関する Prometheus ドキュメント](https://prometheus.io/docs/alerting/latest/notifications/)」を参照してください。

```
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 "slack.message" . }}
   ```

## 共有テンプレートを使用して E メールと Slack の両方にテンプレートを作成する
<a name="v10-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="v10-alerting-use-notification-templates"></a>

コンタクトポイントのテンプレートを使用して通知をカスタマイズします。

**コンタクトポイントの作成時にテンプレートを使用するには**

1. **[アラート]** メニューから、**[コンタクトポイント]** タブを選択して、既存のコンタクトポイントのリストを表示します。

1. **[New]** (新規作成) を選択します。または、**[編集]** アイコンを選択して、既存のコンタクトポイントを編集することもできます。

1. **[Message]** (メッセージ) や **[Subject]** (件名) などのフィールドに、使用するテンプレートを入力します。テンプレートを入力するには、`{{ template "template_name" . }}` フォームを使用し、 *template\$1name* を使用するテンプレートの名前に置き換えます。

1. **[コンタクトポイントの保存]** を選択します。

# テンプレートリファレンス
<a name="v10-alerting-template-reference"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

このセクションでは、テンプレートを作成するためのリファレンス情報を提供します。

**アラート (型)**

アラート型には、次のデータがあります。


| 名前 | [Kind] (種類) | 説明 | 例 | 
| --- | --- | --- | --- | 
|  ステータス  |  string  |  `firing` または `resolved`  | \$1\$1 .Status \$1\$1 | 
|  ラベル  |  KeyValue  |  アラートに付与された一連のラベル。  | \$1\$1 .Labels \$1\$1 | 
|  ‏注釈  |  KeyValue  |  アラートに付与された一連の注釈。  | \$1\$1 .Annotations \$1\$1 | 
| 値 | KeyValue | クラシック条件を含むすべての式の値 | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  time.Time  |  アラートが発行された時刻。  | \$1\$1 .StartsAt \$1\$1 | 
|  EndsAt  |  time.Time  |  アラートの終了時刻がわかっている場合にのみ設定されます。それ以外の場合、最後にアラートを受信してから設定可能なタイムアウト期間が適用されます。  | \$1\$1 .EndsAt \$1\$1 | 
|  GeneratorURL  |  string  |  Grafana または外部アラートマネージャーへのリンク。  | \$1\$1 .GeneratorURL \$1\$1 | 
|  SilenceURL  |  string  |  アラートをサイレンスするリンク (このアラートのラベルがあらかじめ入力されています)。Grafana 管理のアラートのみ。  | \$1\$1 .SilenceURL\$1\$1 | 
|  DashboardURL  |  string  |  Grafana ダッシュボードへのリンク (アラートルールが Grafana に属している場合)。Grafana 管理のアラートのみ。  | \$1\$1 .DashboardURL \$1\$1 | 
|  PanelURL  |  string  |  Grafana ダッシュボードパネルへのリンク (アラートルールが Grafana に属している場合)。Grafana 管理のアラートのみ。  | \$1\$1 .PanelURL \$1\$1 | 
|  Fingerprint  |  string  |  アラートの識別に使用するフィンガープリント。  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  string  |  アラート内の各削減された式のラベルと値を含む文字列。  | \$1\$1 .ValueString \$1\$1 | 

 **ExtendedData**

ExtendedData オブジェクトには、以下のプロパティが含まれています。


| 名前 | [Kind] (種類) | 説明 | 例 | 
| --- | --- | --- | --- | 
|  レシーバー  |  `string`  |  通知を送信するコンタクトポイントの名前。  |  `{{ .Receiver }}`  | 
|  ステータス  |  `string`  |  ステータスは、少なくとも 1 つのアラートが発せられている場合は `firing` で、それ以外の場合は `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 }}` | 
|  [Values] (値)  |    |  []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="v10-alerting-manage-contactpoints"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

**[コンタクトポイント]** リストビューには、既存のすべてのコンタクトポイントと通知テンプレートが一覧表示されます。

**[コンタクトポイント]** タブでは、次のことができます。
+ コンタクトポイントと統合の名前とタイプを検索する。
+ 既存のすべての連絡先と統合を表示する。
+ 各コンタクトポイントが使用されている通知ポリシーの数を表示し、リンクされた通知ポリシーに直接移動する。
+ 通知配信のステータスを表示する。
+ 個々のコンタクトポイントまたはすべてのコンタクトポイントを JSON、YAML、または Terraform 形式でエクスポートする。
+ 通知ポリシーで使用されていないコンタクトポイントを削除する。

**[通知テンプレート]** タブでは、次のことができます。
+ 既存の通知テンプレートを表示、編集、コピー、または削除する。

# アラート通知のサイレンシング
<a name="v10-alerting-silences"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

*サイレンス*を使用してアラート通知を抑制できます。サイレンスは通知の作成を停止するだけで、アラートルールの評価やユーザーインターフェースへのアラートインスタンスの表示は引き続き行われます。アラートをサイレンスにする場合、停止する時間枠を指定します。

**注記**  
アラート通知を一定の時間間隔、定期的なメンテナンス期間中など、で停止するには、サイレンスではなく [ミュートタイミング](v10-alerting-manage-muting.md) を使用します。

**サイレンスの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。

1. **[サイレンス]** を選択します。

1. アラートマネージャードロップダウンから **[アラートマネージャー]** を選択します。

1. **[サイレンスの作成]** を選択します。

1. **[サイレンスの開始と終了]** でサイレンスを有効にする開始日と終了日を選択します。

1. 終了時刻を設定する代わりに、**[期間]** でサイレンスが適用される期間を指定します。この方法を使用すると、**[サイレンスの開始と終了]** フィールドの終了時刻が自動的に更新されます。

1. **[ラベル]** と **[値]** フィールドに、1 つ以上の*一致するラベル*を入力します。照合機能により、どのルールにサイレンスを適用するかが決定されます。一致するアラート (発動状態) はすべて、**[Affected alerts instances(影響を受けるアラートインスタンス)]** フィールドに表示されます。

1. 必要に応じて、サイレンスに関する**コメント**を追加します。

1. **[送信]** を選択します。

**サイレンスを編集するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。

1. 既存のサイレンスのリストを表示するには、**[サイレンス]** を選択します。

1. 編集するサイレンスを見つけ、**[編集]** (ペンアイコン) を選択します。

1. 変更後、**[送信]** を選択して変更を保存します。

既存のサイレンスを編集するには、**[編集]** アイコン (ペン) を選択します。

**サイレンスフォームへの URL リンクを作成するには**

サイレンスフォームにリンクするときは、`matcher` および `comment` クエリパラメータを使用して、デフォルトの一致するラベルとコメントを指定します。`matcher` パラメータは、次の `[label][operator][value]` の形式である必要があります。この時、`operator` パラメータには以下のいずれかを指定できます: `=` (正規表現ではなく等号)、`!=` (正規表現ではなく不等号)、`=~` (等号、正規表現)、`!~` (不等号、正規表現)。URL には、 キー `matcher` を含む多くのクエリパラメータを含めることができます。例えば、一致するラベル `severity=critical` と `cluster!~europe-.*` ならびにコメント `Silence critical EU alerts` を使用してサイレンスフォームにリンクするには、URL `https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert` を作成します。

外部アラートマネージャーの新しいサイレンスページにリンクするには、`alertmanager` クエリパラメータを追加します。

**サイレンスを削除するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。

1. 既存のサイレンスのリストを表示するには、**[サイレンス]** を選択します。

1. 終了するサイレンスを選択し、**[サイレンス解除]** を選択します。この操作によりアラートの停止状態は終了します。
**注記**  
サイレンス解除を行うと、終了時刻が現在の時刻に設定されたものとして、アラートの停止状態が終了します。（自動または手動を問わず）終了したサイレンスは5 日間保持され、一覧表示されます。リストからサイレンスを手動で削除することはできません。

# アラートルールの表示とフィルタリング
<a name="v10-alerting-manage-rules-viewfilter"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

**[アラート]** ページには、アラートルールが一覧表示されます。デフォルトでは、ルールはデータソースの種類ごとにグループ化されます。**Grafana** セクションには、Grafana によって管理されるルールが一覧表示されます。Prometheus 互換データソースのアラートルールもここに表示されます。Prometheus 互換データソースのアラートルールは表示できますが、編集することはできません。

Mimir/Cortex/Loki ルールセクションには、Mimir、Cortex、または Loki データソースのすべてのルールが一覧表示されます。クラウドアラートルールもこのセクションに表示されます。

大量のアラートを管理する場合、拡張アラートルール検索機能を使用して、フォルダ、評価グループ、ルールをフィルタリングできます。さらに、ラベル、状態、タイプ、正常性などのプロパティでアラートルールをフィルタリングできます。

## アラートルールの表示
<a name="v10-alerting-manage-rules-view"></a>

Grafana アラートを使用すると、すべてのアラートを 1 ページに表示できます。

**アラートの詳細を表示するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]**、**[アラートルール]** を選択します。デフォルトでは、リストビューが表示されます。

1. **[表示形式]** では、任意のオプションを選択して、グループ化されたビュー、リストビュー、および状態ビューを切り替えることができます。

1. ルール行を展開して、ルールラベル、注釈、データソース、ルールクエリ、およびルールの結果のアラートインスタンスのリストを表示します。

このページから、アラートルールのコピーを作成して、既存のルールを再利用することもできます。

## アラートルールのエクスポート
<a name="v10-alerting-manage-rules-export"></a>

ルールは Grafana ワークスペースで YAML または JSON にエクスポートできます。
+ YAML、JSON、または Terraform にエクスポートする各アラートルールグループの横にある **[ルールグループのエクスポート]** アイコンを選択します。
+ **[ルールのエクスポート]** を選択して、すべての Grafana マネージドアラートルールを YAML、JSON、または Terraform にエクスポートします。
+ グループ内の個々のアラートルールの横にある **[その他]**、**[エクスポートを変更** を選択して、プロビジョニングされたアラートルールを編集し、変更されたバージョンをエクスポートします。

## プロビジョニングされたアラートのクエリ定義を表示する
<a name="v10-alerting-manage-rules-querydef"></a>

プロビジョニングされたアラートの読み取り専用クエリ定義を表示します。ルール定義の「as-code」リポジトリにアクセスすることなく、アラートルールのクエリが正しいかどうかをすばやく確認できます。

**グループ化されたビュー**

グループ化されたビューには、フォルダ別にグループ化された Grafana アラートルールと、`namespace` と `group` によりグループ化された Loki または Prometheus アラートルールが表示されます。これは、ルールの管理を目的としたデフォルトのルールリストビューです。各グループを展開すると、そのグループ内のルールのリストが表示されます。さらにルールを展開すると、その詳細を見ることができます。また、ルールから生成されたアクションボタンとアラートを展開して、詳細を表示することもできます。

**状態ビュー**

状態ビューには、アラートルールが状態ごとグループ化されて表示されます。このビューを使用すると、各ルールがどの状態にあるかを一目で確認できます。各ルールは展開して詳細を表示することがでます。アクションボタンとこのルールによって生成されたアラート、および各アラートをさらに展開して詳細を表示することができます。

## アラートルールのフィルタリング
<a name="v10-alerting-manage-rules-filter"></a>

**[アラート]** ページに表示されるアラートルールは、いくつかの方法でフィルタリングできます。

**アラートルールをフィルタリングするには**

1. **[データソースの選択]** からデータソースを選択します。選択したデータソースをクエリするアラートルールが表示されます。

1. **[ラベルで検索]** で、ラベルセレクタを使用して検索条件を入力します。例えば、`environment=production;region=~US|EU,severity!=warning`。

1. **[Filter alerts by state (状態別にアラートをフィルタリング)]** から、表示するアラート状態を選択します。その状態に一致するアラートルールが表示されます。他の状態に一致するルールは非表示になります。

# ミュートタイミング
<a name="v10-alerting-manage-muting"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ミュートタイミングとは、ポリシーの新しい通知が生成されたり送信されないようにする繰り返しの時間間隔です。定期的なメンテナンス期間など、アラートが特定の期間や繰り返し発生するのを防ぐために使用されます。

サイレンスと似ていますが、ミュートタイミングはアラートルールの評価や、ユーザーインターフェースへのアラート表示を停止せず、通知の作成のみを防ぎます。

外部のアラートマネージャーデータソースの Grafana 管理のミュートタイミングとミュートタイミングを設定できます。

## ミュートタイミングとサイレンス
<a name="v10-alerting-manage-muting-compare"></a>

次の表に、「ミュートタイミング」と「サイレンス」の違いを示します。


| ミュートタイミング | サイレンス | 
| --- | --- | 
| 繰り返しの時間間隔を定義します。 | 開始時刻と終了時刻を固定します。 | 
| 作成され、通知ポリシーに追加されます。 | ラベルを使用してアラートと照合し、サイレンスするかどうかが判断されます。 | 

## ミュートタイミングの追加
<a name="v10-alerting-manage-muting-add"></a>

ミュートタイミングは Grafana ワークスペースで作成できます。

**ミュートタイミングを追加するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。

1. **[通知ポリシー]** を選択し、**[ミュートタイミング]** タブを選択します。

1. **[アラートマネージャー]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. **[\$1 ミュートタイミングの追加]** ボタンを選択します。

1. フォームに入力して、ミュートタイミングに合わせて一致する[[時間間隔]](#v10-alerting-manage-muting-interval)を作成します。

1. ミュートタイミングを保存します。

## 通知ポリシーへのミュートタイミングの追加
<a name="v10-alerting-manage-muting-add-notif"></a>

ミュートタイミングが設定されたら、一定間隔でミュートする通知ポリシーに追加して使用します。

**通知ポリシーへのミュートタイミングの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。

1. **[通知ポリシー]** を選択し、**[通知ポリシー]** タブを選択します。

1. ミュートタイミングを追加する通知ポリシーを選択し、**[...]**、**[編集]** を選択します。

1. **[ミュートタイミング]** ドロップダウンから、ポリシーに追加するミュートタイミングを選択します。

1. 変更内容を保存します。

## 時間間隔
<a name="v10-alerting-manage-muting-interval"></a>

時間間隔は、アラートが抑制される特定の期間です。この期間は通常、特定の時間範囲と曜日、月、または年で構成されます。

サポートされている時間間隔のオプションは次のとおりです。
+ **[時間範囲]** – 開始時間を含み、終了時間を含まない時間 (場所が選択されていない場合は UTC で、それ以外の場合は現地時間)。
+ **Location (場所)** – タイミングの場所を設定します。時間範囲は、その場所の現地時間で表示されます。
+ **[曜日]** – 曜日または一連の曜日。例えば、`monday:thursday`。
+ **[月の日付]** – 1 か月内の日付。値は `1`～`31` の範囲で指定します。負の値は月の日を逆順で指定することを意味します。たとえば、`-1` は月の最終日を表します。
+ **[月]** - 暦月の完全な名前の数値で表された、その年の月。例えば、`1, may:august`。
+ **[年]** - 間隔の年または複数年。例えば、`2023:2024`。

これらの要素はそれぞれリストにすることができ、一致するには要素内の少なくとも 1 つの項目を満たす必要があります。フィールドは、`:` を使用して、範囲もサポートします。例えば、`monday:thursday`。

フィールドを空白のままにすると、任意の時刻をフィールドと照合します。のインスタントが完全な時間間隔と一致するには、すべてのフィールドが一致している必要があります。ミュートタイミングには複数の時間間隔を含めることができます。

正確な期間を指定する場合は、その期間に必要なすべてのオプションを指定します。例えば、3 月、6 月、9 月、12 月の最初の月曜日の 12:00 から 24:00 UTC の時間間隔を作成する場合、時間間隔の指定は次のようになります。
+ ‬時間範囲
  + 開始時間: `12:00`
  + 終了時間: `24:00`
+ 曜日: `monday`
+ 月: `3, 6, 9, 12`
+ 日: `1:7`

# アラートルールの状態と正常性を表示する
<a name="v10-alerting-manage-rulestate"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートルールの状態と正常性は、アラートに関するいくつかの主要なステータスインジケータを提供します。

次の 3 つのコンポーネントがあります。
+ [アラートルールの状態](#v10-alerting-manage-rulestate-state)
+ [アラートインスタンスの状態](#v10-alerting-manage-rulestate-instance)
+ [アラートルールの正常性](#v10-alerting-manage-rulestate-health)

それぞれに関連はありますが、各コンポーネントは微妙に異なる情報を伝達します。

**アラートルールの状態と正常性を表示するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。

1. **[アラートルール]** を選択して、既存のアラートのリストを表示します。

1. アラートルールを選択して、その状態と正常性を表示します。

## アラートルールの状態
<a name="v10-alerting-manage-rulestate-state"></a>

アラートルールは、次のいずれかの状態になります。


| State | 説明 | 
| --- | --- | 
| [普通] | 評価エンジンによって返される時系列のいずれも pending または firing 状態ではありません。 | 
| [保留中] | 評価エンジンから返される少なくとも 1 つの時系列は pending です。 | 
| [発射] | 評価エンジンから返される少なくとも 1 つの時系列は firing です。 | 

**注記**  
アラートは最初に `pending` に移行し、次に `firing` に移行します。そのため、アラートが発生する前に少なくとも 2 つの評価サイクルが必要です。

## アラートインスタンスの状態
<a name="v10-alerting-manage-rulestate-instance"></a>

アラートインスタンスは、次のいずれかの状態になります。


| State | 説明 | 
| --- | --- | 
| [普通] | pending でも firing でもないアラートの状態。すべてが期待どおりに機能しています。 | 
| [保留中] | 設定されたしきい値期間未満でアクティブであったアラートの状態。 | 
| [アラート] | 設定されたしきい値期間よりも長くアクティブであったアラートの状態。 | 
| [データなし] | 設定された時間枠のデータを受信しない状態。 | 
| [アラート] | アラートルールの評価試行中にエラーが発生しました。 | 

## 最後の状態を保持する
<a name="v10-alerting-manage-rulestate-keepstate"></a>

アラートルールは、`NoData` または `Error` 状態が発生したときに最後の状態を保持するように設定できます。これにより、アラートの発射、解決と再発射の両方が防止されます。通常の評価と同様に、アラートルールは保留期間が経過すると `pending` から `firing` に移行します。

## アラートルールの正常性
<a name="v10-alerting-manage-rulestate-health"></a>

アラートルールは、次のいずれかのヘルスステータスを持つことができます。


| State | 説明 | 
| --- | --- | 
| [OK] | アラートルールを評価するときにエラーはありません。 | 
| [エラー] | アラートルールの評価中にエラーが発生しました。 | 
| [NoData] | ルール評価中に返される少なくとも 1 つの時系列にデータがありません。 | 
| \$1status\$1、KeepLast | ルールは別のステータスを受け取りますが、アラートルールの最後の状態を保持するように設定されています。 | 

## NoData とエラーの特別なアラート
<a name="v10-alerting-manage-rulestate-special"></a>

アラートルールの評価で状態 `NoData` または `Error` が生成されると、Grafana アラートは、次の追加ラベルを含むアラートインスタンスを生成します。


| ラベル | 説明 | 
| --- | --- | 
| alertname | 状態に応じて、DatasourceNoData または DatasourceError のいずれか。 | 
| datasource\$1uid | 状態の原因となったデータソースの UID。 | 

**注記**  
追加のラベルを生成するには、[Grafana マネージドアラートルールを設定する](v10-alerting-configure-grafanamanaged.md) のトピックで説明されているように、アラートルールで no data またはエラー処理を `NoData` または `Error` に設定する必要があります。

これらのアラートは、サイレンスを追加したり、コンタクトポイントにルーティングしたりするなど、通常のアラートと同じ方法で処理できます。

# アラートグループ別に表示およびフィルタリングする
<a name="v10-alerting-manage-viewfiltergroups"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートグループは、アラートマネージャーインスタンスからのグループ化されたアラートを表示します。デフォルトでは、アラートルールは通知ポリシーのデフォルトポリシーのラベルキーによってグループ化されます。共通のアラートルールを 1 つのアラートグループにグループ化することで、重複したアラートルールが発生することを防ぎます。

アラートグループを表示し、特定の条件に一致するアラートルールをフィルター処理することもできます。

**アラートグループを表示するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。

1. **[グループ]** を選択して、既存のグループを表示します。

1. **[アラートマネージャー]** ドロップダウンから、データソースとして外部アラートマネージャーを選択します。

1. **[カスタムグループ化]** ドロップダウンでラベルの組み合わせを選択して、デフォルト以外のグループを表示します。これは、通知ポリシーのグループをデバッグおよび検証するのに役立ちます。

アラートにルートポリシーのグループ化またはカスタムグループ化のいずれかで指定されたラベルが含まれていない場合、アラートは `No grouping` のヘッダーを持つ [すべてのグループを取得] に追加されます。

アラートは、ラベルまたはアラートの状態によってフィルタリングできます。

**ラベルでフィルタリングするには**
+ **[検索]** で既存のラベルを入力して、ラベルに一致するアラートを表示します。

  例えば、`environment=production,region=~US|EU,severity!=warning`。

**状態でフィルタリングするには**
+ **[状態]** では、Active (アクティブ)、Suppressed (抑制)、または Unprocessed (未処理) の状態を選択すると、選択した状態に一致するアラートが表示されます。他のすべてのアラートは非表示になります。

# 通知エラーの表示
<a name="v10-alerting-manage-viewnotificationerrors"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

通知エラーを表示し、送信に失敗したか受信されなかった理由を確認できます。

**注記**  
この機能は Grafana アラートマネージャーでのみサポートされています。

**通知エラーを表示するには**

1. 左側のメニューから、**[アラート]**、**[コンタクトポイント]** を続けて選択します。

   いずれかのコンタクトポイントが失敗した場合、ワークスペースの右隅にあるメッセージに、エラーがあることと、その数が表示されます。

1. コンタクトポイントを選択すると、そのコンタクトポイントのエラーの詳細が表示されます。

   エラーアイコンにカーソルを合わせると、エラーの詳細が表示されます。

   コンタクトポイントに複数の統合がある場合、各統合のすべてのエラーが表示されます。

1. [正常性] 列で、通知のステータスを確認します。

   これは、[OK]、[試行なし]、または [エラー]のいずれかです。