検索インデックスの集計機能のパーセンタイル統計を指定します。パーセンタイル値は、データセット内の値の相対位置を示します。たとえば、システムの日常的なO&M中に各リクエストの応答時間の統計を収集する場合、p25、p50、p90、p99などのパーセンタイルを使用して応答時間の分布を分析する必要があります。
リクエスト構文
message PercentilesAggregation {
optional string field_name = 1; // 集計に使用するフィールド。
repeated double percentiles = 2; // p50、p90、p99などのパーセンタイル。1つ以上のパーセンタイルを指定できます。複数のパーセンタイルはカンマ(,)で区切ります。例:25.0,50.0,99.0。
optional bytes missing = 3; // 行のフィールド値が空の場合のフィールドのデフォルト値。パラメータの値はPlainBufferでエンコードされます。詳細は、PlainBufferを参照してください。
}パラメーター | タイプ | 必須 | 説明 |
field_name | string | はい | 集計に使用するフィールド。 |
percentiles | double | はい | p50、p90、p99などのパーセンタイル。1つ以上のパーセンタイルを指定できます。複数のパーセンタイルはカンマ(,)で区切ります。例: パーセンタイルの範囲は1~100です。 |
missing | bytes | いいえ | 行のフィールド値が空の場合のフィールドのデフォルト値。パラメータの値はPlainBufferでエンコードされます。詳細については、PlainBufferを参照してください。
|
レスポンス構文
message PercentilesAggregationResult {
repeated PercentilesAggregationItem percentiles_aggregation_items = 1; // パーセンタイル統計におけるパーセンタイル分布。
}パラメーター | タイプ | 必須 | 説明 |
percentiles_aggregation_items | repeated PercentilesAggregationItem | はい | パーセンタイル統計におけるパーセンタイル分布。 |