你有沒有選擇過10個時間序列，但得到不是10個，而是100個？如果有，這是給你的。讓我帶你了解一下潛在的問題是什么，以及我是如何解決它的。

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

在Prometheus v2.25.0中，我們引入了一個新的PromQL修飾符@。與offset修飾符讓你對向量選擇器、范圍向量選擇器和子查詢的求值進行相對于求值時間的固定時間偏移類似，@修飾符讓你對這些選擇器的求值進行固定，而不考慮查詢求值時間。該語法的功勞歸于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()也可以作為特殊值作為@修飾符的值。對于范圍查詢，它們分別解析到范圍查詢的開始和結束，并且對所有步驟保持相同。對于即時查詢，start()和end()都解析為計算時間。

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

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()排名可以用其他函數代替，比如histogram_quantile()，它現在只用于即時查詢。rate()可以用<aggregation>_over_time()等替換。讓我們知道你如何使用這個新的修飾符！

@修飾符默認是禁用的，可以使用標志--enable-feature=promql-at-modifier來啟用。