項目 | 説明 | 備考 |
エンドポイント | /query、/query_range、/labels、/label/{label}/values、および /series API エンドポイントがサポートされています。 | |
データ仕様 | メトリック名は、[a-zA-Z_:][a-zA-Z0-9_:]* 正規表現に一致する必要があります。 ラベルキーは、[a-zA-Z_][a-zA-Z0-9_]* 正規表現に一致する必要があります。ラベル値には縦棒 (|) を含めることはできません。
| 詳細については、「メトリック」をご参照ください。 |
同時検索ステートメントの最大数 | 各プロジェクトは、最大 15 個の同時検索ステートメントをサポートします。 | たとえば、15 人のユーザーがプロジェクトのすべてのメトリックストアで同時に検索ステートメントを実行できます。 |
読み取りデータの最大量 | 一度に 1 つのシャードから最大 2 億の時系列、2 億のデータポイント、または 200 MB のデータを読み取ることができます。シャードからデータを読み取るときに上記の制限のいずれかに達すると、データの読み取りは停止します。 | シャードの一部のデータのみが読み取られたことを示すステータスが返されます。この場合、大量のデータを読み取ることができる十分なシャードを分割することをお勧めします。 |
コンピューティング側のデータの最大量 | PromQL 計算を実行する前に、システムはノード内の生データの量を確認します。最大 2 億の時系列、2 億のデータポイント、または 2 GB のデータを計算に含めることができます。上記の制限のいずれかに達すると、エラーが返されます。 | ビジネスが単一操作での大規模データ集約に強く依存している場合は、同時コンピューティング機能を有効にすることをお勧めします。詳細については、「同時コンピューティング」をご参照ください。 |
コンピューティング側のデータポイントの最大数 | PromQL-Engine 計算プロセスで、選択され計算に含まれるデータポイントの数が 5,000 万を超えると、エラーが返されます。 | オープンソースの Prometheus に課せられるコンピューティング制限は、PromQL-Engine にも課せられます。クエリに集約計算が含まれる場合は、同時コンピューティング機能を使用することをお勧めします。 |
PromQL ステートメントの結果 | 標準のオープンソースプロトコルでは、/query_range エンドポイントは、時系列に対して返される最大 11,000 個のデータポイントをサポートします。クエリパラメータの値が (end - start)/step > 11000 式と一致する場合、エラーが返されます。 | 長期間にわたってデータをクエリする場合は、step パラメータに大きな値を指定することをお勧めします。 |
SQL ステートメントの結果 | デフォルトでは、SQL クエリ操作または計算に対して最大 100 個のデータエントリを返すことができます。SQL ステートメントに LIMIT ALL 句を追加すると、最大 100 万個のデータエントリを返すことができます。この制限は、次のシナリオで有効になります。 SQL ステートメントを使用して、生の時系列データに対して計算を実行します。 SQL ステートメントでネストされた PromQL サブクエリを使用して計算を実行します。
| 100 万個のデータエントリは、100 万個のデータポイントを表します。検索構文の詳細については、「メトリックデータのクエリと分析の構文」をご参照ください。 |
SQL ステートメントでのネストされた PromQL サブクエリ | PromQL ステートメントの長さは 3,000 文字を超えることはできません。 | 検索構文の詳細については、「メトリックデータのクエリと分析の構文」をご参照ください。 |
lookback-delta | デフォルトでは、このパラメータは Simple Log Service メトリックストアで 3 分に設定されています。 | lookback-delta は、PromQL クエリ固有のパラメータです。詳細については、lookback-delta をご参照ください。 カスタム PromQL API 操作を指定して、このパラメータを設定できます。最大値は 3 日間です。詳細については、「メトリッククエリの API 操作」をご参照ください。 |
タイムアウト期間 | デフォルト値は、PromQL API 操作ベースのクエリの場合は 1 分、SQL クエリの場合は 55 秒です。 | カスタム PromQL API 操作を指定して、このパラメータを設定できます。詳細については、「メトリッククエリの API 操作」をご参照ください。 |
メタクラスエンドポイント | クエリパフォーマンスのために、メタクラスのエンドポイントを使用して、5 分以内に生成されたデータをクエリできます。この制限は、/labels、/label/{label}/values、および /series エンドポイントに有効です。 | 5 分間のタイムウィンドウには、終了時刻の 5 分前の開始時刻と、end パラメータで指定された終了時刻が含まれます。5 分間のタイムウィンドウは [end - 5min, end] です。 カスタム PromQL API 操作を指定して、メタデータの開始時刻と終了時刻を指定できます。詳細については、「Query Series API 操作」をご参照ください。 説明 デフォルトでは、メタクラスのエンドポイントはすべてのデータをクエリします。クエリのパフォーマンスを大幅に向上させるために、ビジネス要件に基づいて match パラメータを設定することをお勧めします。詳細については、「Query Series API 操作」をご参照ください。 |