

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

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

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

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

**Topics**
+ [パネル](Grafana-panels.md)
+ [ダッシュボード](dashboard-overview.md)
+ [Explore](explore.md)
+ [リンク](linking-in-Amazon-Managed-Service-for-Grafana.md)
+ [テンプレートおよび変数](templates-and-variables.md)
+ [Grafana アラート](alerts-overview.md)

# パネル
<a name="Grafana-panels"></a>

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

パネルは Grafana サーバーの基本的な視覚化構築ブロックです。いくつかの特殊用途パネルを除き、パネルは 1 つ以上のクエリの視覚的表現です。クエリは時間経過に伴うデータを表示します。これは、温度変動から、ログまたはアラートのリストに対する現在のサーバーステータスに至るまで多岐にわたります。

各パネルには、パネルで選択されたデータソース特有のクエリエディタがあります。クエリエディタを使用するとパネルに表示する視覚化を抽出できます。



データを表示するためには、ワークスペースに少なくとも 1 つのデータソースを追加する必要があります。データソースの詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

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

**Topics**
+ [パネルの追加](add-a-panel-to-a-dashboard.md)
+ [パネルの削除](Deleting-a-panel.md)
+ [クエリ](panel-queries.md)
+ [記録済みのクエリ](recorded-queries.md)
+ [変換](panel-transformations.md)
+ [フィールドオプションとオーバーライド](field-options-overrides.md)
+ [パネルエディタ](AMG-panel-editor.md)
+ [ライブラリパネル](AMG-library-panel.md)
+ [視覚化](AMG-visualizations.md)

# パネルの追加
<a name="add-a-panel-to-a-dashboard"></a>

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

 パネルを使用してデータを視覚的に表示できます。このトピックでは、パネルを作成する基本的なステップについて説明します。

**ダッシュボードへのグラフの追加方法**

1.  パネルを追加するダッシュボードを選択します。

1.  **[パネルを追加]** アイコンを選択します。

1.  **[新しいラベルを追加]** を選択します。

    Grafana ワークスペース上に、空のグラフパネルがデフォルトのデータソースが選択された状態で作成されます。

1.  必須ではありませんが、パネルに分かりやすいタイトルと説明を追加することをお勧めします。また、タイトルや説明には、いずれかのフィールドで定義済みの変数を使用することができますが、グローバル変数は使用できません。詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。
   + **パネルタイトル** – このフィールドに入力したテキストは、パネルエディタとダッシュボードのパネルの上部に表示されます。
   + **説明** – このフィールドに入力したテキストは、パネルの左上にあるツールチップに表示されます。表示するデータとパネルの説明を記入します。

1. パネルのクエリを書き込みます。視覚的表現を表示するには、各パネルに少なくとも 1 つのクエリが必要です。パネルエディタのクエリタブに**クエリ**を書き込みます。詳細については、「[クエリ](panel-queries.md)」を参照してください。

   1. データソースを選択します。**クエリ**タブの最初の行にあるドロップダウンリストを選択すると、使用可能なすべてのデータソースが表示されます。このリストには、追加したすべてのデータソースが表示されます。データソースの詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

   1. データソースのクエリ言語でクエリを記述または作成します。選択できる内容は、データソースによって異なります。詳細については、各データソースのドキュメントをご確認ください。

1.  **[パネル]** タブの **[視覚的表現]**] セクションで、視覚的表現の種類を選択します。Grafana ワークスペースに、その視覚的表現を適用したクエリ結果のプレビューが表示されます。

1. **[保存]**] を選択する前に、変更内容を説明するメモを追加することをお勧めします。ダッシュボードを以前のバージョンに戻す必要が生じた際、このメモが役に立ちます。

1.  ダッシュボードの保存は、画面の右上隅にある **[保存]**] を選択します。

# パネルの削除
<a name="Deleting-a-panel"></a>

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

Grafana のパネルを削除するには、次のステップを実行します。
+  パネルタイトルの横にあるドロップダウンを選択し、[**パネルの削除**] を選択します。

または
+ パネルにカーソルを合わせ、キーボードを「p r」の順に押します。

# クエリ
<a name="panel-queries"></a>

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

 Grafana ワークスペースのパネルは、*クエリ*を使用してデータソースと通信し、視覚化用データを取得します。クエリは、データソースで使用すクエリ言語で記述された質問です。クエリが適切に形成されると、データソースが応答します。パネルのデータソースオプションでは、クエリがデータソースに送信される頻度と、収集されるデータポイント数を調整できます。

 Grafana ワークスペースは、パネルごとに最大 26 個のクエリをサポートします。

## クエリエディタ
<a name="query-editors"></a>

 クエリエディタはクエリの記述に役立つフォームです。データソースによっては、クエリエディタが自動完了機能、メトリクス名、または変数の提案が用意されている場合があります。

 クエリ言語の違いにより、各データソースのクエリエディタの外観が異なる場合があります。

## クエリ構文
<a name="query-syntax"></a>

 データソースがデータを求めるためのクエリ言語と構文が異なります。これらはその 2 つのクエリ例です。

 **[PostgreSQL]** 

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

 **PromQL** 

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

 データソースのクエリの書き込みについては、そのデータソースのドキュメントを参照してください。データソースは [データソースに接続する](AMG-data-sources.md) に一覧されています。

## クエリタブ UI
<a name="query-tab-ui"></a>

 **[クエリ]** タブは以下の要素で設定されています。
+  データソースセレクター 
+  クエリオプション 
+  クエリインスペクターボタン 
+  クエリエディタリスト 

### データソースセレクター
<a name="data-source-selector"></a>

 データソースセレクターはドロップダウンリストです。追加済みのデータソースを選択するには、これを選択します。パネルを作成すると、Amazon Managed Grafana によりデフォルトのデータソースが自動的に選択されます。データソースの詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

 Grafana ワークスペースで設定されたデータソースに加え、3 つの特別なデータソースを使用できます。
+ **TestDataDB** – ランダムな歩行データを生成する組み込みデータソースです。Grafana データソースは視覚化のテストや実験の実行に役立ちます。
+  **混合** – 同じパネル内の複数のデータソースをクエリするためのデータソースです。このデータソースを選択すると、追加する新しいクエリすべてにデータソースを選択できます。
  +  最初のクエリでは、**[混合]** を選択する前に選択済みのデータソースを使用します。
  +  既存のクエリを変更して混合データソースを使用することはできません。
+ **ダッシュボード** – 同じダッシュボード内の別のパネルの一連の結果を使用するためのデータソースです。

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

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

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

 次のパネルデータソースのクエリオプションを使用できます。
+  **[最大データポイント数]** – データソースがサポートしている場合、返される各シリーズのデータポイントの最大数を設定します。クエリが最大データポイント設定よりも多くのデータポイントを返す場合、データソースはそれらを統合します (平均、最大、または他の関数で集計することで、返されるポイントの数を減らします)。

   ポイント数を制限する主な 2 つの理由は、パフォーマンスおよびラインの平滑化です。デフォルト値はグラフの幅 (またはピクセル数) で、これにより、大きすぎてグラフパネルが表示できないデータポイントがなくなります。

   ストリーミングデータでは、ローリングバッファに最大データポイント値が使用されます。(ストリーミングはデータの継続的なフローであり、バッファリングはストリームをチャンクに分割する方法です)。
+  **最小間隔** – 自動計算された間隔の最小制限を設定します。これは通常、最小スクレイプ間隔です。データポイントを 15 秒ごとに保存する場合、それよりも間隔を短くする必要はありません。もう 1 つのユースケースは、スクレイプ間隔よりも高い最小値に設定して、粗く適切に機能するクエリを取得することです。
+  **間隔** – データポイントを時間別に集計またはグループ化するときに使用できる時間範囲です。

   Amazon Managed Grafana は、テンプレートクエリで変数として使用できる適切な間隔を、自動的に計算します。変数は秒: `$__interval`、ミリ秒: `$__interval_ms` のいずれかです。通常、`sum` や `average` などの集計関数で使用されます。例えば、これは間隔変数 `rate(http_requests_total[$__interval])` を使用する Prometheus クエリです。

   この自動間隔は、グラフの幅に基づいて計算されます。ユーザーがズームアウトすると間隔が大きくなり、より粗視化された集計になります。ユーザーがズームインすると間隔が短くなり、より高精細な集計になります。

   詳細については、「[グローバル変数](variables-types.md#global-variables)」を参照してください。
+  **[相対時間]** – 個々のパネルの相対時間範囲をオーバーライドし、これによりパネルは、ダッシュボードの右上隅にあるダッシュボードタイムピッカーで選択されている時間とは異なります。これにより同じダッシュボードに異なる期間または日数のメトリクスを表示できます。
+  **[タイムシフト]** – 個々のパネルの時間範囲を上書きする別の方法です。この関数は相対時間範囲でのみ機能し、その時間範囲を調整できます。

   例えば、パネルの時間範囲をダッシュボードのタイムピッカーより 2 時間早くシフトできます。詳細については、「[時間範囲コントロール](dashboard-time-range-controls.md)」を参照してください。
+  **[キャッシュタイムアウト]** – (このフィールドはデータソースで使用可能な場合にのみ表示されます)。時系列ストアにクエリキャッシュがある場合、デフォルトのキャッシュタイムアウトが上書きされます。数値 (秒単位) として指定します。

### クエリインスペクターボタン
<a name="query-inspector-button"></a>

 ** クエリインスペクター]** を選択すると、パネルインスペクターの **[クエリ]** タブを開くことができます。**[クエリ]** タブには、パネルとレスポンスによって送信されたクエリリクエストが表示されます。

 **[更新]** を選択すると、このパネルからサーバーに送信されたリクエストの全文が表示されます。

**注記**  
 クエリインスペクターが結果を返すようにするには、少なくとも 1 つのクエリを追加する必要があります。

 パネルインスペクターの詳細については、「[パネルの検査](inspect-a-panel.md)」を参照してください。

### クエリエディタリスト
<a name="query-editor-list"></a>

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

## パネル間のクエリ結果の共有
<a name="share-query-results-between-panels"></a>

 Amazon Managed Grafana では、1 つのパネルのクエリ結果をダッシュボード内の他の任意のパネルで使用できます。パネル間でクエリ結果を共有すると、データソースに対して実行されるクエリの数が減少し、ダッシュボードのパフォーマンスが向上します。

 ダッシュボードのデータソースを使用すると、結果を共有するクエリを含むダッシュボード内のパネルを選択できます。パネルごとに個別のクエリを送信する代わりに、Amazon Managed Grafana は 1 つのクエリを送信し、他のパネルはクエリ結果を使用して視覚化を構築します。

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

**データソースクエリを別のパネルと共有する方法**

