timeSeriesQuantileToGrid
導入バージョン: v26.9.0 タイムスタンプと値のペアとして与えられた時系列データを受け取り、開始タイムスタンプ、終了タイムスタンプ、ステップで定義される一定間隔の時間グリッド上で PromQLquantile_over_time 関数を計算する集約関数です。グリッド上の各ポイントでは、指定された時間ウィンドウ内のサンプルを対象に分位数を計算します。分位数は quantileExactInclusive と同様に R-7 (inclusive) 方式で計算されます。ただし、NaN サンプルは quantileExactInclusive とは異なりスキップされません。Prometheus と同様に保持され、すべての実数値より前にソートされます。そのため、[1, NaN, 2] というウィンドウの中央値は 1 となり、サンプルがすべて NaN のウィンドウでは NaN が返されます。
分位数のレベルは、サンプルの後ろに最後の引数として指定します。すべてのグリッドポイントに共通の単一の数値か、グリッドポイントごとに 1 つずつ数値を持つ配列のいずれかを指定できます。この値はすべての行で同一である必要があります。Prometheus と同様に、レベルが 0 未満の場合は -Inf、1 を超える場合は +Inf となり、レベルが NaN の場合は、ウィンドウにサンプルが存在するすべてのグリッドポイントで NaN が返されます。
この関数はプライベートプレビュー段階です。使用するには
enable_time_series_aggregate_functions=true を設定して有効化してください。start_timestamp— グリッドの開始位置を指定します。小数、または数値や日時テキストを含む文字列で指定することもできます。UInt32またはDateTimeまたはDateTime64またはFloat*またはDecimal*またはStringend_timestamp— グリッドの終了位置を指定します。小数、または数値や日時テキストを含む文字列で指定することもできます。UInt32またはDateTimeまたはDateTime64またはFloat*またはDecimal*またはStringgrid_step— グリッドのステップを秒単位で指定します。小数、または数値や ’15s’、‘1m’ のような期間を含む文字列で指定することもできます。UInt32またはFloat*またはDecimal*またはStringstaleness— 対象とするサンプルの最大「staleness」を秒単位で指定します。staleness ウィンドウは左開右閉区間です。小数、または数値や ’15s’、‘1m’ のような期間を含む文字列で指定することもできます。UInt32またはFloat*またはDecimal*またはString
timestamp— サンプルのタイムスタンプ。単一の値または配列を指定できます。UInt32またはDateTimeまたはDateTime64またはArray(UInt32)またはArray(DateTime)またはArray(DateTime64)value— タイムスタンプに対応する時系列の値。単一の値または配列を指定できます。Float*またはArray(Float*)samples—(timestamp, value)のタプルの配列として渡す時系列のサンプル。タプルの各要素の型は、上記のタイムスタンプおよび値の型と同じです。タイムスタンプと値を 2 つの別々の引数として渡す代わりに使用できます。Array(Tuple(T1, T2))phi— 分位数のレベル。通常は [0, 1] の範囲です。グリッド全体に対して 1 つの数値を指定するか、グリッドポイントごとに 1 つの数値を含む配列を指定します。すべての行で同じ値である必要があります。Float*またはUInt8/16/32/64またはInt8/16/32/64またはArray(Float*)またはArray(UInt8/16/32/64)またはArray(Int8/16/32/64)
Array(Nullable(Float64))
例