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

# Prometheus データソースの使用
<a name="amazon-using-prometheus-datasource"></a>

## Prometheus の設定
<a name="amazon-prometheus-settings"></a>


|  名前  |  説明  | 
| --- | --- | 
|  Name  |  データソース名。これは、パネルとクエリ内へのデータソースの表示のされ方です。 | 
|  Default  |  デフォルトのデータソースは、新しいパネル用に事前に選択されたデータソースです。 | 
|  Url  |  Amazon Managed Service for Prometheus ワークスペースの URL。例: https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-example1234/。 | 
|  Access  |  サーバー (デフォルト) = URL は Grafana バックエンド/サーバーからアクセス可能である必要があります。 | 
|  Scrape interval  |  これを Prometheus で設定された一般的なスクレイプと評価の間隔に設定します。デフォルトは 15 秒です。 | 
|  Disable metrics lookup  |  このオプションをオンにすると、クエリフィールドのオートコンプリートでメトリクスの選択とメトリクス/ラベルのサポートが無効になります。これにより、より大きな Prometheus インスタンスでパフォーマンスの問題が発生した場合に役立ちます。 | 
|  Custom Query Parameters  |  Prometheus クエリ URL にカスタムパラメータを追加します。例えば、timeout、partial\$1response、dedup または max\$1source\$1resolution などです。複数のパラメータを「&」で連結する必要があります。 | 

## Prometheus クエリエディタ
<a name="amazon-prometheus-query-editor"></a>

 次のセクションでは、ダッシュボードと Explore の Prometheus クエリエディタに関する情報とオプションについて説明します。

### ダッシュボードのクエリエディタ
<a name="amazon-query-editor-in-dashboards"></a>

 タイトルを選択し、**[編集]** (またはパネルで一時停止中に **e** キーを押す) を選択して、編集モードでグラフを開きます。