1.  ダッシュボードを作成します。詳細については、「[ダッシュボードの作成](getting-started-grafanaui.md#create-a-dashboard)」を参照してください。

1.  パネルを追加します。詳細については、「[パネルの追加](add-a-panel-to-a-dashboard.md)」を参照してください。

1.  タイトルを「**Source panel**」に変更します。このパネルを他のパネルのソースとして使用します。共有するクエリ (1 つ以上) を定義します。現在利用可能なデータソースがない場合は、**[Grafana]** データソースを使用できます。このデータソースはテストに使用できるランダムな時系列を返します。

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

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

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

 クエリを定義済みのパネルに移動するには、そのクエリを選択します。

# 記録済みのクエリ
<a name="recorded-queries"></a>

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

記録済みのクエリを使用して設定間隔でデータポイントのスナップショットを撮ると、時間の経過に伴う傾向を確認できます。これにより過去の傾向を把握できます。

時系列を返さないプラグインの場合は、履歴データをプロットすると便利な場合があります。例えば、**[ServiceNow]** をクエリするとリクエスト応答時間の履歴を表示できますが、現在時点のメトリクスのみを返すことができます。

## 記録済みのクエリの仕組み
<a name="how-recorded-queries-work"></a>

記録済みのクエリは、バックエンドデータソースプラグインでのみ機能します。詳細については、[「バックエンドデータソースプラグイン](https://grafana.com/tutorials/build-a-data-source-backend-plugin/)」を参照してください。次の 3 つのタイプのクエリを記録できます。
+ 単一の行および列 - 単一の行および列を返すクエリ。
+ 行カウント - カウントする意味のある行を返すクエリ。
+ 式 - 任意の式。式の作成および使用の詳細については、「[式](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)」を参照してください。

記録済みのクエリを作成または有効にすると、すぐにスナップショットが作成され、設定間隔でスナップショットが引き続き作成されます。記録済みのクエリでは、スナップショットが無効化、削除された場合、または Grafana が実行されていない場合、スナップショットの作成が停止します。記録済みのクエリを実行し、各結果をリモート書き込み対応の Prometheus インスタンスに転送すると、データポイントはバックエンドに収集されます。

**注記**  
記録済みのクエリを使用するには、Prometheus データソースを設定してリモート書き込み先に関連付ける必要があります。

## 記録済みのクエリの作成
<a name="create-a-recorded-query"></a>

記録済みのクエリを作成するには、次の手順を実行します。

1. 編集パネルでダッシュボードに記録するクエリを検索または作成します。クエリは単一の行と列のみを返す必要があります。さらに多く返される場合、*カウント*オプションを使用して、返される結果の数を記録できます。クエリのデータソースは、バックエンドデータソースである必要があります。式は時系列クエリからのデータ集約に使用できます。式の作成および使用の詳細については、「[式](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)」を参照してください。

1. クエリエディタで **[レコードクエリ]** メニューを選択します。

1. 記録済みのクエリの情報を入力します。特に指示されていない限り、すべてのフィールドは必須です。
   + 名前 - 記録済みのクエリの名前。
   + 説明 - (オプション) 記録済みのクエリのリストに表示する、記録済みのクエリに関する説明を記述します。
   + 間隔 - スナップショットが取得される間隔です。間隔は、記録済みのクエリの作成時に開始され、記録済みのクエリを一時停止または削除すると停止します。記録済みのクエリの一時停止と削除の詳細については、「[記録済みのクエリの管理](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries)」を参照してください。
   + 範囲 - クエリの相対時間範囲です。30m の範囲と 1h の間隔を選択すると、クエリは過去 30 分の 1 時間ごとのスナップショットを取得します。
   + クエリ結果のカウント - クエリが返した行をカウントする場合は、このオプションをオンに切り替えます。このオプションがオフの場合、クエリは 1 つの値を持つ 1 行を返します。

1. [記録済みのクエリのテスト] ボタンを選択して、記録済みのクエリをテストします。

1. **[記録の開始]** を選択します。

## 記録済みのクエリの追加
<a name="Adding-a-recorded-query"></a>

ダッシュボードで、既存の記録済みのクエリをパネルに追加できます。記録済みのクエリを追加するたび、Prometheus クエリ `generated_recorded_query_name{id="generated_id", name="recorded query name"}` が作成されます。Prometheus から作成されたクエリは、記録済みのクエリすべてが収集されたスナップショットを返します。

1. 記録済みのクエリを追加するダッシュボードのパネルに移動します。

1. **[\$1 記録済みのクエリ]** メニューを選択します。

1. データソースにより記録済みのクエリをフィルタリングする場合は、データソースドロップダウンメニューで、フィルターのデータソースを選択します。

1. 記録済みのクエリで **[追加]** メニューを選択して、パネルに追加します。

記録済みのクエリをパネルに追加すると、パネルデータソースは `-- Mixed --` になります。記録済みのクエリは、記録済みのクエリの名前と一致する名前ラベルが付いた `Prometheus` クエリで表されます。Prometheus データソースの詳細については、「[Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/)」を参照してください。

記録済みのクエリを追加した後、Prometheus データソースではなく `-- Mixed --` データソースを持つクエリが表示される場合は、記録済みのクエリに対して `Prometheus ` リモート書き込み先が設定されていない可能性があります。「[リモート書き込み先](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target)」を参照して、リモート書き込みポイントをセットアップしてください。

## 記録済みのクエリの使用
<a name="using-a-recorded-query"></a>

記録済みのクエリを使用するには、クエリを作成してダッシュボードに追加します。その後、**[記録済みのクエリ]** タブの **[設定]** で管理できます。

## 記録済みのクエリの管理
<a name="managing-recorded-queries"></a>

記録済みのクエリを一時停止またはアクティブ化すると、設定の [記録済みのクエリ] タブから削除できます。記録済みのクエリを削除すると Grafana から削除されますが、Prometheus で収集された情報はそこに残ります。記録済みのクエリを一時停止すると、再開されるまで新しいデータポイントが収集されなくなります。

## リモート書き込み先
<a name="remote_write_target"></a>

リモート書き込み先は、記録済みのクエリデータポイントが書き込まれる **[Prometheus]** データソースです。リモート書き込みが有効な Prometheus が必要で、この Prometheus のデータソースを作成する必要があります。

リモート書き込み先を編集するには、**[設定]** の **[記録済みのクエリ]** タブのコンソールメニューで、**[リモート書き込み先の編集]** を選択します。リモート書き込みが有効な **[Prometheus]** データソースを選択して、リモート書き込みパスを入力します。

# 変換
<a name="panel-transformations"></a>

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

変換は視覚化に渡される前に一連の結果を処理します。Amazon Managed Grafana パネルエディタの **[変換]** タブで変換にアクセスします。

変換を使用して、フィールドの名前変更、個別の時系列の結合、クエリ間の計算などを実行できます。大きなダッシュボードや大量のクエリがある場合、あるパネルのクエリ結果を別のパネルで再利用できれば、パフォーマンスが大幅に向上する可能性があります。

**注記**  
変換ではグラフ化できないデータが発生することがあります。この場合、Amazon Managed Grafana では視覚化に提案が表示されます。テーブル視覚化に切り替える提案を選択します。多くの場合、変換がデータに何を実行しているかを理解するのに役立ちます。

Amazon Managed Grafana は画面に一覧される順序で変換を適用します。各変換ではパイプライン内の次の変換に渡される新しい結果セットが作成されます。

この順序により結果が大きく異なる場合があります。例えば、縮小変換を使用して 1 つの列のすべての結果を 1 つの値に集約する場合、変換はその 1 つの値にのみ適用できます。

**前提条件**

変換を適用する前に、次のすべてが実行済みである必要があります。
+ クエリを入力してデータソースからデータを返された。クエリの詳細については、「[クエリ](panel-queries.md)」を参照してください。
+ 次のいずれかの視覚化などの、クエリをサポートする視覚化を適用した。
  + 棒ゲージ
  + ゲージ
  + グラフ
  + ヒートマップ
  + ログ
  + 統計
  + [テーブル]

## 変換の適用
<a name="apply-a-transformation"></a>

 変換は、パネルエディタの下部ペインの、**[クエリ]** タブの隣の **[変換]** タブから使用できます。

**変換の適用方法**

1.  変換を追加するパネルで、パネルタイトルを選択してから、**[編集]** を選択します。

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

1.  変換を選択します。

    表示される変換行では、変換オプションを設定できます。

1.  **[変換ルールの追加]** を選択すると、別の変換ルールを追加できます。次の変換は、前の変換が返した一連の結果に従って動作することに注意してください。

 問題が発生した場合は、バグアイコンを選択して [[変換をデバッグ]](#debug-transformations) します。

 変換を削除する場合、ごみ箱アイコンを選択します。

## 変換タイプおよびオプション
<a name="transformation-types-and-options"></a>

 Grafana ワークスペースには次の変換が含まれます。

**Topics**
+ [削減](#reduce)
+ [Merge (マージ)](#merge)
+ [名前に基づいてフィルタリングする](#filter-by-name)
+ [クエリによるデータのフィルタリング](#filter-data-by-query)
+ [フィールドの整理](#organize-fields)
+ [フィールドにより結合 (外部結合)](#join-by-field-outer-join)
+ [計算からのフィールドの追加](#add-field-from-calculation)
+ [フィールドへのラベル付け](#labels-to-fields)
+ [グループ化の条件](#sort-by)
+ [グループ化の条件](#group-by)
+ [シリーズから行](#series-to-rows)
+ [値によるデータのフィルタリング](#filter-data-by-value)
+ [変換のデバッグ](#debug-transformations)

### 削減
<a name="reduce"></a>

 結果を 1 つの値に簡略化する場合は、**[削減]** 変換を適用します。削減では基本的に時間コンポーネントを削除します。テーブルとして視覚化する場合は、列が 1 行 (値) に減少します。

 **[計算]** フィールドに、1 つ以上の計算タイプを入力します。計算選択肢のリストの表示を選択します。利用可能な計算の詳細については、「[計算リスト](list-of-calculations.md)」を参照してください。

少なくとも 1 つの計算を選択すると、Amazon Managed Grafana では選択した計算を使用して 1 つの値が表示されます。複数の計算を選択すると、複数の値が表示されます。

### Merge (マージ)
<a name="merge"></a>

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

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

クエリ A


|  Time  |  ジョブ  |  アップタイム  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  ノード  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  123001233  | 

クエリ B


|  Time  |  ジョブ  |  エラー  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  ノード  |  15  | 
|  2020-07-07 11:24:20  |  postgre  |  5  | 

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


|  Time  |  ジョブ  |  エラー  |  アップタイム  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  ノード  |  15  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  5  |  123001233  | 

### 名前に基づいてフィルタリングする
<a name="filter-by-name"></a>

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

 Amazon Managed Grafana には **[識別子]** フィールドが表示され、クエリが返すフィールドが続きます。

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

### クエリによるデータのフィルタリング
<a name="filter-data-by-query"></a>

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

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

### フィールドの整理
<a name="organize-fields"></a>

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

**注記**  
 この変換は単一クエリを持つパネルでのみ機能します。パネルに複数のクエリがある場合は、**[フィールドによる結合 (外部結合)]** 変換を適用、またはさらにクエリを削除する必要があります。

 Amazon Managed Grafana ではクエリが返すフィールドのリストが表示されます。以下の任意の変更を行うことができます。
+  フィールド上で一時停止してフィールドの順序を変更します。カーソルが手の形になると、フィールドを新しい場所にドラッグできます。
+  フィールド名の隣の目アイコンを選択して、フィールドを非表示または表示します。
+  **名前変更**ボックスに新しい名前を入力して、フィールドの名前を変更します。

### フィールドにより結合 (外部結合)
<a name="join-by-field-outer-join"></a>

 この変換を使用してフィールドで設定された結果から複数の時系列を結合します。

 この変換は、フィールドからの結果を計算できるようにするため、クエリを組み合わせる場合に役立ちます。

### 計算からのフィールドの追加
<a name="add-field-from-calculation"></a>

 この変換を使用して、他の 2 つのフィールドから計算した新しいフィールドを追加します。各変換では 1 つの新しいフィールドを追加できます。
+  **[モード]** – 以下のモードを選択します。
  +  **[行を減らす]** – 選択したフィールドの各行に、選択済みの計算を個別に適用します。
  +  **バイナリオプション** – 選択した 2 つのフィールドから、1 つの行の値に基本的な計算演算 (`sum`、`multiply` など) を適用します。
+  **フィールド名** – 新しいフィールドの計算に使用する、フィールドの名前を選択します。
+  **計算 -** Amazon Managed Grafana により新しいフィールドが作成されるときに使用する計算を選択します。計算選択肢のリストを表示するフィールドを選択します。利用可能な計算の詳細については、「[計算リスト](list-of-calculations.md)」を参照してください。
+  **[エイリアス]** – (オプション) 新しいフィールドの名前を入力します。これを空白のままにすると、計算に一致するようにフィールドの名前が付けられます。
+  **すべてのフィールドを置き換え** – (オプション) 他のすべてのフィールドを非表示にし、計算したフィールドのみを視覚化に表示する場合は、このオプションを使用します。

### フィールドへのラベル付け
<a name="labels-to-fields"></a>

**注記**  
 この変換を適用するには、クエリがラベル付きフィールドを返す必要があります。

 この変換を選択すると、Amazon Managed Grafana により、ラベル付けされたすべてのデータがフィールドに自動的に変換されます。

 例えば、2 つの時系列のクエリ結果を考慮しましょう。

 1: labels Server=Server A, Datacenter=EU 2: labels Server=Server B, Datacenter=EU 

 この変換により次の表が表示されます。


|  Time  |  サーバー  |  データセンター  |  値  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  サーバー A  |  EU  |  1  | 
|  2020-07-07 11:34:20  |  サーバー B  |  EU  |  2  | 

 **[値フィールド名]**: `Server` を **[値フィールド名]** として選択した場合は、`Server` ラベルの値ごとに 1 つのフィールドを取得します。


|  Time  |  データセンター  |  サーバー A  |  サーバー B  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  EU  |  1  |  2  | 

### グループ化の条件
<a name="sort-by"></a>

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

### グループ化の条件
<a name="group-by"></a>

 この変換では、指定されたフィールド (列) 値でデータをグループ化し、各グループの計算を処理します。使用可能な計算は削減変換の場合と同じです。

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


|  Time  |  サーバー ID  |  CPU 温度  |  サーバーステータス  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  サーバー 1  |  80  |  シャットダウン  | 
|  2020-07-07 11:34:20  |  サーバー 3  |  62  |  OK  | 
|  2020-07-07 10:32:20  |  サーバー 2  |  90  |  オーバーロード  | 
|  2020-07-07 10:31:22  |  サーバー 3  |  55  |  OK  | 
|  2020-07-07 09:30:57  |  サーバー 3  |  62  |  再起動  | 
|  2020-07-07 09:30:05  |  サーバー 2  |  88  |  OK  | 
|  2020-07-07 09:28:06  |  サーバー 1  |  80  |  OK  | 
|  2020-07-07 09:25:05  |  サーバー 2  |  88  |  OK  | 
|  2020-07-07 09:23:07  |  サーバー 1  |  86  |  OK  | 

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


|  Time  |  サーバー ID  |  CPU 温度  |  サーバーステータス  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  サーバー 1  |  80  |  シャットダウン  | 
|  2020-07-07 09:28:06  |  サーバー 1  |  80  |  OK  | 
|  2020-07-07 09:23:07  |  サーバー 1  |  86  |  OK  | 

```
2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting
```

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

データをグループ化するフィールドを選択すると、他のフィールドにさまざまな計算を追加でき、その計算は行の各グループに適用されます。例えば、これらの各サーバーの平均 `CPU temperature` の計算について考えましょう。`CPU Temperature` フィールドに適用される*平均*計算を追加して、以下を取得できます。


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

これらの計算を複数追加できます。例えば、次の計算を使用できます。
+  フィールド `Time` では、*[最後]*の値を計算して、サーバーごとにデータポイントを最後にいつ受信したかを知ることができます。
+  フィールド `Server Status` では、*最後*の値を計算して、サーバーごとに最後の状態値を知ることができます。
+  フィールド `Temperature` では、*最後*の値を計算して、サーバーごとに最新の測定温度を知ることができます。

 グループ化の条件変換では次の結果が生成されます。


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

この変換を使用すると、時系列から一部のキー情報を抽出して便利な方法で表示できます。

### シリーズから行
<a name="series-to-rows"></a>

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

この変換の結果には、`Time`、`Metric`、`Value` の 3 つの列が含まれます。`Metric` 列が追加されると、メトリクスの元となったクエリを確認できます。ソースクエリで `Label` を定義して、この値をカスタマイズします。

次の例では、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  | 

 `Series to rows` 変換を適用すると次の結果が得られます。


|  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="filter-data-by-value"></a>

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

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

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

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

複数の条件をフィルターに追加できます。複数の条件がある場合、追加した条件のすべてまたはいずれかと一致する行に、含めたり除外したりするためのアクションを適用するかどうかを選択できます。

有効でない条件、または設定が不完全である条件は無視されます。

### 変換のデバッグ
<a name="debug-transformations"></a>

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

 Amazon Managed Grafana の変換行の下に変換デバッグビューが表示されます。

# フィールドオプションとオーバーライド
<a name="field-options-overrides"></a>

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

 このセクションでは、Amazon Managed Grafana のフィールドオプションおよびフィールドオーバーライドとは何か、およびそれらの使用方法について説明します。

 Grafana ワークスペースで使用されるデータモデルであるデータフレームは、時系列とテーブルのクエリ結果の両方が統合された列指向のテーブル構造です。この構造内の各列は、*フィールド*と呼ばれます。フィールドは、単一の時系列またはテーブル列を表すことができます。

 フィールドオプションを使用すると、視覚的表現でのデータの表示方法を変更できます。オプションとオーバーライドを適用してもデータは変更されません。Amazon Managed Grafana でのデータの表示方法が変更されます。

## フィールドオプション
<a name="field-options-overview"></a>

 パネルエディタの [**フィールド**] タブには、標準とカスタムの両方の*フィールドオプション*があります。このタブで行われた変更は、すべてのフィールド (シリーズと列) に適用されます。例えば、単位をパーセンテージに変更すると、すべての数値フィールドがパーセンテージで表示されます。フィールドオプションを適用する方法については、「[すべてのフィールドを設定する](#configure-all-fields)」で説明します。

## フィールドのオーバーライド
<a name="field-overrides-overview"></a>

 *フィールドのオーバーライド*は、パネルエディタの **[オーバーライド]** タブに追加できます。このタブには [**フィールド**] タブと同じオプションを追加できますが、特定のフィールドのみの適用となります。オーバーライドを適用する方法については、「[特定のフィールドを設定する](#configure-specific-fields)」で説明します。

## 使用可能なフィールドオプションとオーバーライド
<a name="available-field-options-and-overrides"></a>

 フィールドオプションの種類は、フィールドオプションとフィールドオーバーライドの両方に共通しています。唯一の違いは変更の適用先で、すべてのフィールド (**[フィールド]** タブに適用) かフィールドのサブセット (**[オーバーライド]** タブに適用) かが異なります。
+  [標準フィールドオプション](#standard-field-options) は、変換を許可するすべてのパネルの視覚的表現に適用されます。
+  [テーブルのフィールドオプション](table-panel.md#table-field-options) は、テーブルパネルの視覚的表現にのみ適用されます。

### すべてのフィールドを設定する
<a name="configure-all-fields"></a>

 [**フィールド**] タブでオプションを変更すると、すべてのフィールドのデータの表示方法を変更することができます。**[オーバーライド]** タブからは、特定のフィールドのフィールドオプションをオーバーライドすることができます。詳細については、「[特定のフィールドを設定する](#configure-specific-fields)」を参照してください。

 例えば、**小数**オプションを変更すると、すべてのフィールドに表示される小数点以下の桁数が変更されます。オプションの詳細については、「[標準フィールドオプション](#standard-field-options)」および「[テーブルのフィールドオプション](table-panel.md#table-field-options)」を参照してください。

#### フィールドオプションを変更する
<a name="change-a-field-option"></a>

 オプションはいくつでも変更できます。

**フィールドオプションの変更方法**

1.  編集するパネル、パネルタイトル、[**編集**] の順に選択します。

1.  **[フィールド]** タブを選択します。

1.  変更するオプションを見つけます。以下を定義できます。
   +  [標準フィールドオプション](#standard-field-options) (変換を許可するすべてのパネル視覚的表現に適用されます) 
   +  [テーブルのフィールドオプション](table-panel.md#table-field-options) (テーブルパネルの視覚的表現にのみ適用されます) 

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

1.  ダッシュボードの編集が完了したら、[**保存**] を選択します。

#### フィールドオプションの例
<a name="field-option-example"></a>

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


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

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


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

 この例では、小数点に値が無いため不要になります。小数を `auto` からゼロ (`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  | 

### 特定のフィールドを設定する
<a name="configure-specific-fields"></a>

 オーバーライドを使用して、1 つ以上のフィールドの設定を変更することができます。オーバーライドのフィールドオプションは、特定の視覚的表現で使用可能なフィールドオプションとまったく同じです。唯一の違いは、適用するフィールドを選択する点です。

 例えば、すべての数値フィールドまたは列に表示される小数点以下の桁数を変更するには、型が**数値**の**フィールド**の**小数点**オプションを変更します。オプションの詳細については、変換を許可するすべてのパネル視覚的表現に適用される「[標準フィールドオプション](#standard-field-options) 」およびテーブルパネルの視覚的表現のみに適用される「[テーブルのフィールドオプション](table-panel.md#table-field-options)」を参照してください。

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

 フィールドオプションは、いくつでも上書きできます。

**フィールドオーバーライドの追加方法**

1.  編集するパネル、パネルタイトル、[**編集**] の順に選択します。

1.  **[オーバーライド]** タブを選択します。

1.  [**オーバーライドの追加先**] を選択します。

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

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

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

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

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

1.  完了したら、**[保存]** を選択します。

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

1.  削除するオーバーライドがある [オーバーライド] タブを選択します。

1.  オーバーライドの横にあるごみ箱アイコンを選択します。

#### フィールドオーバーライドの例
<a name="field-override-example"></a>

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


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

 [フィールドオプションの例](#field-option-example) と同様に、摂氏単位を適用して小数点以下を削除します。表は次のようになります。


|  時間  |  高温  |  低温  |  湿度  | 
| --- | --- | --- | --- | 
|  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="standard-field-options"></a>

 このセクションでは、使用可能なフィールドオプションについて説明します。アルファベット順に紹介します。

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

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

 これらのオプションの適用の詳細については、以下のセクションを参照してください。
+  [すべてのフィールドを設定する](#configure-all-fields) 
+  [特定のフィールドを設定する](#configure-specific-fields) 

#### 小数
<a name="decimals"></a>

 表示する値の小数点以下の桁数を設定します。Amazon Managed Grafana がデータソースによって提供される小数点以下の桁数をそのまま使用する場合、空白のままにします。

 この設定を変更するには、 フィールドに数値を入力します。

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

 値または視覚的表現がリンクする URL を制御します。詳細と手順については、[データリンク](data-links.md) を参照してください。

#### Display name (表示名)
<a name="display-name"></a>

 すべてのフィールドの表示タイトルを設定します。フィールドタイトルには変数を使用できます。テンプレート作成とテンプレート変数の詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。

 複数の統計、フィールド、または系列が表示される場合、このフィールドは各統計のタイトルを制御します。式 (例: `${__field.name}`) を使用して、タイトルに系列名またはフィールド名のみを表示させることができます。

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


|  式の構文  |  例  |  レンダリング先  |  説明  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  構文と同じ  |  Temp \$1Loc="PBI", Sensor="3"\$1  |  フィールド名とラベルがある場合、\$1\$1 内が表示されます。レスポンスにラベルキーが 1 つしかない場合、ラベル部分において、Amazon Managed 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="max"></a>

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

#### 最小
<a name="min"></a>

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

#### 値なし
<a name="no-value"></a>

 フィールド値が空または null の場合に Amazon Managed Grafana が表示する値を入力します。

#### Unit
<a name="unit"></a>

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

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

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

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

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

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

 Amazon Managed Grafana は、文字列を解析して数値として表示することがあります。Amazon Managed Grafana に元の文字列を表示させるには、フィールドオーバーライドを作成し、`string` 単位の単位プロパティを追加します。

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

 フィールドの色オプションは、Amazon Managed Grafana が系列またはフィールドを色分けする方法を定義します。それぞれ動作が異なる複数のモードがあり、その有用性は、現在選択されている視覚的表現に大きく依存します。

 連続色モードでは、最小値と最大値から割合を算出して色を補間します。
+  **単一色** – カラーピッカーを使用して特定の色を設定します。これは、オーバーライドルールで最も便利です。
+  **閾値から** – 閾値から色を派生させます。これは、ゲージ、統計、テーブルの視覚的表現で使用できます。

##### 系列別の色設定
<a name="color-by-series"></a>

 Amazon Managed Grafana には、系列ごとに色を定義する配色機能があります。これは、グラフや円グラフなどで使用できます。

##### 値別の色設定
<a name="color-by-value"></a>

 Amazon Managed Grafana には、連続 (グラデーション) のカラースキーム機能もあります。これは、統計パネルやテーブルパネルなど、個々の値を色分けする視覚的表現で使用できます。

#### しきい値
<a name="thresholds-overview"></a>

 しきい値を設定することで、値を基にフィールドの色を変更することができます。詳細と手順については、[しきい値](thresholds.md) を参照してください。

#### 値の配置
<a name="value-mapping"></a>

 フィールド値または値の範囲を明示的なテキストに変換するルールを設定できます。複数の値を配置できます。
+  **[配置タイプ]**でオプションを選択します。
  +  **[値]** に値を入力します。フィールド値が指定した値以上の場合、**テキスト**が表示されます。
  +  **[開始]**] と **[終了]** に範囲を入力します。フィールド値が範囲内である場合、**テキスト**が表示されます。
+  [**テキスト**] は、フィールドで条件が満たされた場合に表示されるテキストです。このフィールドには変数を使用できます。

# パネルエディタ
<a name="AMG-panel-editor"></a>

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

 このトピックでは、Amazon Managed Grafana パネルエディタの各部品について説明しています。また、詳細情報を確認するためのリンクも記載しています。

## パネルエディタを開く
<a name="open-the-panel-editor"></a>

 パネルエディタ (呼称は**編集パネル**画面、*編集モード*、または*パネル編集モード*など様々です) にアクセスする方法はいくつかあります。
+  画面上部にある [**パネルの追加**] アイコンを選択し、[**新しいパネルの追加**] を選択します。新しいパネルがパネルエディタで開きます。パネルを追加する方法については、「[パネルの追加](add-a-panel-to-a-dashboard.md)」を参照してください。
+  既存のパネルのタイトルを選択して [**編集**] を選択します。パネルが編集モードで開きます。
+  既存のパネルの任意の場所を選択し、キーボードで **e** を入力します。パネルが編集モードで開きます。

## パネルエディタセクションのサイズ変更
<a name="resize-panel-editor-sections"></a>

 パネルエディタのセクションのサイズは、ドラッグして変更することができます。サイドペインが狭すぎると、**[パネル]**、**[フィールド]**、**[オーバーライド]** タブがドロップダウンリストに変わります。

## パネルエディタの部品
<a name="parts-of-the-panel-editor"></a>

 このセクションでは、パネルエディタ画面の部品と、各部品に関連付けられたフィールド、オプション、タスクについて説明します。

### ヘッダー
<a name="header"></a>

 ヘッダーセクションには、パネルが属するダッシュボードの名前と一部のダッシュボードコマンドが表示されます。[**戻る**] 矢印を選択してダッシュボードに戻ることもできます。

 ヘッダーの右側には、以下のオプションがあります。
+  **[ダッシュボード設定 (ギア) アイコン]** — ダッシュボード設定へのアクセスを選択します。
+  **Discard (破棄)** — 選択すると、ダッシュボードを最後に保存してから行ったすべての変更が破棄されます。
+  **[保存]** — 選択すると、パネルエディタで行ったすべての変更を含めてダッシュボードが保存されます。
+  **[適用]** — 選択すると、行った変更が適用され、パネルエディタが閉じてダッシュボードに戻ります。また、適用された変更を保持するためにダッシュボードも保存します。

### 視覚的表現のプレビュー
<a name="visualization-preview"></a>

 視覚的表現のプレビューセクションには、表示オプション、時間範囲コントロール、視覚的表現のプレビュー、該当する場合はパネルタイトル、軸、凡例が含まれます。
+  **[塗りつぶし]** – 視覚的表現のプレビュー上のプレビューパートにある塗りつぶし可能なスペースが塗りつぶされます。サイドペインの幅またはボトムペインの高さを変更すると、視覚的表現の塗りつぶし可能なスペースが塗りつぶされます。
+  **[塗りつぶし]** – 視覚的表現のプレビューで塗りつぶし可能ななスペースが塗りつぶされますが、パネルのアスペクト比は保持されます。
+  **[正確]** – 視覚的表現のプレビューが、ダッシュボードの実際のサイズで表示されます。十分なスペースがない場合、視覚的表現はアスペクト比が保持されたまま縮小されます。
+  **[時間範囲コントロール]** – 詳細については、「[時間範囲コントロール](dashboard-time-range-controls.md)」を参照してください。

### データセクション (最下部ペイン)
<a name="data-section-bottom-pane"></a>

 データセクションには、クエリの入力、データの変換、アラートルールの作成 (該当する場合) を行うタブがあります。
+  **[クエリ] タブ** – データソースを選択し、ここにクエリを入力します。詳細については、「[クエリ](panel-queries.md)」を参照してください。
+  **[変換 タブ]** – データ変換を適用します。詳細については、「[変換](panel-transformations.md)」を参照してください。
+  **[アラート] タブ** – アラートルールを入力します。詳細については、「[Grafana アラート](alerts-overview.md)」を参照してください。

### パネルとフィールドのオプション (サイドペイン)
<a name="panel-and-field-options-side-pane"></a>

 データの視覚化方法のほぼすべての設定を行うタブがこのセクションにあります。視覚的表現ごとに利用できるタブは異なります。

 これらのタブの機能については、次のトピックで説明します。
+  [パネルの追加](add-a-panel-to-a-dashboard.md) 
+  [視覚化](AMG-visualizations.md) 
+  [フィールドオプションとオーバーライド](field-options-overrides.md) 
+  [パネルリンク](panel-links.md) および [データリンク](data-links.md) (視覚的表現を他のリソースに接続する際に役立つ情報を掲載しています) 

# ライブラリパネル
<a name="AMG-library-panel"></a>

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

 ライブラリパネルを使用することで、ユーザーは再利用可能なパネルを作成できます。また、1 つのインスタンスに加えた変更が、そのパネルが使用されているすべてのダッシュボードに自動的に反映されます。これらのパネルはダッシュボードと一緒にフォルダに保存でき、複数のダッシュボード間でパネルの再利用を効率化できます。

## ライブラリパネルを作成する
<a name="library-panel-create"></a>

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

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

1. 通常どおりにパネルを作成します。既存のパネルを使用することもできます。

1. パネルのタイトルを選択して [**編集**] を選択します。

1. パネル表示オプションサイドペインで、下矢印オプションを選択して視覚的表現に変更を加えます。

1. **[ライブラリパネル]** を選択して **[新規ライブラリパネルを作成]** を選択します。

1. ライブラリパネルの名前を入力し、フォルダを選択して保存します。

1. **[ライブラリパネルの作成]** を選択し、ダッシュボードを保存します。

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

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

## ライブラリパネルを追加する
<a name="library-panel-add"></a>

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

1. 左のメニューで「\$1」オプションを選択し、次に **[作成]** を選択します。

1. **[パネルライブラリ からパネルを追加する]** を選択します。

1. ライブラリパネルのリストをフィルタリングして、パネルを見つけます。

1. そのパネルを選択し、ダッシュボードに追加します。

## ライブラリパネルのリンクを解除する
<a name="library-panel-unlink"></a>

ライブラリパネルのリンクを解除することで、ライブラリパネルの他のすべてのインスタンスに影響を与えずにダッシュボードのライブラリパネルに変更を加えることができます。

**ダッシュボードからライブラリパネルのリンクを解除する方法**

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

1. ライブラリパネルを選択します。そのライブラリパネルが使用されているすべてのダッシュボードのリストが表示されます。

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

1. パネルのタイトルを選択して [**編集**] を選択します。

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

## ライブラリパネルを削除する
<a name="library-panel-delete"></a>

ライブラリパネルを削除する前に、そのパネルがダッシュボードで使用されていないことを確認します。

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

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

1. ライブラリパネルを選択します。そのライブラリパネルが使用されているすべてのダッシュボードのリストが表示されます。

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

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

## パネルエディタの部品
<a name="parts-of-the-panel-editor"></a>

 このセクションでは、パネルエディタ画面の部品と、各部品に関連付けられたフィールド、オプション、タスクについて説明します。

### ヘッダー
<a name="header"></a>

 ヘッダーセクションには、パネルが属するダッシュボードの名前と一部のダッシュボードコマンドが表示されます。[**戻る**] 矢印を選択してダッシュボードに戻ることもできます。

 ヘッダーの右側には、以下のオプションがあります。
+  **[ダッシュボード設定 (ギア) アイコン]** — ダッシュボード設定へのアクセスを選択します。
+  **Discard (破棄)** — 選択すると、ダッシュボードを最後に保存してから行ったすべての変更が破棄されます。
+  **[保存]** — 選択すると、パネルエディタで行ったすべての変更を含めてダッシュボードが保存されます。
+  **[適用]** — 選択すると、行った変更が適用され、パネルエディタが閉じてダッシュボードに戻ります。また、適用された変更を保持するためにダッシュボードも保存します。

### 視覚的表現のプレビュー
<a name="visualization-preview"></a>

 視覚的表現のプレビューセクションには、表示オプション、時間範囲コントロール、視覚的表現のプレビュー、該当する場合はパネルタイトル、軸、凡例が含まれます。
+  **[塗りつぶし]** – 視覚的表現のプレビュー上のプレビューパートにある塗りつぶし可能なスペースが塗りつぶされます。サイドペインの幅またはボトムペインの高さを変更すると、視覚的表現の塗りつぶし可能なスペースが塗りつぶされます。
+  **[塗りつぶし]** – 視覚的表現のプレビューで塗りつぶし可能ななスペースが塗りつぶされますが、パネルのアスペクト比は保持されます。
+  **[正確]** – 視覚的表現のプレビューが、ダッシュボードの実際のサイズで表示されます。十分なスペースがない場合、視覚的表現はアスペクト比が保持されたまま縮小されます。
+  **[時間範囲コントロール]** – 詳細については、「[時間範囲コントロール](dashboard-time-range-controls.md)」を参照してください。

### データセクション (最下部ペイン)
<a name="data-section-bottom-pane"></a>

 データセクションには、クエリの入力、データの変換、アラートルールの作成 (該当する場合) を行うタブがあります。
+  **[クエリ] タブ** – データソースを選択し、ここにクエリを入力します。詳細については、「[クエリ](panel-queries.md)」を参照してください。
+  **[変換 タブ]** – データ変換を適用します。詳細については、「[変換](panel-transformations.md)」を参照してください。
+  **[アラート] タブ** – アラートルールを入力します。詳細については、「[Grafana アラート](alerts-overview.md)」を参照してください。

### パネルとフィールドのオプション (サイドペイン)
<a name="panel-and-field-options-side-pane"></a>

 データの視覚化方法のほぼすべての設定を行うタブがこのセクションにあります。視覚的表現ごとに利用できるタブは異なります。

 これらのタブの機能については、次のトピックで説明します。
+  [パネルの追加](add-a-panel-to-a-dashboard.md) 
+  [視覚化](AMG-visualizations.md) 
+  [フィールドオプションとオーバーライド](field-options-overrides.md) 
+  [パネルリンク](panel-links.md) および [データリンク](data-links.md) (視覚的表現を他のリソースに接続する際に役立つ情報を掲載しています) 

# 視覚化
<a name="AMG-visualizations"></a>

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

Amazon Managed Grafana には、さまざまなユースケースに合わせたさまざまな視覚的表現が提供されてます。以下のセクションでは、Amazon Managed Grafana で使用できる視覚的表現とその表示設定について紹介します。

**Topics**
+ [アラートリストパネル](alert-list-panel.md)
+ [棒グラフパネル](bar-chart-panel.md)
+ [棒ゲージパネル](alert-panel-bar-gauge-panel.md)
+ [時計パネル](clock-panel.md)
+ [ダッシュボードリストパネル](dashboard-list-panel.md)
+ [ゲージパネル](gauge-panel.md)
+ [ジオマップパネル](AMG-Geomap.md)
+ [グラフパネル](graph-panel.md)
+ [ヒートマップ](visualization-heatmap.md)
+ [ヒストグラムパネル](histogram-panel.md)
+ [ログパネル](logs-panel.md)
+ [ニュースパネル](news-panel.md)
+ [ノードグラフパネル (ベータ)](node-graph-panel.md)
+ [円グラフパネル](pie-chart-panel.md)
+ [Plotly パネル](plotly-panel.md)
+ [サンキーパネル](sankey-panel.md)
+ [散布図パネル](scatter-panel.md)
+ [統計パネル](stat-panel.md)
+ [状態タイムラインパネル](state-timeline-panel.md)
+ [ステータス履歴パネル](status-history-panel.md)
+ [テーブルパネル](table-panel.md)
+ [テキストパネル](text-panel.md)
+ [時系列パネル](time-series-panel.md)
+ [しきい値](thresholds.md)
+ [WindRose](windrose.md)
+ [パネルの検査](inspect-a-panel.md)
+ [計算リスト](list-of-calculations.md)

# アラートリストパネル
<a name="alert-list-panel"></a>

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

アラートリストパネルには、ダッシュボードのアラートが表示されます。このリストは、現在の状態を表示、または最近の状態の変更を表示するように設定することができます。アラートの詳細については、「[Grafana アラート](alerts-overview.md)」を参照してください。　

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

## オプション
<a name="alert-list-panel-options"></a>
+  **[表示]** — パネルに「現在のアラートの状態」または「最近のアラート状態の変更」のどちらを表示するかを選択します。
+  **[最大項目数]** – 一覧表示するアラートの最大数を設定します。
+  **[ソート順序]** – アラートをどのような順番で表示するかを選択します。
  +  **アルファベット (昇順)** – アルファベット順
  +  **アルファベット (降順)** – 逆アルファベット順
  +  **[重要性]** – 以下を参照。1 が最も高い。
    + アラート中: 1
    + no\$1data (データなし): 2
    + 保留中: 3
    + OK: 4
    + 一時停止中: 5
+  **[このダッシュボードからのアラート]** – アラートリストが含まれているダッシュボードからのみアラートを表示します。

## フィルター
<a name="alerts-panel-filter"></a>

選択したクエリ、フォルダ、またはタグでアラートをフィルタリングする場合、次のオプションを使用できます。
+  **[アラート名]** – アラート名クエリを入力します。
+  **ダッシュボードのタイトル** – ダッシュボードのタイトルクエリを入力します。
+  **[フォルダ]** – フォルダを選択します。選択したフォルダ内のダッシュボードからのアラートのみが表示されます。
+  **[ダッシュボードタグ]** - 1 つ以上のタグを選択します。1 つ以上のタグを持つダッシュボードからのアラートのみが表示されます。

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

このパネルに表示するアラートの状態を選択します。
+ OK
+ 一時停止中
+ データなし
+ 実行エラー
+ [アラート]
+ 保留中

# 棒グラフパネル
<a name="bar-chart-panel"></a>

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

このパネル表示では、カテゴリデータをグラフ化できます。

## サポートされているデータ形式
<a name="bar-chart-formats"></a>

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


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

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

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

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

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

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

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

**[値の表示]**

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

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

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

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

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

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

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

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

**[凡例モード]** – これらの設定を使用して視覚化内の凡例の表示方法を改善します。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

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

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

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

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

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

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

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

# 棒ゲージパネル
<a name="alert-panel-bar-gauge-panel"></a>

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

棒ゲージは、各フィールドのデータを 1 つの値にまとめて表示することで情報を簡素化します。Amazon Managed Grafana では、どのようにその値を計算するかを選択できます。

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

## データオプションとフィールドオプション
<a name="bar-gauge-data-and-field-options"></a>

棒ゲージの可視化表現を使用すると、次のオプションを適用できます。
+  [変換](panel-transformations.md) 
+  [フィールドオプションとオーバーライド](field-options-overrides.md) 
+  [しきい値](thresholds.md) 

## 表示オプション
<a name="bar-gauge-display-options"></a>

次のオプションを使用して、視覚化する表示内容を絞り込みます。
+  **[表示] ** – Amazon Managed Grafana でのデータ表示方法を選択します。
  +  **[計算]**– すべての行を元に計算した値を表示します。使用可能な計算のリストについては、「[計算リスト](list-of-calculations.md)」を参照してください。
  +  **[すべての値]** - 行ごとに個別の統計を表示します。このオプションを選択すると、**[制限]**、または表示する最大行数も選択できます。
+  **[値]** – Amazon Managed Grafana が多くのフィールドを 1 つの値にまとめるための reducer 関数を選択します。**Value (値)**リストを選択すると、関数と簡単な説明が表示されます。
+  **[Orientation]** (向き) – 積み重ね方向を選択します。
  +  **[自動]** – Amazon Managed Grafana が最適な方向を選択します。
  +  **[水平]** – バーは水平方向に左から右に伸びます。
  +  **[垂直]** – バーは垂直に上から下に伸びます。
+  **Display mode (表示モード)** – 表示モードを選択します。
  +  **Gradient (グラデーション)** – グラデーションを定義するしきい値レベルを選択します。
  +  **Retro LCD (レトロ LCD)** – 指標を小さなセルに分け、点灯または消灯させて表示します。
  +  **[基本]** – 指定したしきい値に基づいて 1 色で表示します。
+  **[塗りつぶされていない領域を表示]** – バーの塗りつぶされていない領域を濃い灰色で表示する場合は、このオプションを選択します。このオプションは、レトロ LCD 表示モードでは使用できません。

# 時計パネル
<a name="clock-panel"></a>

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

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

# ダッシュボードリストパネル
<a name="dashboard-list-panel"></a>

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

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

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

## オプション
<a name="options-1"></a>

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

### 検索
<a name="panel-dashboard-list-search"></a>

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

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

# ゲージパネル
<a name="gauge-panel"></a>

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

 **ゲージ**は、各シリーズ、列、または行に対してゲージを繰り返すことができる単一値のパネルです。

## データオプションとフィールドオプション
<a name="gauge-panel-data-and-field-options"></a>

ゲージの可視化を使用すると、次のオプションを適用できます。
+  [変換](panel-transformations.md) 
+  [フィールドオプションとオーバーライド](field-options-overrides.md) 
+  [しきい値](thresholds.md) 

## 表示オプション
<a name="gauge-panel-display-options-2"></a>

可視化を改善するには、次のオプションを使用します。
+  **[表示] ** – Amazon Managed Grafana でのデータ表示方法を選択します。
  +  **[計算]**– すべての行を元に計算した**値**を表示します。使用可能な計算のリストについては、「[計算リスト](list-of-calculations.md)」を参照してください。
  +  **[すべての値]** - 行ごとに個別の統計を表示します。このオプションを選択すると、**[制限]**、または表示する最大行数も選択できます。
+  **[Orientation]** (向き) – 積み重ね方向を選択します。
  +  **自動** – Amazon Managed Grafana は最適な方向であると考えるものを選択します。
  +  **[水平]** – バーは水平方向に左から右に伸びます。
  +  **[垂直]** – バーは垂直に上から下に伸びます。
+  **しきい値ラベルを表示** – しきい値を表示するかどうかを選択します。
+  **しきい値マーカを表示** – 内部ゲージ値幅の外にしきい値幅を表示するかどうかを選択します。

# ジオマップパネル
<a name="AMG-Geomap"></a>

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

**ジオマップ**パネルの視覚的表現により、地理空間データを用いて世界地図を表示、カスタマイズできます。さまざまなオーバーレイスタイルとマップビュー設定を設定して、データの重要な位置情報に注目しやすくすることができます。

## データレイヤー
<a name="Data-Layer"></a>

Geomap プラグインのデータレイヤーを使用して、ベースマップ上にどのように地理空間データを表示するかを決定します。

### ロケーション
<a name="Location"></a>

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

## マーカーレイヤー
<a name="Markers-Layer"></a>

**マーカー**レイヤーを使用すると、データポイントを円、正方形、三角形、星などのさまざまな形のマーカーとして表示することができます。
+ [**マーカーの色**] で、マーカーの色を設定します。デフォルトの「Fixed (固定)」サイズではすべてのポイントが 1 色になります。**しきい値**セクションで設定された「データポイント値」と「しきい値」に応じて、複数の色を使用できる代替オプションがあります。
+  **マーカーサイズ**: マーカーのサイズを設定します。デフォルトは ` Fixed size` で、すべてのマーカーサイズはデータポイントに関係なく同じになります。ただし、対応するデータポイントに円を拡大縮小するオプションもあります。マーカーレイヤーの拡大縮小の範囲を指定するため、マーカーサイズの ` Min` と `Max ` を設定する必要があります。
+  **Marker Shape** (マーカーの形状): データポイントをさまざまな形で表示することができます。
  + 円
  + [Square] (平方)
  + [Triangle] (三角形)
  + [Cross] (十字)
  + X
+  **[塗りつぶしの透明度]**: 各マーカーの透明度を設定します。

## ヒートマップレイヤー
<a name="Heatmap-layer"></a>

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



**マーカー**と同様に、どのデータポイントをどのように視覚化するかを決定するためのさまざまなオプションが用意されています。
+ **[重み値]**: ヒートマップクラスターの強度を設定します。「固定値」を選択すると、すべてのデータポイントに対して一定の重みが適用されます。この値は 0～1 の範囲で設定します。**マーカー**と同様に、ドロップダウンには、データ値に応じて重み値を自動的にスケールする代替オプションがあります。
+  **[Radius]** (半径): ヒートマップクラスターのサイズを設定します。
+  **[Blur]** (ぼかし) では、各クラスターのぼかしの量を設定します。

# グラフパネル
<a name="graph-panel"></a>

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

グラフパネルは、線、ドットの軌跡、または一連のバーとしてレンダリングできます。このタイプのグラフは、ほぼすべての時系列データを表示するための十分な汎用性があります。

## データオプションとフィールドオプション
<a name="graph-panel-data-and-field-options"></a>

グラフ視覚化を使用すると、次のオプションを適用できます。
+  [変換](panel-transformations.md) 
+ アラート。これはアラートを設定できる唯一の視覚化タイプです。詳細については、「[Grafana アラート](alerts-overview.md)」を参照してください。
+  [しきい値](thresholds.md) 

## 表示オプション
<a name="graph-panel-display-options"></a>

視覚化を絞り込むためには、次の設定を使用します。
+  **[棒]** – 値を棒グラフとして表示します。
+  **[線]** – 値を折れ線グラフとして表示します。
+  **[線の幅]** – 系列の線幅を指定します。デフォルトは 1 です。
+  **[階段]** – 隣接するポイントを階段として描画します。
+  **[領域塗りつぶし]** – シリーズの色塗りつぶし量を指定します。デフォルトは 1 で、0 はなしです。
+  **[塗りつぶしグラデーション]** – エリア塗りつぶしのグラデーションの程度を指定します。デフォルトは 0 で、グラデーションはありません。10 は急なグラデーションです。
+  **[ポイント]** – 値のポイントを表示します。
+  **[ポイント半径]** – ポイントの大きさを制御します。
+  **[アラートしきい値]** – アラートしきい値とリージョンをパネルに表示します。

### スタッキングおよび null 値
<a name="stacking-and-null-value"></a>
+  **[スタック]** – 各シリーズが別のシリーズの上にスタックされます。
+  **[パーセント]** – 各系列が全系列の合計のパーセンテージとして描画されます。このオプションは **[スタック]** が選択されている場合に使用できます。
+  **[Null 値]** – null 値の表示方法を指定します。*これは重要な設定です。*以下の注記を参照してください。
  +  **[接続‭]** – 系列にギャップがある場合、つまり 1 つ以上の null 値がある場合、線はギャップをスキップして次の null 以外の値に接続します。
  +  **[null]** - 系列にギャップがある場合、つまり null 値の場合、グラフの線は分割されてギャップが表示されます。これはデフォルトの設定です。
  +  **[ゼロとしての null]** – シリーズにギャップがある場合、つまり null 値は、グラフパネルにゼロ値として表示されます。

**重要**  
サーバーの CPU 負荷をモニタリングしているときに負荷が 100% に達すると、サーバーはロックアップされ、統計情報を送信するエージェントは負荷統計を収集できなくなります。これによりメトリクスにギャップが生じ、デフォルトの *null* 設定を使用すると Amazon Managed Grafana にはギャップが表示され、何かが間違っていることを示します。これが*[接続]*に設定されていると、このシグナルを見逃しやすくなります。

### ホバー時のツールヒント
<a name="graph-panel-hover-tooltip"></a>

これらの設定を使用して、グラフの視覚化上にカーソルを置いたときに表示されるツールヒントの外観を変更します。
+  **[モード]** - カーソルのツールチップに表示される系列数を決定します。
  +  **[すべての系列]** – カーソルのツールチップには、グラフ内の系列がすべて表示されます。Grafana ワークスペースは、ツールヒント内のシリーズリストで、一時停止しているシリーズを太字で強調表示します。
  +  **[単独]** – ツールチップには、カーソルを合わせている系列が 1 つだけ表示されます。
+  **[ソート順序]** – **[すべての系列]** モードを選択した場合、カーソルのツールチップにおいて系列の順序を並べ替えます。グラフで一時停止すると、Amazon Managed Grafana は線に関連付けられた値を表示します。一般的に、ユーザーは最大値や最小値に最も関心があります。これらの値をソートすると、目的のデータを簡単に見つけることができます。
  +  **[なし]** – ツールチップ内のシリーズ順序は、クエリのソート順序によって決まります。例えば、シリーズ名によりシリーズをアルファベット順にソートできます。
  +  **[増加]** – ホバー時のツールチップ内のシリーズは値が昇順にソートされ、リストの上部には最小値が表示されます。
  +  **[減少]** – ホバー時のツールチップ内のシリーズは値が降順にソートされ、リストの上部に最大値が表示されます。

## シリーズオーバーライド
<a name="graph-panel-series-overrides"></a>

シリーズオーバーライドを使用すると、グラフパネル内の系列を他の系列とは異なるレンダリングにできます。表示オプションは、シリーズごとに、または正規表現ルールを使用してカスタマイズできます。例えば、1 つのシリーズで線の幅を太くして目立つようにしたり、右の Y 軸に移動したりできます。

シリーズオーバーライドは複数追加できます。

**シリーズオーバーライドの追加方法**

1. **[シリーズオーバーライドの追加]** を選択します。

1. **[エイリアスまたは正規表現]** で、シリーズを入力または選択します。フィールドを選択すると使用可能なシリーズのリストが表示されます。

   例えば、`/Network.*/` は `Network out` および `Network in` という名前の 2 つのシリーズと一致します。

1. **[\$1]** を選択してからシリーズに適用するスタイルを選択します。各エントリには複数のスタイルを追加できます。
+  **[棒]** – 系列を棒グラフとして表示します。
+  **[折れ線]** – シリーズを折れ線グラフとして表示します。
+  **[折れ線塗りつぶし]** – 領域塗りつぶしで折れ線グラフを表示します。
+  **[塗りつぶしグラデーション]** – 領域塗りつぶしグラデーション量を指定します。
+  **[線の幅]** – 線幅を設定します。
+  **[Null ポイントモード]** – このオプションを使用して null 値を無視、またはゼロに置き換えます。これはデータ内ののギャップを無視する場合に重要です。
+  **[下を塗りつぶし]** – 2 つのシリーズ間の領域を塗りつぶします。
+  **[階段線]** — シリーズを階段線として表示します。
+  **[ダッシュ]** – ダッシュで線を表示します。
+  **[シリーズを非表示]** – シリーズを非表示にします。
+  **[ダッシュ長さ]** – 線内のダッシュの長さを設定します。
+  **[ダッシュスペース]** – 線内のダッシュ間のスペースの長さを設定します。
+  **[ポイント]** – 個別のポイントとして系列を表示します。
+  **[ポイント半径]** – ポイントのレンダリング半径を設定します。
+  **[スタック]** – シリーズのスタックグループを設定します。
+  **[色]** – シリーズの色を設定します。
+  **[Y 軸]** – 系列の Y 軸を設定します。
+  **[Z インデックス]** – 系列の z インデックス (レンダリング順序) を設定します。このオプションは、棒グラフや面グラフなどの、さまざまなスタイルをオーバーレイする場合に重要です。
+  [変換] – 負の値に変換して Y 軸の下にレンダリングします。
+  **[凡例]** – 凡例内にシリーズを表示するかどうかを制御します。
+  **[ツールヒントで非表示]** – グラフのツールヒントにシリーズを表示するかどうかを制御します。

## [Axes] (軸)
<a name="graph-panel-axes"></a>

これらのオプションを使用して、視覚化内の軸表示を制御します。

### [Left Y]/[Right Y]
<a name="left-yright-y"></a>

オプションは両方の Y 軸で同じです。
+  **[表示]** – 軸の表示または非表示を選択します。
+  **[単位]** – Y 値の表示単位を選択します。
+  **[スケール]** – Y 値に使用するスケールを、**[線形]**、または **[対数]** から選択します。デフォルトは **[線形]** です。
+  **[Y 最小]** – Y の最小値です。デフォルトは **[自動]** です。
+  **[Y 最大]** – Y の最大値です。デフォルトは **[自動]** です。
+  **[小数]** – Y 値に表示される小数点以下の桁数を定義します。デフォルトは **[自動]** です。
+  **[ラベル]** – Y 軸のラベルを指定します。デフォルトは [“",] です

### Y 軸
<a name="y-axes"></a>
+  **[配置]** – 左右の Y 軸を値で配置します。デフォルトは [未チェック/偽] です。
+  **[レベル]** – Y=0 から始まる、左右の Y 軸の配置に使用する値を入力します。デフォルトは 0 です。このオプションは、**[配置]** が選択されている場合に使用できます。

### X 軸
<a name="x-axis"></a>
+  **[表示]** – 軸の表示または非表示を選択します。
+  **[モード]** – 表示モードではグラフパネルの視覚化が完全に変更されます。3 つのパネルを 1 つにしたようなものです。メインモードは、X 軸の時間による時系列モードです。他の 2 つのモードは、時間とヒストグラムのモードではなく、X 軸上のシリーズ使用する基本的な棒グラフモードです。
  +  **[時間]** (デフォルト) – X 軸は時間を表し、データは時間 (時間、分など) でグループ化されます。
  +  **[系列]** – データは時間ではなく系列でグループ化されます。Y 軸は引き続き値を表します。
    +  **[値]** – これは値のために使用する集計タイプです。デフォルトは **[合計]** (値を合計) です。
  +  **[ヒストグラム]** – このオプションではグラフをヒストグラムに変換します。ヒストグラムは数値を範囲にグループ化する棒グラフの一種で、バケットやビンとも呼ばれます。背の高い棒は、より多くのデータがその範囲内にあることを示します。

    ヒストグラムの詳細については、「[ヒストグラムおよびヒートマップの概要](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)」を参照してください。
    +  **[バケット]** – 値をグループ化するためのバケットの数を設定します。空にすると、Amazon Managed Grafana は適切な数のバケットを計算しようとします。
    +  **[X 最小]** – この下限未満のヒストグラムから値をフィルタリングします。
    +  **[X 最大]** – この上限を超える値をフィルタリングします。

## 凡例
<a name="graph-panel-legend"></a>

これらの設定を使用して、グラフ内の凡例の表示方法を改善します。

### オプション
<a name="graph-panel-legends-options"></a>
+  **[表示]** – クリアすると凡例は非表示になります。デフォルトが選択されます (真)。
+  **[テーブルとして]** – 選択すると凡例がテーブルに表示されます。デフォルトがチェックされます (真)。
+  **[右側]** - 選択すると右側に凡例が表示されます。
+  [幅] – 凡例の最小幅をピクセル単位で入力します。このオプションは、**[右側]** を選択した場合に使用できます。

### 値
<a name="graph-panel-values"></a>

凡例名の横に追加の値を表示できます。
+  **[最小]** – メトリクスクエリから返される最小値です。
+  **[最大]** – メトリクスクエリから返される最大値です。
+  **平均** – メトリクスクエリから返される平均値です。
+  **[現在]** – メトリクスクエリから返された最後の値です。
+  **[合計]** – メトリクスクエリから返されるすべての値の合計です。
+  **[小数]** – 凡例値およびグラフカーソルのツールチップに表示される小数点以下の桁数です。

Amazon Managed Grafana はクライアント側の凡例値を計算します。これらの凡例値は、メトリクスクエリが使用している集計またはポイント統合のタイプによって異なります。上記の凡例値がすべて同時に正確になることはありません。

例えば、おそらく平均をアグリゲーターとして使用する、リクエスト/秒の割合などをプロットする場合、凡例の合計はリクエストの合計数を表しません。これは Amazon Managed Grafana が受信したすべてのデータポイントの合計にすぎません。

### シリーズの非表示
<a name="graph-panel-hide-series"></a>

メトリクスクエリからのシリーズの値すべてが特定の値であるときに、シリーズを非表示にします。
+  **[null のみを使用]** – Value=null (デフォルトは未チェック)
+  **[ゼロのみを使用]** – Value=ゼロ (デフォルトは未チェック)

### 時間リージョン
<a name="graph-panel-time-regions"></a>

週末、営業時間、勤務時間外など、グラフ上の特定の時間リージョンを強調表示して見やすくできます。設定されたすべての時間リージョンは UTC 時間です。

# ヒートマップ
<a name="visualization-heatmap"></a>

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

ヒートマップパネルの視覚化により、ヒストグラムを経時的に表示できます。ヒストグラムの詳細については、「[ヒストグラムおよびヒートマップの概要](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)」を参照してください。

## 軸オプション
<a name="heatmap-axes-options"></a>

これらの設定を使用して、視覚化での軸の表示方法を設定します。

### Y 軸
<a name="heatmap-y-axis"></a>
+  **[単位]** – Y 軸の値の表示単位
+  **[Scale]** – Y 軸の値に使用する目盛
  +  **[線形]** – 線形目盛。
  +  **[log (base 2)]** – 底が 2 の対数目盛
  +  **[log (base 10)]** – 底が 10 の対数目盛
  +  **[log (base 32)]** – 底が 32 の対数目盛
  +  **[log (base 1024)]** – 底が 1024 の対数目盛
+  **[Y 最小]** – y の最小値 (デフォルトは自動）
+  **[Y 最大]** – y の最大値 (デフォルトは自動）
+  **[小数]** – Y 軸の値をレンダリングする際の小数点以下の桁数 (デフォルトは自動）

### バケット
<a name="heatmap-buckets"></a>

**注記**  
データ形式が**時系列バケット**の場合、このセクションは使用できません。
+  **[Y 軸バケット]** – Y 軸が分割されるバケットの数。
+  **[サイズ]** – 各 y 軸バケットのサイズ (**[目盛]**が*線形*の場合にのみ表示)。このオプションは、**Y 軸バケット**よりも優先されます。
+  **[分割係数]** – (**目盛**が *対数 (底 2)* 以上の場合にのみ表示)。デフォルトでは、Amazon Managed Grafana は対数の底で y 値を分割します。このオプションを使用すると、各デフォルトバケットを指定された数のバケットに分割できます。
+  **[X 軸バケット]** – X 軸が分割されるバケットの数。
+  **[サイズ]** – 各 X 軸バケットのサイズ。数または時間間隔 (10 秒、5 分、1 時間など)。サポートされている間隔: ms、s、m、h、d、w、M、y。このオプションは、**X 軸バケット**よりも優先されます。

#### バケット境界
<a name="heatmap-bucket-bound"></a>

データ形式が時系列バケットの場合、データソースはバケット境界を表す名前の系列を返します。ただし、データソースによっては、境界を上下にすることができます。このオプションを使用して、境界線のタイプを調整できます。**自動**設定にされている場合、パネルのデータソースタイプに基づいて境界オプションが選択されます。

#### [バケットサイズ]
<a name="heatmap-bucket-size"></a>

バケット数とサイズオプションは、Amazon Managed Grafana がヒートマップ内の各セルのサイズを計算するために使用されます。バケットサイズは、バケット数 (最初の入力ボックス) またはサイズ間隔を指定することで定義できます。Y 軸の場合、サイズ間隔は単なる値です。X バケットの場合、**サイズ**入力で時間間隔を指定できます。例えば、時間範囲を`1h`に設定することができます。これにより、X 軸でセルの幅が 1 時間になります。

#### [Data format] (データ形式)
<a name="heatmap-data-format"></a>

**[フォーマット]** リストでオプションを選択します。
+ **[時系列]** – Amazon Managed Grafana は、すべての時系列値を調べることでバケット化を実行します。バケットのサイズと間隔は、**[バケット]**オプションで設定されます。
+ **[時系列バケット]** – 各時系列は元々、Y 軸バケットを表します。時系列名 (エイリアス) は、バケットの上限間隔または下限間隔を表す数値である必要があります。Grafana ワークスペースはバケット化を行わないため、バケットサイズオプションは非表示になります。

## 表示オプション
<a name="heatmap-display-options"></a>

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

### カラー
<a name="heatmap-colors"></a>

色のスペクトルは、値の数 (各バケット内) と各バケットに割り当てられた色間とのマッピングを制御します。スペクトルの左端の色は最低数を表し、右端の色は最大数を表します。一部のカラースキームは、ライトテーマを使用するときに自動的に反転されます。

また、カラーモードを **[不透明度]** に変更することもできます。この場合、色は変わりませんが、不透明度はバケット数に応じて変化します。
+  **モード** 
  +  **[不透明度]** – セルの不透明度で表されるバケット値。不透明セルは最大値を意味します。
    +  **[Color]** – セルのベース色。
    +  **[Scale]** (目盛) – バケット値を不透明度にマッピングするための目盛。
      +  **[線形]** – 線形目盛。バケット値は不透明度に対して直線的にマッピングされます。
      +  **[sqrt]** (平方根) – 対数目盛。セルの不透明度は `value ^ k` として計算され、`k` は設定された**指数**値です。指数が `1` より小さい場合、対数スケールが表示されます。指数が `1` より大きい場合、指数スケールが表示されます。`1` の場合、目盛は線形と同じになります。
    +  **[Exponent]** – 指数の値 (`0` より大きい場合)。
  +  **[spectrum]** (スペクトル) – セルの色で表されるバケット値。
    +  **[Scheme]** – モードが**スペクトル**の場合、カラースキームを選択します。

### カラースケール
<a name="heatmap-color-scale"></a>

デフォルトでは、Amazon Managed Grafana は最小および最大バケット値に基づいてセルの色を計算します。**最小値**と**最大値**を設定することで、これらの値を上書きできます。バケット値は z 軸、最小値と最大値はそれぞれ Z の最小値と Z の最大値と考えてください。
+  **[最小]** – セルの色の計算に使用される最小値。バケット値が最小値より小さい場合、最小値の色にマッピングされます。デフォルトは `series min value` です。
+  **[最大]** – セルの色の計算に使用される最大値。バケット値が最大値より大きい場合、最大値の色にマッピングされます。デフォルトは `series max value` です。

### 凡例
<a name="heatmap-legend"></a>

視覚化にヒートマップの凡例を表示するかどうかを選択します。

### バケット
<a name="heatmap-legend-buckets"></a>
+  **[Hide zero]** – 値がゼロのセルは表示しません。
+  **[Space]** – セル間のスペースをピクセル単位で設定します。デフォルトは 1 ピクセルです。
+  **[Round]** – セルの真円度をピクセル単位で設定します。デフォルトは 0 です。

### Tooltip (ツールチップ)
<a name="heatmap-tooltip"></a>
+  **[Show tooltip]** - ヒートマップのツールチップを表示します。
+  **[Histogram]** – ツールチップに Y 軸のヒストグラムを表示します。ヒストグラムは、特定のタイムスタンプにおけるバケット値の分布を表します。
+  **[小数]** – バケット値をレンダリングする際の小数点以下の桁数を設定します (デフォルトは自動)。

# ヒストグラムパネル
<a name="histogram-panel"></a>

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

ヒストグラムの視覚化は値の分布を計算して棒グラフとして表示します。Y 軸と各バーの高さは各括弧に含まれる値の数を表し、X 軸は値の範囲を表します。

ヒストグラムの視覚化では、1 つ以上の数値フィールドを持つ時系列とテーブル結果をサポートしています。

## 表示オプション
<a name="histogram-options"></a>

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

**[バケットサイズ]**

バケットのサイズです。自動バケットサイズ設定 (全範囲の 10% まで) では、この値は空のままにします。

**[バケットオフセット]**

最初のバケットを 0 で始めない場合です。ゼロ以外のオフセットでは集計ウィンドウがシフトします。例えば、デフォルトの 0 オフセットの 0～5、5～10、10～15 の 5 サイズのバケットは、オフセット 2 の 2～7、7～12、12～17 になる場合があります。この場合、オフセット 0、5、10 であれば事実上何も実行されません。通常、このオプションは自動ではなく、明示的に定義されたバケットサイズで使用します。この設定が作用するためには、オフセット量を 0 より大きく、バケットサイズより小さくする必要があります。この範囲外の値には、この範囲内の値と同じ効果があります。

**[系列の結合]**

これにより、すべての系列とフィールドが結合されたヒストグラムにマージされます。

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

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

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

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

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

## 凡例オプション
<a name="histogram-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの [カラースキーム] オプションを [単一色] または [クラシックパレット] に設定することが重要です。凡例にしきい値の括弧を表示するには、カラースキームを [しきい値起点] に設定します。

**[凡例モード]** – これらの設定を使用して視覚化内の凡例の表示方法を改善します。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

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

**[凡例計算]**

凡例に表示する計算を選択します。詳細については、「[計算リスト](list-of-calculations.md)」を参照してください。

# ログパネル
<a name="logs-panel"></a>

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

ログパネルの視覚化では、Elastic、Influx、Loki などのログをサポートするデータソースのログ行が表示されます。通常、グラフパネルの横のこのパネルを使用して、関連するプロセスのログ出力を表示します。

ログパネルには、**[Query]** タブに入力されたクエリの結果が表示されます。複数のクエリ結果がマージされ、時間別にソートされます。表示可能な行よりも多くの行がデータソースから返される場合は、パネル内でスクロールできます。

レンダリングされる行数を制限するには、**[クエリオプション]**で **[最大データポイント数]** の設定を使用できます。設定しない場合、データソースは通常デフォルトの制限を適用します。

## 表示オプション
<a name="logs-panel-display-options"></a>

以下の設定を使用して、視覚化する内容を絞り込みます。
+  **[時間]** – 時間列を表示または非表示にします。これはデータソースから報告されたログ行と関連するタイムスタンプです。
+  **[一意のラベル]** – 一意のラベル列を表示または非表示にします。この列には、共通ではないラベルのみが表示されます。
+  **[行の折り返し]** – 行の折り返しを切り替えます。
+  **[Order]** (順序) – 結果を降順または昇順で表示します。デフォルトは **[降順]** で、最新のログが最初に表示されます。**[昇順]** に設定すると最も古いログ行が最初に表示されます。

# ニュースパネル
<a name="news-panel"></a>

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

このパネルには RSS フィードが表示されます。デフォルトでは、Grafana Labs のブログ記事が表示されます。

**[表示]** セクションの **[URL]** フィールドに、RSS フィードの URL を入力します。このパネルタイプは他のクエリを受け入れません。

# ノードグラフパネル (ベータ)
<a name="node-graph-panel"></a>

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

ノードグラフパネルは有向グラフまたはネットワークを視覚化します。有向フォースレイアウトを使用してノードを効果的に配置し、複雑なインフラストラクチャマップ、階層、または実行図の表示に役立ちます。

## データ要件
<a name="node-graph-panel-requirements"></a>

ノードグラフのパネルでは、ノードとエッジを表示するためにデータの特定の形状が必要です。このパネルでは、すべてのデータソースやクエリを視覚化できるわけではありません。

ノードグラフの視覚化は、*ノード*および*エッジ*で構成されます。
+ ある*ノード*は円として表示されます。あるノードは、アプリケーション、サービス、またはアプリケーションの観点から関連するその他のものを表す場合があります。
+ ある*エッジ*は、2 つのノードを接続する線として表示されます。接続は、リクエスト、実行、または 2 つのノード間の他の関係である場合があります。

## ノード
<a name="node-graph-panel-nodes"></a>

通常、ノードには、ノード内の 2 つの統計値とノードのすぐ下の 2 つの識別子、通常は名前とタイプが表示されます。ノードでは、ノードの周囲に一連の別の値を色付きの円として表示することもできます。異なる色のセクションは、合計が 1 になる異なる値を表します。例えば、円の赤い部分によってエラーの割合を表すことができます。

ノードを選択すると表示されるコンテキストメニューには、さらに詳細を表示できます。Grafana ワークスペースの他の部分または外部リンクをターゲットにできる追加のリンクを、コンテキストメニューに含めることもできます。

## エッジ
<a name="node-graph-panel-edges"></a>

エッジでは、エッジにカーソルを合わせると統計を表示することもできます。ノードと同様に、エッジを選択すると、追加の詳細とリンクを含むコンテキストメニューを開けます。

この視覚化をサポートする最初のデータソースは、サービスマップ機能の AWS X-Ray データソースです。詳細については、「[AWS X-Ray データソースに接続する](x-ray-data-source.md)」を参照してください。

ノードを選択すると表示されるコンテキストメニューには、さらに詳細を表示できます。Grafana ワークスペースの他の部分または外部リンクをターゲットにできる追加のリンクを、コンテキストメニューに含めることもできます。

## ノードグラフの操作方法
<a name="node-graph-panel-navigation"></a>

ノードグラフ内でパンするには、ノードまたはエッジの外部を選択してマウスをドラッグします。

ノードグラフの左上隅にあるボタンを使用するとズームできます。

# 円グラフパネル
<a name="pie-chart-panel"></a>

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

円グラフには、1 つ以上のクエリから誘導されたシリーズ、またはシリーズ内の値が、円グラフのスライスで相互に関連付けられて表示されます。スライスの円弧長、面積、中心角度はすべての値の合計と関係するため、すべてスライス値に比例します。この種類のグラフは、一連の小規模な値を見た目がきれいな形ですばやく比較する場合に最適です。

円グラフの可視化を使用すると、次のオプションを適用できます。
+  [変換](panel-transformations.md). 
+  [フィールドオプションとオーバーライド](field-options-overrides.md). 
+  [しきい値](thresholds.md).

## オプション
<a name="pie-chart-panel-options"></a>

次のオプションを使用して、視覚化を絞り込みます。
+  **表示** – 表示する情報の量を選択します。**[計算]** 各値を系列ごとに単一の値に減らします。**[すべての値]** 1 つの系列におけるすべての値を表示します。
+  **[計算]** - を選択すると、各系列を削減する**[計算]**を選択できます。利用可能な計算の詳細については、「[計算リスト](list-of-calculations.md)」を参照してください。
+  **制限** – 1 つのシリーズのすべての値を表示する場合、表示される値の数が制限されます。
+  **フィールド** – 視覚化に表示するフィールドを選択します。
  + **数値フィールド** – 数値を持つすべてのフィールド。
  + **[すべてのフィールド]** – 変換によって削除されないすべてのフィールド。
  + **[時間]** – 時間値を持つすべてのフィールド。

## ラベル
<a name="pie-charts-panel-labels"></a>

円グラフに表示するラベルを選択します。複数選べます。
+  **[名前]** – 系列名またはフィールド名。
+  **[パーセント]** – 全体の割合。
+  **[Value]** – 未加工の数値。

ラベルはグラフ部分の上に白で表示されます。グラフの色を濃く選択して、より見やすくする必要がある場合があります。長い名前や数字は文字切れする可能性があります。

## 凡例の配置および値
<a name="pie-charts-panel-legend"></a>

凡例を表示する場所を選択します。
+  **下部** – グラフの下。
+  **右** – グラフの右側。

凡例に表示する値は、複数選択できます。**[パーセント]** は全体のパーセンテージ、**[値]** は未加工の数値です。

# Plotly パネル
<a name="plotly-panel"></a>

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

Plotly パネルは、オープンソースの javascript グラフ作成ライブラリである [Plotly](https://plotly.com/javascript/) を使用してグラフをレンダリングします。

**データ**、**レイアウト**、および**設定** フィールドは、「[Plotly ドキュメント](https://plotly.com/javascript/plotlyjs-function-reference/)」で説明されている一般的なパラメータと一致します。これらは JSON 形式である必要があります。

データソースによって提供されるデータは、Plotly グラフに挿入される前に、ユーザー定義スクリプトを介して変換できます。スクリプトには 2 つの引数が含まれます。
+ `data` – データソースから返されるデータ。
+ `variables` – 現在のダッシュボードに [Grafana 変数](templates-and-variables.md)を含むオブジェクト (ユーザー変数と、グローバル変数である `__from`、`__to`、`__interval`、`__interval_ms`)。

スクリプトは、`data`、`layout`、`config`、`frames` のプロパティから 1 つ以上を有するオブジェクトを返す必要があります。以下に例を示します。

```
let x = data.series[0].fields[0].values;
let y = data.series[0].fields[1].values;
let series = {
    x: x,
    y: y,
    name: variables.name, // where ‘name’ is the name of a Grafana dashboard variable
};

return {
    data: [series],
    config: {
        displayModeBar: false,
    },
};
```

*データ*、*レイアウト*、および *設定* フィールドで指定されたスクリプトと JSON によって返されるオブジェクトはマージされます (ディープマージ)。

スクリプトが指定されていない場合、パネルは*データ*、*レイアウト*、および *設定* フィールドのみを使用します。

# サンキーパネル
<a name="sankey-panel"></a>

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

サンキーパネルにはサンキーダイアグラムが表示されます。サンキーダイアグラムは、選択したメトリクスに比例したフローの幅で、フローデータを視覚化するのに適したものです。次の図は、ソースとターゲットの 2 つのグループを含むサンキーダイアグラムを示しています。

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/sankey-panel.png)


**仕組み**

サンキーパネルには、フローのソースとターゲットの 2 つ以上の列のデータが必要です。クエリは、データを少なくとも 2 つのグループにグループ化する必要があります。パネルは、データポイントの最初の列からクエリの順序で最後の列へのリンクを描画します。リンクの厚さは、クエリ内のメトリクスによって割り当てられた値に比例します。

**カスタマイズ**
+ **リンク** – 現在、リンクの色にはマルチまたはシングルの 2 つのオプションがあります。デフォルトでは、マルチカラーです。リンクの単一色を選択するには、**[単一リンクの色のみ]**オプションを切り替え、Grafana のカラーピッカーから色を選択します。
+ **[ノード]** – **[ノードの色]** オプションを変更することで、長方形ノードの色を変更できます。
+ **[ノード幅]** – ノードの幅は、**[ノード幅]** スライダーで調整するか、入力ボックスに数値を入力することで調整できます。数値は整数である必要があります。
+ **[ノードパディング]** – ノード間の垂直パディングは、**[ノードパディング]** スライダーで調整するか、入力ボックスに数値を入力することで調整できます。数値は整数である必要があります。リンクが細すぎる場合は、この数値を調整してみてください。
+ **ヘッダー** – 列ヘッダーは、エディタパネルの **[表示名]** オーバーライドを使用して変更できます。**[テキスト色]** で選択した色と同じ色になります
+ **[サンキーレイアウト]** – サンキーリンクのレイアウトは、**[レイアウト反復]** スライダーを使用して微調整できます。この数は整数でなければならず、レイアウトの生成に使用される緩和反復の数です。

# 散布図パネル
<a name="scatter-panel"></a>

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

散布図パネルは、他のグラフパネルよりもシンプルなインターフェイスを持つテーブルデータの X/Y 散布図を示しています。グラフパネルとは異なり、散布図パネルではデータが時系列に含まれる必要はありません。散布図パネルには、データの 2 つ以上の数値列を含むテーブル形式のデータセットが必要です。

これらのいずれかを X 軸に割り当てることができます。1 つ以上を一連の Y 軸値に割り当てることができ、その結果データは一連の点としてプロットされます。各系列では、オプションで、統計に基づく複数のベストフィットのいずれかを使用して回帰線を表示することもできます。

**散布図の作成**

次の手順では、散布図パネルを使用して散布図を作成する方法について説明します。この例では、次の表のように、年齢別の男の子と女の子の平均身長を示す数値 `Age`、`Boys`、`Girls` の 3 つの列を持つ `HEIGHT` で呼び出されるデータがあると想定します。


| 年齢 | 男の子の身長 | 女の子の身長 | 
| --- | --- | --- | 
|  5  |  109.7  |  109.5  | 
|  6  |  115.6  |  115.4  | 
|  7  |  121.1  |  120.8  | 
|  8  |  126.3  |  126  | 
|  9  |  131.3  |  131.3  | 
|  10  |  136.2  |  137.1  | 
|  11  |  141.2  |  143.2  | 
|  12  |  147  |  148.7  | 
|  13  |  153.6  |  152.6  | 
|  14  |  159.9  |  155.1  | 
|  15  |  164.4  |  156.7  | 
|  16  |  167.3  |  157.6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158.3  | 
|  19  |  170.8  |  158.6  | 

**散布図パネルを使用して散布図を作成するには**

1. Grafana ダッシュボードで、**[パネルの追加]** を選択します。パネルの追加の詳細については、「[パネルの追加](add-a-panel-to-a-dashboard.md)」を参照してください。

1. [クエリ] には、必要なデータを返すクエリを書き込みます。この場合、`SELECT * FROM HEIGHT` などのクエリを使用します。

1. **[散布図]** での視覚化を選択します。

これにより、最初の列を X 軸として使用し、他の数値列を Y 軸として使用して散布図が作成されます。

**設定オプション**

散布図パネルには、次の 4 つのカスタム設定オプションが用意されています。
+ **[X 軸]** – X 軸として使用するフィールド、軸の範囲とタイトル、および表示情報を選択できます。
+ **[Y 軸]** – 各フィールドの表示オプション、軸の範囲とタイトル情報など、Y 軸に表示するフィールドを選択できます。また、各フィールドの回帰線を表示することもできます。回帰線設定の詳細については、以下の情報を参照してください。
+ **[凡例]** – パネルの凡例をオンまたはオフにしたり、凡例内のテキストサイズを選択したりできます。
+ **[表示]** – グリッドの色や境界スタイルなど、グラフの他のオプションを設定できます。

**回帰線の設定**

各 Y 軸データセットには、個々の点に加えて線を表示できます。線タイプには 5 つのオプションがあります。
+ **[なし]** – 回帰線を表示しません。
+ **[単純]** – データセットポイントを接続する回帰線を表示します。
+ **[線形]** – 最小二乗法、ベストフィット方式を使用して直線を表示します。
+ **[指数]** – 指数のベストフィット回帰線を表示します。
+ **[累乗]** – 累乗のベストフィット回帰線を表示します。

# 統計パネル
<a name="stat-panel"></a>

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

統計パネルにはオプションのグラフスパークラインを含む 1 つの大きな統計値が表示されます。しきい値を使用すると背景または値の色を制御できます。

デフォルトでは、統計パネルに次のいずれかが表示されます。
+ 単一のシリーズまたはフィールドの値のみ。
+ 複数の系列またはフィールドの値と名前の両方。

**テキストモード**オプションを使用すると、テキストを表示するかどうかを制御できます。

## データオプションとフィールドオプション
<a name="stat-panel-data-and-field-options"></a>

統計の可視化を使用すると、次のオプションを適用できます。
+  [変換](panel-transformations.md).
+  [フィールドオプションとオーバーライド](field-options-overrides.md).
+  [しきい値](thresholds.md).

## 自動レイアウト調整
<a name="stat-panel-automatic-layout-adjustment"></a>

パネルは、ダッシュボードで使用可能な幅と高さに応じてレイアウトを自動的に調整します。パネルが小さすぎると、グラフ (スパークライン) が自動的に非表示になります。

## 表示オプション
<a name="stat-panel-display-options"></a>

次のオプションを使用して、視覚化する表示内容を絞り込みます。
+  **[表示]** – Amazon Managed Grafana でのデータ表示方法を選択します。
  +  **[計算]** – すべての行を元に計算した値を表示します。
    +  **計算** - 適用する計算を選択します。利用可能な計算の詳細については、「[計算リスト](list-of-calculations.md)」を参照してください。
  +  **すべての値** — 行ごとに個別の統計を表示します。
    +  **[制限]** – 表示する行の最大数を指定します。
+  **[フィールド]** – このパネルに含めるフィールド名またはフィールドタイプ (**[すべてのフィールド]** または **[数値フィールド]** を含む) を選択します。
+  **[値]** – Amazon Managed Grafana が多くのフィールドを 1 つの値にまとめるための reducer 関数を選択します。**Value (値)**リストを選択すると、関数と簡単な説明が表示されます。
+  **[Orientation]** (向き) – 積み重ね方向を選択します。
  +  **自動** – Amazon Managed Grafana は最適な方向であると考えるものを選択します。
  +  **[水平]** – バーは水平方向に左から右に伸びます。
  +  **[垂直]** – バーは垂直に上から下に伸びます。
+  **テキストモード** – **[テキストモード]** オプションを使用すると、パネルが表示するテキストを制御できます。名前と色のみが重要で、値が重要でない場合は、**[テキストモード]** を **[名前]** に変更します。値が色を決定するために使用され、ツールヒントに表示されます。
  +  **[自動]** – データに複数のシリーズまたはフィールドが含まれている場合は、名前と値の両方を表示します。
  +  **[値]** – 値のみを表示し、名前は表示しません。名前がツールヒントに表示されます。
  +  **値と名前** – 常に値と名前を表示します。
  +  **名前** – 値の代わりに名前を表示します。値がツールヒントに表示されます。
  +  **[なし]** – 何も表示しません (空)。名前と値がツールヒントに表示されます。
+  **カラーモード** – カラーモードを選択します。
  +  **[値]** – 値とグラフ領域のみを色付けします。
  +  **[Background]** (背景) – 背景も色付けします。
+  **グラフモード** – グラフモードを選択します。
  +  **[なし]** – グラフを非表示にし値のみを表示します。
  +  **[エリア]** – 値の下に面グラフを表示します。このオプションではクエリが時間列を返す必要があります。
+  **アライメントモード** – アライメントモードを選択します。
  +  **自動** – 値が 1 つだけ表示されている場合 (繰り返しなし)、値は中央に配置されます。複数の系列または行が表示されている場合、値は左揃えになります。
  +  **[Center]** (中央) – 統計値は中央にあります。

# 状態タイムラインパネル
<a name="state-timeline-panel"></a>

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

状態タイムラインパネルの視覚化では、時間の経過に伴う個別の状態の変化が表示されます。各フィールドまたは系列は、一意の水平バンドとしてレンダリングされます。状態領域は、値の有無にかかわらずレンダリングできます。このパネルは、文字列またはブール値の状態とうまく連携しますが、時系列でも使用できます。時系列で使用すると、しきい値を使用して数値を離散状態の領域に変換します。

## 状態タイムラインオプション
<a name="state-timeline-options"></a>

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

**[Merge equal consecutive values] (等しい連続値をマージする)**

Grafana は、互いに隣接する同じ値をマージするかどうかを制御します。

**[値の表示]**

値が状態領域内でレンダリングされるかどうかを制御します。[自動] は、十分なスペースがある場合に値をレンダリングします。

**[値の整列]**

状態領域内の値のアライメントを制御します。

**[Row height]** (行の高さ)

行間のスペースを制御します。1 = スペースなし = 0.5 = 50% のスペース。

**[線の幅]**

状態領域の線幅を制御します。

**[塗りつぶしの不透明度]**

状態領域の不透明度を制御します。

## 値のマッピング
<a name="state-timeline-valuemap"></a>

ブール値または文字列値に色を割り当てるには、[値の配置](field-options-overrides.md#value-mapping) を使用します。

## しきい値を含む時系列データ
<a name="state-timeline-threshold"></a>

パネルは時系列データでも使用できます。この場合、しきい値を使用して時系列を個別の色付き状態領域に変換します。

## 凡例オプション
<a name="state-timeline-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの [カラースキーム] オプションを [単一色] または [クラシックパレット] に設定することが重要です。凡例にしきい値の括弧を表示するには、カラースキームを [しきい値起点] に設定します。

**[凡例モード]** – これらの設定を使用して視覚化内の凡例の表示方法を改善します。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

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

# ステータス履歴パネル
<a name="status-history-panel"></a>

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

ステータス履歴の視覚化は、時間の経過に伴う周期的な状態を表示します。各フィールドまたは系列は、横の列としてレンダリングされます。ボックスがレンダリングされ、各値を中央に配置します。

ステータス履歴の視覚化は、文字列、ブール値、数値フィールドまたは時系列で機能します。時間フィールドは必須です。値マッピングを使用して、文字列の色付け、またはテキスト値の数値範囲への割り当てができます。

## 表示オプション
<a name="status-timeline-options"></a>

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

**[値の表示]**

値が値ボックス内でレンダリングされるかどうかを制御します。[自動] は、十分なスペースがある場合に値をレンダリングします。

**[列幅]** は、ボックスの幅を制御します。1=最大、0=最小幅。

**[線の幅]** は、状態領域の線幅を制御します。

**[塗りつぶしの不透明度]** は、状態領域の塗りつぶしの不透明度を制御します。

## 値のマッピング
<a name="status-history-valuemap"></a>

ブール値または文字列値に色を割り当てるには、[値の配置](field-options-overrides.md#value-mapping) を使用します。

## しきい値を含む時系列データ
<a name="status-history-threshold"></a>

パネルは時系列データでも使用できます。この場合、しきい値を使用してボックスを色付けします。グラデーションのカラースキームを使用して値を色付けすることもできます。

## 凡例オプション
<a name="status-history-legend"></a>

凡例オプションを有効にすると、値のマッピングまたはしきい値の括弧のいずれかを表示できます。凡例に値のマッピングを表示するには、[標準] オプションの [カラースキーム] オプションを [単一色] または [クラシックパレット] に設定することが重要です。凡例にしきい値の括弧を表示するには、カラースキームを [しきい値起点] に設定します。

**[凡例モード]** – これらの設定を使用して視覚化内の凡例の表示方法を改善します。
+  **[リスト ]** – 凡例を一覧として表示します。これは凡例のデフォルトの表示モードです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

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

# テーブルパネル
<a name="table-panel"></a>

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

テーブルパネルは、時系列、テーブル、注釈、未加工 JSON データのための複数のモードをサポートします。このパネルには、日付の書式設定、値の書式設定、色付けのためのオプションも用意されています。

## データオプションとフィールドオプション
<a name="data-and-field-options"></a>

テーブルの視覚化を使用すると、次のオプションを適用できます。
+  [変換](panel-transformations.md).
+  [フィールドオプションとオーバーライド](field-options-overrides.md).
+  [しきい値](thresholds.md).

## 表示オプション
<a name="display-options"></a>
+  **ヘッダーの表示** – データソースからインポートされた列名を表示または非表示にします。
+  **[昇順/降順のソート]** — 列タイトルを選択してソート順序をデフォルトから降順に変更します。選択するたび、ソート順序はサイクルの次のオプションに変わります。一度に 1 つの列のみでソートすることができます。
+  [テーブルのフィールドオプション](#table-field-options) – 列幅、配置、セル表示モードなどのフィールドオプションに変わります。
+  [テーブル列のフィルタリング](#filter-table-columns) – 列データの表示方法が一時的に変わります。例えば、最大から最小までの値を順序付けたり、特定の値を非表示にしたりできます。

## 注釈のサポート
<a name="annotation-support"></a>

注釈は現在新しいテーブルパネルではサポートされていません。

## テーブルのフィールドオプション
<a name="table-field-options"></a>

このセクションでは、使用可能なすべてのテーブルフィールドのオプションについて説明します。オプションは、Amazon Managed Grafana と同じ順序で一覧されます。このトピックに一覧されるオプションは、テーブルパネルの視覚化にのみ適用されます。

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

これらのオプションの適用の詳細については、「[すべてのフィールドを設定する](field-options-overrides.md#configure-all-fields)」および「[特定のフィールドを設定する](field-options-overrides.md#configure-specific-fields)」を参照してください。

### [列の配置]
<a name="column-alignment"></a>

Amazon Managed Grafana がセルの内容を配置する方法を選択します。
+ Auto (デフォルト)
+ Left (左)
+ Center (中央)
+ Right (右)

### 列幅
<a name="column-width"></a>

デフォルトでは、Amazon Managed Grafana はセルの内容に基づいて列の幅を自動的に計算します。このフィールドオプションでは、設定を上書きして、すべての列の幅をピクセル単位で定義できます。

例えば、`100` をフィールドに入力すると、フィールドの外部を選択したときにすべての列の幅が 100 ピクセルに設定されます。

### セル表示モード
<a name="cell-display-mode"></a>

デフォルトでは、Amazon Managed Grafana は自動的に表示設定を選択します。以下のオプションのいずれかを選択してすべてのフィールドを変更すると、設定を上書きできます。

**注記**  
**[フィールド]** タブでこれらを設定すると、表示モードが時間フィールドを含むすべてのフィールドに適用されます。**[オーバーライド]** タブで設定すると、多くのオプションが最適に機能します。

#### 文字色
<a name="color-text"></a>

しきい値が設定されている場合、フィールドのテキストは適切なしきい値の色で表示されます。

#### 色付背景
<a name="color-background"></a>

しきい値が設定されている場合、フィールドの背景は適切なしきい値の色で表示されます。

#### グラデーションゲージ
<a name="gradient-gauge"></a>

しきい値レベルによりグラデーションが決定されます。

#### LCD ゲージ
<a name="lcd-gauge"></a>

ゲージは小さなセルに分割され、点灯または消灯で表示されます。

#### JSON ビュー
<a name="json-view"></a>

値はコードの形式で表示されます。値がオブジェクトの場合、値の上にカーソルを置くと JSON オブジェクトに移動できる JSON ビューが表示されます。

### [Column filter] (列フィルター)
<a name="column-filter"></a>

## テーブル列のフィルタリング
<a name="filter-table-columns"></a>

テーブルオプションで **[列フィルター]** をオンにすると、テーブルオプションをフィルタリングできます。詳細については、「[テーブルのフィールドオプション](#table-field-options)」を参照してください。

### 列フィルタリングを有効にする
<a name="turn-on-column-filtering"></a>

1. Amazon Managed Grafana で、フィルタリングする列を含むテーブルを表示するダッシュボードを選択します。

1. フィルタリングするテーブルパネルで、[パネルエディタを開く](AMG-panel-editor.md#open-the-panel-editor) を実行します。

1. **[フィールド]** タブを選択します。

1. **[テーブル]** オプションで、**[列フィルター]** オプションをオンにします。

各列のタイトルの横にフィルターアイコンが表示されます。

### 列の値のフィルタリング
<a name="filter-column-values"></a>

列の値をフィルタリングするには、列タイトルの横にあるフィルター (ファネル) アイコンを選択します。Grafana ワークスペースにその列のフィルターオプションが表示されます。

表示する値の横にあるチェックボックスを選択します。上部の検索フィールドにテキストを入力してそれらの値をディスプレイに表示すると、スクロールして探さずに選択できます。

### 列フィルターのクリア
<a name="clear-column-filters"></a>

フィルターが適用された列では、タイトルの横に青い漏斗が表示されます。

フィルターを削除するには、青いファネルアイコンを選択してから、**[フィルターをクリア]** を選択します。

# テキストパネル
<a name="text-panel"></a>

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

テキストパネルを使用すると、ダッシュボードの情報パネルと説明パネルを作成できます。

**[モード]**で、マークダウンまたは HTML を使用してテキストのスタイルを設定するかどうかを選択し、以下のボックスにコンテンツを入力します。Grafana ワークスペースには使用開始に役立つタイトルと段落が含まれています。別のエディタからコンテンツを貼り付けることもできます。

# 時系列パネル
<a name="time-series-panel"></a>

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

時系列パネルでは、時系列を線、ドットの軌跡、または一連の棒としてレンダリングできます。このタイプのグラフは、ほぼすべての時系列データを表示するための十分な汎用性があります。

**注記**  
グラフパネルの視覚化は時系列の視覚化に移行できます。移行するには、**[パネル]**タブで **[時系列の視覚化]** を選択します。Grafana は該当するすべての設定を転送します。

時系列の視覚化を使用すると、次のオプションを適用できます。
+  [変換](panel-transformations.md) 
+  [フィールドオプションとオーバーライド](field-options-overrides.md) 
+  [しきい値](thresholds.md) 

また、フィールドオプションを使用してさまざまなタイプのグラフを作成、または軸を調整できます。

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

## ツールチップモード
<a name="time-series-panel-tooltip"></a>

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

## 凡例モードと配置
<a name="time-series-panel-legend"></a>

凡例の表示方法を選択します。
+  **[リスト]** – 凡例を一覧として表示します。これがデフォルトです。
+  **[テーブル]** – 凡例をテーブルとして表示します。
+  **[非表示]** – 凡例を非表示にします。

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

## 凡例計算
<a name="time-series-panel-legend-calculations"></a>

凡例に表示する計算を選択します。詳細については、「[計算リスト](list-of-calculations.md)」を参照してください。

# 線による時系列のグラフ
<a name="time-series-graph-lines"></a>

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

このセクションでは、時系列フィールドオプションを使用して時系列データを線として視覚化する方法と、オプションの動作について説明します。

**パネルの作成**

1. **[時系列]** の視覚化を選択して、パネルを作成します。詳細については、「[パネルの追加](add-a-panel-to-a-dashboard.md)」を参照してください。

1. **[パネルエディタ]** で、**[フィールド]** を選択します。

1. **[スタイル]** で、**[線]** を選択します。

## 線のスタイル設定
<a name="time-series-graph-lines-style"></a>

線のスタイリングにはさまざまなオプションがあります。
+ **[線形補間]** — Grafana がシリーズの線を補間する方法を選択します。選択肢は、**[直線]**、**[平滑線]**、**[前のステップ]**、**[後のステップ]** です。
+ **線幅** – 線の厚さを 0～10 ピクセルに設定します。
+ **[塗りつぶしの不透明度]** – シリーズの塗りつぶしの不透明度を 0～100% に設定します。
+ **[グラデーションモード]** – グラデーション塗りつぶしのモードを設定します。塗りつぶしグラデーションは線の色を基準にします。色を変更するには、標準のカラースキームフィールドオプションを使用します。

  グラデーションの外観は **[塗りつぶし不透明度]** の設定に影響されます。

  グラデーションフィルの選択肢は、**[なし]**、**[不透明度]**、**[色相]** です。**[不透明度]** では、グラデーションの透明度が y 軸の値に基づいて計算されます。y 軸の値とともに塗りつぶしの不透明度が増加します。**[色相]** では、グラデーションの色が線の色の色相に基づいて生成されます。
+ **[線のスタイル]** – 線のスタイルを設定します。色を変更するには、標準のカラースキームフィールドオプションを使用します。

  線のスタイルの外観は、**[線幅]** と **[塗りつぶしの不透明度]** の設定に影響されます。

  線のスタイルの選択肢は、**[実線]**、**[破線]**、および **[点線]** です。
+ **[Null 値]** – データ内のギャップの表示方法を選択します。null 値は、連続線を形成するために接続することも、オプションで、超えるとデータ内のギャップが接続されなくなるしきい値を設定することもできます。**[常に非表示]** で常にデータポイントをギャップで接続しない、**[常に表示]** で常にデータポイントをギャップで接続する、またはデータ内のギャップを接続しなくなる **[しきい値]** を設定することができます。
+ **ポイントの表示** – ポイントがグラフに表示されるタイミングを選択します。選択肢は、**[自動]**、**[常に]**、**[なし]** です。

## [下を塗りつぶす]
<a name="time-series-panel-legend-fillbelow"></a>

このオプションは、オーバーライドタブでのみ使用できます。

**2 つのシリーズ間の領域を埋める方法**

1. 下を塗りつぶすフィールドを選択します。

1. **[オーバーライドプロパティの追加]** で、**[下を塗りつぶす]** を選択します。

1. 塗りつぶしを停止するシリーズを選択します。

# 棒による時系列のグラフ
<a name="time-series-graph-bars"></a>

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

このセクションでは、時系列フィールドオプションを使用して時系列データを棒として視覚化する方法と、オプションの動作について説明します。

**パネルの作成**

1. **[時系列]** の視覚化を選択して、パネルを作成します。詳細については、「[パネルの追加](add-a-panel-to-a-dashboard.md)」を参照してください。

1. **[パネルエディタ]** で、**[フィールド]** を選択します。

1. **[スタイル]** で、**[棒]** を選択します。

## 棒のスタイル設定
<a name="time-series-graph-bars-style"></a>

棒のスタイリングにはさまざまなオプションがあります。
+ **棒の配置** – データポイントに対する棒の位置を設定します。選択肢は、**[前]**、**[中央]**、**[後]** です。
+ **線幅** – 棒の輪郭の厚さを 0～10 ピクセルに設定します。
+ **[塗りつぶしの不透明度]** – 棒の塗りつぶしの不透明度を 0～100% に設定します。
+ **[グラデーションモード]** – グラデーション塗りつぶしのモードを設定します。塗りつぶしグラデーションは線の色を基準にします。色を変更するには、標準のカラースキームフィールドオプションを使用します。

  グラデーションの外観は **[塗りつぶし不透明度]** の設定に影響されます。

  グラデーションフィルの選択肢は、**[なし]**、**[不透明度]**、**[色相]** です。**[不透明度]** では、グラデーションの透明度が y 軸の値に基づいて計算されます。y 軸の値とともに塗りつぶしの不透明度が増加します。**[色相]** では、グラデーションの色が線の色の色相に基づいて生成されます。
+ **ポイントの表示** – ポイントがグラフに表示されるタイミングを選択します。選択肢は、**[自動]**、**[常に]**、**[なし]** です。

# ポイントによる時系列のグラフ
<a name="time-series-graph-points"></a>

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

このセクションでは、時系列フィールドオプションを使用して時系列データをポイントとして視覚化する方法と、オプションの動作について説明します。

**パネルの作成**

1. **[時系列]** の視覚化を選択して、パネルを作成します。詳細については、「[パネルの追加](add-a-panel-to-a-dashboard.md)」を参照してください。

1. **[パネルエディタ]** で、**[フィールド]** を選択します。

1. **[スタイル]** で、**[ポイント]** を選択します。

## ポイントのスタイル設定
<a name="time-series-graph-points-style"></a>

ポイントとしてグラフ化するときは、ポイントサイズを選択できます。
+ **ポイントサイズ** – 直径 1～40 ピクセルからポイントサイズを選択します。

# 軸表示の変更
<a name="time-series-change-axis"></a>

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

このセクションでは、時系列フィールドオプションを使用して視覚化内の軸表示を制御する方法を説明し、軸オプションの動作を示します。

軸にはさまざまなオプションがあります。
+ **Y 軸の配置** – Y 軸の配置を設定します。選択肢は、**[左]**、**[右]**、**[非表示]** です。
+ **Y 軸のラベル** – Y 軸のテキストラベルを設定します。Y 軸が複数ある場合は、**[上書き]** タブを使用して異なるラベルを割り当てることができます。
+ **幅** – 軸の固定幅を設定します。デフォルトでは、Grafana ワークスペースは軸の幅を動的に計算します。軸の幅を設定することで、軸タイプが異なるデータでも同じ表示比率を共有できます。これにより、軸が互いに視覚的に近接して移動または伸張されないため、複数のグラフのデータの価値を簡単に比較できます。
+ **ソフト最小値とソフト最大値** — Y 軸の制限をより適切に制御するために、**[ソフト最小値]** または **[ソフト最大値]** を設定します。デフォルトでは、Grafana ワークスペースはデータに基づいて y 軸の範囲を自動的に設定します。

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

# 積み上げ時系列のグラフ
<a name="time-series-stacked"></a>

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

このセクションでは、時系列パネルフィールドのオプションを使用してシリーズの積み上げを制御する方法と、積み上げオプションの動作について説明します。積み上げにより、Grafana は系列の上に別の系列を表示できます。視覚化で積み上げを使用すると、誤解を招くグラフを簡単に作成できるため、注意が必要です。積み上げが最適な手段ではない理由の詳細については、「[積み上げに関する問題](https://www.data-to-viz.com/caveat/stacking.html)」を参照してください。

# グループ内の系列の積み上げ
<a name="time-series-stacked-groups"></a>

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

積み上げグループオプションは、オーバーライドとしてのみ使用できます。

**同じグループにシリーズをスタックする方法**

1. オーバーライドセクションで、**[シリーズの積み上げ]** オプションのフィールドオーバーライドを作成します。

1. **[普通]** スタックモードを選択します。

1. シリーズを表示する積み上げグループに名前を付けます。積み上げグループ名オプションは、オーバーライドを作成する場合にのみ使用できます。

# しきい値
<a name="thresholds"></a>

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

しきい値により、定義した条件に応じて値のテキストまたは背景の、いずれかの色が設定されます。

しきい値は次の 2 つの方法のいずれかで定義できます。
+ **絶対**しきい値は、1～150 のスケールで 80 のように、数値に基づいて定義されます。
+ **パーセント**しきい値は、最小値または最大値に対して、80% などのように定義されます。

次の視覚化に対してしきい値を適用できます。
+ [棒ゲージパネル](alert-panel-bar-gauge-panel.md) 
+  [ゲージパネル](gauge-panel.md) 
+  [グラフパネル](graph-panel.md)
+  [統計パネル](stat-panel.md)
+  [テーブルパネル](table-panel.md)

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

これをサポートする視覚化で、Amazon Managed Grafana は、80 = 赤、ベース = 緑、モード = 絶対の、デフォルトのしきい値を設定します。

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

## しきい値の追加
<a name="add-a-threshold"></a>

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

**注記**  
これらの手順は、統計、ゲージ、棒ゲージ、テーブルの視覚化にのみ適用されます。

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

1. **[フィールド]** タブを選択します。

1. **[しきい値の追加]** を選択します。

   Amazon Managed Grafana は推奨される数値と色値を含むしきい値を追加します。

1. 推奨を受け入れるか新しいしきい値を編集します。
   +  **色の編集** – 変更する色ドットを選択してから新しい色を選択します。
   +  **数の編集** – 変更する数を選択し、新しい数を入力します。
   +  **しきい値モード** – このパネルのすべてのしきい値に対して変更するモードを選択します。

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

## グラフパネルへのしきい値の追加
<a name="add-a-threshold-to-a-graph-panel"></a>

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

1. しきい値を追加するグラフパネルを選択します。

1. **[パネル]** タブで、**[しきい値]** を選択します。

1. **[しきい値の追加]** を選択します。

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

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

## しきい値の削除
<a name="delete-a-threshold"></a>

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

1. **[フィールド]** タブを選択します。(グラフパネルの場合は、**[パネル]** タブを選択します)

1. 削除するしきい値の横にある、ごみ箱アイコンを選択します。

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

# WindRose
<a name="windrose"></a>

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

WindRose パネルは、生の時系列データを受信し、データを変換して WindRose チャートにマッピングします。

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/windrose.png)


## オプション
<a name="windrose-options"></a>

WindRose パネルは、以下のオプションをサポートしています。
+ 軸の頻度
+ 軸のスタイル (角度またはコンパス)
+ 目盛 (線形、正方形、対数)

# パネルの検査
<a name="inspect-a-panel"></a>

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

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

## パネルインスペクター UI
<a name="panel-inspector-ui"></a>

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

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

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

## パネルインスペクタータスク
<a name="panel-inspector-tasks"></a>

パネルインスペクターでは、パネルの検査、未加工のクエリ結果の検査およびダウンロード、クエリのパフォーマンスの検査を実行し、パネル JSON モデルを表示し、データソースに対する未加工のリクエストおよびレスポンスを表示できます。

### パネルインスペクターを開く
<a name="open-the-panel-inspector"></a>

表示できるすべてのパネルを検査できます。

1. Grafana ワークスペースコンソールで、検査するパネルが含まれるダッシュボードを選択します。

1. 検査するパネルのタイトルを選択して、 **[検査]** を選択します。または、パネルタイトルを一時停止してから **i** を押します。

画面の右側にパネルインスペクターペインが表示されます。

### 未加工クエリ結果の検査
<a name="inspect-raw-query-results"></a>

テーブル内の未加工クエリ結果を確認します。これらは、、クエリに変換が適用され、パネルにフィールドオプションまたはフィールドオプションオーバーライドを適用する前に、クエリによって返されるデータです。

1. パネルインスペクターを開いてから **[データ]** タブを選択します。または、パネルメニューで、**[検査]**、**[データ]** を選択します。

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

  フィールドオプションとオプションオーバーライドを適用済みのテーブルに未加工のクエリ結果を表示します。

  1. パネルインスペクターで **[データ]** タブを開きます。

  1. テーブルの上方にある **[データ表示オプション]** を選択します。

  1. **[フィールド設定の適用]** トグルボタンを選択します。

### 未加工のクエリ結果を CSV ファイルとしてダウンロード
<a name="download-raw-query-results-as-csv"></a>

Amazon Managed Grafana は、ブラウザのデフォルトのダウンロード場所に CSV ファイルを生成します。お好みのビューワーで開くことができます。

1. パネルインスペクターを開きます。

1. 上記のように未加工のクエリ結果を検査します。エクスポートする未加工データが表示されるまで、設定を調整します。

1. **[CSV のダウンロード]** を選択します。

Excel 用にフォーマットされた CSV ファイルをダウンロードするには、**[データオプション]** パネルを展開して **[Excel 用ダウンロード]** オプションをオンにしてから、**[CSV のダウンロード]** を選択します。

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

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

1. パネルインスペクターを開きます。

1. **[ステータス]** タブを選択します。

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

### パネル JSON モデルの表示
<a name="view-panel-json-model"></a>

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

1. パネルインスペクターを開いてから、**[JSON]** タブを選択します。または、パネルメニューで、**[検査]**、**[パネル JSON]** を選択します。

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

1. JSON の一部を展開または折りたたんで調べるか、**[クリップボードにコピー]** を選択して別のアプリケーションの JSON に貼り付けることができます。

### データソースへの未加工リクエストとレスポンスの表示
<a name="view-raw-request-and-response-to-data-source"></a>

1. パネルインスペクターを開いてから **[クエリ]** タブを選択します。または、パネルメニューで、**[検査]**、**[クエリ]** を選択します。

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

Amazon Managed Grafana は情報を収集するためのクエリをサーバーに送信してから、結果を表示します。クエリの特定の部分をドリルダウン、そのすべてを展開または折りたたみ、またはデータをクリップボードにコピーして他のアプリケーションで使用できます。

# 計算リスト
<a name="list-of-calculations"></a>

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

このトピックでは Amazon Managed Grafana で使用される計算を一覧表示して定義します。

特に、これらの計算は、**[変換]** タブと棒ゲージ、ゲージ、および統計の視覚化に使用します。


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

# ダッシュボード
<a name="dashboard-overview"></a>

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

 *ダッシュボード*は、1 つ以上の行に編成および配置された 1 つ以上のパネルのセットです。Amazon Managed Grafana には、さまざまなパネルが用意されています。Amazon Managed Grafana では、クエリを簡単に作成し、表示プロパティをカスタマイズして、お好みのダッシュボードを作成することができます。各パネルは、設定された任意のデータソースからのデータを操作できます。

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

 ダッシュボードの期間の制御は、ダッシュボードの右上にある [時間範囲コントロール](dashboard-time-range-controls.md) を使用します。

 ダッシュボードは、テンプレートや変数を使用することで、より動的でインタラクティブにすることができます。詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。

 ダッシュボードは、[‏注釈](dashboard-annotations.md) を使用してパネル間でイベントデータを表示できます。これにより、パネル内の時系列データを他のイベントと関連付けることができます。

 ダッシュボードはさまざまな方法で簡単に共有できます。詳細については、「[ダッシュボードの共有](share-a-dashboard.md)」を参照してください。

 ダッシュボードにはタグを付けることができます。ダッシュボードピッカーを使用することで、特定の組織内のすべてのダッシュボードを簡単に検索してアクセスできるようになります。

## [Rows] (行)
<a name="dashboard-rows"></a>

 *行*は、ダッシュボード内を論理的に区切るための要素です。行を使用してパネルをグループ化することができます。

 行の幅は常に 12 *ユニット*です。このユニットは、ブラウザの水平解像度に従って自動的にスケーリングされます。特定の幅を設定することで、行内のパネルの相対的な幅を制御できます。

 Amazon Managed Grafana は、画面サイズに応じて最適な表示を実現するために、ユニットの抽象化を使用しています。

**注記**  
 最大データポイント数 機能を使用すると、Amazon Managed Grafana は解像度や時間範囲に関係なく、必要な数のデータポイントを表示できます。

 行を折りたたむには、行タイトルを選択します。行が折りたたまれた状態でダッシュボードを保存するとその状態で保存され、行を展開するまでグラフは読み込まれません。

 繰り返し行機能を使用すると、選択したテンプレート変数に基づいて、パネルの行全体を動的に作成または削除することができます。

# ‏注釈
<a name="dashboard-annotations"></a>

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

 注釈は、リッチイベントでグラフ上のポイントをマークする方法を提供します。注釈にカーソルを合わせると、イベントの説明とイベントタグを見ることができます。テキストフィールドには、より詳細な他のシステムへのリンクを含めることができます。

## ネイティブ注釈
<a name="native-annotations"></a>

 Amazon Managed Grafana には、ネイティブ注釈ストアと、グラフパネルから直接注釈イベントを追加する機能が付属しています。

## 注釈の追加
<a name="adding-annotations"></a>

 注釈を追加するには、[**Ctrl**] または [**Cmd**] を押して、注釈を追加する場所を選択します。注釈にタグを追加することで、他のダッシュボードから注釈を検索できるようになります。

### リージョン注釈の追加
<a name="adding-regions-events"></a>

 リージョンの注釈を作成するには、リージョンを選択しながら [**Ctrl**] または [**Cmd**] を押します。

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

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

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

### タグによるクエリ
<a name="annotation-query-by-tag"></a>

 `-- Grafana --` データソースを使用して **[～でフィルタリング]** を **タグ** に設定することで、ネイティブ注釈ストアから注釈を取得する新しい注釈クエリを作成できます。少なくとも 1 つのタグを指定します。例えば、`outages` という名前の注釈クエリ名を作成し、`outage` という名前のタグを指定します。このクエリは、(ダッシュボードまたは API 経由) で作成した `outage` タグを含むすべての注釈を表示します。

デフォルトでは、注釈クエリに複数のタグを追加すると、Amazon Managed Grafana は指定したすべてのタグを持つ注釈のみを表示します。指定したタグのうち、いずれか1つを含む注釈を表示するには、**[任意の一致]** をオンにします。

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

## その他のデータソースのクエリ
<a name="querying-other-data-sources"></a>

 注釈イベントは、注釈クエリを使用して取得されます。ダッシュボードに新しい注釈クエリを追加するには、[**ダッシュボード設定**] (歯車) アイコン、[`Annotations`]、[**新規**] の順に選択します。

 注釈クエリの名前を指定します。この名前は、このクエリの注釈イベントの表示または非表示を切り替えるチェックボックスに表示されます。例えば、2 つの注釈クエリ(`Deploys` と `Outages`) があるとします。チェックボックスのオンとオフを切り替えることで、表示する注釈を指定できます。

### 注釈クエリの詳細
<a name="annotation-query-details"></a>

 注釈クエリオプションは、データソースごとに異なります。
+ [Graphite クエリエディタを使用した注釈](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [OpenSearch データソースを使用した注釈](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [Prometheus を使用した注釈](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [[MySQL を使用した注釈]](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [[PostgreSQL を使用した注釈]](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# ダッシュボードのフォルダ
<a name="dashboard-folders"></a>

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

 フォルダを使用して、ダッシュボードを整理してグループ化することができます。これは、ダッシュボードが数多くある場合や、複数のチームが同じ Grafana ワークスペースを使用している場合に重宝します。

## フォルダの作成
<a name="how-to-create-a-folder"></a>

フォルダを作成するには、以下のいずれかの操作を実行します。
+  サイドメニューの [\$1] アイコンから **[フォルダの作成]** リンクを選択します。
+  [**ダッシュボードの管理**] ページで、[**フォルダの作成**] ボタンを選択します。

 [**フォルダの作成**] ページで、フォルダの一意の名前を入力して [**作成**] を選択します。

ダッシュボードの保存先には、既存のフォルダを選択するか、新しいフォルダを作成して選択することができます。

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

 [**ダッシュボードの管理**] ページでは、さまざまなタスクを実行できます。
+  フォルダを作成します。
+  ダッシュボードを作成します。
+  ダッシュボードをフォルダに移動します。
+  複数のダッシュボードを削除します。
+  フォルダページに移動します (フォルダまたはそのダッシュボードのアクセス権限を設定できます)。

## ダッシュボードフォルダページ
<a name="dashboard-folder-page"></a>

 ダッシュボードフォルダページを開くには、[検索結果] または [ダッシュボードの管理] ページのダッシュボード一覧のフォルダにカーソルを合わせると表示される歯車アイコンを選択します。

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

## 権限
<a name="folder-permissions"></a>

 アクセス許可はフォルダに割り当てることができ、そのフォルダに含まれるダッシュボードがその権限を継承します。アクセスコントロールリスト (ACL) は、**組織ロール **、**チーム**、個人**ユーザー**に権限を割り当てるために使用します。詳細については、「[ダッシュボードおよびフォルダのアクセス権限](dashboard-and-folder-permissions.md)」を参照してください。

# プレイリスト
<a name="dashboard-playlist"></a>

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

 プレイリストは、ダッシュボードを順番に表示するためのリストです。プレイリストを使用して状況認識を高めたり、チームや訪問者にメトリクスを提示することができます。

 Amazon Managed Grafana は、解像度に合わせてダッシュボードを自動的に拡大縮小し、大画面にも対応します。

 **プレイリスト**機能には、サイドメニューの**ダッシュボード**サブメニューからアクセスできます。

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

 プレイリストは、ダッシュボードを順番に、一定の時間間隔で表示します。

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

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

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

1.  **[名前]** ボックスに、プレイリスト名を入力します。

1.  **[間隔]** テキストボックスに時間間隔を入力します。

   時間間隔は、Amazon Managed Grafana が順番に表示するプレイリストの各ダッシュボードを表示したままにする時間です。

1.  プレイリストに追加したいダッシュボードの横にある、**[プレイリストに追加]** を選択します。

1.  **[作成]** を選択します。

## プレイリストの編集
<a name="edit-a-playlist"></a>

 プレイリストは、作成中または保存後に編集できます。

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

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

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

### プレイリスト名の編集
<a name="edit-the-name-of-a-playlist"></a>

1. **[名前]** テキストボックスを選択します。

1.  名前を編集します。

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

### プレイリストの間隔の編集
<a name="edit-the-interval-of-a-playlist"></a>

1.  **[間隔]** テキストボックスを選択します。

1.  間隔を編集します。

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

### プレイリストにダッシュボードを追加する
<a name="add-a-dashboard-to-a-playlist"></a>

1.  プレイリストに追加したい各ダッシュボードの横にある、**[プレイリストに追加]** を選択します。

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

### 追加するダッシュボードの検索
<a name="search-for-a-dashboard-to-add"></a>

1. **[ダッシュボードの追加]** で、**[名前でダッシュボードを検索]** テキストボックスを選択します。

1.  名前または正規表現を入力します。

1. 必要に応じて、スター付きの状態やタグで結果を絞り込むことができます。デフォルトでは、スター付きのダッシュボードがプレイリストに追加できるオプションとして表示されます。

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

### ダッシュボードの順序の並べ替え
<a name="rearrange-dashboard-order"></a>

1.  移動させるダッシュボードの横にある上矢印または下矢印を選択します。

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

### ダッシュボードの削除
<a name="remove-a-dashboard"></a>

1.  プレイリストからダッシュボードを削除するには、x アイコンを選択します。

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

### プレイリストの削除
<a name="delete-a-playlist"></a>

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

1.  削除したいプレイリストの横にある x アイコンを選択します。

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

 プレイリストを保存すると、**プレイリスト**ページに追加され、そこで再生を開始できます。プレイリストを保存する前に、表示させたいすべてのダッシュボードが追加されていることを確認してください。

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

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

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

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

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

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

## プレイリストの開始
<a name="start-a-playlist"></a>

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

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

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

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

1.  ドロップダウンリストから、次のいずれかの表示モードを選択します。
   +  **[通常モード]** 
     +  サイドメニューは表示されたままです。
     +  ナビゲーションバー、行、パネルのコントロールが画面の上部に表示されます。
   +  **TV モード** 
     +  サイドメニューは非表示 (削除) されます。
     +  ナビゲーションバー、行、パネルのコントロールが画面の上部に表示されます。
     +  1 分間操作しないと、TV モードが自動的にオンになります。
     +  TV モードを手動でオンにするには、ショートカットとして **d v** を順番に押すか、ダッシュボード URL に パラメータ `?inactive` を追加します。
     +  マウスを動かしたり何かキーボードのキーを押すことで、TV モードを無効にできます。
   +  **TV モード (自動フィットパネル付き)** 
     +  サイドメニューは非表示 (削除) されます。
     +  ナビゲーションバー、行、パネルのコントロールが画面の上部に表示されます。
     +  ダッシュボードパネルは、画面上のスペースを最適化するために自動的に調整されます。
   +  **キオスクモード** 
     +  サイドメニュー、ナビゲーションバー、行、およびパネルコントロールが、完全に非表示 (表示から削除) になります。
     +  プレイリストの起動後、 ショートカットとして **d v** を順番に押すと、手動で Kiosk モードをオンにできます。
     +  このショートカットを使用して、手動で Kiosk モードをオフにできます。
   +  **キオスクモード (自動フィットパネル付き)** 
     +  サイドメニュー、ナビゲーションバー、行、およびパネルコントロールが、完全に非表示 (表示から削除) になります。
     +  ダッシュボードパネルは、画面上のスペースを最適化するために自動的に調整されます。

## プレイリストの制御
<a name="control-a-playlist"></a>

 プレイリストの開始後は、画面上部のナビゲーションバーを使用して、**通常**モードまたは**テレビ**モードでプレイリストを制御できます。


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

 キーボードの **Esc** でもプレイリストを停止できます。

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

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

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

1.  共有するプレイリストの横にある [**プレイリストの開始**] を選択し、お好みのビューモードを選択します。

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

    例えば、Grafana Play サイトのキオスクモードのプレイリスト URL は `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk` のようになります 

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

# ダッシュボードの検索
<a name="dashboard-search"></a>

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

 ダッシュボードは、ダッシュボード名で検索することができます。また、タグ (複数可) やスター付きの状態でフィルタリングすることができます。ダッシュボードの検索は、ダッシュボード上部のナビゲーションバーにあるダッシュボードピッカーから行うことができます。ダッシュボードの検索は、ショートカット「**F**」でも開きます。

キーボードのみを使用する場合、キーボードの矢印キーで目的のダッシュボードまで検索結果を移動して「**Enter**」キーを押して開くことができます。

## ダッシュボード名でフィルタリング
<a name="find-by-dashboard-name"></a>

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

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

## タグでフィルタリング
<a name="filter-by-tags"></a>

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

 ダッシュボードの一覧をタグでフィルタリングするには、右側の列に表示されるタグを選択します。選択するタグを増やすことで、一覧をさらにフィルタリングできます。

**[タグでフィルタリング]**ドロップダウンメニューを選択すると、使用可能なすべてのタグの一覧を見ることができます。タグを選択すると、ダッシュボードの検索結果がリアルタイムにフィルタリングされます。

キーボードのみを使用する場合、「**Tab**」を押してタグリンクにカーソルを移動し、下矢印キーを押してタグを検索し、「**Enter**」を押してタグを選択します。

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

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

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

 ダッシュボードを共有するには、上部のナビゲーションバーで **[ダッシュボードの共有]** (共有アイコン) を選択します。**[共有]** ダイアログボックスが開き、現在選択されている時間範囲とテンプレート変数を含む現在のダッシュボードへのリンクを取得できます。ダッシュボードに変更を加えた場合は、リンクをコピーする前に、必ずこれらの変更を保存してください。

## ダッシュボードスナップショット
<a name="dashboard-snapshot"></a>

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

## スナップショットの発行
<a name="publish-snapshots"></a>

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

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

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

 パネルタイトルを選択してパネルメニューを開き、パネルメニューで [**共有**] を選択して**パネル共有**ダイアログボックスを開きます。コピーしたリンクには現在の時間範囲と選択したテンプレート変数が設定されるため、このパネルに正確に移動できます。

# 時間範囲コントロール
<a name="dashboard-time-range-controls"></a>

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

 Amazon Managed Grafana では、視覚化されるデータの時間範囲を制御できるいくつかの方法がダッシュボードレベルとパネルレベルの両方に用意されています。

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

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

## 時間単位と相対範囲
<a name="time-units-and-relative-ranges"></a>

 以下の時間単位がサポートされています。
+ `s` (秒)
+ `m` (分)
+ `h` (時間)
+ `d` (日数)
+ `w` (週数)
+ `M` (月数)
+ `y` (年数)

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

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

 次に例を示します。


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

## 一般的な時間範囲コントロール
<a name="common-time-range-controls"></a>

 ダッシュボードとパネルの時間コントロールには、以下のオプションを含む共通のユーザーインターフェイスがあります。

### 現在の時間範囲
<a name="current-time-range"></a>

 現在の時間範囲 (別名*タイムピッカー*)は、そのダッシュボードまたはパネルに現在表示されている時間範囲を示します。

 フィールドにカーソルを合わせると、その範囲内の正確なタイムスタンプとソース (ローカルブラウザなど) が表示されます。

 時間範囲を変更するには、現在の時間範囲を選択します。現在の時間は、過去 15 分などの*相対時間範囲*や、`2020-05-14 00:00:00 to 2020-05-15 23:59:59` のような*絶対時間範囲*で変更できます。

### 相対時間範囲
<a name="relative-time-range"></a>

 **[相対時間範囲]** リストから相対時間範囲を選択します。相対時間範囲の例をいくつか示します。
+  過去 30 分 
+  過去 12 時間 
+  過去 7 日間 
+  過去 2 年間 
+  昨日 
+  一昨日 
+  先週のこの日 
+  現在まで 
+  今週始めから現在まで 
+  今月始めから現在まで 

### 絶対時間範囲
<a name="absolute-time-range"></a>

 絶対時間範囲は、次の 2 つの方法のいずれかで設定します。
+  **[開始]** フィールドと **[終了]** フィールドに値を入力します。正確な時間値または `now-24h` などの相対値を入力し、**[時間範囲の適用]** を選択します。
+  **[開始]** または **[終了]** フィールドを選択します。Amazon Managed Grafana にカレンダーが表示されます。現在の時間範囲として使用したい日付を選択し、**[時間範囲の適用]** を選択します。

 Amazon Managed Grafana には、最近使用した絶対範囲も表示されます。

### ズームアウト (Cmd\$1Z または Ctrl\$1Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 ダッシュボードまたはパネルの視覚的表現でより大きな時間範囲を表示するには、[**時間範囲のズームアウト**] アイコンを選択します。

### ズームイン (グラフに対してのみ)
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 グラフ上でドラッグして表示する時間範囲を選択します。

### ダッシュボードの更新
<a name="refresh-dashboard"></a>

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

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

## ダッシュボードの時間設定
<a name="dashboard-time-settings"></a>

 時間設定はダッシュボードごとに保存されます。

 画面上部の**ダッシュボード設定** (歯車) アイコンを選択すると、ダッシュボードの時間設定が開きます。設定は、[**全般**] タブの「**時間オプション**」セクションで行います。
+  **[タイムゾーン]** – モニタリングするサービスまたはシステムのローカルタイムゾーン。これは、複数のタイムゾーンで動作するシステムまたはサービスを監視する場合に役立ちます。
  +  **[デフォルト]** – ユーザープロファイル、チーム、または組織にデフォルトで設定されているタイムゾーン。ユーザープロファイル、ユーザーが所属するチーム、または組織にタイムゾーンが指定されていない場合、Amazon Managed Grafana はローカルブラウザの時間を使用します。
  +  **[ブラウザの時間]** – 使用中のブラウザに設定されたタイムゾーン。これは通常、コンピュータに設定されているタイムゾーンです。
  +  **[協定世界時]** – UTC を含む標準の ISO 8601 タイムゾーン。詳細については、「[タイムゾーン一覧](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)」を参照してください。
+  **[自動更新]** – 相対時間と自動更新設定 (カスタマイズ可能オプション)。入力はカンマで区切りで、いずれも有効な時間単位である必要があります。
+  **現在時刻の遅延-** - `now` 値をオーバーライドする時間遅延値。通常、この機能は、データ集約の既知の遅延に対応するために null 値を回避するために使用されます。
+  **[タイムピッカーを非表示]** – タイムピッカーを非表示にします。

## パネル時間のオーバーライドと時間のシフト
<a name="panel-time-overrides-and-timeshift"></a>

 [クエリオプション](panel-queries.md#query-options) では、個々のパネルに対して相対時間範囲を上書きして、ダッシュボードの上部ナビゲーションバーにあるタイムピッカーで選択されているものと異なる時間範囲に設定することができます。これにより、異なる期間または日数のメトリクスを同時に表示することができます。

## URL の使用による時間範囲の制御
<a name="control-the-time-range-using-a-url"></a>

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

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

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

 Amazon Managed Grafana のダッシュボードは、UI または [HTTP API] から簡単にエクスポートおよびインポートすることができます。

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

 ダッシュボードは、後でダッシュボードをインポートするために必要なレイアウト、変数、スタイル、データソース、クエリなどすべてを含めた Amazon Managed Grafana JSON 形式でエクスポートされます。

 エクスポート機能は、ダッシュボードメニューの [共有] ボタンを選択して開いた共有ウィンドウから利用できます。

### ダッシュボードをポータブルにする
<a name="making-a-dashboard-portable"></a>

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

 `Constant` タイプのテンプレート変数は、ダッシュボードで自動的に非表示になります。ダッシュボードがインポートされる際にも、必要な入力として追加されます。テンプレート作成とテンプレート変数の詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。

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

 ダッシュボードをインポートするには、サイドメニューの [\$1] アイコン、**[インポート]** の順に選択します。

 ダッシュボードの JSON ファイルをアップロードしたり、ダッシュボードの URL を貼り付けたり、ダッシュボードの JSON テキストをテキスト領域に直接貼り付けたりすることができます。

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

## Grafana.com でダッシュボードを探す
<a name="discover-dashboards-on-grafana.com"></a>

 [Grafana.com/dashboards](https://grafana.com/dashboards) で一般的なサーバーアプリケーションのダッシュボードを検索します。

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

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

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

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

## 2 つのダッシュボードバージョンの比較
<a name="comparing-two-dashboard-versions"></a>

 2 つのダッシュボードバージョンを比較するには、比較するリストから 2 つのバージョンを選択します。2 つのバージョンを選択後、[**バージョンを比較**] を選択すると差分ビューが開きます。デフォルトでは、次の画像のように、変更の概要がテキストで表示されます。

 ダッシュボードを表す未加工の JSON の差分を表示するには、**[JSON の差分を表示]** を選択します。

 比較対象の以前のバージョンに復元するには、[**バージョン <x> に復元**] を選択します。

## 以前に保存したダッシュボードバージョンへの復元
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

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

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

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

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

 Amazon Managed Grafana では多数のキーボードショートカットを利用できます。ご使用の Amazon Managed Grafana のバージョンで使用可能なすべてのキーボードショートカットを表示するには、キーボードで **Shift \$1 ?** を押します。

 **Amazon Managed Grafana には次の一般的なショートカットが含まれています。**
+  **Ctrl\$1S** では現在のダッシュボードを保存します。
+  **Ctrl\$1F** ではダッシュボードファインダー/検索が開きます。
+  **Ctrl\$1H** ではすべてのコントロールが非表示になります (コントロールの非表示は TV のディスプレイでうまく機能します)。
+  **Escape** では全画面モードまたは編集モードのときにはグラフを終了します。

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

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

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

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

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

1.  上部のナビゲーションバーで、**ダッシュボードの管理**を選択します。

1.  ドロップダウンメニューから **[JSON の表示]** を選択します。

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

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

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

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "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  |  ダッシュボードの一意の数値識別子 (データベースによって生成）  | 
|  uid  |  誰でも生成できる一意のダッシュボード識別子。uid は 8～40 文字の文字列です。 | 
|  title  |  ダッシュボードの現在のタイトル。 | 
|  [タグ]  |  ダッシュボードに関連付けられているタグ。JSON では、タグは文字列の配列です。 | 
|  style  |  ダッシュボードのテーマ (dark や light など)。 | 
|  timezone  |  ダッシュボードのタイムゾーン (utc または browser)。 | 
|  editable  |  ダッシュボード編集の可否。 | 
|  graphTooltip  |  ツールチップのスタイル。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  ダッシュボードの時間範囲 (過去 6 時間、過去 7 日など)。 | 
|  timepicker  |  タイムピッカーメタデータ。詳細については、「[タイムピッカー](#dashboard-json-timepicker)」を参照してください。 | 
|  templating  |  テンプレートメタデータ。詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。 | 
|  annotations  |  注釈メタデータ。詳細については、「[‏注釈](dashboard-annotations.md)」を参照してください。 | 
|  refresh  |  自動更新間隔。 | 
|  schemaVersion  |  JSON スキーマのバージョン (整数)。Amazon Managed Grafana 更新でスキーマが変更されるたびに増加します。 | 
|  version  |  ダッシュボードのバージョン (整数)。ダッシュボードが更新されるたびに増加します。 | 
|  panels  |  パネル配列。詳細については、「[パネル](#dashboard-JSON-panels)」を参照してください。 | 

## パネル
<a name="dashboard-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"
  }
```

### パネルのサイズと位置
<a name="panel-size-and-position"></a>

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

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

### タイムピッカー
<a name="dashboard-json-timepicker"></a>

`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"
  }
```

 `timepicker` の使用方法の詳細を以下の表に示します。


|  名前  |  使用方法  | 
| --- | --- | 
|  collapse  |  timepicker が折りたたまれているかどうか  | 
|  enable  |  timepicker がアクティブ化されているかどうか  | 
|  notice  |  TODO  | 
|  now  |  TODO  | 
|  refresh\$1intervals  |  TODO  | 
|  status  |  TODO  | 
|  type  |  TODO  | 

### テンプレート作成
<a name="json-templating"></a>

 `templating` フィールドには、保存された値やその他のメタデータを含むテンプレート変数の配列が格納されています。`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  |  ダッシュボードに現在選択されている変数テキスト/値を表示します  | 
|  データソース  |  変数のデータソースを表示します  | 
|  includeAll  |  すべての値オプションが使用可能かどうか  | 
|  multi  |  変数値リストから複数の値を選択できるかどうか  | 
|  multiFormat  |  データソースから時系列を取得する際に使用する形式  | 
|  [名前]  |  変数の名前。 | 
|  options:  |  ダッシュボードで選択できる可変テキスト/値のペアの配列  | 
|  query  |  変数の値の取得に使用されるデータソースクエリ  | 
|  [更新]  |  TODO  | 
|  [正規表現]  |  TODO  | 
|  type  |  変数のタイプ (custom、query、または interval)。 | 

# スクリプト化ダッシュボード
<a name="scripted-dashboards"></a>

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

**警告**  
 この機能は廃止されており、将来のリリースでは削除されます。

 定義されたパターンで変更されるメトリクス名 (新しいサーバーなど) が多数ある場合、常に新しいダッシュボードを作成するには時間がかかる場合があります。

 スクリプト化ダッシュボードでは、JavaScript を使用してダッシュボードを動的に作成できます。Grafana のインストールフォルダの `public/dashboards/` の下に、`scripted.js` という名前のファイルがあります。このファイルにはスクリプト化ダッシュボードの例が含まれています。URL `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName` を使用してアクセスできます。

 `scripted.js` を開くと、`ARGS` 変数から URL パラメータを読み取ってから行とパネルを追加する方法を確認できます。

## 例: scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## その他の の例
<a name="more-examples"></a>

 その他の例は、Grafana インストールの `public/dashboards/` ディレクトリに収められています。

# Explore
<a name="explore"></a>

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

 Grafana ワークスペースでは、ダッシュボード UI に視覚的表現用のダッシュボードを構築するためのツールが提供されています。*Explore* では、クエリに集中できるように、ダッシュボードとパネルのオプションが削除されます。クエリが機能するまで繰り返し調整し、その後ダッシュボードを計画して構築します。

 インフラの監視やインシデント対応のために障害をデバッグする際に、他のツールに切り替える必要がなくなりました。Explore により、メトリクスとログをより深く掘り下げて原因を特定することができます。

 Explore では、ダッシュボードを作成せずにデータを簡単に表示することができます。データソースがグラフとテーブルのデータをサポートしている場合、Explore には結果をグラフとテーブルの両方が表示されます。これにより、データの傾向と詳細を同時に確認できます。

## 探索を開始する
<a name="start-exploring"></a>

**注記**  
 デフォルトでは、閲覧者ロールが付与されたユーザーは編集できず、Explore へのアクセス権を持ちません。

 左側のメニューの **[Explore]** アイコンをクリックすると、空の Explore タブが開きます。

 パネル内の既存のクエリから開始するには、**[パネル]** メニューから **[Explore]** オプションを選択します。選択すると、パネルからのクエリを含む Explore タブが開きます。その後、ダッシュボードの外部でクエリを調整または反復処理することができます。

 左上のドロップダウンからデータソースを選択します。Prometheus にはカスタム Explore 実装があります。他のデータソースでは、標準のクエリエディタを使用します。

 クエリフィールドでは、クエリを記述し、データを探索できます。クエリフィールドの横に、クリアボタン (X)、クエリ追加ボタン (\$1)、クエリ削除ボタン (-) の 3 つのボタンが表示されます。パネルクエリエディタと同様に、複数のクエリを追加または削除できます。

## 分割と比較
<a name="split-and-compare"></a>

 分割ビューを使用すると、グラフと表を並べて比較したり、関連するデータを 1 ページでまとめて表示することができます。**[分割]** を選択して現在のクエリを複製し、ページを 2 つのクエリを並列に分割します。複製したクエリに、別のデータソースを選択するオプションが表示されます。この機能を使用して、同じクエリで 2 つサーバーを比較したり、ステージング環境と本番環境を比較することができます。

 分割ビューのどちらかで、タイムピッカーに付いている [時刻の同期] ボタンを選択すると、両方のパネルのタイムピッカーをリンクすることができます (一方を変更すると、他方の他のパネルも変更されます)。タイムピッカーをリンクすると、分割ビュークエリの開始時刻と終了時刻が同期されるため、両方の分割パネルで同じ時間間隔を確認できます。

 複製した方のクエリを閉じるには、[**分割を閉じる**] を選択します。

## 短縮リンクの共有
<a name="share-shortened-link"></a>

 **短縮リンクの共有**機能を使用すると、複雑なクエリパラメータを含む長い URL を共有する代わりに、`/goto/:uid` 形式のより短いシンプルな URL を作成することができます。短縮リンクを作成するには、Explore ツールバーで **[共有]** オプションを選択します。使用されていない短縮リンクは、7 日後に自動的に削除されます。

## クエリ履歴
<a name="query-history"></a>

 クエリ履歴は、Explore で使用したクエリの一覧です。履歴は使用しているブラウザにのみ有効であり、共有されません。履歴の表示と操作は、Explore で **[クエリ履歴]** を選択します。

### クエリ履歴の表示
<a name="view-query-history"></a>

 クエリ履歴では、以下の操作が可能です。
+  クエリを実行する 
+  コメントを作成または編集する。
+  クエリをクリップボードにコピーする。
+  クエリを含む短縮リンクをクリップボードにコピーする。
+  クエリをスター付けする。

### お気に入りのクエリの管理
<a name="manage-favorite-queries"></a>

 [クエリ履歴] タブにあるスター付きのすべてのクエリは、[スター付き] タブに表示されます。お気に入りのクエリにすばやくアクセスし、それらのクエリを再入力することなく再利用できます。

### クエリ履歴の並べ替え
<a name="sort-query-history"></a>

 デフォルトでは、クエリ履歴には最新のクエリが表示されます。履歴は日付またはデータソース名で、昇順または降順に並べ替えることができます。

クエリ履歴の右側にあるドロップダウンリストで、フィールドオプションから次のいずれかを選択します。
+  新しい順 
+  [古い順] 
+  データソース A→Z 
+  データソース Z→A 

**注記**  
 分割ビューの場合、ソートモードはアクティブなパネルにのみ適用されます。

### クエリ履歴のフィルタリング
<a name="filter-query-history"></a>

 [**クエリ履歴**] と [**スター付き**] タブでは、データソース名でクエリ履歴をフィルタリングすることができます。

1. **[特定のデータソース (複数可) のクエリをフィルタリング]** を選択します。

1. 履歴のフィルタリングに使用するデータソースを選択します。複数のデータソースを選択することもできます。

[**クエリ履歴**] タブでは、垂直スライダーを使用してクエリを日付でフィルタリングできます。
+ 下部のハンドルをドラッグして、開始日を調整します。
+ 上部のハンドルをドラッグして、終了日を調整します。

**注記**  
分割ビューの場合、フィルターはアクティブなパネルにのみ適用されます。

### クエリ履歴での検索
<a name="search-in-query-history"></a>

 クエリとコメントをまたいで履歴を検索できます。[**クエリ履歴**] タブと [**スター付き**] タブのクエリを検索できます。

1.  [**検索クエリ**] フィールドを選択します。

1.  検索フィールドに、検索語句を入力します。

### クエリ履歴設定
<a name="query-history-settings"></a>

 **[設定]** タブでクエリ履歴をカスタマイズできます。以下の表に、使用できるオプションの一覧を紹介します。


|  設定  |  デフォルトの値  | 
| --- | --- | 
|  Grafana にクエリ履歴が保存される期間を指定します。 |  1 週間  | 
|  デフォルトでアクティブになるタブを変更します。 |  [クエリ履歴] タブ  | 
|  Explore で現在アクティブなデータソースに対してのみクエリを表示します。 |  真  | 
|  クエリ履歴をクリアします。 |  ([クエリ履歴をクリア] を選択すると、保存されたすべてのクエリが完全に削除されます。)  | 

**注記**  
クエリ履歴設定は全体に及び、分割モードで両方のパネルに適用されます。

## Prometheus 固有の機能
<a name="prometheus-specific-features"></a>

 Explore の最初のバージョンには、Prometheus のカスタムクエリエクスペリエンスが含まれています。クエリを実行すると、Grafana ではグラフ用の通常の Prometheus クエリとテーブル用のインスタントクエリの 2 つのクエリが実行されます。インスタントクエリは、グラフに表示されるデータの適切な要約を示す各時系列の最後の値を返します。

### メトリクスエクスプローラー
<a name="metrics-explorer"></a>

 クエリフィールドの左側で **[メトリクス]** を選択すると、メトリクスエクスプローラーが開きます。エクスプローラーには、メトリクスがプレフィックスごとにグループ化された階層メニューが示されます。例えば、すべてのアラートマネージャーメトリクスは `alertmanager` プレフィックスの下にグループ化されます。これにより、利用可能なメトリクスの確認が容易になります。

### クエリフィールド
<a name="query-field"></a>

 クエリフィールドは、メトリクス名、関数の自動補完機能がサポートされており、標準の Prometheus クエリエディタとほぼ同じように動作します。[**Enter**] を押すとクエリが実行されます。

 **Ctrl\$1Space** キーを押すとオートコンプリートメニューが開きます。オートコンプリートメニューには新たに [履歴] セクションが追加されており、最近実行されたクエリの一覧が表示されます。

 クエリフィールドの下に候補が表示されます。候補を選択すると、クエリがその内容で更新されます。
+  カウンター (指数関数的に増加するメトリクス) には、レート関数が候補として表示されます。
+  バケットのには、ヒストグラム関数が候補として表示されます。
+  記録ルールの場合、ルールを展開できます。

### テーブルをフィルタリング
<a name="table-filters"></a>

 テーブルパネルの [**ラベル**] 列にある [**フィルター**] ボタンを選択すると、クエリ式にフィルターを追加することができます。フィルターは複数のクエリに追加することもできます。フィルターはすべてのクエリに追加されます。

## ログの統合
<a name="logs-integration"></a>

 Explore では、ログの調査に以下のデータソースを使用することもできます。
+  InfluxDB 
+  Elasticsearch 

### ログの視覚的表現
<a name="logs-visualization"></a>

 ログクエリの結果はグラフにヒストグラムとして表示され、個々のログはその下に表示されます。データソースから要求した時間範囲のヒストグラムデータが送信されない場合、ログモデルは、自動的に計算された時間間隔でバケット化されたログ行数を基に時系列を計算します。ヒストグラムの開始点は、結果の最初のログ行のタイムスタンプで固定されます。時系列の終了点は、タイムピッカーの **To** 範囲に固定されます。

#### ログレベル
<a name="log-level"></a>

 **レベル**ラベルが指定されているログの場合、Grafana はラベルの値を使用してログレベルを判別し、それに応じて色を更新します。ログにレベルラベルが指定されていない場合、Grafana はログを解析して、その内容がサポートされている式のいずれかと一致するかどうかを確認します。ログレベルは常に最初の一致によって決まります。Grafana がログレベルを判別できない場合、**不明な**ログレベルとして視覚化されます。以下に、ログレベルとログレベルの略語と式の対応表を示します。


|  サポートされている式  |  ログレベル  |  色  | 
| --- | --- | --- | 
|  emerg  |  critical  |  紫色  | 
|  fatal  |  critical  |  紫色  | 
|  alert  |  critical  |  紫色  | 
|  crit  |  critical  |  紫色  | 
|  critical  |  critical  |  紫色  | 
|  err  |  エラー  |  赤  | 
|  eror  |  エラー  |  赤  | 
|  エラー  |  エラー  |  赤  | 
|  warn  |  警告  |  黄色  | 
|  警告  |  警告  |  黄色  | 
|  情報  |  情報  |  緑色  | 
|  information  |  情報  |  緑色  | 
|  notice  |  情報  |  緑色  | 
|  dbug  |  デバッグ  |  青  | 
|  デバッグ  |  デバッグ  |  青  | 
|  トレース  |  トレース  |  水色  | 
|  \$1  |  不明  |  灰色  | 

### 視覚的表現オプション
<a name="visualization-options"></a>

 ログの表示方法をカスタマイズしたり、表示する列を選択することができます。

#### [時間]
<a name="visualization-options-time"></a>

 時間列の表示と非表示を切り替えます。これはデータソースから報告されたログ行に関連付けられているタイムスタンプです。

#### 一意のラベル
<a name="visualization-options-unique-labels"></a>

 非一般的なラベルのみを含む一意のラベル列の表示と非表示を切り替えます。すべての一般的なラベルが上に表示されます。

#### 行の折り返し
<a name="visualization-options-wrap-lines"></a>

 行を折り返して表示する場合、**[真]** に設定します。**[偽]** に設定すると、水平スクロールになります。

#### 重複排除
<a name="visualization-options-deduping"></a>

 ログデータは非常に繰り返しが多いことがあります。Explore では、重複するログ行を非表示にすることができます。さまざまな重複排除アルゴリズムを選択できます。
+  **[完全]** - 完全一致は、日付フィールドを除き、行全体で行われます。
+  **[数値]** - の一致は、期間、IP アドレスなどの数値を除外した後に行で行われます。
+  **署名** – 最も積極的な重複排除で、すべての文字と数字を除きます。一致は残りの空白文字と句読点に対して行われます。

#### 結果の順序を反転する
<a name="visualization-options-flip-results-order"></a>

 受信したログの順序は、デフォルトの降順 (新しい順) から昇順 (古い順) に変更できます。

### ラベルと検出されたフィールド
<a name="labels-and-detected-fields"></a>

 各ログ行には、より堅牢なインタラクションのために、ラベルと検出されたフィールドを含む拡張可能な領域があります。すべてのラベルについて、選択したラベルを含める (ポジティブフィルター) または除外する (ネガティブフィルター) フィルターを適用することができます。各フィールドまたはラベルには、表示されているすべてのログに関連する統計を1回で表示する統計アイコンがあります。

### 検出されたフィールドの切り替え
<a name="toggle-detected-fields"></a>

 ログが JSON または logfmt で構造化されている場合、検出されたフィールドを表示または非表示にできます。ログ行を展開し、目のアイコンを選択してフィールドの表示または非表示を切り替えます。

 \$1\$1< docs-imagebox img="/img/docs/explore/parsed-fields-7-2.gif" max-width="800px" caption="Explore の検出されたフィールドの切り替え" >\$1\$1 

## トレース統合
<a name="tracing-integration"></a>

 Explore では、データソースのトレースからのトレースを視覚化できます。以下は現在サポートされているデータソースです。
+ [Jaeger データソースへの接続](jaeger-data-source.md) 
+ [Tempo データソースへの接続](tempo-data-source.md) 
+ [AWS X-Ray データソースに接続する](x-ray-data-source.md) 
+ [Zipkin データソースへの接続](zipkin-data-source.md) 

 クエリエディタの使用については、該当するデータソースのドキュメントを参照してください。

### ヘッダー
<a name="explore-header"></a>

このヘッダーには、次の項目が含まれます。
+  ヘッダータイトル (ルートスパンの名前とトレース ID が表示されます) 
+  検索 (検索されたテキストを含む時間範囲が強調表示されます) 
+  トレースに関するメタデータ 

### ミニマップ
<a name="explore-minimap"></a>

 ミニマップには、要約ビューまたはトレースタイムラインが表示されます。マウスをミニマップ上でドラッグすると、より短い時間範囲にズームインすることができます。ズームするとメインタイムラインも更新されるため、短い時間範囲も簡単に確認することができます。ズームされたミニマップ上にカーソルを合わせて表示される [**選択のリセット**] ボタンを押すと、ズームがリセットされます。

### タイムライン
<a name="explore-timeline"></a>

 タイムラインには、トレース内の時間範囲のリストが表示されます。各スパン行は以下で構成されます。
+ [**子を展開**] ボタン: 選択したスパンのすべての子スパンを展開または折りたたみます 
+ サービス名: スパンをログに記録したサービスの名前
+ オペレーション名: このスパンが表すオペレーションの名前
+ スパン期間バー: トレース内のオペレーション期間の視覚的表現

スパン行の任意の場所を選択すると、スパンの詳細が表示されます。

### スパンの詳細
<a name="explore-span-details"></a>

スパンの詳細には、次の項目が含まれます。
+  オペレーション名 
+  スパンメタデータ 
+  タグ (このスパンに関連付けられているタグ) 
+  プロセスメタデータ (このスパンをログに記録したプロセスに関するメタデータ) 
+  ログ: このスパンおよび関連するキー値によってログに記録されたログのリスト。Zipkin ログの場合、セクションには Zipkin 注釈が表示されます。

## Explore とダッシュボード間の移動
<a name="navigating-between-explore-and-a-dashboard"></a>

 Explore とダッシュボード間の頻繁な行き来を効率化するため、パネルのドロップダウンから Explore に移動した後、元のダッシュボードに戻る機能を追加しました。

 Explore に移動後、ツールバーに [戻る] ボタンが表示されます。

 ボタンを選択するだけで元のダッシュボードに戻ることができます。また、Explore で行った変更をダッシュボードにも反映させたい場合、ボタン横の矢印をクリックして、[変更を反映してパネルに戻る] メニュー項目を選択します。

## クエリインスペクター
<a name="query-inspector"></a>

 クエリのデバッグを支援するために、Explore ではクエリリクエストとレスポンス、クエリ統計を「クエリインスペクター」を使用して調査できます。この機能は、パネルインスペクターの [**統計**] タブと [**クエリ**] タブと似たものです。詳細については、「[クエリパフォーマンスの検査](inspect-a-panel.md#inspect-query-performance)」および「[データソースへの未加工リクエストとレスポンスの表示](inspect-a-panel.md#view-raw-request-and-response-to-data-source)」を参照してください。

# リンク
<a name="linking-in-Amazon-Managed-Service-for-Grafana"></a>

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

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

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

## どのリンクを使用する必要がありますか｡
<a name="which-link-should-you-use"></a>

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

 次のステップでは、ご使用のワークフローに適したリンクタイプを特定します。Grafana のすべてのリンクタイプは他のダッシュボードや外部ウェブサイトへのショートカットの作成に使用されますが、それらはさまざまなコンテキストで動作します。
+  ダッシュボード内のパネルの大部分またはすべてに関連するリンクを追加するには、[ダッシュボードリンク](dashboard-links.md) を使用します。
+  特定のパネルにドリルダウンするには、[パネルリンク](panel-links.md) を使用します。
+  外部サイトへのリンクには、ダッシュボードリンクまたはパネルリンクのいずれかを使用できます。
+  特定のシリーズ、または 1 つの測定までドリルダウンするには、[データリンク](data-links.md) を使用します。

## URL の使用による時間範囲の制御
<a name="controlling-time-range-using-the-url"></a>

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

# ダッシュボードリンク
<a name="dashboard-links"></a>

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

 ダッシュボードリンクを作成するときに、時間範囲と現在のテンプレート変数を含めることで、別のダッシュボードの同じコンテキストに直接ジャンプできます。これにより、リンクを送信した相手が適切なデータを確認できるようになります。その他のタイプのリンクについては、「[データリンク変数](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables)」を参照してください。

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

## ダッシュボードへのリンクの追加
<a name="add-links-to-dashboards"></a>

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

1.  リンクを追加するダッシュボードを表示している状態で、画面上部の歯車アイコンを選択して **[ダッシュボード設定]** を開きます。

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

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

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

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

## ダッシュボードへの URL リンクの追加
<a name="add-a-url-link-to-a-dashboard"></a>

 現在のダッシュボードの上部にある URL へのリンクを追加します。ダッシュボード、パネル、外部サイトなど、使用可能なあらゆる URL にリンクできます。ユーザーが Grafana ワークスペースの特定のデータを表示できるように、時間範囲を制御できます。

1.  リンクするダッシュボードを表示している状態で、画面上部の歯車アイコンを選択して **[ダッシュボード設定]** を開きます。

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

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

1.  リンクオプションを選択します。
   +  **URL** – リンク先の URL を入力します。ターゲットによっては、フィールド値を含めることもできます。
   +  **[タイトル]** — リンクを表示するタイトルを入力します。
   +  **Tooltip** (ツールヒント) – リンクにカーソルを合わせたときに表示するツールヒントを入力します。
   +  **Icon** (アイコン) – リンクとともに表示するアイコンを選択します。
   +  **[時間範囲]** – このオプションを選択すると、ダッシュボードの時間範囲がリンクに含まれます。ユーザーがリンクを選択すると、指定された時間範囲が既に設定された状態でリンクされたダッシュボードが開きます。
     +  `from` は、エポックミリ秒で指定した、時間範囲の下限を定義します。
     +  `to` は、エポックミリ秒で指定した、時間範囲の上限を定義します。
     +  `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータは、ミリ秒単位で指定する必要があります。例えば、`?time=1500000000000&time.window=10000` は 1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。
   +  **[変数値]** – このオプションを選択すると、リンクにクエリパラメータとして現在使用されているテンプレート変数を含めることができます。ユーザーがリンクを選択すると、リンク先のダッシュボードに一致するテンプレートがリンクの値に設定されます。例: https://play.grafana.org/d/000000074/alerting?var-app=backend&var-server=backend\$101&var-server=backend\$103&var-interval=1h 
   +  **[新しいタブで開く]** – ダッシュボードリンクを新しいタブまたはウィンドウで開く場合は、このオプションを選択します。

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

## ダッシュボードリンクの更新
<a name="update-a-dashboard-link"></a>

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

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

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

## ダッシュボードリンクの複製
<a name="duplicate-a-dashboard-link"></a>

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

## ダッシュボードリンクの削除
<a name="delete-a-dashboard-link"></a>

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

# パネルリンク
<a name="panel-links"></a>

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

 各パネルには、パネルの左上隅に表示する一連の独自のリンクを含めることができます。ダッシュボード、パネル、外部サイトなどの、使用可能な URL にリンクできます。ユーザーが Grafana ワークスペースの特定のデータを表示できるように、時間範囲を制御できます。

パネルの左上隅にあるアイコンを選択すると使用可能なパネルリンクが表示されます。

## パネルリンクの追加
<a name="add-a-panel-link"></a>

1.  リンクを追加するパネルで一時停止して、**e** を押します。または、パネルタイトルの横にあるドロップダウン矢印を選択して、**[編集]** を選択します。

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

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

1.  リンクの **[タイトル]** を入力します。そのタイトルは UI に表示されます。

1.  リンクする **[URL]** を入力します。ダッシュボードで定義済みのテンプレート変数のいずれかを含めることができます。**Ctrl\$1スペース** または **Cmd\$1スペース** を押してから、**URL** フィールドを選択して使用可能な変数を表示します。パネルリンクにテンプレート変数を追加すると、リンクは関連する変数を設定済みの、適切なコンテキストを開きます。時間変数も使用できます。
   +  `from` は、エポックミリ秒で指定した、時間範囲の下限を定義します。
   +  `to` は、エポックミリ秒で指定した、時間範囲の上限を定義します。
   +  `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータは、ミリ秒単位で指定する必要があります。例えば、`?time=1500000000000&time.window=10000` は 1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。

1.  新しいタブで開くには、**[新しいタブで開く]** を選択します。

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

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

## パネルリンクの更新
<a name="update-a-panel-link"></a>

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

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

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

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

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

## パネルリンクの削除
<a name="delete-a-panel-link"></a>

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

1.  削除するキーの横にある **[X]** アイコンを選択します。

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

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

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

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

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

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

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

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

## データリンクの追加
<a name="add-a-data-link"></a>

1.  リンクを追加するパネルで一時停止して、**e** を押します。または、パネルタイトルの横にあるドロップダウン矢印を選択して、**[編集]** を選択します。

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

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

1.  リンクの **[タイトル]** を入力します。そのタイトルは UI に表示されます。

1.  リンクする **[URL]** を入力します。

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

1.  新しいタブで開くには、**[新しいタブで開く]** を選択します。

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

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

## データリンクの更新
<a name="update-a-data-link"></a>

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

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

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

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

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

## データリンクの削除
<a name="delete-a-data-link"></a>

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

1.  削除するキーの横にある **[X]** アイコンを選択します。

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

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

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

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

 データリンク URL ではテンプレート変数も使用できます。詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。

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

 次の変数を使用すると、データリンク URL に現在の時間範囲を含めることができます。
+  `__url_time_range` – 現在のダッシュボードの時間範囲。例: `?from=now-6h&to=now` 
+  `$__from and $__to` – 詳細については、「[グローバル変数](\$1\$1< relref "../variables/variable-types/global-variables.md\$1\$1\$1from-and-\$1\$1to" >\$1\$1)」を参照してください。

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

 シリーズ固有の変数は、`__series` 名前空間で使用できます。
+  `__series.name` — URL へのシリーズ名の追加 
+  `__series.labels.<LABEL>` – ラベルの値を URL に追加します。ラベルにドットが含まれている場合は、`__series.labels["<LABEL>"]` 構文を使用します。

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

 フィールド固有の変数は、`__field` 名前空間で使用できます。
+  `__field.name` – フィールドの名前 

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

 値固有の変数は、`__value` 名前空間で使用できます。
+  `__value.time` – URL への値のタイムスタンプ (Unix ms エポック)。例えば `?time=1560268814105` 
+  `__value.raw` – 未加工値。
+  `__value.numeric` – 値の数値表現 
+  `__value.text` – 値のテキスト表現 
+  `__value.calc` – 値が計算結果である場合の計算名 

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

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

 `var-myvar=${myvar}` を使用します。ここで、`myvar` は使用する現在のダッシュボードのテンプレート変数の名前です。

 現在のダッシュボードのすべての変数を URL に追加するには、`__all_variables` を使用します。

# テンプレートおよび変数
<a name="templates-and-variables"></a>

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

変数は、値のプレースホルダーです。メトリクスクエリとパネルタイトルで変数を使用できます。変数を使用するとよりインタラクティブで動的なダッシュボードを作成できます。メトリクスクエリでサーバー、アプリケーション、センサー名などをハードコーディングする代わりに、変数を使用できます。

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

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

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

サポートされている変数タイプのリスト、各変数タイプの追加手順については、「[変数タイプ](variables-types.md)」を参照してください。

## テンプレート
<a name="templates"></a>

 *[テンプレート]*は、変数を含むすべてのクエリです。

例えば、複数サーバーをモニタリングするためにダッシュボードを管理している場合は、サーバーごとにダッシュボードを作成できます。または、次の例に示すように、1 つのダッシュボードを作成して、テンプレートクエリでパネルを使用できます。

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

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

## 変数のベストプラクティス
<a name="variable-best-practices"></a>

変数のドロップダウンリストは、**[ダッシュボード設定]** の変数リストに一覧されている順序で表示されます。

頻繁に変更する変数を一番上に置くと、ダッシュボードの左端に最初に表示されるようになります。

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

 パネルタイトルとメトリクスクエリは、次の 2 つの異なる構文を使用して変数を参照できます。
+  `$varname` これは次の例のように読みやすい構文です。`apps.frontend.$server.requests.count`ただし、単語の途中で変数を使用することができません。
+  `${var_name}` この構文は式の途中で変数を補間する場合に使用します。
+  `${var_name:<format>}` この形式により、Grafana が値を解釈する方法をより細かく制御できます。詳細については、「[高度な変数フォーマットオプション](#advanced-variable-format-options)」を参照してください。

 クエリがデータソースに送信される前に、クエリは*[補間されます]*。つまり、変数は現在の値に置き換えられます。補間中、変数値は、クエリ言語の構文と使用される場所に準拠するように*エスケープ*される可能性があります。例えば、Prometheus クエリの正規表現で使用される変数は、正規表現からエスケープされます。補間中の値のエスケープの詳細については、データソース固有のドキュメントトピックを参照してください。

 データソースのデフォルトのフォーマットを上書きする高度な構文については、「[高度な変数フォーマットオプション](#advanced-variable-format-options)」を参照してください。

# 変数タイプ
<a name="variables-types"></a>

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

 Grafana は、変数のタイプをいくつか使用します。


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

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

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

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

### クエリ式
<a name="query-expressions"></a>

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

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

**クエリ変数の一般的なオプションを入力するには**

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

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

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

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

1. (オプション) **[ラベル]** には、変数ドロップダウンリストの表示名を入力します。表示名を入力しない場合、ドロップダウンラベルは変数名になります。

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

### クエリオプションの入力
<a name="enter-query-options"></a>

**クエリ変数のクエリオプションを入力するには**

1. **[データソース]** リストで、クエリのターゲットデータソースを選択します。データソースの詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

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

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

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

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

1. (オプション) **[選択オプション]** を入力します。詳細については、「[変数選択オプションの入力](templates-and-variables.md#enter-variable-selection-options)」を参照してください。

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

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

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

 変更されない値には*カスタム*変数を使用します。これは、数値、文字列、またはその他の変数である場合があります。

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

### 一般的なオプションの入力
<a name="variables-enter-general-options"></a>

**カスタム変数のクエリオプションを入力するには**

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

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

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

1.  **[タイプ]** リストで **[カスタム]** を選択します。

1. (オプション) **[ラベル]** には、変数ドロップダウンリストの表示名を入力します。表示名を入力しない場合、ドロップダウンラベルは変数名になります。

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

### カスタムオプションの入力
<a name="enter-custom-options"></a>

**カスタム変数のカスタムオプションを入力するには**

1. **[カンマで区切られた値]** リストで、この変数の値をカンマ区切りリストに入力します。コロンで区切られた数値、文字列、その他の変数、またはキーと値のペアを含めることができます。

1.  (オプション) **[選択オプション]** を入力します。詳細については、「[変数選択オプションの入力](templates-and-variables.md#enter-variable-selection-options)」を参照してください。

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

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

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

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

### 一般的なオプションの入力
<a name="text-box-enter-general-options"></a>

**テキストボックス変数の一般的なオプションを入力するには**

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

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

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

1.  **[タイプ]** リストで、**[テキストボックス]** を選択します。

1. (オプション) **[ラベル]** には、変数ドロップダウンリストの表示名を入力します。表示名を入力しない場合、ドロップダウンラベルは変数名になります。

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

### テキストオプションの入力
<a name="enter-text-options"></a>

**テキストボックス変数のテキストオプションを入力するには**

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

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

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

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

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

定数変数は複数設定できません。各定数変数は 1 つの値のみを保持します。更新するには、変数設定を更新する必要があります。

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

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

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

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

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

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

1.  **[タイプ]** リストで **[Constant]** (定数) を選択します。

1. (オプション) **[ラベル]** には、変数ドロップダウンリストの表示名を入力します。表示名を入力しない場合、ドロップダウンラベルは変数名になります。

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

### 定数オプションの入力
<a name="enter-constant-options"></a>

**定数変数の定数オプションを入力するには**

1. **[値]** フィールドに変数値を入力します。英数字と記号を入力できます。高度な変数の形式オプションを使用する場合は、ワイルドカードを使用することもできます。詳細については、「[高度な変数フォーマットオプション](templates-and-variables.md#advanced-variable-format-options)」を参照してください。

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

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

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

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

### 一般的なオプションの入力
<a name="data-source-enter-general-options"></a>

**データソース変数の一般的なオプションを入力するには**

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

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

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

1.  **[タイプ]** リストで、**[Datasource]** を選択します。

1. (オプション) **[ラベル]** には、変数ドロップダウンリストの表示名を入力します。表示名を入力しない場合、ドロップダウンラベルは変数名になります。

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

### データソースオプションの入力
<a name="enter-data-source-options"></a>

**データソース変数のデータソースオプションを入力するには**

1.  **[タイプ]** リストで、変数のターゲットデータソースを選択します。データソースの詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

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

1.  (オプション) **[選択オプション]** を入力します。詳細については、「[変数選択オプションの入力](templates-and-variables.md#enter-variable-selection-options)」を参照してください。

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

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

## 間隔変数の追加
<a name="add-an-interval-variable"></a>

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

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

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

**間隔変数の一般的なオプションを入力するには**

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

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

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

1.  **[タイプ]** リストで **[間隔]** を選択します。

1. (オプション) **[ラベル]**には、変数ドロップダウンリストの表示名を入力します。表示名を入力しない場合、ドロップダウンラベルは変数名になります。

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

### 間隔オプションの入力
<a name="enter-interval-options"></a>

**間隔変数の間隔オプションを入力するには**

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

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

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

### 間隔変数の例
<a name="interval-variable-examples"></a>

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

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

 より複雑な Graphite の例: 

```
groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')
```

## アドホックフィルターの追加
<a name="add-ad-hoc-filters"></a>

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

**注記**  
**注:** 1 回限り、またはアドホックのフィルター変数は、InfluxDB 、Prometheus、および OpenSearch データソースでのみ機能します。

### 一般的なオプションの入力
<a name="ad-hoc-filters-enter-general-options"></a>

**アドホックフィルターの一般的なオプションを入力するには**

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

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

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

1.  **[タイプ]** リストで、**[Ad hoc filters]** (アドホックフィルター) を選択します。

1. (オプション) **[ラベル]** には、変数ドロップダウンリストの表示名を入力します。表示名を入力しない場合、ドロップダウンラベルは変数名になります。

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

### オプションの入力
<a name="ad-hoc-enter-options"></a>

**アドホックフィルターのオプションを入力するには**

1.  **[データソース]** リストで、ターゲットデータソースを選択します。データソースの詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

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

### アドホックフィルターの作成
<a name="create-ad-hoc-filters"></a>

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

## 連鎖変数
<a name="chained-variables"></a>

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

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

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

### ベストプラクティスとヒント
<a name="variables-best-practices-and-tips"></a>

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

#### 新しい連鎖変数の作成
<a name="creating-new-linked-variables"></a>
+  連鎖変数は親子の依存関係を作成します。ラダーまたはツリー構造として想定できます。
+ 新しい連鎖変数を作成する最も簡単な方法は、新しい変数の基盤となる変数をコピーすることです。変数リストで、変数エントリの右側にある **[Duplicate variable]** (変数の複製) アイコンを選択してコピーを作成します。その後、親変数のクエリに追加できます。
+ この方法で作成した新しい連鎖変数は、リストの下部に表示されます。リストに論理的順序を付けるには、変数をリスト内の別の位置にドラッグします。

#### 変数の順序
<a name="variable-order"></a>

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

#### 複雑さに関する考慮事項
<a name="complexity-consideration"></a>

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

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

## グローバル変数
<a name="global-variables"></a>

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

### \$1\$1\$1dashboard
<a name="global-variable-dashboard"></a>

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

### \$1\$1\$1from および \$1\$1\$1to
<a name="global-variable-from-and-__to"></a>

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


|  構文  |  結果の例  |  説明  | 
| --- | --- | --- | 
|  \$1\$1\$1\$1from\$1  |  1594671549254  |  Unix エポックミリ秒  | 
|  \$1\$1\$1\$1from:date\$1  |  2020-07-13T20:19:09.254Z  |  引数なし、デフォルトは ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:iso\$1  |  2020-07-13T20:19:09.254Z  |  ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:seconds\$1  |  1594671549  |  Unix エポック秒  | 
|  \$1\$1\$1\$1from:date:YYYY-MM\$1  |  2020-07  |  任意のカスタムデータ形式。詳細については、「[表示](https://momentjs.com/docs/#/displaying/)」を参照してください。 | 

上記の構文は「`${__to}`」を使用しても機能します。

この変数は URL でも使用できます。例えば、6 時間前から現在までの時間範囲を示すダッシュボードにエンドユーザーを送信するには、次の URL を使用します。https://play.grafana.org/d/000000012/grafana-play-home?viewPanel=2&orgId=1?from=now-6h&to=now 

### \$1\$1\$1interval
<a name="global-variable-interval"></a>

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

Grafana ワークスペースは、クエリで時間別にグループ化するために使用できる間隔を自動的に計算します。グラフに表示されるデータポイントよりも多い場合、クエリはより長い間隔でグループ化することで、より効率的になります。例えば、3 か月分のデータを調べる場合、1 日でグループ化する方が 10 秒でグループ化するよりも効率的です。グラフは同じように見え、クエリは高速になります。`$__interval` は、時間範囲とグラフの幅 (ピクセル数) を使用して計算されます。

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

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

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

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

### \$1\$1\$1interval\$1ms
<a name="global-variable-interval_ms"></a>

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

### \$1\$1\$1name
<a name="global-variable-name"></a>

 この変数は Singlestat パネルでのみ使用でき、**[オプション]** タブのプレフィックスまたはサフィックスフィールドで使用できます。変数は系列名またはエイリアスに置き換えられます。

### \$1\$1\$1org
<a name="global-variable-org"></a>

 この変数は、現在の組織 ID です。変数 `${__org.name}` は、現在の組織名称です。

### \$1\$1\$1user
<a name="global-variable-user"></a>

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

### \$1\$1\$1range
<a name="global-variable-range"></a>

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

### \$1timeFilter または \$1\$1\$1timeFilter
<a name="global-variable-timefilter-or-__timefilter"></a>

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

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

## その他の変数オプション
<a name="other-variable-options"></a>

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

### 変数選択オプションの入力
<a name="enter-variable-selection-options"></a>

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

#### 複数値
<a name="multi-value"></a>

このオプションをオンにすると、変数のドロップダウンリストで複数のオプションを同時に選択することができます。詳細については、「[複数値の変数のフォーマット](#formatting-multi-value-variables)」を参照してください。

#### すべてを含めるオプション
<a name="include-all-option"></a>

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

#### すべての値のカスタム化
<a name="custom-all-value"></a>

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

`All` オプションの値を定義するには、**[すべての値のカスタム化]** フィールドに regex、glob、または Lucene 構文を入力します。

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

**すべての値のカスタム化**オプションでカスタム正規表現、glob、または Lucene 構文を使用する場合はエスケープされないため、データソースに有効な値は何かを考慮する必要があります。

### 高度な変数フォーマットオプション
<a name="advanced-variable-format-options"></a>

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

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

#### 一般的な構文
<a name="general-syntax"></a>

 構文: `${var_name:option}` 

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

#### CSV
<a name="variables-csv"></a>

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

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

#### 分散 - OpenTSDB
<a name="distributed---opentsdb"></a>

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

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

#### 二重引用符
<a name="doublequote"></a>

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

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

#### Glob - Graphite
<a name="glob---graphite"></a>

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

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

#### JSON
<a name="json"></a>

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

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

#### Lucene - OpenSearch
<a name="lucene---opensearch"></a>

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

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

#### Percentencode
<a name="percentencode"></a>

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

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

#### パイプ
<a name="pipe"></a>

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

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

#### Raw
<a name="raw"></a>

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

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

#### [正規表現]
<a name="regex"></a>

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

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

#### 一重引用符
<a name="singlequote"></a>

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

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

#### Sqlstring
<a name="sqlstring"></a>

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

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

#### テキスト
<a name="text"></a>

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

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

### 複数値の変数のフォーマット
<a name="formatting-multi-value-variables"></a>

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

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

#### Graphite データソースを使用した複数値変数
<a name="multi-value-variables-with-a-graphite-data-source"></a>

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

#### Prometheus または InfluxDB データソースを使用した複数値変数
<a name="multi-value-variables-with-a-prometheus-or-influxdb-data-source"></a>

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

#### Elastic データソースを使用した複数値変数
<a name="multi-value-variables-with-an-elastic-data-source"></a>

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

#### フォーマットのトラブルシューティング
<a name="formatting-troubles"></a>

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

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

### 正規表現での変数のフィルタリング
<a name="filter-variables-with-regex"></a>

 正規表現クエリオプションを使用すると、変数クエリが返すオプションのリストをフィルタリング、または返すオプションを変更できます。

このセクションでは、正規表現を使用して変数ドロップダウンリスト内の値をフィルタリングおよび変更する方法を示します。

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

 次のオプションリストでのフィルタリングの例: 

```
backend_01
backend_02
backend_03
backend_04
```

#### `01` または `02` で終わるオプションのみが返されるようにフィルタリング
<a name="filter-so-that-only-the-options-that-end-with-01-or-02-are-returned"></a>

 [Regex] (正規表現) 

```
/.*[01|02]/
```

 結果: 

```
backend_01
backend_02
```

#### 正規表現キャプチャグループを使用してテキストの一部を返すオプションのフィルタリングおよび変更
<a name="filter-and-modify-the-options-using-a-regex-capture-group-to-return-part-of-the-text"></a>

 正規表現: 

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

 結果: 

```
01
02
```

#### フィルタリングと変更 - Prometheus 例
<a name="filter-and-modify---prometheus-example"></a>

 オプションのリスト: 

```
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
```

#### 名前付きテキストおよび値のキャプチャグループを使用したフィルタリングと変更
<a name="filter-and-modify-using-named-text-and-value-capture-groups"></a>

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

 例えば、`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="repeat-panels-or-rows"></a>

 *テンプレート変数*を使用すると動的ダッシュボードを作成できます。クエリ内のすべての変数は、クエリがデータベースに送信される前に変数の現在の値に拡張されます。変数を使用すると、すべての サービスで 1 つのダッシュボードを再利用できます。

 ダッシュボード全体でクエリを動的に変更する際は、テンプレート変数が非常に役立ちます。選択した値に基づいて Grafana で新しいパネルまたは行を動的に作成させる場合は、*繰り返し*機能を使用できます。

#### パネルの繰り返し
<a name="repeating-panels"></a>

 `Multi-value` または `Include all value` オプションがオンの変数がある場合は、1 つのパネルを選択して、Grafana に選択した値ごとにそのパネルを繰り返させることができます。*繰り返し*機能はパネル編集モードの*全般タブ*にあります。

 `direction` はパネルの配置方法を制御します。

`horizontal` を選択するとパネルは並んで配置されます。Grafana は繰り返しパネルの幅を自動的に調整して行全体がいっぱいになるようにします。現在、行上の他のパネルと繰り返しパネルを混在して使うことはできません。

 `Max per row` を設定して、行あたりの最大パネル数を Grafana に指示します。デフォルトは *4* です。

`vertical` を選択すると、パネルは列の上から下に配置されます。繰り返しパネルの幅は、繰り返される最初の繰り返しパネル (元のテンプレート) の幅と同じです。

最初のパネル (元のテンプレート) のみ変更します。すべてのパネルに変更が適用されるためには、動的ダッシュボードの再構築を開始する必要があります。このためには変数値を変更 (つまり、繰り返しの基礎)、またはダッシュボードを再ロードします。

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

#### 行の繰り返し
<a name="repeating-rows"></a>

 パネルに関して前述したように、変数に `Multi-value` または `Include all value` 選択オプションを設定している場合は、行を繰り返すこともできます。

 この機能を有効にするには、まず *[パネルの追加]* メニューを使用して新しい*行*を追加する必要があります。次に、行タイトルの上にカーソルを置いて歯車ボタンを選択し、`Row Options` 設定パネルにアクセスします。行を繰り返す変数を選択できるようになります。

 ベストプラクティスは行タイトルにも変数を使用することです。

# Grafana アラート
<a name="alerts-overview"></a>

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

Grafana アラートからは、システムの問題が発生した直後に、サービスの中断を最小限に抑えるための強力で実用的なアラートが提供されます。

Amazon Managed Grafana には最新のアラートシステム *[Grafana アラート]*が含まれており、アラート情報を一元的に管理、検索できるビューが用意されています。以下に、その機能の一部を紹介します。
+ Grafana アラートを一元的に作成および管理できるビュー。
+ Cortex と Loki 管理のアラートを作成および管理できる単一のインターフェイス。詳細については、「[アラートルールの管理](v9-alerting-managerules.md)」を参照してください。
+ Prometheus、Amazon Managed Service for Prometheus、およびその他のアラートマネージャー互換データソースからのアラート情報の表示。
+ 複数のアラートインスタンスを 1 つのアラートルールから作成。詳細については、「[1 次元ルールと多次元ルール](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule)」を参照してください。
+ アラートリソースの管理が可能な terraform またはプロビジョニング API。詳細については、「[Grafana アラートリソースのプロビジョニング](v9-alerting-setup-provision.md)」を参照してください。

既存の Amazon Managed Grafana ワークスペースの場合、デフォルトでは [従来のダッシュボードアラート](old-alerts-overview.md) が使用されます。Grafana アラートに移行するには、[Grafana アラートに移行](alert-opt-in.md)する必要があります。

Grafana アラートの詳細については、「[Grafana アラートの新機能](alerts-whats-new.md)」を参照してください。

Grafana アラートには 4 つの主要な構成要素があります。
+ [アラートルール](alert-rules.md) - アラートを発行するかどうかを判断する評価基準。1 つ以上のクエリと式、条件、評価の頻度、およびオプションとしてその条件の持続時間で構成されます。
+ [コンタクトポイント](alert-contact-points.md) - アラートルールの条件が満たされたときに通知の送信先となるチャネル。
+ [通知ポリシー](alert-notifications.md) - 通知の頻度を決定するために使用される一連の一致基準とグループ化基準。
+ [サイレンス](alert-silences.md) - 通知のサイレンスに使用される日付と一致する基準。

Grafana アラートを有効にすると、次のことができます。
+ [Grafana マネージドアラートルールを作成する](alert-rules.md#create-grafana-alert-rule)
+ [Cortex または Loki管理のアラートルールを作成する](alert-rules.md#create-alert-rule)
+ [既存のアラートルールを表示し、現在の状態を管理する](alert-rules.md#manage-alert-rules)
+ [アラートルールの状態と正常性を表示する](alert-fundamentals.md#alerts-state)
+ [アラートのコンタクトポイント (通知先) を追加または編集する](alert-contact-points.md#alert-working-contact-points)
+ [通知ポリシーを追加または編集する](alert-notifications.md#alert-notifications-working)
+ [サイレンスを追加または編集する](alert-silences.md)

## 制限事項
<a name="alert-limitations"></a>
+ Grafana アラートシステムは、利用可能なすべての Amazon Managed Service for Prometheus、Prometheus、Loki、およびアラートマネージャーデータソースからルールを取得できますが、他のサポートされているデータソースからはルールを取得できない場合があります。
+ Prometheus ではなく Grafana で定義されたアラートルールは、複数の通知をコンタクトポイントに送信します。ネイティブ Grafana アラートを使用している場合は、新しい Grafana アラート機能を有効にせず、従来のダッシュボードアラートのまま使用することをお勧めします。Prometheus データソースで定義されたアラートを表示する場合は、Grafana アラートを有効にすることをお勧めします。これにより、Prometheus アラートマネージャーで作成されたアラートの通知が 1 つだけ送信されます。
**注記**  
この制限は、Grafana v10.4 以降をサポートする Amazon Managed Grafana ワークスペースの制限ではなくなりました。

**Topics**
+ [制限事項](#alert-limitations)
+ [Grafana アラートの新機能](alerts-whats-new.md)
+ [従来のダッシュボードアラートを Grafana アラートに移行する](alert-opt-in.md)
+ [アラートの基本](alert-fundamentals.md)
+ [Grafana アラートルールの作成と管理](alert-rules.md)
+ [アラートグループ](alert-groups.md)
+ [Prometheus データソースのアラート通知のサイレンス化](alert-silences.md)
+ [コンタクトポイント (通知先) の使用](alert-contact-points.md)
+ [メッセージテンプレートの使用](alert-message-templates.md)
+ [通知ポリシーの使用](alert-notifications.md)

# Grafana アラートの新機能
<a name="alerts-whats-new"></a>

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

Grafana アラートは、従来のダッシュボードアラートよりもいくつかの機能強化が行われています。

## 多次元アラートの作成
<a name="alerts-new-dimensional"></a>

1 つのアラートルールでシステム全体の可視性を提供できるようになりました。このルールは 1 つのアラートルールから複数のアラートインスタンスが生成されます。例えば、1 つのルールで 1 台のホスト上に存在する複数のマウントポイントのディスク使用量をモニタリングするルールを作成できます。評価エンジンは 1 つのクエリから複数の時系列を返し、各時系列データはラベルセットで識別されます。

**注記**  
各アラートインスタンスは、アラートのクォータ (上限数) にカウントされます。アラートの上限数を超えるインスタンスを作成する多次元ルールは評価されず、クォータエラーが返されます。詳細については、「[クォータ到達エラー](alert-rules.md#rule-quota-reached)」を参照してください。

## ダッシュボード外のアラートの作成
<a name="alerts-new-not-dashboard"></a>

従来のダッシュボードアラートとは異なり、Grafanaのアラート機能では複数のデータソースからのデータを独自に組み合わせたクエリや式を作成できます。また、ID を使用してダッシュボードとパネルをアラートルールにリンクし、観察中のシステムのトラブルシューティングをすばやく行うことができます。

統合アラートはパネルクエリに直接関連付けられなくなるため、通知メールに画像やクエリ値は含まれませんが、カスタマイズされた通知テンプレートを使用して、クエリ値を表示できます。

## Loki および Cortex のアラートルールの作成
<a name="alerts-new-loki-cortex"></a>

Grafana アラートでは、Grafana 管理のアラートと同じ UI と API を使用して Loki および Cortex のアラートルールを管理することができます。

## Amazon Managed Service for Prometheus およびその他の Prometheus 互換データソースからのアラートの表示と検索
<a name="alerts-new-prometheus"></a>

Amazon Managed Service for Prometheus および Prometheus 互換データソースのアラートがアラートインターフェイスに一覧表示されるようになりました。これにより、複数のデータソースでラベルを検索して、関連するアラートをすばやく見つけることができます。

## 特別な (NoData、Error アラート状態) アラート
<a name="alerts-new-error"></a>

Grafana アラートは、アラートルールの評価で状態が `NoData` または `Error` のものを生成した場合、次のラベルを持つ特別なアラートを生成します。
+ `alertname` (状態によって `DatasourceNoData` または `DatasourceError` の値を持ちます)。
+ `rulename` (特別なアラートが属するアラートルールの名前を持ちます)。
+ `datasource_uid` (状態の原因となったデータソースの UID を持ちます)。
+ 元のルールのすべてのラベルと注釈。

これらのアラートは、例えば、サイレンスを追加したり、コンタクトポイントにルーティングしたりするなど、通常のアラートと同じように処理できます。

**注記**  
ルールが複数のデータソースを使用し、そのうち 1 つ以上 がデータを返さない場合、アラート状態の原因となったデータソースごとに特別なアラートが作成されます。

# 従来のダッシュボードアラートを Grafana アラートに移行する
<a name="alert-opt-in"></a>

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

既存のワークスペースや、Grafana アラートを使用しないワークスペースには、従来のダッシュボードアラートを利用します。新しい Grafana アラートに移行するには、この機能を利用することに同意する必要があります。

、、 AWS CLIまたは Amazon Managed Grafana API を使用して AWS マネジメントコンソール、Grafana アラートを使用するように Amazon Managed Grafana インスタンスを設定できます。Grafana アラートのオン/オフの切り替えなど、Amazon Managed Grafana の設定方法の詳細については、「[Amazon Managed Grafana ワークスペースを設定する](AMG-configure-workspace.md)」を参照してください。

**注記**  
Grafana アラートを使用する場合、Grafana で定義されたアラートルールは、Prometheusではなく、複数の通知をコンタクトポイント (通知先) に送信します。ネイティブ Grafana アラートを使用している場合は、新しい Grafana アラート機能を有効にせず、従来のダッシュボードアラートのまま使用することをお勧めします。Prometheus データソースで定義されたアラートを表示する場合は、Grafana アラートを有効にすることをお勧めします。これにより、Prometheus アラートマネージャーで作成されたアラートの通知が 1 つだけ送信されます。  
この制限は、Grafana v10.4 以降をサポートする Amazon Managed Grafana ワークスペースで削除されます。

## Grafana アラートシステムへの移行
<a name="alert-opt-in-migrating"></a>

Grafana アラートを有効にすると、既存の従来のダッシュボードアラートは Grafana アラートと互換性のある形式で移行されます。移行後のアラートと新しく作成したアラートは、Grafana インスタンスのアラートページに表示されます。Grafana アラートを使用した場合、Grafana が管理するアラートルールは、一致するときに 1 つのアラートではなく、複数の通知を送信します。

従来のダッシュボードアラートと Grafana アラートへの読み取りおよび書き込みアクセス権は、それらが保存されているフォルダのアクセス権限で制御されます。移行中、従来のダッシュボードアラートアクセス許可は、次のように新しいルールアクセス許可と照合されます。
+ 元のアラートが属するダッシュボードにアクセス権限が設定されている場合、移行時に元のダッシュボードの権限 (フォルダから継承された権限を含む) 設定で `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` という形式の名前のフォルダが作成されます。
+ ダッシュボードにアクセス権限が設定されておらず、ダッシュボードがフォルダ内にある場合、ルールはこのフォルダにリンクされ、そのアクセス権限が継承されます。
+ ダッシュボードにアクセス権限が設定されておらず、ダッシュボードが General (全般) フォルダにある場合、ルールは General (全般) アラートフォルダにリンクされ、ルールにはデフォルトのアクセス権限が継承されます。

**注記**  
Grafana のアラート設定には `NoData` に対する `Keep Last State` オプションがないため、このオプションは従来のルールを移行する際に `NoData` になります。`Error` 処理のためのオプション `Keep Last State` は、新しいオプション `Error` に移行されます。`Keep Last State` の動作に合わせるため、移行時には各アラートルールに対して 1 年間のサイレンスが Amazon Managed Grafana によって自動的に作成されます。

通知チャネルは、適切なルートと受信者が設定されたアラートマネージャー設定に移行されます。デフォルトの通知チャネルは、コンタクトポイントとしてデフォルトのルートに追加されますが、ダッシュボードアラートに関連付けられていない通知チャネルは `autogen-unlinked-channel-recv` ルートに送られます。

### 制限事項
<a name="alert-migration-limitations"></a>
+ Grafana アラートシステムは、利用可能なすべての Prometheus、Loki、およびアラートマネージャーデータソースからルールを取得できますが、他のサポートされているデータソースからアラートルールを取得できない場合があります。
+ Grafana アラートと従来のダッシュボードアラートを交互に移行すると、どちらか一方でのみサポートされる機能のデータが失われる可能性があります。
**注記**  
従来のダッシュボードアラートに戻した場合、Grafana アラートが有効になっている間に新たに作成されたアラートルールやアラート設定に加えられたすべての変更は失われます。

# アラートの基本
<a name="alert-fundamentals"></a>

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

このセクションでは、Grafana アラートの基本概念について説明します。

## アラートの概念
<a name="alert-fundamentals-terms"></a>

以下の表では、Grafana アラート機能の主要な概念について説明しています。


| 主要な概念または機能 | 定義 | 
| --- | --- | 
|  アラートに使用するデータソース  |  メトリクス、ログ、トレースをクエリおよび視覚化するデータソースを選択します。  | 
|  スケジューラー  |  アラートルールを評価するコンポーネントで、データソースに対して定期的にクエリを実行します。これは Grafana が管理するルールにのみ適用されます。  | 
|  アラートマネージャー  |  アラートインスタンスのルーティングとグループ化を管理します。  | 
|  アラートルール  |  アラートルールを発動させる評価基準のセット。アラートルールは、1 つ以上のクエリと式、条件、評価の頻度、その条件の持続時間で構成されます。アラートルールは、複数のアラートインスタンスを生成できます。  | 
|  アラートインスタンス  |  アラートインスタンスは、アラートルールのインスタンスです。1 次元アラートルールには 1 つのアラートインスタンスがあります。多次元アラートルールには 1 つ以上のアラートインスタンスがあります。複数の結果に一致する単一のアラートルール、たとえば 10 台の仮想マシンに対する CPU の監視は、複数 (この場合は 10) のアラートインスタンスとしてカウントされます。この数は時間の経過とともに変動する場合があります。たとえば、システム内のすべての仮想マシンの CPU 使用率を監視するアラートルールは、仮想マシンを追加するとアラートインスタンスが増加します。アラートインスタンスのクォータの詳細については、[クォータ到達エラー](alert-rules.md#rule-quota-reached) を参照してください。  | 
|  アラートグループ  |  アラートマネージャーは、ルート通知ポリシーのラベルを使用して、デフォルトでアラートインスタンスをグループ化します。これにより、コンタクトポイントに送信される重複排除とアラートインスタンスのグループが制御されます。  | 
|  コンタクトポイント  |  アラートルール発生時の通知先への通知方法を定義します。  | 
|  メッセージテンプレート  |  コンタクトポイント使用する再利用可能なカスタムテンプレートを作成します。  | 
|  通知ポリシー  |  アラートがどこで、いつ、どのようにグループ化され、コンタクトポイントにルーティングされるかを定義するルールのセット。  | 
|  ラベルとラベル照合機能  |  ラベルはアラートルールを識別するための一意な識別子です。ラベルによってアラートルールが通知ポリシーとサイレンスに紐づけられ、どのポリシーで処理されるか、どのアラートルールをサイレンス対象にするかを決定します。  | 
|  サイレンス  |  1 つ以上のアラートインスタンスからの通知を停止します。サイレンスとミュートタイミングの違いは、サイレンスは指定した時間帯の間だけ有効であるのに対し、ミュートタイミングは繰り返しのスケジュールに基づいて発生する点です。アラートインスタンスをサイレンス対象とするにはラベル照合機能を使用します。  | 
|  ミュートタイミング  |  通知を新たに生成または送信しない時間間隔を指定します。メンテナンス期間など、繰り返し発生する期間中にアラート通知を停止することができます。既存の通知ポリシーにリンクする必要があります。  | 

## アラートのデータソース
<a name="alert-sources"></a>

Grafana 管理のアラートは、アラートが有効になっている以下のバックエンドデータソースをクエリします。
+ ビルトイン、または Grafana によって開発、維持管理されているデータソース: `Alertmanager`、`Graphite`、`Prometheus` (Amazon Managed Service for Prometheus を含む)、`Loki`、`InfluxDB`、`Amazon OpenSearch Service`、`Google Cloud Monitoring`、`Amazon CloudWatch`、`Azure Monitor`、`MySQL`、`PostgreSQL`、`MSSQL`、`OpenTSDB`、`Oracle`、`Azure Monitor`。

## 数値データのアラート
<a name="alert-numeric"></a>

時系列形式でない数値データは、サーバー側の式に渡したり、直接アラートすることができます。これにより、データソース内の処理と効率が向上し、アラートルールを簡素化することができます。時系列データではなく数値データを基にアラートを送信する場合、ラベル付きの各時系列を 1 つの数値に集約する必要はありません。代わりに、ラベル付き番号が Grafana に返されます。

### 表形式のデータ
<a name="alert-tabular-data"></a>

この機能は、MySQL 、Postgres、MSSQL、Oracle などの SQL データソースを含む表形式のデータをクエリするバックエンドデータソースでサポートされています。

Grafana 管理のアラートまたはサーバー側の式を含むクエリは、これらのデータソースでは数値として扱われます。
+ データソースのクエリで `Format AS` オプションが `Table` に設定されている場合。
+ クエリから Grafana に返されたレスポンステーブルの数値列 (int、double、float など) が 1 列だけの場合 (その他文字列が返されている場合も含みます)。

文字列がある場合、それらの列はラベルになります。列の名前はラベル名になり、各行の値は対応するラベルの値になります。複数の行が返された場合、各行はラベルによって一意に識別される必要があります。

### 例
<a name="alert-tabular-example"></a>

例えば、次のような MySQL のテーブル「Diskspace」があるとします。


| 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)
```

このクエリでは、次のようなレスポンステーブルが返されます。


| ホスト | ディスク | 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="alert-alertmanager"></a>

Grafana にはビルトインで Prometheus アラートマネージャーのサポートが含まれています。アラートマネージャーはアラートルールをグループ化し管理する役割を果たし、アラートエンジンの上にオーケストレーション機能を追加します。デフォルトでは、Grafana 管理のアラートの通知は、Grafana の基本機能の一部として組み込まれているアラートマネージャーによって処理されます。アラートマネージャードロップダウンから Grafana オプションを選択することで、Grafana アラート UI からアラートマネージャーのコンタクトポイント、通知ポリシー、テンプレートを設定できます。

Grafana のアラート機能は、外部アラートマネージャー設定をサポートしています (外部データソースとしてのアラートマネージャーの詳細については、「[アラートマネージャーデータソースに接続する](data-source-alertmanager.md)」を参照してください)。外部アラートマネージャーを追加すると、アラートマネージャードロップダウンに使用可能な外部アラートマネージャーデータソースのリストが表示されます。データソースを選択して、スタンドアロンの Cortex または Loki データソースのアラートを作成および管理します。

## アラートルールの状態と正常性
<a name="alerts-state"></a>

アラートルールの状態と正常性は、アラートに関するいくつかの主要なステータスインジケータを理解するのに役立ちます。主な構成内容は、「アラートの状態」、「アラートルール状態」、「アラートルールの正常性」の 3 つです。これらは関連していますが、それぞれ異なる情報を伝達します。

**アラートルールの状態**
+ **[普通]** – 評価エンジンから返された時系列のいずれも `Pending` または `Firing` の状態でない。
+ **[保留中]**– 評価エンジンから返された時系列の少なくとも 1 つに `Pending` がある。
+ **[発動中]** — 評価エンジンから返された時系列の少なくとも 1 つに `Firing` がある。

**アラートの状態**
+ **[普通]** – 評価エンジンから返されたすべての時系列に対して、アラートルールの条件が **[偽]** である。
+ **[アラート]** – 評価エンジンから返された時系列のうち、1 つ以上のアラートルールの条件が **[真]** である。アラートが発生するために必要な、条件がである持続時間が設定されていて、その持続時間を経過した、または超えている。
+ **[保留中]** – 評価エンジンから返された時系列のうち、1 つ以上のアラートルールの条件が **[真]** である。アラートが発生するために必要な、条件がである持続時間が設定されていて、その持続時間を経過していない。
+ **[NoData]** – アラートルールが時系列を返していない、時系列のすべての値が null、または時系列のすべての値がゼロ。
+ **[エラー]** - アラートルールを評価しようとしてエラーが発生した。

**アラートルールの正常性**
+ **OK** – アラートルールの評価時にエラーがなかった。
+ **[エラー]** – アラートルールの評価時にエラーがあった。
+ **[NoData]** – ルール評価中に返された少なくとも 1 つの時系列にデータが存在しない。

# Grafana アラートルールの作成と管理
<a name="alert-rules"></a>

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

アラートルールは、アラートを発行するかどうかを判断する評価基準のセットです。アラートルールは、1 つ以上のクエリと式、条件、評価の頻度、およびオプションとしてその条件の持続時間で構成されます。

評価するデータセットを「クエリと式」で選択し、「条件」にアラートがアラートを発行するための基準 (しきい値) を設定します。間隔は、アラートルールが評価される頻度を指定します。「持続時間」を設定した場合、その条件下にある状態の継続時間を示します。また、データがない場合のアラート動作も設定できます。

以下のセクションでは、さまざまな種類の Grafana アラートルールの作成と管理について説明します。

**Topics**
+ [Cortex または Loki 管理のアラートルールの作成](#create-alert-rule)
+ [Cortex または Loki 管理のレコードルールの作成](#create-alert-recording-rule)
+ [Grafana 管理のアラートルールの作成](#create-grafana-alert-rule)
+ [アラートルールの注釈とラベル](#alert-rule-labels)
+ [アラートルールの管理](#manage-alert-rules)
+ [Cortex または Loki ルールグループと名前空間](#alert-rule-groups)

## Cortex または Loki 管理のアラートルールの作成
<a name="create-alert-rule"></a>

Grafana では、外部の Cortex または Loki インスタンスのアラートルールを作成することができます。

**注記**  
Cortex は、Amazon Managed Service for Prometheus および Prometheus データソースで使用される時系列データベースです。

**前提条件**
+ Prometheus データソースへの書き込みアクセス権限があることを確認します。アクセス権限がない場合、Cortex 管理のアラートルールを作成または更新することはできません。
+ Cortex と Loki のデータソースでそれぞれのサービスを設定して Ruler API を有効にします。
  + **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集する場合、他のストレージタイプを設定してください。
  + **Cortex** – `/prometheus` ではなく、旧式の `/api/prom` プレフィックスを使用します。Prometheus データソースは Cortex と Prometheus の両方に対応しており、Grafana はクエリ API と Ruler API の両方が同じ URL にあることを期待しています。Ruler API に別の URL を指定することはできません。

**注記**  
特定の Loki または Prometheus データソースのアラートルールを管理しない場合は、その設定に移動し、**[アラート UI 経由でアラートを管理する]** チェックボックスをオフにします。

**Cortex または Loki 管理のアラートルールの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[新しいアラートルール]** を選択します。

1. **ステップ 1** で、以下を参照してルール名、タイプ、ストレージの場所を追加します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[ルールタイプ]** ドロップダウンから、**[Cortex/Loki 管理アラート]**を選択します。
   + **[データソース]の選択**ドロップダウンから、Prometheus または Loki データソースを選択します。
   + **[名前空間]** ドロップダウンから、既存のルール名前空間を選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。詳細については、「[Cortex または Loki ルールグループと名前空間](#alert-rule-groups)」を参照してください。
   + **[グループ]** ドロップダウンから、選択した名前空間内の既存のグループを選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。

1. **ステップ 2** で、評価するクエリを追加します。

   値は PromQL または LogQL 式で指定することができます。評価結果に 0 より大きい値を持つシリーズが 1 つ以上ある場合、ルールはアラートを発行します。アラートはシリーズごとに作成されます。

1. **ステップ 3** で、条件を追加します。

   条件の [For] テキストボックスに、アラートが発行されるために必要な条件の継続時間を指定します。例えば `5m` を指定した場合、条件が 5 分間継続した場合にアラートが発行されます。
**注記**  
条件が満たされると、アラートは `Pending` 状態に入り、そのまま指定された期間条件が継続するとアラートは `Firing` 状態に移行します。条件から外れた場合、`Normal` 状態に戻ります。

1. **ステップ 4** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[アラートルールの注釈とラベル](#alert-rule-labels)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[アラートのプレビュー]** を選択してルールを評価し、生成されるアラートを確認します。各アラートの状態と値を含むアラートのリストが表示されます。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

## Cortex または Loki 管理のレコードルールの作成
<a name="create-alert-recording-rule"></a>

外部 Cortex または Loki インスタンスのレコードルールを作成および管理することができます。記録ルールは、頻繁に必要になる式や計算負荷の高い式を事前に計算し、その結果を新しい時系列セットとして保存します。この新しい時系列のクエリは、特にダッシュボードでは、ダッシュボードが更新されるたびに同じ式をクエリするため、より高速になります。

**前提条件**

Cortex と Loki のデータソースでそれぞれのサービスを設定して Ruler API を有効にします。
+ **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集する場合、他のストレージタイプを設定してください。
+ **Cortex** – Cortex を指すように Grafana Prometheus データソースを設定するときは、`/prometheus` ではなく旧式の `/api/prom` プレフィックスを使用します。Prometheus データソースは Cortex と Prometheus の両方に対応しており、Grafana はクエリ API と Ruler API の両方が同じ URL にあることを期待しています。Ruler API に別の URL を指定することはできません。

**注記**  
特定の Loki または Prometheus データソースのアラートルールを管理しない場合は、その設定に移動し、**[アラート UI 経由でアラートを管理する]** チェックボックスをオフにします。

**Cortex または Loki 管理のレコードルールの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[新しいアラートルール]** を選択します。

1. **ステップ 1** で、以下を参照してルール名、タイプ、ストレージの場所を追加します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[ルールタイプ]** ドロップダウンから、**[Cortex/Loki 管理アラート]**を選択します。
   + **[データソース]の選択**ドロップダウンから、Prometheus または Loki データソースを選択します。
   + **[名前空間]** ドロップダウンから、既存のルール名前空間を選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。詳細については、「[Cortex または Loki ルールグループと名前空間](#alert-rule-groups)」を参照してください。
   + **[グループ]** ドロップダウンから、選択した名前空間内の既存のグループを選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。

1. **ステップ 2** で、評価するクエリを追加します。

   値は PromQL または LogQL 式で指定することができます。評価結果に 0 より大きい値を持つシリーズが 1 つ以上ある場合、ルールはアラートを発行します。アラートはシリーズごとに作成されます。

1. **ステップ 3** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[アラートルールの注釈とラベル](#alert-rule-labels)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

## Grafana 管理のアラートルールの作成
<a name="create-grafana-alert-rule"></a>

Grafana では、1 つ以上のデータソースをクエリして結果を集約または変換して、それらを相互に比較したり、固定のしきい値と比較したりするアラートルールを作成することができます。これらが処理された場合、Grafana はコンタクトポイント (通知先) に通知を送信します。

**注記**  
Grafana アラートの使用中に Grafana 管理のアラートルールを作成すると、ルールが一致した際に複数の通知が送信されます。一部のコンタクトポイントとなるプロバイダーには、重複した通知を避けるための設定可能なオプションがある場合があります。

**Grafana 管理のルールの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[新しいアラートルール]** を選択します。

1. **ステップ 1** で、以下を参照してルール名、タイプ、ストレージの場所を追加します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[ルールタイプ]** ドロップダウンから、**[Grafana 管理のアラート]** を選択します。
   + **[フォルダ]** ドロップダウンから、ルールの保存先となるフォルダを選択します。フォルダを選択しない場合、ルールは `General` フォルダに保存されます。フォルダを作成する場合、ドロップダウンを選択し、新しいフォルダ名を入力します。

1. **ステップ 2** で、評価するクエリと式を追加します。
   + 名前はデフォルトのままでも構いませんが、変更する場合、カーソルを合わせて編集アイコンを選択します。
   + クエリの場合、ドロップダウンからデータソースを選択します。
   + 1 つ以上の[クエリ](panel-queries.md)または式を追加します (式の詳細については、*Grafana ドキュメント*の「[式](https://grafana.com/docs/grafana/next/panels/query-a-data-source/)」を参照してください)。
   + 式ごとに **[クラシック条件]**を選択して単一のアラートルールを作成するか、**[Math]**、**[削減]**、**[リサンプリング]** オプションから選択して、各シリーズに個別のアラートを作成します。これらのオプションの詳細については、「[1 次元ルールと多次元ルール](#single-multi-rule)」を参照してください。
   + **[Run queries]** (クエリの実行) を選択して、クエリが正しく動作すことを確認します。

1. **ステップ 3** で、条件を追加します。
   + **[条件]** ドロップダウンから、アラートルールを発動させるクエリまたは式を選択します。
   + **Evaluate every** (～ごとに評価する) には、評価の頻度を指定します。10 秒の倍数である必要があります。例えば、`1m` や `30s` などです。
   + **[評価対象]** には、アラートが発行されるために必要な条件の継続時間を指定します。
**注記**  
条件が違反すると、アラートは `Pending` 状態に入り、そのまま指定された期間条件の違反が継続するとアラートは `Firing` 状態に移行します。条件から外れた場合、`Normal` 状態に戻ります。
   + **[Configure no data and error handling]** (データがない場合の設定とエラー処理) で、データがない場合のアラート動作を設定します。「[データがない場合やエラーが発生した場合の対処](#rule-no-data-error)」のガイドラインを参照してください。
   + **[アラートのプレビュー]** を選択してルールを評価し、生成されるアラートを確認します。プレビューでは、データとエラー処理条件は除外されます。

1. **ステップ 4** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[アラートルールの注釈とラベル](#alert-rule-labels)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

### 1 次元ルールと多次元ルール
<a name="single-multi-rule"></a>

Grafana 管理のアラートルールでは、従来の条件を使用してルールを作成することも、多次元ルールを作成することもできます。

**1 次元ルール (従来の条件)**

従来の条件式を使用して、条件が満たされたときに単一のアラートを発行するルールを作成します。複数のシリーズを返すクエリの場合、Grafana は各シリーズのアラート状態を追跡しません。そのため、複数のシリーズでアラート条件が満たされた場合でも、Grafana が送信するアラートは 1 件のみです。

式のフォーマット方法の詳細については、*Grafana ドキュメント*の「[式](https://grafana.com/docs/grafana/next/panels/query-a-data-source/)」を参照してください。

**多次元ルール**

クエリで返されるシリーズごとに個別のアラートインスタンスを生成するには、多次元ルールを作成します。

**注記**  
多次元ルールによって生成された各アラートインスタンスは、アラートの合計クォータにカウントされます。クォータに達すると、ルールは評価されなくなります。多次元ルールのクォータの詳細については、「[クォータ到達エラー](#rule-quota-reached)」を参照してください。

1 つのルールから複数のインスタンスを作成するには、`Math`、`Reduce`、または `Resample` 式を使用して多次元ルールを作成します。例えば、以下のことが可能です:
+ 各クエリに `Reduce` 式を追加すると、選択した時間範囲の値が 1 つの値に集計されます。([数値データ を使用するルール](alert-fundamentals.md#alert-numeric)には必要ありません)。
+ ルールの条件を含む `Math` 式を追加します。もしクエリや reduce 式がすでにアラートを発行すべき場合は正の数、発行しない場合に 0 を返す場合、これは必要ありません。

  例: 
  + `$B > 70` は、B クエリ/式の値が 70 を超える場合にアラートを発行します。
  + `$B < $C * 100` は、B の値が C の値に 100 を掛けた値より小さい場合にアラートを発行します。比較対象のクエリの結果に複数のシリーズがある場合、異なるクエリのシリーズが同じラベルを持っているか、一方が他方のサブセットである場合に一致します。

**注記**  
Grafana は、テンプレート変数を使用したアラートクエリはサポートしていません。詳細については、コミュニティページ「[アラートクエリではアラート設定時にテンプレート変数を使用できません](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514)」を参照してください。



**多次元ルールのパフォーマンスに関する考慮事項**

各アラートインスタンスは、アラートのクォータ (上限数) にカウントされます。アラートの上限数を超えるインスタンスを作成する多次元ルールは評価されず、クォータエラーが返されます。詳細については、「[クォータ到達エラー](#rule-quota-reached)」を参照してください。

多次元アラートは、Grafana ワークスペースや、Grafana がアラートルールを評価するためにクエリを実行するデータソースのパフォーマンスに大きな影響を与える可能性があります。監視システムのパフォーマンスを最適化したい場合、以下の考慮事項を参照してください。
+ **ルール評価の頻度** – アラートルールの **[Evaluate Every]** (～ごとに評価する) プロパティでルール評価の頻度を制御します。評価の頻度を許容可能な最小頻度に収めることをお勧めします。
+ **結果セットのカーディナリティ** – ルールで作成されるアラートインスタンスの数は直接そのパフォーマンスに影響します。例えば、すべての仮想マシン上の各 API パスごとに API 応答エラーを監視しているとします。このセットのカーディナリティは「パスの数 × 仮想マシンの数」になります。例えば、仮想マシンあたりのパスごとではなく、仮想マシンあたりの合計エラー数を監視することで、結果セットのカーディナリティを減らすことができます。
+ **クエリの複雑さ** – データソースが迅速に処理して応答できるクエリにするだけで、リソースの消費を大幅に抑えることができます。これは他の考慮事項よりは重要度が低いものの、他の点での最適化が十分に行われている場合、個別のクエリパフォーマンスの見直しが役立つ可能性があります。また、これらのルールの評価がデータソースに与える影響にも注意する必要があります。アラートクエリは、監視データベースで処理されるクエリの大部分を占めることが多いため、Grafana インスタンスにかかる負荷要因がデータソースにも同様に影響を与えます。

### クォータ到達エラー
<a name="rule-quota-reached"></a>

1 つのワークスペース内に保持できるアラートインスタンスの数にはクォータ (上限) があります。この上限に達した場合、そのワークスペースにこれ以上新たにアラートルールを作成できなくなります。多次元アラートでは、アラートインスタンスの数は時間の経過とともに変動する場合があります。

以下に、アラートインスタンスを使用する際に覚えておくべき重要な点について紹介します。
+ 作成するのが 1 次元ルールのみの場合、ルールからはそれぞれ 1 つのアラートインスタンスが作成されます。1 つのワークスペースに作成できるルールの上限は、アラートインスタンスのクォータ数までとなります。
+ 多次元ルールからは複数のアラートインスタンスが作成されますが、その数は評価されるまでわかりません。例えば、Amazon EC2 インスタンスの CPU 使用率を追跡するアラートルールを作成した場合、最初は 50 台の EC2 インスタンスが対象となり、50 個のアラートインスタンスが作成されますが、1 週間後にさらに 10 台の EC2 インスタンスが追加された場合、次の評価時には 60 個のアラートインスタンスが存在することになります。

  アラートインスタンスの数は、多次元アラートを作成するときに評価され、アラートインスタンスのクォータをすぐに超えるインスタンスを作成することはできません。アラートインスタンスの数は変動する可能性があるため、ルール評価の都度クォータがチェックされます。
+ 評価時に、ルールがアラートインスタンスのクォータを超える場合、アラートルールが更新されアラートインスタンスの合計数がサービスクォータを下回るまで、そのルールは評価されません。この場合、クォータに達したことを通知するアラート通知を受け取ります (通知は評価対象のルールの通知ポリシーを基に送信されます)。通知には、`QuotaReachedError` 値を含む `Error` 注釈が含まれています。
+ `QuotaReachedError` を引き起こすルールは、評価されなくなります。評価は、更新が行われ、更新後の評価が `QuotaReachedError` を引き起こさなくなった場合にのみ再開されます。評価されていないルールは、Grafana コンソールに**クォータ到達**エラーが表示されます。
+ アラートインスタンスの数を減らすには、アラートルールを削除するか、複数次元のアラートを編集してアラートインスタンスを減らします (例えば、仮想マシン内の API ごとに 1 個のアラートではなく、仮想マシンごとの 1 件のエラーに対して 1 個のアラートを持つようにします)。
+ 評価を再開するには、アラートを更新して保存します。アラートインスタンスの数を減らすように更新することもできますし、インスタンス数を減らすために他の変更を加えた場合、変更なしで保存しても構いません。再開可能な場合、評価が再開されます。さらに別の `QuotaReachedError` を引き起こす結果となった場合、保存することはできません。
+ アラートが保存され、アラートクォータを超えることなく評価が再開された場合、Grafana コンソールにはしばらくの間**クォータ到達**エラーが (次の評価間隔まで) 表示され続けることがありますが、アラートルール評価が開始され、ルールのしきい値に達するとアラートが送信されます。
+ アラートのクォータおよびその他のクォータの詳細については、「[Amazon Managed Grafana のサービスクォータ](AMG_quotas.md)」を参照してください。

### データがない場合やエラーが発生した場合の対処
<a name="rule-no-data-error"></a>

データがない場合やエラーが発生した場合のアラート動作の処理方法を選択します。

データがない場合に選択できる処理方法を、以下の表に照会します。


| データがない場合の選択肢 | 行動 | 
| --- | --- | 
|  データなし  |  アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用したアラート `DatasourceNoData` を作成します。  | 
|  [アラート]  |  アラートルールの状態を `Alerting` に設定します。  | 
|  OK  |  アラートルールの状態を `Normal` に設定します。  | 

エラーが発生した場合に選択できる処理方法を、以下の表に照会します。


| エラーまたはタイムアウト時の選択肢 | 行動 | 
| --- | --- | 
|  [アラート]  |  アラートルールの状態を `Alerting` に設定します  | 
|  OK  |  アラートルールの状態を `Normal` に設定します  | 
|  エラー  |  アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用したアラート `DatasourceError` を作成します。  | 

## アラートルールの注釈とラベル
<a name="alert-rule-labels"></a>

注釈とラベルは、アラートルール、データソースのレスポンス、およびアラートルール評価の結果として発生するアラートに関連付けられたキーと値のペアです。これらは、アラート通知の内容として直接使用することも、[テンプレート](alert-message-templates.md)や[テンプレート関数](alert-message-templates.md#alert-template-functions)で使用して、通知内容を動的に作成することもできます。

**注釈**

注釈は、アラートに関する追加情報を提供するキーと値のペアです。`description`、`summary`、`runbook_url`、`alertId`、`dashboardUid`、`panelId` の注釈を使用できます。これらは UI のルールとアラートの詳細に表示され、コンタクトポイントのメッセージテンプレートで使用できます。

**ラベル**

ラベルは、アラートに関する情報を含むキーと値のペアです。アラートのラベルセットは、アラート評価および通知プロセス全体で生成および追加されます。これらは以下の方法で使用されます。
+ アラートの完全なラベルセットを使用することで、Grafana Alerts 内でそのアラートが一意に識別されます。
+ アラートマネージャーはラベルを使用して、[[通知ポリシー]](alert-notifications.md)の[[サイレンス]](alert-silences.md)と[[アラートグループ]](alert-groups.md)のアラートを照合します。
+ アラート UI には、そのルールの評価によって生成されたすべてのアラートインスタンスのラベルが表示されます。
+ コンタクトポイントには、通知を生成する際にラベルにアクセスして、そのアラートに固有の情報を含めることができます。
+ ラベルは[アラートルール](#alert-rules) に追加できます。これらの手動で設定されたラベルは、テンプレート関数を使用したり、他のラベルを参照することができます。ここでアラートルールに追加されたラベルは、ラベル間で衝突が発生した場合に優先されます。

以下に、注釈とラベルを展開する際に使用できる変数を紹介します。


| 名前 | 説明 | 
| --- | --- | 
|  `$labels`  |  クエリまたは条件からのラベル。例えば、`{{ $labels.instance }}` と `{{ $labels.job }}` です。これは、ルールが従来の条件を使用している場合には使用できません。  | 
|  `$values`  |  このアラートルールで評価されたすべての reduce と math 式の値。たとえば、`{{ $values.A }}`、`{{ $values.A.Labels }}`、`{{ $values.A.Value }}` などです。式の `refID` は、`A` にあたります。これは、ルールが従来の条件を使用している場合には使用できません。  | 
|  `$value`  |  アラートインスタンスの値の文字列。例えば、`[ var='A' labels={instance=foo} value=10 ]`。  | 

## アラートルールの管理
<a name="manage-alert-rules"></a>



**[アラート]** ページには、アラートルールが一覧表示されます。デフォルトでは、ルールはデータソースの種類ごとにグループ化されます。**Grafana** セクションには Grafana によって管理されるルールが一覧表示され、**Cortex/Loki** セクションには Prometheus 互換データソースのルールが一覧表示されます。Prometheus 互換データソースのアラートルールは表示できますが、編集することはできません。

### アラートルールの表示
<a name="manage-alerts-view"></a>

Grafana アラートを使用すると、すべてのアラートを 1 ページに表示できます。

**アラートの詳細を表示するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。デフォルトでは、ルールはデータソースの種類ごとにグループ化して表示されます。各アラートの現在の状態別に表示することもできます (詳細については後述します)。

1. **[表示形式]** では、グループビューと状態ビューを切り替えることができます。

1. 行の横にある矢印を選択すると、その行の詳細が表示されます。ルールの詳細には、ルールのラベル、注釈、データソース、クエリ、およびルールから生成されたアラートインスタンスのリストが含まれます。

**グループビュー**

グループビューには、フォルダ別にグループ化された Grafana アラートルールと、`namespace` \$1 `group` 別にグループ化された Loki または Prometheus アラートルールが表示されます。これは、ルールの管理を目的としたデフォルトのルールリストビューです。各グループを展開すると、そのグループ内のルールのリストが表示されます。さらにルールを展開すると、その詳細を見ることができます。また、ルールから生成されたアクションボタンとアラートを展開して、詳細を表示することもできます。

**状態ビュー**

状態ビューには、アラートルールが状態ごとグループ化されて表示されます。このビューを使用すると、各ルールがどの状態にあるかを一目で確認できます。各ルールは展開して詳細を表示することがでます。アクションボタンとこのルールによって生成されたアラート、および各アラートをさらに展開して詳細を表示することができます。

**アラートルールのフィルター**

**[アラート]** ページに表示されるアラートルールは、いくつかの方法でフィルタリングできます。
+ 特定のデータソースを使用するルールだけを表示するには **[データソースの選択]** でフィルタリングするデータソースを選択します。
+ また、**[ラベルで検索]** から検索条件を選択して、ラベルでフィルタリングすることもできます。例えば、`environment=production`、`region=~US|EU`、`severity!=warning` などの条件で検索できます。
+ 特定の状態のルールだけを表示するには **[状態でアラートをフィルタリング]** で表示する状態を選択します。

### アラートルールの編集または削除
<a name="manage-alerts-edit"></a>

Grafana管理のアラートルールの編集または削除は、ルールが保存されているフォルダに対する編集権限を持つユーザーのみが行うことができます。外部 Cortex または Loki インスタンスのアラートルールの編集または削除は、エディタまたは管理者ロールを持つユーザーが行うことができます。

**ルールを編集または削除するには**

1. **表示**、**編集**、**削除**のルールコントロールが表示されるまでルールを展開します。

1. **[編集]** を選択してルールの作成ページを開きます。更新方法はルール作成方法と同じです。詳細については、「[Grafana 管理のアラートルールの作成](#create-grafana-alert-rule)」または「[Cortex または Loki 管理のアラートルールの作成](#create-alert-rule)」の手順を参照してください。

1. 削除する場合は [**削除**] を選択してルールを削除します。

## Cortex または Loki ルールグループと名前空間
<a name="alert-rule-groups"></a>

ルールは整理することができます。ルールはルールグループ内に作成され、ルールグループは名前空間に整理されます。ルールグループ内のルールは、一定の間隔で順次実行されます。デフォルトの間隔は 1 分です。また、Cortex または Loki の名前空間とルールグループの名前を変更したり、ルールグループの評価間隔を編集することができます。

**ルールグループまたは名前空間の編集方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. 編集するルールグループまたは名前空間内のルールに移動します。

1. **[編集]** (ペン) アイコンを選択します。

1. ルールグループまたは名前空間に変更を加えます。
**注記**  
名前空間では、名前のみを編集できます。ルールグループの場合、名前、またはグループ内のルールの評価間隔を変更します。たとえば、ルールを 1 分ごとに評価する場合は `1m` を選択し、30 秒ごとに評価する場合は `30s` を選択します。

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

# アラートグループ
<a name="alert-groups"></a>

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

アラートグループは、アラートマネージャーインスタンスからのグループ化されたアラートを表示します。デフォルトでは、アラートは [通知ポリシーの使用](alert-notifications.md) のルートポリシーのラベルキーでグループ化されます。共通のアラートを 1 つのアラートグループにグループ化することで、重複したアラートが発生することを防ぎます。

**アラートグループの表示方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択し、**[アラートグループ化]** 項目を選択すると、現在設定されているグループの一覧が表示されるページが開きます。

1. **[アラートマネージャー]** ドロップダウンから、データソースとして外部アラートマネージャーを選択します。デフォルトでは、`Grafana` アラートマネージャーが選択されています。

1. **[カスタムグループ化対象]** ドロップダウンから、グループ化を表示するラベルの組み合わせを選択します。このビューを使用して、通知ポリシーのグループ化をデバッグしたり検証することができます。

ルートポリシーのグループ化またはカスタムグループ化で指定されたラベルのないアラートは、`No grouping` のヘッダーのグループに追加されます。

**アラートのフィルタリング**

アラートは、次のフィルターを使用して、特定の条件に一致するものだけを表示することができます。
+ **[ラベルで検索]** – **[検索]** に既存のラベルを入力すると、ラベルに一致するアラートが表示されます。例えば、`environment=production`、`region=~US|EU`、`severity!=warning` などです。
+ **[状態別にアラートをフィルタ]** – **[状態]**] で、`Active`、`Suppressed`、`Unprocessed` のいずれかを選択すると、その状態のアラートが表示されます。

# Prometheus データソースのアラート通知のサイレンス化
<a name="alert-silences"></a>

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

外部のアラートマネージャーデータソース (Amazon Managed Service for Prometheus を含む) では、*[サイレンス]*機能を使用してアラート通知を停止できます。サイレンスは通知の作成を停止するだけで、アラートルールの評価やユーザーインターフェースへのアラートインスタンスの表示は引き続き行われます。アラートをサイレンスにする場合、停止する時間枠を指定します。

外部アラートマネージャーデータソースのサイレンスを設定できます。

**注記**  
アラート通知を一定の時間間隔 (定期的なメンテナンス期間中など) で停止するには、サイレンスではなく [ミュートタイミング](alert-notifications.md#alert-notification-muting) を使用します。

**サイレンスの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. [**サイレンス**] を選択するとページが開き、既存の[コンタクトポイント](alert-contact-points.md)が一覧表示されます。

1. **[アラートマネージャー]** ドロップダウンから外部アラートマネージャーを選択します。

1. **[新規サイレンス]** を選択します。

1. **[サイレンスの開始と終了]** でサイレンスを有効にする開始日と終了日を選択します。

   終了時刻を設定する代わりに、**[期間]** でサイレンスが適用される期間を指定します。この方法を使用すると、**[サイレンスの開始と終了]** フィールドの終了時刻が自動的に更新されます。

1. **[名前]** および **[値]** のフィールドには、1 つ以上の*一致するラベル*を入力します。照合機能により、どのルールにサイレンスを適用するかが決定されます。ラベルの照合については、この手順の後に詳しく説明します。

1. 必要に応じて、**コメント**を追加したり、**作成者**を変更してサイレンスの所有者を設定することができます。

**アラート停止のラベル一致**

サイレンスの作成時に、サイレンスの一部として*一致するラベル*のセットを作成します。これは、アラートが停止されるために一致する必要があるラベルに関するルールのセットです。一致するラベルは、次の 3 つの部分で構成されます。
+ **ラベル** – 一致させるラベルの名前。アラートのラベル名と完全に一致する必要があります。
+ **[演算子]** – ラベル値と一致するラベル値の比較に使用される演算子。利用できる演算子は次のとおりです。
  + `=` 値が指定された文字列と完全に一致するラベルが選択されます。
  + `!=` 値が指定された文字列と一致しないラベルが選択されます。
  + `=~` 指定された文字列の正規表現解釈値と一致するラベルが選択されます (指定された文字列は正規表現として解釈されます)
  + `!=` 指定された正規表現と一致しないラベルが選択されます。
+ **[値])** – ラベル値と一致する値。選択した演算子に応じて、文字列または正規表現として照合させることができます。

サイレンスは指定された終了日に終了しますが、いつでも手動で停止状態を解除することができます。

**サイレンスを手動で終了する方法**

1. **[アラート]** ページで、**[サイレンス]** を選択して既存のサイレンスのリストを表示します。

1. 終了するサイレンスを選択し、**[サイレンス解除]** を選択します。この操作によりアラートの停止状態は終了します。
**注記**  
サイレンス解除を行うと、終了時刻が現在の時刻に設定されたものとして、アラートの停止状態が終了します。（自動または手動を問わず）終了したサイレンスは5 日間保持され、一覧表示されます。リストからサイレンスを手動で削除することはできません。

**サイレンス作成フォームへのリンクの作成**

詳細が既に入力されているサイレンス作成フォームへの URL を作成できます。オペレータはこれを使用して、運用上のイベントを行う際にアラームをすばやく停止することができます。

サイレンスフォームへのリンクを作成するときは、`matchers` クエリパラメータを使用して一致するラベルを指定し、`comment` クエリパラメータを使用してコメントを指定します。`matchers` パラメータには、カンマで区切られた `[label][operator][value]` 形式の 1 つ以上の値が必要です。

**URL の例**

ラベル `severity=critical` と `cluster!~europe-.*` が一致し、`Silencing critical EU alerts` というコメントが付いたサイレンスフォームにリンクするには、次のような URL を使用します。*mygrafana* を Grafana インスタンスのホスト名に置き換えてください。

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

外部アラートマネージャーの新しいサイレンスページにリンクする場合、アラートマネージャーデータソース名を含む `alertmanager` クエリパラメータを追加します (例: `alertmanager=myAlertmanagerdatasource`)。

# コンタクトポイント (通知先) の使用
<a name="alert-contact-points"></a>

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

連絡窓口は、アラート発生時の通知の受け取り方の設定に使用します。コンタクトポイントには、Amazon Simple Notification Service や Slack など、1 つ以上の通知方法を指定できます。アラートが発生すると、コンタクトポイントにリストされているすべての連絡窓口タイプに通知が送信されます。必要に応じて、[メッセージテンプレートの使用](alert-message-templates.md) を使用して通知メッセージをカスタマイズすることができます。

**注記**  
Grafana で管理されるアラートの通知先 (コンタクトポイント) は、作成および編集が可能です。アラートマネージャーアラートの通知先 (コンタクトポイント) は読み取り専用です。

## コンタクトポイント (通知先) の使用
<a name="alert-working-contact-points"></a>

次の手順では、通知先 (コンタクトポイント) を追加、編集、テスト、削除する方法について説明します。

**コンタクトポイントの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[コンタクトポイント]**を選択し、**[新しいコンタクトポイント]**を選択します。

1. **[アラートマネージャー]** ドロップダウンから、アラートマネージャーを選択します。デフォルトでは、Grafana アラートマネージャーが選択されています。

1. コンタクトポイントの** [名前]** を入力します。

1. **[コンタクトポイントタイプ]** から、タイプを選択し、そのタイプの必須フィールドを選択します。例えば、Slack を選択した場合は、Slack チャネルと通知先となるユーザーを入力します。

1. 選択したコンタクトポイントで利用可能な場合は、**オプションの設定**を選択して追加の設定を指定します。

1. **[通知設定]**で**[解決済みメッセージの無効化]**を選択すると、アラートが解決した際に通知を受け取らないようにすることができます (任意)。

1. コンタクトポイントにコンタクトポイントタイプを追加したい場合は、**新しいコンタクトポイントタイプ**を選択し、必要なコンタクトポイントタイプごとに同じ手順を繰り返します。

1. **[コンタクトポイントの保存]** を選択して変更を保存します。

**コンタクトポイントの編集方法**

1. **[コンタクトポイント]**を選択すると、現在設定されているコンタクトポイントのリストが表示されます。

1. 編集する連絡先を選択し、**[編集]** アイコン (ペン) を選択します。

1. 必要な変更を加え、**[コンタクトポイントの保存]** を選択して変更を保存します。

コンタクトポイントを作成したら、テスト通知を送信して、正しく設定されていることを確認します。

**テスト通知の送信方法**

1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。

1. テストする連絡先を選択し、**[編集]** アイコン (ペン) を選択します。

1. **[テスト]** アイコン (紙飛行機) を選択します。

1. 事前定義されたテスト通知を送信するか、**[カスタム]** を選択してテスト通知に独自の注釈とラベルを追加するかを選択します。

1. **[テスト通知を送信]**を選択して、指定されたコンタクトポイント宛にアラートをテストします。

使用されていないコンタクトポイントは、通知ポリシーで削除できます。

**連絡先の削除方法**

1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。

1. 削除する連絡先を選択し、**[削除]** アイコン (ゴミ箱) を選択します。

1. 確認ダイアログボックスで、**[はい、削除]** を選択します。

**注記**  
コンタクトポイントが通知ポリシーで使用されている場合、コンタクトポイントを削除する前に、通知ポリシーを削除するか、別のコンタクトポイントを使用するように編集する必要があります。

## サポートされている通知方法の一覧
<a name="alert-supported-notifiers"></a>


|  名前  |  タイプ  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| Pager Duty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# メッセージテンプレートの使用
<a name="alert-message-templates"></a>

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

[コンタクトポイント (通知先) の使用](alert-contact-points.md) 経由で送信される通知は、*メッセージングテンプレート*を使用して構築されます。Grafana のデフォルトテンプレートは [Go テンプレートシステム](https://golang.org/pkg/text/template)に基づいており、一部のフィールドはテキストとして評価され、他のフィールドは HTML (エスケープに影響する可能性があります) として評価されます。

コンタクトポイントに使用するほとんどのフィールドはテンプレート化できるため、再利用可能なカスタムテンプレートを作成し、複数のコンタクトポイントで使用すると良いでしょう。この [テンプレートのデータ](#alert-template-data) トピックでは、テンプレートに使用できる変数一覧を紹介します。

**テンプレートの使用**

テンプレートはメッセージを作成するために使用されます。例えば、Slack のアラートメッセージでは、コンタクトポイントにタイトルと本文を設定することができます。次の例では、デフォルトのテンプレートを使用して、発行されたアラートの件数と解決済みのアラートの件数を含むタイトルと、アラートとそのステータスを一覧表示する本文を作成する方法を紹介します。
+ **タイトル**:

  ```
  {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
  ```
+ **本文テキスト**: 

  ```
  {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
  {{end }}
  ```

カスタムテンプレートは次のように作成します。
+ **タイトル**:

  ```
  {{ template "slack.default.title" .}}
  ```
+ **本文テキスト**: 

  ```
  {{ template "mymessage" .}}
  ```

以下はサンプルテンプレートです。

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

以下に、カスタムメッセージテンプレートを作成、編集、削除する手順を紹介します。

**メッセージテンプレートの作成方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[コンタクトポイント]** を選択します。

1. **[アラートマネージャー]** ドロップダウンから、メッセージテンプレートを作成するアラートマネージャーインスタンスを選択します。デフォルトは Grafana アラートマネージャーです。

1. **テンプレートを追加**を選択します。

1. わかりやすい**名前**を付けます。

1. テンプレートの**内容**を追加します。例:

   ```
   {{ define "mymessage" }}
     {{ range .Alerts }}
       [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
     {{ end }}
   {{ end }}
   ```

   コンテンツセクションの `define` タグは、テンプレート名を割り当てます。このタグはオプションです。省略した場合、テンプレート名は**名前**フィールドから取得されます。両方を指定する場合、一致させておくことが推奨されます。

1. **[テンプレートを保存]** を選択します。

**注記**  
アラートメッセージテンプレートの HTML はテキストとして表示され、制御文字はエスケープされます。Grafana では、通知での HTML 形式の表示はサポートされていません。

**メッセージテンプレートを編集するには**

1. **アラート**ページで、**[コンタクトポイント]**を選択してコンタクトポイントのリストを開きます。

1. **テンプレートテーブル**の編集するテンプレートで**編集**アイコン (ペン) を選択します。

1. 変更後、[**テンプレートを保存**] を選択します。

**メッセージテンプレートを削除するには**

1. **アラート**ページで、**[コンタクトポイント]**を選択してコンタクトポイントのリストを開きます。

1. **テンプレートテーブル**の削除するテンプレートで**削除**アイコン (ゴミ箱) を選択します。

1. [**はい、削除します**] を選択してテンプレートを削除します。

**テンプレートのネスト**

テンプレートは他のテンプレートに埋め込むことができます。

例えば、`define` キーワードを使用してテンプレートの一部を定義することができます。

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

その後、 `template` キーワードを使用して、このフラグメント内にカスタムテンプレートを埋め込むことができます。例えば、次のようになります。

```
Alert summary:
{{ template "mytemplate" . }}
```

以下のビルトインのテンプレートオプションを使用して、カスタムテンプレートを埋め込むことができます。


| 名前 | 注意事項 | 
| --- | --- | 
|  `default.title`  |  全体的なステータス情報を表示します。  | 
|  `default.message`  |  発生中および解決済みのアラートの概要をフォーマット付きで提供します。  | 

**カスタムテンプレートの例**

以下にカスタムテンプレートの使用方法の例を紹介します。

単一のアラートを表示するテンプレート:

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

通知メッセージ全体を表示するテンプレート:

```
{{ define "mymessage" }}
  {{ if gt (len .Alerts.Firing) 0 }}
    {{ len .Alerts.Firing }} firing:
    {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
  {{ end }}
  {{ if gt (len .Alerts.Resolved) 0 }}
    {{ len .Alerts.Resolved }} resolved:
    {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
  {{ end }}
{{ end }}
```

## テンプレートのデータ
<a name="alert-template-data"></a>

メッセージテンプレートには、次のデータが渡されます。


| 名前 | 型 | 注意事項 | 
| --- | --- | --- | 
|  `Receiver`  |  string  |  コンタクトポイント (通知先) の名前。  | 
|  `Status`  |  string  |  少なくとも 1 つのアラートが発生している場合は「発生中」となり、それ以外の場合「解決済」となります。  | 
|  `Alerts`  |  アラート  |  この通知に含まれるアラートオブジェクトのリスト (以下を参照)。  | 
|  `GroupLabels`  |  KeyValue  |  これらのアラートがグループ化されたラベル。  | 
|  `CommonLabels`  |  KeyValue  |  この通知に含まれるすべてのアラートに共通のラベル。  | 
|  `CommonAnnotations`  |  KeyValue  |  この通知に含まれるすべてのアラートに共通する注釈。  | 
|  `ExternalURL`  |  string  |  通知の送信元である Grafana へのリンク。外部のアラートマネージャーを使用している場合、そのアラートマネージャーへのリンク。  | 

`Alerts` 型には、返されたアラートをフィルタリングするための 2 つの関数があります。
+ `Alerts.Firing` – 発生中のアラートのリストを返します。
+ `Alerts.Resolved` – 解決済みのアラートのリストを返します。

**アラート (型)**

アラート型には、次のデータがあります。


| 名前 | 型 | 注意事項 | 
| --- | --- | --- | 
|  ステータス  |  string  |  `firing` または `resolved`  | 
|  ラベル  |  KeyValue  |  アラートに付与された一連のラベル。  | 
|  ‏注釈  |  KeyValue  |  アラートに付与された一連の注釈。  | 
|  StartsAt  |  time.Time  |  アラートが発行された時刻。  | 
|  EndsAt  |  time.Time  |  アラートの終了時刻がわかっている場合にのみ設定されます。それ以外の場合、最後にアラートを受信してから設定可能なタイムアウト期間が適用されます。  | 
|  GeneratorURL  |  string  |  Grafana または外部アラートマネージャーへのリンク。  | 
|  SilenceURL  |  string  |  このアラートのラベルが事前に入力された grafana のサイレンスへのリンク。Grafana 管理のアラートのみ。  | 
|  DashboardURL  |  string  |  Grafana ダッシュボードへのリンク (アラートルールが Grafana に属している場合)。Grafana 管理のアラートのみ。  | 
|  PanelURL  |  string  |  Grafana ダッシュボードパネルへのリンク (アラートルールが Grafana に属している場合)。Grafana 管理のアラートのみ。  | 
|  Fingerprint  |  string  |  アラートの識別に使用するフィンガープリント。  | 
|  ValueString  |  string  |  アラート内の各削減された式のラベルと値を含む文字列。  | 

**KeyValue 型**

`KeyValue` 型は、キー (ラベル) 値 (注釈) の文字列を組み合わせたものです。

`KeyValue` として保存されたデータに直接アクセスするメソッドだけでなく、データをソート、削除、変換するメソッドも備えています。


| 名前 | 引数 | 戻り値 | 注意事項 | 
| --- | --- | --- | --- | 
|  SortedPairs  |    |  キーと値の文字列のソート済みのリスト  |    | 
|  削除  |  []string  |  KeyValue  |  指定したキーを除いたキー/値のマップのコピーを返します。  | 
|  名前  |    |  []string  |  ラベル名のリスト  | 
|  値  |    |  []string  |  ラベル値のリスト  | 



## テンプレート関数
<a name="alert-template-functions"></a>

テンプレート関数を使用すると、ラベルと注釈を処理して動的に通知を生成できます。以下の機能を使用できます。


| 名前 | 引数の型 | 戻り型 | 説明 | 
| --- | --- | --- | --- | 
|  `humanize`  |  数値または文字列  |  string  |  メトリクスプレフィックスを使用して、数値をより読み取り可能な形式に変換します。  | 
|  `humanize1024`  |  数値または文字列  |  string  |  humanize と同様に、1000 ではなく 1024 を基準にします。  | 
|  `humanizeDuration`  |  数値または文字列  |  string  |  時間を秒単位のより読みやすい形式に変換します。  | 
|  `humanizePercentage`  |  数値または文字列  |  string  |  比率の値を 100 分の 1 の形に変換します。  | 
|  `humanizeTimestamp`  |  数値または文字列  |  string  |  Unix のタイムスタンプを秒単位のより読みやすい形式に変換します。  | 
|  `title`  |  string  |  string  |  strings.Title を使用すると、各単語の最初の文字が大文字になります。  | 
|  `toUpper`  |  string  |  string  |  strings.ToUpper を使用すると、文字列がすべて大文字に変換されます。  | 
|  `toLower`  |  string  |  string  |  strings.ToLower を使用すると、文字列がすべて小文字に変換されます。  | 
|  `match`  |  パターン、テキスト  |  boolean  |  regexp.MatchString を使用すると、アンカーなしでの正規表現の一致テストを実行できます。  | 
|  `reReplaceAll`  |  パターン、置換、テキスト  |  string  |  Regexp.ReplaceAllString を使用すると、アンカーなしでの正規表現による置換が実行できます。  | 
|  `graphLink`  |  文字列 - `expr` および `datasource` フィールドを持つ JSON オブジェクト  |  string  |  指定された式とデータソースに対するグラフィカルビューへのパスを返します。  | 
|  `tableLink`  |  文字列 - `expr` および `datasource` フィールドを持つ JSON オブジェクト  |  string  |  指定された式とデータソースに対するタブ形式ビューへのパスを返します。  | 
|  `args`  |  []interface\$1\$1  |  map[string]interface\$1\$1  |  オブジェクトのリストを arg0、arg1 などのキーを持つマップに変換します。複数の引数をテンプレートに渡す場合、この関数を使用します。  | 
|  `externalURL`  |  なし  |  string  |  外部 URL を表す文字列を返します。  | 
|  `pathPrefix`  |  なし  |  string  |  外部 URL のパスを返します。  | 

次の表に、各関数の使用例を紹介します。


| 関数 | TemplateString | Input | 予想 | 
| --- | --- | --- | --- | 
|  humanize  |  \$1 humanize \$1value \$1  |  1234567.0  |  1.235M  | 
|  humanize1024  |  \$1 humanize1024 \$1value \$1  |  1048576.0  |  1Mi  | 
|  humanizeDuration  |  \$1 humanizeDuration \$1value \$1  |  899.99  |  14 分 59 秒  | 
|  humanizePercentage  |  \$1 humanizePercentage \$1value \$1  |  0.1234567  |  12.35%  | 
|  humanizeTimestamp  |  \$1 humanizeTimestamp \$1value \$1  |  1435065584.128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  title  |  \$1 \$1value \$1 title \$1  |  aa bB CC  |  Aa Bb Cc  | 
|  toUpper  |  \$1 \$1value \$1 toUpper \$1  |  aa bB CC  |  AA BB CC  | 
|  toLower  |  \$1 \$1value \$1 toLower \$1  |  aa bB CC  |  aa bb cc  | 
|  match  |  \$1 match "a\$1" \$1labels.instance \$1  |  aa  |  真  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll "localhost:(.\$1)" "my.domain:\$11" \$1labels.instance \$1\$1  |  localhost:3000  |  my.domain:3000  | 
|  graphLink  |  \$1\$1 graphLink "\$1\$1"expr\$1": \$1"up\$1", \$1"datasource\$1": \$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true\$1]  | 
|  tableLink  |  \$1\$1 tableLink "\$1\$1"expr\$1":\$1"up\$1", \$1"datasource\$1":\$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false\$1]  | 
|  args  |  \$1\$1define "x"\$1\$1\$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1\$1\$1end\$1\$1\$1\$1template "x" (args 1 "2")\$1\$1  |    |  1 2  | 
|  externalURL  |  \$1 externalURL \$1  |    |  http://localhost/path/prefix  | 
|  pathPrefix  |  \$1 pathPrefix \$1  |    |  /path/prefix  | 

# 通知ポリシーの使用
<a name="alert-notifications"></a>

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

通知ポリシーでは、アラートがコンタクトポイント (通知先) にどのように配信されるかを指定します。ポリシーはツリー構造で、ポリシーごとに 1 つ以上の子ポリシーを持つことができます。ルートポリシーを除く各ポリシーは、特定のアラートラベルにも一致させることができます。各アラートはルートポリシーによって評価され、次に各子ポリシーによって評価されます。特定のポリシーに対して `Continue matching subsequent sibling nodes` オプションを有効にすると、1 つ以上の一致があっても評価が続行されます。子ポリシーのいずれとも一致しない場合、親ポリシーの設定とコンタクトポイント (通知先) の情報によってアラートの動作が制御されます。特定のポリシーと一致しない場合、ルートポリシーがアラートを制御します。

**注記**  
Grafana 管理のアラートの通知ポリシーを作成および編集することができますが、アラートマネージャーアラートの通知ポリシーは読み取り専用となっています。

**通知のグループ化**

グループ化すると、似た性質のアラート通知を 1 つの funnel にまとめられます。これは、システム上で一度に複数の障害が発生して多数のアラートが同時に発生する場合、大規模な停止中にアラート通知を制御することができます。

**グループ化の例**

例えば、異なる環境でデータベースに接続されている100のサービスがあるとします。これらのサービスは、ラベル `env=environmentname` で区別され、サービスがデータベースに到達できるかどうかを監視するためのアラートルールが設定されています。このアラートルールは、`alertname=DatabaseUnreachable` という名前のアラートを作成します。

サービスの半分がデータベースに到達できなくなったネットワークの分断が発生すると、50 件のアラートが個別に発生しますが、影響を受けている環境のリストを含む (50 件ではなく) 1 ページの通知を受け取りたいと考えています。

`group_by: [alertname]`でグループ化を設定することができます(サービスごとに異なる `env` ラベルを使用する代わりに)。この設定を行うと、Grafana は、このアラートルールの影響を受けるすべての環境が記載された 1 通のコンパクトな通知を送信します。

**特殊グループ**

Grafana には 2 つの特殊グループがあります。デフォルトのグループである `group_by: null` は、*すべての*アラートを 1 つのグループにグループ化します。`...` という名前の特殊ラベルを使用してすべてのラベルでアラートをグループ化することで、グループ化を無効にし、各アラートを独自のグループに送信することもできます。

## 通知の使用
<a name="alert-notifications-working"></a>

以下に、通知ポリシーを作成および管理するための手順を紹介します。

**ルート通知ポリシーの編集方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[通知ポリシー]** を選択します。

1. **[アラートマネージャー]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. **[ルートポリシー]** セクションで、**[編集]** アイコン (ペン) を選択します。

1. **[デフォルトのコンタクトポイント]** で、アラートルールが特定のポリシーと一致しない場合に通知を送信するコンタクトポイント (通知先) を更新します。

1. **[グループ化対象]** で、アラートをグループ化するラベル (または特殊グループ) を選択します。

1. **[タイミングオプション]** で、以下のいずれかを選択します。
   + **[グループ待機]** – 同じグループのアラートをバッファリングしてから、最初の通知を送信するまでの待機時間。デフォルト値は 30 秒です。
   + **[グループ間隔]** – グループ内の 2 つの通知の最小時間間隔。デフォルト値は 5 分です。
   + **[繰り返し間隔]** – グループに新しいアラートが追加されなかった場合に、通知を再送信するまでの最小時間間隔。デフォルトは 4 時間です。

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

**上位の特定のポリシーの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[通知ポリシー]** を選択します。

1. **[アラートマネージャー]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. **[特定のルーティング]** セクションで、**[新しい特定のポリシー]** を選択します。

1. **[一致するラベル]** セクションで、一致するアラートラベルを 1 つ以上追加します。ラベルの一致の詳細については、このトピックの後半で説明します。

1. **コンタクトポイント**で、アラートがこの特定のポリシーと一致する場合に通知を送信するコンタクトポイントを追加します。ネストされたポリシーは、このコンタクトポイントを上書きします。

1. 必要に応じて **[グループ化を上書き]** を選択して、ルートポリシーとは異なるグループ化を指定します。

1. 必要に応じて **[一般的なタイミングを上書き]** を選択して、グループ通知ポリシーで設定されているタイミングオプションを上書きします。

1. **[ポリシーの保存]** を選択して変更を保存します。

**ネストしたポリシーの追加方法**

1. ネストしたポリシーの作成先となる特定のポリシーを展開します。

1. **[ネストしたポリシーの追加]** を選択し、詳細を追加します (最上位の特定のポリシーを追加する場合と同様)。

1. **[ポリシーの保存]** を選択して変更を保存します。

**特定のポリシーの編集方法**

1. **[アラート]** ページから **[通知ポリシー]** を選択するとページを開き、現在設定されているポリシーが一覧表示されます。

1. 編集する設定ポリシーを選択したら、**[編集]** アイコン (ペン) を選択します。

1. 必要な変更を加えます (最上位の特定のポリシーを追加する場合と同様)。

1. **[ポリシーを保存]** を選択します。

**ラベル一致の仕組み**

ポリシーは、アラートのラベルがポリシーで指定されたすべての*一致ラベル*と合致する場合に、そのアラートに適用されます。
+ **ラベル** – 一致させるラベルの名前。アラートのラベル名と完全に一致する必要があります。
+ **[演算子]** – ラベル値と一致するラベル値の比較に使用される演算子。利用できる演算子は次のとおりです。
  + `=` 値が指定された文字列と完全に一致するラベルが選択されます。
  + `!=` 値が指定された文字列と一致しないラベルが選択されます。
  + `=~` 指定された文字列の正規表現解釈値と一致するラベルが選択されます (指定された文字列は正規表現として解釈されます)。
  + `!=` 指定された正規表現と一致しないラベルが選択されます。
+ **[値])** – ラベル値と一致する値。選択した演算子に応じて、文字列または正規表現として照合させることができます。

## ミュートタイミング
<a name="alert-notification-muting"></a>

ミュートタイミングとは、ポリシーの新しい通知が生成されたり送信されないようにする繰り返しの時間間隔です。定期的なメンテナンス期間など、アラートが特定の期間や繰り返し発生するのを防ぐために使用されます。

サイレンスと似ていますが、ミュートタイミングはアラートルールの評価や、ユーザーインターフェースへのアラート表示を停止せず、通知の作成のみを防ぎます。

外部のアラートマネージャーデータソースの Grafana 管理のミュートタイミングとミュートタイミングを設定できます。

**サイレンスとミュートタイミングの比較**

次の表に、「ミュートタイミング」と「サイレンス」の違いを示します。


| ミュートタイミング | サイレンス | 
| --- | --- | 
|  繰り返しの時間間隔を定義します  |  開始時刻と終了時刻を固定します  | 
|  作成され、通知ポリシーに追加されます  |  ラベルを使用してアラートと照合し、サイレンスするかどうかが判断されます  | 

**ミュートタイミングの作成方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. **[通知ポリシー]** を選択します。

1. **[アラートマネージャー]** ドロップダウンから、編集するアラートマネージャーを選択します。

1. **[ミュートタイミング]** セクションで、**[ミュートタイミングの追加]** ボタンを選択します。

1. ミュートタイミングを適用したい時間間隔を選択します。

1. **[送信]** を選択してミュートタイミングを作成します。

**通知ポリシーへのミュートタイミングの追加方法**

1. ミュートタイミングを追加する通知ポリシーを選択し、**[編集]** ボタンを選択します。

1. **[ミュートタイミング]** ドロップダウンから、ポリシーに追加するミュートタイミングを選択します。

   **[ポリシーを保存]** ボタンを選択します。

**時間間隔**

時間間隔には、時間範囲を指定します。この時間間隔内にアラートが発生した場合、抑制されます。範囲には `:` を使用して表現することができます (例: `monday:thursday`)。ミュートタイミングには複数の時間間隔を含めることができます。時間間隔は複数のフィールド (詳細は次のリストを参照) で構成され、アラートを抑制するには、すべてのフィールドが一致する必要があります。例えば、曜日に月曜日から金曜日 `monday:friday`、時間範囲を 8:00～9:00 と指定した場合、アラートは月曜日から金曜日の 8:00～9:00 の間は抑制されますが、土曜日の 8:00～9:00 は抑制されません。
+ **[時間範囲]** – 通知を抑制する時間帯。**[開始時刻]**と**[終了時刻]** の 2 つのサブフィールドで構成されます。時刻は `14:30` のように指定します。時刻は UTC の 24 時間表記です。
+ **[曜日]** - 曜日。単一の日 (例: `monday`)、範囲 (例: `monday:friday`)、またはカンマで区切られた複数の日のリスト (例: `monday, tuesday, wednesday`) を指定できます。
+ **[月]** - 選択する月。月は、数値で指定することも、完全な月名で指定することもできます。例えば、`1` または `january` のどちらでも 1 月を指定できます。単一の月、月の範囲、またはカンマ区切りの月のリストを指定できます。
+ **[月の日付]** – 1 か月内の日付。値は `1`～`31` の範囲で指定します。負の値は月の日を逆順で指定することを意味します。たとえば、`-1` は月の最終日を表します。日付は単一の日、日付の範囲、またはカンマで区切った日付のリストを指定できます。