你有沒有選擇過10個時間序列，但得到不是10個，而是100個？如果有，這是給你的。讓我?guī)懔私庖幌聺撛诘膯栴}是什么，以及我是如何解決它的。

目前，topk()查詢僅作為一個即時查詢才有意義，你得到確切的k個結(jié)果，但當(dāng)你作為一個范圍查詢運(yùn)行它時，你可以得到更多的結(jié)果，因為每一步都是獨立計算的。這個@修飾符允許你修復(fù)范圍查詢中所有步驟的排名。

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

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

<timestamp>是一個unix時間戳，用float文字描述。

例如，查詢http_requests_total @ 1609746000返回的是http_requests_total在2021-01-04T07:40:00+00:00的值。查詢rate(http_requests_total[5m] @ 1609746000)返回同時http_requests_total的5分鐘速率。

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

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

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

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