[TOC] > [參考](https://hulining.gitbook.io/prometheus/prometheus/querying/functions) ## 函數 ``` abs(v instant-vector) //絕對值 ceil(v instant-vector) //取整 round(v instant-vector, to_nearest=1 scalar) //將v中所有元素的樣本值四舍五入到最接近的整數 floor(v instant-vector) //向下舍入到最近的整數 changes(v range-vector) //其值在提供的時間范圍內變化的次數作為即時向量返回 clamp_max(v instant-vector, max scalar) // 設置最大值 clamp_min(v instant-vector, min scalar) // 設置最小值 day_of_month(v=vector(time()) instant-vector) // UTC 時間中每個給定時間的是當月的第幾天。返回值是 1-31 day_of_week(v=vector(time()) instant-vector) //值 0-6 ,0 是周日 days_in_month(v=vector(time()) instant-vector) //返回 UTC 時間中每個給定時間的月份有幾天。返回值是 28-31 hour(v=vector(time()) instant-vector) minute(v=vector(time()) instant-vector) month(v=vector(time()) instant-vector) year(v=vector(time()) instant-vector) delta(v range-vector) // 范圍向量第一個值和最后一個值的差集 rate(v range-vector) //計算范圍向量中時間序列的每秒平均增長率 irate(v range-vector) //計算范圍向量中時間序列的每秒瞬時增長率。 //這是基于最后兩個數據點的。單調性中斷（例如由于目標重新啟動而導致的計數器重置）會自動調整 idelta(v range-vector) // 計算范圍向量中最后兩個樣本之間的差異v，返回具有給定增量和等效標簽的瞬時向量。 //idelta僅應與儀表一起使用 increase(v range-vector) //計算范圍向量中時間序列的增量。單調性中斷（例如由于目標重新啟動而導致的計數器重置）會自動調整。 // 增量被推斷為覆蓋范圍向量選擇器中指定的整個時間范圍，因此即使計數器僅按整數增量增加，也可能得到非整數結果 sort(v instant-vector) //返回按其樣本值升序排列的向量元素 sort_desc(v instant-vector) //降序 time() // 返回自 UTC 1970-01-01 以來的秒數。請注意，這實際上并不返回當前時間，而是返回要計算的表達式的時間 timestamp(v instant-vector) //返回自 UTC 1970-01-01以來，給定矢量的每個樣本的時間戳。 vector(s scalar) //將標量s作為沒有標簽的向量返回 avg_over_time(range-vector): 指定間隔中所有采樣點的平均值 min_over_time(range-vector): 指定間隔中所有采樣點的最小值 max_over_time(range-vector): 指定間隔中所有采樣點的最大值 sum_over_time(range-vector): 指定時間間隔內所有采樣點值的和 count_over_time(range-vector): 指定間隔內所有值的計數 quantile_over_time(scalar, range-vector): 指定間隔中值的 φ-quantile 分位數(0≤φ≤1) stddev_over_time(range-vector): 在指定間隔內值的總體標準差 stdvar_over_time(range-vector): 在指定間隔內值的總體標準方差 ``` ## 示例 ### 取整 實際 ``` windows_cpu_cstate_seconds_total{core="0,9",state="c2"} 114317.4443318 ``` 取證 ``` ceil(windows_cpu_cstate_seconds_total{core="0,9",state="c2"}) //114317 ``` ### rate 用于報警 計算范圍向量中時間序列的每秒平均增長率。 單調性中斷(例如由于目標重新啟動而導致的計數器重置)會自動進行調整。而且，計算會推斷到時間范圍的末尾，從而允許遺漏采集數據或采集周期與該范圍的時間段不完全對齊 以下示例表達式返回范圍向量中每個時間序列在過去 5 分鐘內每秒的 HTTP 請求速率： ``` rate(http_requests_total{job="api-server"}[5m]) ``` `rate`只能與 counter 一起使用。它最適合于警報和慢速計數器的圖形顯示。 ## 每個時間序列過去 5 分鐘內測得的 HTTP 請求數 ``` increase(http_requests_total{job="api-server"}[5m]) ```