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

# 各クエリのクエリ使用状況に関する統計を取得する
<a name="AMP-stats"></a>

クエリの[料金](https://aws.amazon.com/prometheus/pricing/)は、実行されたクエリから 1 か月間に処理されたクエリサンプルの合計数に基づいて計算されます。行った各クエリに関する統計を取得して、処理されたサンプルを追跡できます。リクエストにクエリパラメータ `stats=all` を含めることで、`query` または `queryRange` API のクエリレスポンスに、処理されたクエリサンプルに関する統計データを含めることができます。`samples` オブジェクトが `stats` オブジェクト内に作成され、`stats` データがレスポンスで返されます。

`samples` オブジェクトは以下の属性で構成されます。


| 属性 | 説明 | 
| --- | --- | 
| totalQueryableSamples | 処理されたクエリサンプルの合計数。これが請求に使用される情報です。 | 
| totalQueryableSamplesPerStep | 各ステップで処理されたクエリサンプルの数。これは、エポックタイムスタンプと、その特定のステップでロードされたサンプルの数から成る配列の配列として表されます。 | 

サンプルのリクエストと、`stats` 情報を含むレスポンスの例を以下に示します。

`query` の例:

**GET**

```
{{endpoint}}/api/v1/query?query=up&time=1652382537&stats=all
```

**レスポンス**

```
{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {
                    "__name__": "up",
                    "instance": "localhost:9090",
                    "job": "prometheus"
                },
                "value": [
                    1652382537,
                    "1"
                ]
            }
        ],
        "stats": {
            "timings": {
                "evalTotalTime": 0.00453349,
                "resultSortTime": 0,
                "queryPreparationTime": 0.000019363,
                "innerEvalTime": 0.004508405,
                "execQueueTime": 0.000008786,
                "execTotalTime": 0.004554219
            },
            "samples": {
                "totalQueryableSamples": 1,
                "totalQueryableSamplesPerStep": [
                    [
                        1652382537,
                        1
                    ]
                ]
            }
        }
    }
}
```

 `queryRange` の例:

**GET**

```
{{endpoint}}/api/v1/query_range?query=sum+%28rate+%28go_gc_duration_seconds_count%5B1m%5D%29%29&start=1652382537&end=1652384705&step=1000&stats=all
```

**レスポンス**

```
{
    "status": "success",
    "data": {
        "resultType": "matrix",
        "result": [
            {
                "metric": {},
                "values": [
                    [
                        1652383000,
                        "0"
                    ],
                    [
                        1652384000,
                        "0"
                    ]
                ]
            }
        ],
        "stats": {
            "samples": {
                "totalQueryableSamples": 8,
                "totalQueryableSamplesPerStep": [
                    [
                        1652382000,
                        0
                    ],
                    [
                        1652383000,
                        4
                    ],
                    [
                        1652384000,
                        4
                    ]
                ]
            }
        }
    }
}
```