|  名前  |  説明  | 
| --- | --- | 
|  Query expression  |  Prometheus のクエリ式の詳細については、[Prometheus のドキュメント](https://prometheus.io/docs/querying/basics/)を参照してください。 | 
|  Legend format  |  名前またはパターンを使用して、時系列の名前を制御します。例えば、\$1\$1hostname\$1\$1 はラベル hostname のラベル値に置き換えられます。 | 
|  Min step  |  [Prometheus 範囲クエリの `step` パラメータ](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)と、\$1\$1\$1interval および \$1\$1\$1rate\$1interval 変数の追加の下限。制限は絶対であり、解決設定でも変更されません。 | 
|  Resolution  |  1/1 は、各ピクセルが 1 つのデータポイントに対応するように、[Prometheus 範囲クエリの](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)\$1\$1\$1interval 変数と step パラメータの両方を設定します。パフォーマンスを向上させるには、低解像度を使用します。1/2 は 1 ピクセルごとにデータポイントを取得し、1/10 は 10 ピクセルあたり 1 つのデータポイントを取得します。最小時間間隔と最小ステップの両方が、\$1\$1\$1interval と step の最終値を制限することに注意してください。 | 
|  Metric lookup  |  この入力フィールドでメトリクス名を検索します。 | 
|  Format as  |  Table、Time series、または Heatmap を切り替えます。Table はテーブルパネルでのみ機能します。 Heatmap は、ヒートマップパネルにヒストグラムタイプのメトリクスを表示するのに適しています。累積ヒストグラムを通常のヒストグラムに変換し、バケットの境界でシリーズをソートします。 | 
|  Instant  |  「インスタント」クエリを実行して、要求された時系列に対して Prometheus がスクレイピングした最新の値のみを返します。インスタントクエリは、通常の範囲クエリよりもはるかに高速に結果を返します。これらを使用して、ラベルセットを検索します。 | 
|  Min time interval  |  この値に解決設定の分母を掛けると、[Prometheus 範囲クエリの `$__interval` 変数と `step` パラメータ](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)の両方に下限が設定されます。デフォルトでは、データソースオプションで設定されたスクレイプ間隔が指定されます。 | 

**注記**  
 Amazon Managed Grafana は、動的に計算されたステップに合わせてクエリのリクエスト日を変更します。これにより、メトリクスデータの一貫した表示が保証されますが、グラフの右端にあるデータの小さなギャップが生じる可能性があります。

#### ダッシュボード内のインスタントクエリ
<a name="amazon-prometheus-instant-queries-in-dashboards"></a>

 Prometheus データソースを使用すると、最新の値のみをクエリするインスタントクエリを実行できます。テーブルパネルで結果を視覚化して、時系列で使用可能なすべてのラベルを表示できます。

 インスタントクエリの結果は、シリーズごとに 1 つのデータポイントのみで構成されます。これらは、シリーズのオーバーライドを使用してグラフパネルに表示できます。最新の値ポイントとしてグラフに表示するには、シリーズオーバーライドを追加して `Points > true` を選択します。グラフ全体に水平線を表示するには、シリーズオーバーライドを追加し、`Transform > constant` を選択します。シリーズオーバーライドの詳細については、「[シリーズオーバーライド](graph-panel.md#graph-panel-series-overrides)」を参照してください。

### Explore のクエリエディタ
<a name="amazon-p-query-editor-in-explore"></a>


|  名前  |  説明  | 
| --- | --- | 
|  Query expression  |  Prometheus のクエリ式の詳細については、[Prometheus のドキュメント](https://prometheus.io/docs/querying/basics/)を参照してください。 | 
|  Step  |  [Prometheus 範囲クエリの `Step` パラメータ](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)。ここで時間単位を使用できます。例えば、5s、1m、3h、1d、1y を使用できます。指定された単位が s (秒) でない場合のデフォルト単位。 | 
|  Query type  |  Range、Instant、Both範囲クエリを実行すると、クエリの結果がグラフとテーブルに表示されます。インスタントクエリは、要求された時系列に対してPrometheus がスクレイピングした最新の値のみを返し、テーブルに表示します。[Both] (両方) を選択すると、インスタントクエリと範囲クエリの両方が実行されます。範囲クエリの結果がグラフに表示され、即時クエリの結果がテーブルに表示されます。 | 

## メトリクスブラウザ
<a name="amazon-prometheus-metrics-browser"></a>

メトリクスブラウザを使用すると、メトリクスをすばやく検索し、関連するラベルを選択して基本的なクエリを作成できます。ブラウザを開くと、使用可能なすべてのメトリクスとラベルが表示されます。Prometheus インスタンスでサポートされている場合、各メトリクスには HELP と TYPE がツールヒントとして表示されます。

メトリクスを選択すると、ブラウザは使用可能なラベルを絞り込み、メトリクスに該当するラベルのみを表示します。その後、下部セクションにあるリストに使用可能なラベル値が表示され、1 つ以上のラベルを選択できます。各ラベルに 1 つ以上の値を選択して、クエリ範囲を絞り込みます。

**注記**  
開始するメトリクス名がわからない場合は、まずいくつかのラベルを選択してリストを絞り込み、関連するラベル値を見つけることもできます。

メトリクスブラウザのすべてのリストには、特定の文字列に一致するメトリクスまたはラベルをすばやくフィルタリングするための検索フィールドが上部にあります。値セクションの検索フィールドは 1 つだけです。フィルタリングはすべてのラベルに適用され、ラベルアプリケーション、ジョブ、ジョブ名など、ラベルが選択された後に、探している値を持つ可能性のある 1 つのみの値を見つけるのに役立ちます。

クエリに満足したら、「クエリを使用」をクリックしてクエリを実行します。**[レートクエリとして使用]** ボタンは、カウンターメトリクスのクエリの書き込みに役立つ rate(...)[\$1\$1\$1interval] をクエリの周囲に追加します。「セレクタの検証」ボタンは、そのセレクタで使用できる時系列の数を Prometheus で確認します。

### 制限事項
<a name="amazon-metrics-browser-limitations"></a>

メトリクスブラウザには、10,000 ラベル (キー) と 50,000 ラベル値 (メトリクス名を含む) の絶対制限があります。Prometheus インスタンスがより多くの結果を返した場合でも、ブラウザは引き続き機能します。ただし、結果セットはこれらの最大制限を超えてカットされます。

## テンプレート作成
<a name="amazon-p-templating"></a>

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

 テンプレート作成とテンプレート変数の詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。

### クエリ変数
<a name="amazon-p-query-variable"></a>

 *クエリ*タイプの変数を使用すると、メトリクス、ラベル、またはラベル値のリストを Prometheus にクエリできます。Prometheus データソースプラグインには、**クエリ**入力フィールドで使用できる以下の関数が用意されています。


|  名前  |  説明  | 
| --- | --- | 
|  label\$1names()  |  ラベル名のリストを返します。 | 
|  label\$1values(label)  |  すべてのメトリクスの label 用のラベル値リストを返します。 | 
|  label\$1values(metric, label)  |  指定されたメトリクスの label 用のラベル値リストを返します。 | 
|  metrics(metric)  |  指定された metric 正規表現に一致するメトリクスのリストを返します。 | 
|  query\$1result(query)  |  query の Prometheus クエリ結果のリストを返します。 | 

 *メトリクス名* 、*ラベル名*、*ラベル値*については、[Prometheus ドキュメント](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)を参照してください。

#### 間隔変数と範囲変数の使用
<a name="amazon-p-using-interval-and-range-variables"></a>

**注記**  
 `$__range`、`$__range_s`、`$__range_ms` は Grafana v5.3 でのみサポートされています。

 クエリ変数には、`$__interval`、`$__interval_ms`、`$__range`、`$__range_s`、`$__range_ms` などのグローバル変数を使用できます。詳細については、「[グローバル変数](variables-types.md#global-variables)」を参照してください。これらは、`query_result`関数がクエリをサポートしていないため、変数クエリをフィルタリングする必要がある場合に `label_values`関数で使用すると便利です。

 ダッシュボードの時間範囲を変更するときに正しいインスタンスを取得するには、変数の`refresh`トリガーを に設定してください`On Time Range Change`。

次のコード例は、ダッシュボードに表示される時間範囲の平均 QPS に基づいて、最もビジーな5つの陸絵sとインスタンスを変数に設定する方法を示しています。

```
Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance)))
Regex: /"([^"]+)"/
```

 次のコード例は、`$__range_s` を使用して、ダッシュボードに表示される時間範囲にわたって特定の状態を持つインスタンスで変数を入力する方法を示しています。

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

### `$__rate_interval` 変数の使用
<a name="amazon-p-using-__rate_interval-variable"></a>

 `$__rate_interval` 変数は、レート関数で使用することを目的としています。これは 最大 ( `$__interval` \$1 *スクレイプ間隔 *、4 \$1 *スクレイプ間隔 *) として定義されます。*スクレイプ間隔*は、設定されている場合は最小ステップ設定 (AKA query\$1interval、PromQL クエリごとの設定) で、それ以外の場合は Prometheus データソースで設定された*スクレイプ間隔*です (ただし、後者は解決設定によって変更されるため、パネル内の最小間隔設定は無視します)。

### クエリでの変数の使用
<a name="amazon-p-using-variables-in-queries"></a>

 2 つの構文があります。
+  `$<varname>` 例: rate(http\$1requests\$1total\$1job=\$1「\$1job」\$1[5m]) 
+  `[[varname]]` 例: rate(http\$1requests\$1total\$1job=\$1「[job]]」\$1[5m]) 

 なぜ 2 つの方法があるのですか？ 最初の構文は読み書きが容易ですが、単語の途中で変数を使用することは許可されません。*[複数値]*または*[すべての値を含める]*オプションが有効になっている場合、Grafana はラベルをプレーンテキストから正規表見互換の文字列に変換します。つまり、 `=` の代わりに `=~` を使用する必要があります。

## ‏注釈
<a name="amazon-p-annotations"></a>

 注釈を使用して、グラフの上にリッチイベント情報をオーバーレイできます。ダッシュボードメニューまたは注釈ビューを使用して注釈クエリを追加します。詳細については、「[‏注釈](dashboard-annotations.md)」を参照してください。

 Prometheus は、注釈をクエリする 2 つの方法をサポートしています。
+  通常のメトリクスクエリ 
+  保留中のアラートと発射アラートの Prometheus クエリ。詳細については、[「ランタイム中のアラートの検査](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/#inspecting-alerts-during-runtime)」を参照してください。

 ステップオプションは、クエリから返されるイベントの数を制限するのに役立ちます。