Prometheus引入‘@’修飾符的方法

你有沒(méi)有選擇過(guò)10個(gè)時(shí)間序列，但得到不是10個(gè)，而是100個(gè)？如果有，這是給你的。讓我?guī)懔私庖幌聺撛诘膯?wèn)題是什么，以及我是如何解決它的。

目前，topk()查詢(xún)僅作為一個(gè)即時(shí)查詢(xún)才有意義，你得到確切的k個(gè)結(jié)果，但當(dāng)你作為一個(gè)范圍查詢(xún)運(yùn)行它時(shí)，你可以得到更多的結(jié)果，因?yàn)槊恳徊蕉际仟?dú)立計(jì)算的。這個(gè)@修飾符允許你修復(fù)范圍查詢(xún)中所有步驟的排名。

在Prometheus v2.25.0中，我們引入了一個(gè)新的PromQL修飾符@。與offset修飾符讓你對(duì)向量選擇器、范圍向量選擇器和子查詢(xún)的求值進(jìn)行相對(duì)于求值時(shí)間的固定時(shí)間偏移類(lèi)似，@修飾符讓你對(duì)這些選擇器的求值進(jìn)行固定，而不考慮查詢(xún)求值時(shí)間。該語(yǔ)法的功勞歸于Bj?rn Rabenstein。

<vector-selector> @ <timestamp>
<range-vector-selector> @ <timestamp>
<subquery> @ <timestamp>

<timestamp>是一個(gè)unix時(shí)間戳，用float文字描述。

例如，查詢(xún)http_requests_total @ 1609746000返回的是http_requests_total在2021-01-04T07:40:00+00:00的值。查詢(xún)r(jià)ate(http_requests_total[5m] @ 1609746000)返回同時(shí)http_requests_total的5分鐘速率。

此外，start()和end()也可以作為特殊值作為@修飾符的值。對(duì)于范圍查詢(xún)，它們分別解析到范圍查詢(xún)的開(kāi)始和結(jié)束，并且對(duì)所有步驟保持相同。對(duì)于即時(shí)查詢(xún)，start()和end()都解析為計(jì)算時(shí)間。

回到topk()修復(fù)的討論，下面的查詢(xún)繪制了這些系列中http_requests_total的1m速率，它們的最后一個(gè)1h速率位于前5位。因此，現(xiàn)在你可以理解topk()，甚至可以將其作為一個(gè)范圍查詢(xún)，精確地繪制出k個(gè)結(jié)果。

rate(http_requests_total[1m]) # This acts like the actual selector.
  and
topk(5, rate(http_requests_total[1h] @ end())) # This acts like a ranking function which filters the selector.

類(lèi)似地，topk()排名可以用其他函數(shù)代替，比如histogram_quantile()，它現(xiàn)在只用于即時(shí)查詢(xún)。rate()可以用<aggregation>_over_time()等替換。讓我們知道你如何使用這個(gè)新的修飾符！

@修飾符默認(rèn)是禁用的，可以使用標(biāo)志--enable-feature=promql-at-modifier來(lái)啟用。