翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
クエリの料金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
]
]
}
}
}
}