Package org.elasticsearch.xpack.esql.optimizer.rules.logical.promql

Class TranslatePromqlToTimeSeriesAggregate

java.lang.Object

org.elasticsearch.xpack.esql.rule.Rule<PromqlCommand,LogicalPlan>

org.elasticsearch.xpack.esql.optimizer.rules.logical.OptimizerRules.OptimizerRule<PromqlCommand>

org.elasticsearch.xpack.esql.optimizer.rules.logical.promql.TranslatePromqlToTimeSeriesAggregate

public final class TranslatePromqlToTimeSeriesAggregate
extends OptimizerRules.OptimizerRule<PromqlCommand>

Translates PromQL logical plans into ESQL TimeSeriesAggregate nodes. This rule runs before TranslateTimeSeriesAggregate to convert PromQL-specific plans (WithinSeriesAggregate, AcrossSeriesAggregate) into standard ESQL TimeSeriesAggregate nodes that can then be further optimized by the existing time-series translation pipeline. Translation examples:

 PromQL: rate(http_requests[5m])

 PromQL Plan:
   WithinSeriesAggregate(name="rate")
     └── RangeSelector(http_requests, range=5m)

 Translated to:
   TimeSeriesAggregate(groupBy=[_tsid], aggs=[rate(value, @timestamp)])
     └── Filter(__name__ == "http_requests")
           └── EsRelation(*, mode=TIME_SERIES)
 

Field Summary

Fields

Modifier and Type	Field	Description
static final Duration	DEFAULT_LOOKBACK

Fields inherited from class org.elasticsearch.xpack.esql.rule.Rule

log

Constructor Summary

Constructors

Constructor	Description
TranslatePromqlToTimeSeriesAggregate()

Method Summary

Modifier and Type	Method	Description
protected LogicalPlan	rule(PromqlCommand promqlCommand)

Methods inherited from class org.elasticsearch.xpack.esql.optimizer.rules.logical.OptimizerRules.OptimizerRule

apply

Methods inherited from class org.elasticsearch.xpack.esql.rule.Rule

name, toString, typeToken

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

DEFAULT_LOOKBACK

public static final Duration DEFAULT_LOOKBACK

Constructor Details

TranslatePromqlToTimeSeriesAggregate

public TranslatePromqlToTimeSeriesAggregate()

Method Details

rule

protected LogicalPlan rule(PromqlCommand promqlCommand)

Specified by:

rule in class OptimizerRules.OptimizerRule<PromqlCommand>