Documentation
Table of Contents
1 Funkcje agreguj?ce
Z wyj?tkiem przypadk¨®w, gdzie zaznaczono inaczej, wszystkie funkcje wymienione tutaj s? obs?ugiwane w:
Funkcje agreguj?ce mog? dzia?a? z:
- histori? pozycji, na przyk?ad
min(/host/key,1h) - funkcjami foreach jako jedynym parametrem, na przyk?ad
min(last_foreach(/*/key))(tylko w pozycjach obliczonych; nie mo?na ich u?ywa? w wyzwalaczach)
Kilka og¨®lnych uwag dotycz?cych parametr¨®w funkcji:
- Parametry funkcji s? oddzielone przecinkiem
- Opcjonalne parametry funkcji (lub ich cz??ci) s? oznaczone
<> - Parametry specyficzne dla funkcji s? opisane przy ka?dej funkcji
- Parametry
/host/keyi(sec|#num)<:time shift>nigdy nie powinny by? w cudzys?owiu
Wsp¨®lne parametry
/host/keyto wsp¨®lny obowi?zkowy pierwszy parametr dla funkcji, odnosz?cych si? do historii pozycji hosta(sec|#num)<:time shift>to wsp¨®lny drugi parametr dla funkcji, odnosz?cych si? do historii pozycji hosta, gdzie:- sec - maksymalny okres ewaluacji w sekundach (mo?na u?ywa? przyrostk¨®w czasowych), lub
- #num - maksymalny zakres ewaluacji w ostatnio zbieranych warto?ciach (je?li poprzedzony jest znakiem hash)
- time shift (opcjonalny) pozwala przesun?? punkt ewaluacji wstecz w czasie. Zobacz wi?cej szczeg¨®?¨®w na temat okre?lania przesuni?cia czasowego.
Funkcje agreguj?ce
| FUNKCJA | ||
|---|---|---|
| Opis | Specyficzne parametry funkcji | Komentarze |
| avg (/host/key,(sec|#num)<:time shift>) | ||
| ?rednia warto?? pozycji w zdefiniowanym okresie ewaluacji. | Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Przyk?ady: => avg(/host/key,1h) ¡ú ?rednia warto?? z ostatniej godziny do teraz => avg(/host/key,1h:now-1d) ¡ú ?rednia warto?? z godziny sprzed 25 godzin do 24 godzin temu od teraz => avg(/host/key,#5) ¡ú ?rednia warto?? z pi?ciu ostatnich warto?ci => avg(/host/key,#5:now-1d) ¡ú ?rednia warto?? z pi?ciu ostatnich warto?ci, wy??czaj?c warto?ci otrzymane w ci?gu ostatnich 24 godzin Przesuni?cie czasowe jest przydatne, gdy istnieje potrzeba por¨®wnania bie??cej ?redniej warto?ci z warto?ci? ?redni? sprzed pewnego czasu. |
| bucket_percentile (item filter,time period,percentage) | ||
| Oblicza percentyl z przedzia?¨®w histogramu. | item filter - patrz filtr pozycji time period - patrz okres czasu percentage - procent (0-100) |
Obs?ugiwane tylko w pozycjach obliczonych. Ta funkcja jest aliasem dla histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1)) |
| count (func_foreach(item filter,<time period>)) | ||
| Liczba warto?ci w tablicy zwracanej przez funkcj? foreach. | func_foreach - funkcja foreach, dla kt¨®rej liczba zwr¨®conych warto?ci powinna by? zliczona (z obs?ugiwanymi argumentami). Patrz funkcje foreach dla szczeg¨®?¨®w. | Obs?ugiwany typ warto?ci: int Obs?ugiwane funkcje foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Przyk?ad: => count(max_foreach(/*/net.if.in[*],1h)) ¡ú liczba pozycji net.if.in, kt¨®re otrzyma?y dane w ci?gu ostatniej godziny do teraz Nale?y zauwa?y?, ?e korzystanie z count() z funkcj? foreach zwi?zan? z histori? (max_foreach, avg_foreach, itp.) mo?e prowadzi? do konsekwencji wydajno?ciowych, podczas gdy korzystanie z exists_foreach(), kt¨®ra dzia?a tylko z danymi konfiguracji, nie b?dzie mia?o takiego efektu. |
| histogram_quantile (quantile,bucket1,value1,bucket2,value2,...) | ||
| Oblicza ¦Õ-kwantyl z przedzia?¨®w (kube?k¨®w) histogramu. | quantile - 0 ¡Ü ¦Õ ¡Ü 1 bucketN, valueN - r?cznie wprowadzone pary (>=2) parametr¨®w lub odpowied? z bucket_rate_foreach |
Obs?ugiwane tylko w pozycjach obliczonych. Obs?ugiwane funkcje foreach: bucket_rate_foreach Funkcjonalnie odpowiada '' w PromQL. Zwraca -1, je?li warto?ci ostatniego kube?ka 'Infinity' ("+inf") s? r¨®wne 0. Przyk?ady: => histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf]) => histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s)) |
| item_count (item filter) | ||
| Liczba istniej?cych pozycji w konfiguracji pasuj?cych do kryteri¨®w filtra. | item filter - kryteria wyboru pozycji, umo?liwia odwo?ywanie si? do grupy host¨®w, hosta, klucza pozycji i znacznik¨®w. Obs?ugiwane s? symbole wildcard. Patrz filtr pozycji po wi?cej szczeg¨®?¨®w. | Obs?ugiwane tylko w pozycjach obliczonych. Obs?ugiwany typ warto?ci: int Dzia?a jako alias dla funkcji count(exists_foreach(filtr_pozycji)). Przyk?ad: => item_count(/*/agent.ping?[group="Host group 1"]) ¡ú liczba host¨®w z pozycj? agent.ping w "Host group 1" |
| kurtosis (/host/key,(sec|#num)<:time shift>) | ||
| "Sp?aszczenie" rozk?adu prawdopodobie¨½stwa w zebranych warto?ciach w zdefiniowanym okresie ewaluacji. Zobacz r¨®wnie?: |
Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: last_foreach Przyk?ad: => kurtosis(/host/key,1h) ¡ú kurtoza z ostatniej godziny do teraz |
| mad (/host/key,(sec|#num)<:time shift>) | ||
| ?rednie odchylenie bezwzgl?dne w zebranych warto?ciach w zdefiniowanym okresie ewaluacji. Zobacz r¨®wnie?: |
Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: last_foreach Przyk?ad: => mad(/host/key,1h) ¡ú ?rednie odchylenie bezwzgl?dne z ostatniej godziny do teraz |
| max (/host/key,(sec|#num)<:time shift>) | ||
| Najwy?sza warto?? pozycji w zdefiniowanym okresie ewaluacji. | Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Przyk?ad: => max(/host/key,1h) - min(/host/key,1h) ¡ú oblicz r¨®?nic? mi?dzy maksymaln? a minimaln? warto?ci? w ci?gu ostatniej godziny do teraz (r¨®?nica warto?ci) |
| min (/host/key,(sec|#num)<:time shift>) | ||
| Najni?sza warto?? pozycji w zdefiniowanym okresie ewaluacji. | Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Przyk?ad: => max(/host/key,1h) - min(/host/key,1h) ¡ú oblicz r¨®?nic? mi?dzy maksymaln? a minimaln? warto?ci? w ci?gu ostatniej godziny do teraz (r¨®?nica warto?ci) |
| skewness (/host/key,(sec|#num)<:time shift>) | ||
| Asymetria rozk?adu prawdopodobie¨½stwa w zebranych warto?ciach w zdefiniowanym okresie ewaluacji. Zobacz r¨®wnie?: |
Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: last_foreach Przyk?ad: => skewness(/host/key,1h) ¡ú asymetria dla ostatniej godziny do teraz |
| stddevpop (/host/key,(sec|#num)<:time shift>) | ||
| Odchylenie standardowe populacji w zebranych warto?ciach w zdefiniowanym okresie ewaluacji. Zobacz r¨®wnie?: |
Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: last_foreach Przyk?ad: => stddevpop(/host/key,1h) ¡ú odchylenie standardowe populacji dla ostatniej godziny do teraz |
| stddevsamp (/host/key,(sec|#num)<:time shift>) | ||
| Odchylenie standardowe pr¨®by w zebranych warto?ciach w zdefiniowanym okresie ewaluacji. Zobacz r¨®wnie?: |
Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: last_foreach Do dzia?ania tej funkcji wymagane s? co najmniej dwie warto?ci danych. Przyk?ad: => stddevsamp(/host/key,1h) ¡ú odchylenie standardowe pr¨®by dla ostatniej godziny do teraz |
| sum (/host/key,(sec|#num)<:time shift>) | ||
| Suma zebranych warto?ci w zdefiniowanym okresie ewaluacji. | Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Przyk?ad: => sum(/host/key,1h) ¡ú suma warto?ci z ostatniej godziny do teraz |
| sumofsquares (/host/key,(sec|#num)<:time shift>) | ||
| Suma kwadrat¨®w zebranych warto?ci w zdefiniowanym okresie ewaluacji. | Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: last_foreach Przyk?ad: => sumofsquares(/host/key,1h) ¡ú suma kwadrat¨®w z ostatniej godziny do teraz |
| varpop (/host/key,(sec|#num)<:time shift>) | ||
| Wariancja populacji zebranych warto?ci w zdefiniowanym okresie ewaluacji. Zobacz r¨®wnie?: |
Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: last_foreach Przyk?ad: => varpop(/host/key,1h) ¡ú wariancja populacji dla ostatniej godziny do teraz |
| varsamp (/host/key,(sec|#num)<:time shift>) | ||
| Wariancja pr¨®bki zebranych warto?ci w zdefiniowanym okresie ewaluacji. Zobacz r¨®wnie?: |
Patrz wsp¨®lne parametry. | Obs?ugiwane typy warto?ci: float, int Obs?ugiwane funkcje foreach: last_foreach Do dzia?ania tej funkcji wymagane s? co najmniej dwie warto?ci danych. Przyk?ad: => varsamp(/host/key,1h) ¡ú wariancja pr¨®bki dla ostatniej godziny do teraz |