MetricsQL 窗口扩展

这些辅助方法需要 mode="metricsql"。它们在回看窗口内工作；转换分类中的 range_* 则作用于整个查询区间。

from metricraft import QueryBuilder as Q

query = Q.from_metric("queue_depth").count_gt_over_time(20, window="5m")
print(query.build(mode="metricsql"))

这里的 value=20 是数值阈值，window="5m" 是时长。相对地，count_values_over_time(value="observed", ...) 的 value 表示输出标签名。参数表会明确区分这些含义。

方法与参数

在本页查找

QueryBuilder

aggr_over_time()对同一个 MetricsQL 回看窗口计算多个受支持的窗口函数。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.aggr_over_time(*functions: StringInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`*functions`str, ...可变参数	aggr_over_time 接受的一个或多个窗口函数名，例如 'min_over_time' 和 'max_over_time'。每个名称都按 Rust 允许列表检查。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

ascent_over_time()累加回看窗口内样本之间的正向变化量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.ascent_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

changes_prometheus()使用 MetricsQL changes_prometheus 窗口函数，请求与 Prometheus 兼容的 changes 窗口行为。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.changes_prometheus(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

count_eq_over_time()返回窗口内值等于给定阈值的样本的数量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.count_eq_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

count_gt_over_time()返回窗口内值大于给定阈值的样本的数量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.count_gt_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

示例

from metricraft import QueryBuilder as Q

Q.from_metric("queue_depth").count_gt_over_time(20, window="5m").build(mode="metricsql")

查看声明 ↗此方法的链接

count_le_over_time()返回窗口内值小于等于给定阈值的样本的数量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.count_le_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

count_ne_over_time()返回窗口内值不等于给定阈值的样本的数量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.count_ne_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

count_values_over_time()统计窗口内每个不同样本值的出现次数，并把该值放入命名输出标签。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.count_values_over_time(value: StringInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`str必填	保存所统计样本值的非空输出标签名；该参数是标签名，不是数值阈值。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

示例

from metricraft import QueryBuilder as Q

Q.from_metric("queue_depth").count_values_over_time("observed", window="5m").build(mode="metricsql")

查看声明 ↗此方法的链接

decreases_over_time()统计回看窗口内相邻样本下降的次数。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.decreases_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

default_rollup()使用 VictoriaMetrics 的默认回看选择方式返回最后一个原始样本。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.default_rollup(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

delta_prometheus()使用 MetricsQL delta_prometheus 窗口函数，请求与 Prometheus 兼容的 delta 窗口行为。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.delta_prometheus(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

deriv_fast()用第一个和最后一个样本估算斜率，而不拟合全部样本。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.deriv_fast(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

descent_over_time()累加回看窗口内样本之间负向变化量的绝对值。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.descent_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

distinct_over_time()计算每条序列回看窗口内样本的不同值的数量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.distinct_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

duration_over_time()估算样本覆盖的时长，大于给定最大间隔的空档视为中断。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.duration_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	允许的最大样本间隔，单位为秒，应使用正标量。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

geomean_over_time()计算每条序列回看窗口内样本的几何平均值。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.geomean_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

histogram_over_time()根据每条序列回看窗口内的值构建 MetricsQL 直方图。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.histogram_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

hoeffding_bound_lower()估算窗口均值的 Hoeffding 置信下界。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.hoeffding_bound_lower(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	[0, 1] 内的置信概率，越界或计算得到的输入由后端处理。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

hoeffding_bound_upper()估算窗口均值的 Hoeffding 置信上界。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.hoeffding_bound_upper(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	[0, 1] 内的置信概率，越界或计算得到的输入由后端处理。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

ideriv()估算最近两个样本之间的斜率。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.ideriv(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

increase_prometheus()使用 MetricsQL increase_prometheus 窗口函数，请求与 Prometheus 兼容的 increase 窗口行为。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.increase_prometheus(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

increase_pure()使用 MetricsQL 对初始样本的纯计数器处理方式计算增长量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.increase_pure(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

increases_over_time()统计回看窗口内相邻样本上升的次数。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.increases_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

integrate()估算样本值随时间的积分，单位为数值乘秒。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.integrate(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

lag()返回回看窗口中最新样本距今的秒数。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.lag(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

lifetime()返回回看窗口内第一个和最后一个样本相隔的秒数。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.lifetime(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

outlier_iqr_over_time()根据窗口内四分位距判断最新值是否为异常值。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.outlier_iqr_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

quantiles_over_time()分别计算每条序列回看窗口内的多个分位数。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.quantiles_over_time(label: StringInput, *quantiles: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`label`str必填	不含控制字符的非空标签名。方言要求时，构建器会为名称加引号。
`*quantiles`int \| float \| QueryBuilder, ...可变参数	一个或多个分位数，通常各自在 [0, 1] 内。PromQL histogram_quantiles 最多接受 10 个，MetricsQL 支持自己的可变参数形式。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

range_over_time()返回回看窗口内最大样本值与最小样本值之差。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.range_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

rate_prometheus()使用 MetricsQL rate_prometheus 窗口函数，请求与 Prometheus 兼容的 rate 窗口行为。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.rate_prometheus(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

rollup_candlestick()计算 MetricsQL 回看窗口内的开、高、低、收值，或选择其中一个分量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.rollup_candlestick(window: Optional[Window]=None, *, result: Optional[StringInput]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。
`result`str \| None默认值： None	选择 'open'、'high'、'low' 或 'close'，None 返回全部四种。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

rollup_delta()计算 MetricsQL 回看窗口内连续样本差值的最小值、最大值和平均值，或选择其中一种统计量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.rollup_delta(window: Optional[Window]=None, *, result: Optional[StringInput]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。
`result`str \| None默认值： None	选择 'min'、'max' 或 'avg'；None 输出全部三种结果序列。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

rollup_deriv()计算 MetricsQL 回看窗口内连续样本每秒斜率的最小值、最大值和平均值，或选择其中一种统计量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.rollup_deriv(window: Optional[Window]=None, *, result: Optional[StringInput]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。
`result`str \| None默认值： None	选择 'min'、'max' 或 'avg'；None 输出全部三种结果序列。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

rollup_increase()计算 MetricsQL 回看窗口内计数器增长量的最小值、最大值和平均值，或选择其中一种统计量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.rollup_increase(window: Optional[Window]=None, *, result: Optional[StringInput]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。
`result`str \| None默认值： None	选择 'min'、'max' 或 'avg'；None 输出全部三种结果序列。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

rollup_scrape_interval()计算 MetricsQL 回看窗口内采样间隔的最小值、最大值和平均值，或选择其中一种统计量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.rollup_scrape_interval(window: Optional[Window]=None, *, result: Optional[StringInput]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。
`result`str \| None默认值： None	选择 'min'、'max' 或 'avg'；None 输出全部三种结果序列。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

scrape_interval()估算原始样本之间的间隔秒数。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.scrape_interval(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

share_eq_over_time()返回窗口内值等于给定阈值的样本的比例。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.share_eq_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

share_gt_over_time()返回窗口内值大于给定阈值的样本的比例。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.share_gt_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

share_le_over_time()返回窗口内值小于等于给定阈值的样本的比例。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.share_le_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

stale_samples_over_time()统计 MetricsQL 回看窗口内的陈旧标记数量。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.stale_samples_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

sum2_over_time()计算每条序列回看窗口内样本的平方和。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.sum2_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

sum_eq_over_time()返回窗口内值等于给定阈值的样本的总和。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.sum_eq_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

sum_gt_over_time()返回窗口内值大于给定阈值的样本的总和。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.sum_gt_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

sum_le_over_time()返回窗口内值小于等于给定阈值的样本的总和。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.sum_le_over_time(value: ScalarInput, window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`value`int \| float \| QueryBuilder必填	与窗口内每个原始样本比较的阈值。接受数字标量，拒绝 bool；满足命名比较条件的样本计入结果。
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

tfirst_over_time()返回回看窗口内第一个值的 Unix 时间戳。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.tfirst_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

timestamp_with_name()返回最新样本的时间戳，并保留指标名。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.timestamp_with_name(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

tlast_change_over_time()返回窗口内最后一次样本值变化的时间戳。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.tlast_change_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

tlast_over_time()返回回看窗口内最后一个值的 Unix 时间戳。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.tlast_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

tmax_over_time()返回回看窗口内最大值最后一次出现的 Unix 时间戳。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.tmax_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接

tmin_over_time()返回回看窗口内最小值最后一次出现的 Unix 时间戳。仅限 MetricsQL

仅限 MetricsQL

QueryBuilder.tmin_over_time(window: Optional[Window]=None) -> QueryBuilder

参数
参数 / 类型	含义与可接受的值
`window`str \| QueryBuilder \| None默认值： None	正回看时长，如 '5m' 或 '1h30m'。None 保留已有范围或使用 MetricsQL 隐式 rollup；无窗口的裸选择器不能构建为 PromQL。时长表达式需要对应方言或功能支持。

返回值 QueryBuilder：共享未变化原生子树的新不可变表达式。接收表达式不变，不查询数据。

查看声明 ↗此方法的链接