PromQL Compliance List #

Introduction #

PromQL is the query language for Prometheus. It is a powerful and flexible language to retrieve data for alerting, graphing, and analysis.

GreptimeDB has reimplemented PromQL (lexer, parser and engine) entirely in Rust, here attaches the compatibility list. You can also check our latest compliance report in this tracking issue.

Compatibility List #

Overview #

• Basics
  • Literal
  • Selector
  • Subquery (unsupported)
• Operators
  • Binary Operators
  • Vector Matching (unsupported)
  • Aggregation Operators
• Funtions
  • Instant Functions
  • Range Functions
  • Others (unsupported)

Literal #

Both string and float literals are supported, with the same rule as PromQL.

Selector #

Both instant and range selector are supported. The only exception is the label matching on metric name, e.g.: {__name__!="request_count}" (but the equal-matching case is supported: {__name__="request_count}").

Time duration and offset are supported, but @ modifier is not supported yet.

Binary #

Pure literal binary-expr like 1+1 is not supported yet.

• Supported:

  Operator	Example
  add	a + b
  sub	a - b
  mul	a * b
  div	a / b
  mod	a % b
  eqlc	a == b
  neq	a != b
  gtr	a > b
  lss	a < b
  gte	a >= b
  lte	a <= b

• Unsupported:

  Operator	Progress
  power	TBD
  atan2	TBD
  and	TBD
  or	TBD
  unless	TBD

Aggregators #

• Supported:

  Aggregator	Example
  sum	sum by (foo)(metric)
  avg	avg by (foo)(metric)
  min	min by (foo)(metric)
  max	max by (foo)(metric)
  stddev	stddev by (foo)(metric)
  stdvar	stdvar by (foo)(metric)

• Unsupported:

  Aggregator	Progress
  count	TBD
  grouping	TBD
  topk	TBD
  bottomk	TBD
  count_values	TBD
  quantile	TBD

Instant Functions #

• Supported:

  Function	Example
  abs	abs(metric)
  ceil	ceil(metric)
  exp	exp(metric)
  ln	ln(metric)
  log2	log2(metric)
  log10	log10(metric)
  sqrt	sqrt(metric)
  acos	acos(metric)
  asin	asin(metric)
  atan	atan(metric)
  sin	sin(metric)
  cos	cos(metric)
  tan	tan(metric)

• Unsupported:

  Function	Progress
  absent	TBD
  scalar	TBD
  sgn	TBD
  sort	TBD
  sort_desc	TBD
  timestamp	TBD
  acosh	TBD
  asinh	TBD
  atanh	TBD
  sinh	TBD
  cosh	TBD
  tanh	TBD
  deg	TBD
  rad	TBD
  other multiple input fns	TBD

Range Functions #

• Supported:

  Function	Example
  idelta	idelta(metric[5m])
  <aggr>_over_time	count_over_time(metric[5m])

• Unsupported:

  Function	Example
  stddev_over_time	TBD
  stdvar_over_time	TBD
  changes	TBD
  delta	TBD
  rate	TBD
  deriv	TBD
  increase	TBD
  idelta	TBD
  irate	TBD
  reset	TBD