Documentation
Table of Contents
1 ?sszes¨ªtett f¨¹ggv¨¦nyek
Hacsak m¨¢sk¨¦pp nem jelezz¨¹k, az itt felsorolt ?sszes funkci¨® t¨¢mogatott ban ben:
- [Trigger kifejez¨¦sek] (/manual/config/triggers/expression)
- Kisz¨¢m¨ªtott t¨¦telek
Az ?sszes¨ªtett f¨¹ggv¨¦nyek a k?vetkez?k b¨¢rmelyik¨¦vel m?k?dhetnek:
- elemek el?zm¨¦nyei, p¨¦ld¨¢ul
min(/host/key,1h) - foreach functions mint az egyetlen param¨¦ter, p¨¦ld¨¢ul
min(last_foreach(/*/key))
N¨¦h¨¢ny ¨¢ltal¨¢nos megjegyz¨¦s a funkci¨®param¨¦terekkel kapcsolatban:
- A funkci¨® param¨¦tereit vessz? v¨¢lasztja el
- Az opcion¨¢lis funkci¨®param¨¦tereket (vagy param¨¦terr¨¦szeket) a jelzi
<> - A funkci¨®specifikus param¨¦terek le¨ªr¨¢sa minden funkci¨®hoz tartozik
- A
/host/key¨¦s a(sec|#num)<:time shift>param¨¦terek soha nem lehetnek id¨¦zett
?ltal¨¢nos param¨¦terek
- A
/host/keya f¨¹ggv¨¦nyek ¨¢ltal¨¢nos k?telez? els? param¨¦tere hivatkozva a gazdag¨¦p elem el?zm¨¦nyeire - A
(sec|#num)<:time shift>egy gyakori m¨¢sodik param¨¦ter a a gazdag¨¦p elem t?rt¨¦net¨¦re hivatkoz¨® f¨¹ggv¨¦nyek, ahol:- mp - maximum ¨¦rt¨¦kel¨¦s id?szak m¨¢sodpercben (id? ³Ü³Ù¨®³Ù²¹²µ´Ç°ì haszn¨¢lhat¨®k), ill
- #²õ³ú¨¢³¾ - maximum ¨¦rt¨¦kel¨¦s range a legfrissebb ?sszegy?jt?tt ¨¦rt¨¦kek (ha hash jel el?zi meg)
- time shift (opcion¨¢lis) lehet?v¨¦ teszi az ¨¦rt¨¦kel¨¦si pont mozgat¨¢s¨¢t vissza az id?ben. T?bbet l¨¢tni r¨¦szletek](/manual/config/triggers/expression#time_shift) bekapcsolva id?eltol¨¢s megad¨¢sa.
Aggregate functions
| FUNCTION | ||
|---|---|---|
| Description | Function-specific parameters | Comments |
| avg (/host/key,(sec|#num)<:time shift>) | ||
| Average value of an item within the defined evaluation period. | See common parameters. | Supported value types: float, int Examples: => avg(/host/key,1h) ¡ú average value for the last hour until now => avg(/host/key,1h:now-1d) ¡ú average value for an hour from 25 hours ago to 24 hours ago from now => avg(/host/key,#5) ¡ú average value of the five latest values => avg(/host/key,#5:now-1d) ¡ú average value of the five latest values excluding the values received in the last 24 hours Time shift is useful when there is a need to compare the current average value with the average value some time ago. |
| bucket_percentile (item filter,time period,percentage) | ||
| Calculates the percentile from the buckets of a histogram. | item filter - see item filter time period - see time period percentage - percentage (0-100) |
Supported only in calculated items. This function is an alias for histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1)) |
| count (func_foreach(item filter,<time period>)) | ||
| Count of values in an array returned by a foreach function. | func_foreach - foreach function for which the number of returned values should be counted (with supported arguments). See foreach functions for details. | Supported value type: int Example: => count(max_foreach(/*/net.if.in[*],1h)) ¡ú number of net.if.in items that received data in the last hour until now Note that using count() with a history-related foreach function (max_foreach, avg_foreach, etc.) may lead to performance implications, whereas using exists_foreach(), which works only with configuration data, will not have such effect. |
| histogram_quantile (quantile,bucket1,value1,bucket2,value2,...) | ||
| Calculates the ¦Õ-quantile from the buckets of a histogram. | quantile - 0 ¡Ü ¦Õ ¡Ü 1 bucketN, valueN - manually entered pairs (>=2) of parameters or response of bucket_rate_foreach |
Supported only in calculated items. Functionally corresponds to '' of PromQL. Returns -1 if values of the last 'Infinity' bucket ("+inf") are equal to 0. Example: => 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) | ||
| Count of existing items in configuration that match filter criteria. | item filter - criteria for item selection, allows referencing by host group, host, item key, and tags. Wildcards are supported. See item filter for more details. | Supported only in calculated items. Supported value type: int Works as an alias for the count(exists_foreach(item_filter)) function. Example: => item_count(/*/agent.ping?[group="Host group 1"]) ¡ú number of hosts with the agent.ping item in the "Host group 1" |
| kurtosis (/host/key,(sec|#num)<:time shift>) | ||
| "Tailedness" of the probability distribution in collected values within the defined evaluation period. See also: |
See common parameters. | Supported value types: float, int Example: => kurtosis(/host/key,1h) ¡ú kurtosis for the last hour until now |
| mad (/host/key,(sec|#num)<:time shift>) | ||
| Median absolute deviation in collected values within the defined evaluation period. See also: |
See common-parameters. | Supported value types: float, int Example: => mad(/host/key,1h) ¡ú median absolute deviation for the last hour until now |
| max (/host/key,(sec|#num)<:time shift>) | ||
| Highest value of an item within the defined evaluation period. | See common parameters. | Supported value types: float, int Example: => max(/host/key,1h) - min(/host/key,1h) ¡ú calculate the difference between the maximum and minimum values within the last hour until now (delta of values) |
| min (/host/key,(sec|#num)<:time shift>) | ||
| Lowest value of an item within the defined evaluation period. | See common parameters. | Supported value types: float, int Example: => max(/host/key,1h) - min(/host/key,1h) ¡ú calculate the difference between the maximum and minimum values within the last hour until now (delta of values) |
| skewness (/host/key,(sec|#num)<:time shift>) | ||
| Asymmetry of the probability distribution in collected values within the defined evaluation period. See also: |
See common parameters. | Supported value types: float, int Example: => skewness(/host/key,1h) ¡ú skewness for the last hour until now |
| stddevpop (/host/key,(sec|#num)<:time shift>) | ||
| Population standard deviation in collected values within the defined evaluation period. See also: |
See common parameters. | Supported value types: float, int Example: => stddevpop(/host/key,1h) ¡ú population standard deviation for the last hour until now |
| stddevsamp (/host/key,(sec|#num)<:time shift>) | ||
| Sample standard deviation in collected values within the defined evaluation period. See also: |
See common parameters. | Supported value types: float, int At least two data values are required for this function to work. Example: => stddevsamp(/host/key,1h) ¡ú sample standard deviation for the last hour until now |
| sum (/host/key,(sec|#num)<:time shift>) | ||
| Sum of collected values within the defined evaluation period. | See common parameters. | Supported value types: float, int Example: => sum(/host/key,1h) ¡ú sum of values for the last hour until now |
| sumofsquares (/host/key,(sec|#num)<:time shift>) | ||
| The sum of squares in collected values within the defined evaluation period. | See common parameters. | Supported value types: float, int Example: => sumofsquares(/host/key,1h) ¡ú sum of squares for the last hour until now |
| varpop (/host/key,(sec|#num)<:time shift>) | ||
| Population variance of collected values within the defined evaluation period. See also: |
See common parameters. | Supported value types: float, int Example: => varpop(/host/key,1h) ¡ú population variance for the last hour until now |
| varsamp (/host/key,(sec|#num)<:time shift>) | ||
| Sample variance of collected values within the defined evaluation period. See also: |
See common parameters. | Supported value types: float, int At least two data values are required for this function to work. Example: => varsamp(/host/key,1h) ¡ú sample variance for the last hour until now |