[comment]: # attributes: notoc

[comment]: # (terms:  avg, bucket_percentile, count, histogram_quantile, item_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp )

[comment]: # (tags:  count )

[comment]: # ({4fbe3c6f-ee60e21e})
# 1 Apkopojošās funkcijas

Ja nav norādīts citādi, visas šeit uzskaitītās funkcijas tiek atbalstītas:

-   [Trigeru izteiksmēs](/manual/config/triggers/expression)
-   [Aprēķināto vienumu formulās](/manual/config/items/itemtypes/calculated)
-   [Izteiksmju makrosos](/manual/config/macros/expression_macros)

Apkopojošās funkcijas var darboties ar:

-   vienumu vēsturi, piemēram, `min(/host/key,1h)`
-   [foreach funkcijām](/manual/config/triggers/expression/aggregate/foreach) kā
    vienīgo parametru, piemēram, `min(last_foreach(/*/key))` (tikai aprēķināto vienumu formulās; lai izmantotu trigeros, atsaucieties uz aprēķināto vienumu pēc tā atslēgas)

Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju.

|Function|Description|
|--|--------|
|[avg](#avg)|Vienuma vidējā vērtība noteiktajā novērtēšanas periodā.|
|[bucket_percentile](#bucket-percentile)|Aprēķina procentili no histogrammas spaiņiem.|
|[count](#count)|Vērtību skaits masīvā, ko atgriež foreach funkcija.|
|[histogram_quantile](#histogram-quantile)|Aprēķina φ-kvantiļu no histogrammas spaiņiem.|
|[item_count](#item-count)|Esošo konfigurācijas vienumu skaits, kas atbilst filtra kritērijiem.|
|[kurtosis](#kurtosis)|Savāktajās vērtībās noteiktajā novērtēšanas periodā esošās varbūtības sadalījuma "astes" izteiktība.|
|[mad](#mad)|Savākto vērtību mediānas absolūtā novirze noteiktajā novērtēšanas periodā.|
|[max](#max)|Vienuma augstākā vērtība noteiktajā novērtēšanas periodā.|
|[min](#min)|Vienuma zemākā vērtība noteiktajā novērtēšanas periodā.|
|[skewness](#skewness)|Savāktajās vērtībās noteiktajā novērtēšanas periodā esošās varbūtības sadalījuma asimetrija.|
|[stddevpop](#stddevpop)|Populācijas standartnovirze savāktajās vērtībās noteiktajā novērtēšanas periodā.|
|[stddevsamp](#stddevsamp)|Izlases standartnovirze savāktajās vērtībās noteiktajā novērtēšanas periodā.|
|[sum](#sum)|Savākto vērtību summa noteiktajā novērtēšanas periodā.|
|[sumofsquares](#sumofsquares)|Savākto vērtību kvadrātu summa.|
|[varpop](#varpop)|Savākto vērtību populācijas dispersija noteiktajā novērtēšanas periodā.|
|[varsamp](#varsamp)|Savākto vērtību izlases dispersija noteiktajā novērtēšanas periodā.|

[comment]: # ({/4fbe3c6f-ee60e21e})

[comment]: # ({a83c5ed7-4d343eb8})
#### Kopējie parametri

-   `/host/key` ir kopīgs obligāts pirmais parametrs funkcijām, kas atsaucas uz hosta vienuma vēsturi
-   `(sec|#num)<:time shift>` ir kopīgs otrais parametrs funkcijām, kas atsaucas uz hosta vienuma vēsturi, kur:
    -   **sec** - maksimālais [izvērtēšanas periods](/manual/config/triggers/expression#time-period) sekundēs (var izmantot laika [sufiksus](/manual/appendix/suffixes)), vai
    -   **\#num** - maksimālais [izvērtēšanas diapazons](/manual/config/triggers/expression#time-period) pēdējās savāktajās vērtībās (ja tam priekšā ir hash zīme)
    -   **time shift** (neobligāts) ļauj pārvietot izvērtēšanas punktu atpakaļ laikā. Skatiet [papildu informāciju](/manual/config/triggers/expression#time-shift) par time shift norādīšanu.

[comment]: # ({/a83c5ed7-4d343eb8})

[comment]: # ({c645f0e4-fe53c04c})
### Funkciju informācija

Dažas vispārīgas piezīmes par funkciju parametriem:

-   Funkciju parametrus atdala ar komatu
-   Neobligātie funkciju parametri (vai parametru daļas) ir norādīti ar
    `<` `>`
-   Katrai funkcijai specifiskie parametri ir aprakstīti pie attiecīgās funkcijas
-   Parametri `/host/key` un `(sec|#num)<:time shift>` nekad nedrīkst būt
    pēdiņās

[comment]: # ({/c645f0e4-fe53c04c})

[comment]: # ({2844b0b7-f5993b4c})
##### avg(/host/key,(sec|#num)<:time shift>) {#avg}

Vienuma vidējā vērtība noteiktajā novērtēšanas periodā.<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītās [foreach funkcijas](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Laika nobīde ir noderīga, ja nepieciešams salīdzināt pašreizējo vidējo vērtību ar vidējo vērtību kādu laiku iepriekš.

Piemēri:

```default
avg(/host/key,1h) #aprēķināt vidējo vērtību pēdējai stundai līdz šim brīdim
avg(/host/key,#5) #aprēķināt piecu jaunāko vērtību vidējo vērtību
avg(/host/key,1h:now-1d) #aprēķināt vidējo vērtību vienai stundai no perioda pirms 25 stundām līdz periodam pirms 24 stundām no pašreizējā brīža
avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) #aprēķināt vidējo procesora slodzi visiem MySQL serveriem
avg(/host/proc.num,5m)>300 #trigeris, ja vidējais procesu skaits pēdējās 5 minūtēs ir bijis virs 300
```

[comment]: # ({/2844b0b7-f5993b4c})

[comment]: # ({ae55eda6-af24d13f})
##### bucket_percentile(item filter,time period,percentage) {#bucket-percentile}

Aprēķina procentili no histogrammas spaiņiem.<br>

Parametri: 

-   **vienuma filtrs** - skatiet [vienuma filtru](/manual/config/triggers/expression/aggregate/foreach#item-filter-syntax);<br>
-   **laika periods** - skatiet [laika periodu](/manual/config/triggers/expression/aggregate/foreach#time-period);<br>
-   **procentuālā vērtība** - procenti (0-100).

Komentāri:

-   Atbalstīts tikai aprēķinātajos vienumos;
-   Šī funkcija ir aizstājvārds `histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))`.

Piemēri:

```default
bucket_percentile(/*/http_request_duration_seconds_bucket[*],5m,95) #calculate the 95th percentile response time over 5 minutes
bucket_percentile(/*/apiserver_request_duration_seconds_bucket[*],10m,99) #calculate the 99th percentile API latency
```

[comment]: # ({/ae55eda6-af24d13f})

[comment]: # ({4520f3ef-3c498650})
##### count(func_foreach(item filter,<time period>),<operator>,<pattern>) {#count}

Vērtību skaits masīvā, ko atgriež foreach funkcija.<br>
Atbalstītās [foreach funkcijas](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parametri: 

-   **func_foreach** - foreach funkcija, kurai jāaprēķina atgriezto vērtību skaits. Sīkāku informāciju skatiet [foreach funkcijās](/manual/config/triggers/expression/aggregate/foreach). Ņemiet vērā, ka count_foreach un bucket_rate_foreach atbalsta [papildu parametrus](/manual/config/triggers/expression/aggregate/foreach#additional-parameters).
-   **item filter** - skatiet [vienuma filtru](/manual/config/triggers/expression/aggregate/foreach#item-filter-syntax);<br>
-   **time period** - skatiet [laika periodu](/manual/config/triggers/expression/aggregate/foreach#time-period);<br>
-   **operator** (jābūt dubultpēdiņās). Atbalstītie `operatori`:<br>*eq* - vienāds<br>*ne* - nav vienāds<br>*gt* - lielāks<br>*ge* - lielāks vai vienāds<br>*lt* - mazāks<br>*le* - mazāks vai vienāds<br>*like* - atbilst, ja satur šablonu (reģistrjutīgs)<br>*bitand* - bitu AND<br>*regexp* - reģistrjutīga atbilstība regulārajai izteiksmei, kas norādīta `pattern`<br>*iregexp* - reģistrnejutīga atbilstība regulārajai izteiksmei, kas norādīta `pattern`<br>
-   **pattern** - nepieciešamais šablons (virknes argumentiem jābūt dubultpēdiņās); tiek atbalstīts, ja *operator* ir norādīts trešajā parametrā.

Komentāri: 

-   Izmantojot **count()** ar vēsturei piesaistītu foreach funkciju (max_foreach, avg_foreach u.c.), var rasties ietekme uz veiktspēju, savukārt **exists_foreach()** izmantošana, kas darbojas tikai ar konfigurācijas datiem, šādu efektu neradīs.
-   Neobligātos parametrus *operator* vai *pattern* pēc komata nevar atstāt tukšus, tos var tikai pilnībā izlaist.
-   Ja kā trešais parametrs tiek izmantots *bitand*, ceturto `pattern` parametru var norādīt kā divus skaitļus, kas atdalīti ar '/': **number_to_compare_with/mask**. count() aprēķina "bitu AND" no vērtības un *mask*, un salīdzina rezultātu ar *number_to_compare_with*. Ja "bitu AND" rezultāts ir vienāds ar *number_to_compare_with*, vērtība tiek ieskaitīta.<br>Ja *number_to_compare_with* un *mask* ir vienādi, var norādīt tikai *mask* (bez '/').
-   Ja kā trešais parametrs tiek izmantots *regexp* vai *iregexp*, ceturtais `pattern` parametrs var būt parasta vai [globāla](/manual/regular_expressions#global-regular-expressions) (sākas ar '@') regulārā izteiksme. Globālo regulāro izteiksmju gadījumā reģistrjutība tiek pārmantota no globālās regulārās izteiksmes iestatījumiem. Regulārās izteiksmes salīdzināšanai peldošā komata vērtības vienmēr tiks attēlotas ar 4 zīmēm aiz '.'. Ņemiet vērā arī to, ka lieliem skaitļiem atšķirība starp decimālo (glabājas datubāzē) un bināro (izmanto Zabbix serveris) attēlojumu var ietekmēt 4. zīmi aiz komata.

Piemēri:

```default
count(max_foreach(/*/net.if.in[*],1h)) #calculate the number of net.if.in items that received data in the last hour until now
count(last_foreach(/*/vfs.fs.size[*,pused]),"gt",95) #calculate the number of file systems with over 95% of disk space used
```

[comment]: # ({/4520f3ef-3c498650})

[comment]: # ({3ba37963-f3ad7158})
##### histogram_quantile(quantile,bucket1,value1,bucket2,value2,...) {#histogram-quantile}

Aprēķina φ-kvantili no histogrammas spaiņiem.<br>
Atbalstītā [foreach funkcija](/manual/config/triggers/expression/aggregate/foreach): *bucket_rate_foreach*.

Parametri: 

-   **quantile** — 0 ≤ φ ≤ 1;<br>
-   **bucketN, valueN** — manuāli ievadīti parametru pāri (>=2) vai [bucket_rate_foreach](/manual/config/triggers/expression/aggregate/foreach) atbilde.

Komentāri:

-   Atbalstīts tikai aprēķinātajos vienumos;
-   Funkcionāli atbilst PromQL funkcijai '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram-quantile)';
-   Atgriež -1, ja pēdējā 'Infinity' spaiņa (*"+inf"*) vērtības ir vienādas ar 0.

Piemēri:

```default
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))
```

[comment]: # ({/3ba37963-f3ad7158})

[comment]: # ({b14d0146-c8e3133a})
##### item_count(item filter) {#item-count}

Konfigurācijā esošo vienumu skaits, kas atbilst filtra kritērijiem.<br>
Atbalstītais vērtības tips: *Integer*.

Parametrs: 

-   **vienuma filtrs** — vienumu atlases kritēriji; ļauj veikt atsauces pēc hostu grupas, hosta, vienuma atslēgas un tagiem. Tiek atbalstītas aizstājējzīmes. Plašāku informāciju skatiet [vienuma filtrs](/manual/config/triggers/expression/aggregate/foreach#item-filter-syntax).<br>

Komentāri:

-   Atbalstīts tikai aprēķinātajos vienumos;
-   Darbojas kā funkcijas *count(exists_foreach(item_filter))* aizstājvārds.

Piemēri:

```default
item_count(/*/agent.ping?[group="Host group 1"]) #aprēķina hostu skaitu ar vienumu agent.ping grupā "Host group 1"
```

[comment]: # ({/b14d0146-c8e3133a})

[comment]: # ({356d9069-88a54099})
##### kurtosis(/host/key,(sec|#num)<:time shift>) {#kurtosis}

Savākto vērtību varbūtības sadalījuma "astainums" noteiktajā novērtēšanas periodā. Skatiet arī: [Kurtosis](https://en.wikipedia.org/wiki/Kurtosis).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach function](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parametri: skatiet [common parameters](#common-parameters).

Piemēri:

```default
kurtosis(/host/system.cpu.util[,user],5m)>5 #trigeris uz straujiem CPU noslodzes pīķiem 5 minūšu laikā
```

[comment]: # ({/356d9069-88a54099})

[comment]: # ({98a81503-bfb43a27})
##### mad(/host/key,(sec|#num)<:time shift>) {#mad}

Mediānā absolūtā novirze savāktajām vērtībām definētajā novērtēšanas periodā. Skatiet arī: [Mediānā absolūtā novirze](https://en.wikipedia.org/wiki/Median_absolute_deviation).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach funkcija](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Piemēri:

```default
last(/host/system.cpu.util[,user])>avg(/host/system.cpu.util[,user],1h)+3*mad(/host/system.cpu.util[,user],1h) #trigeris, ja pēdējā CPU noslodzes vērtība ir statistiski nozīmīga
```

[comment]: # ({/98a81503-bfb43a27})

[comment]: # ({e93a3513-5882010b})
##### max(/host/key,(sec|#num)<:time shift>) {#max}

Vienuma augstākā vērtība noteiktajā novērtēšanas periodā.<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītās [foreach funkcijas](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Piemēri:

```default
max(/host/key,1h) - min(/host/key,1h) #aprēķina starpību starp maksimālo un minimālo vērtību pēdējās stundas laikā līdz šim brīdim (vērtību delta)
max(last_foreach(/*/vfs.fs.size[*,pused]?[group="Linux servers"])) #atgriež augstāko diska lietojumu visos Linux serveros
```

[comment]: # ({/e93a3513-5882010b})

[comment]: # ({cfe7b652-ffd1e499})
##### min(/host/key,(sec|#num)<:time shift>) {#min}

Zemākā vienuma vērtība noteiktajā novērtēšanas periodā.<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītās [foreach functions](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Piemēri:

```default
max(/host/key,1h) - min(/host/key,1h) #aprēķina starpību starp maksimālo un minimālo vērtību pēdējās stundas laikā līdz šim brīdim (vērtību delta)
min(last_foreach(/*/vfs.file.contents["/sys/class/net/enp0s3/operstate"]?[group="Linux servers"])) #atgriež minimālo darbības stāvokli jebkurai saskarnei visos Linux serveros
```

[comment]: # ({/cfe7b652-ffd1e499})

[comment]: # ({f9d7543b-6b6fb273})
##### skewness(/host/key,(sec|#num)<:time shift>) {#skewness}

Savākto vērtību varbūtības sadalījuma asimetrija noteiktajā novērtēšanas periodā. Skatiet arī: [Skewness](https://en.wikipedia.org/wiki/Skewness).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach funkcija](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Piemēri:

```default
skewness(/host/vm.memory.size[used],5m)<-20 #trigeris pēkšņiem negatīviem kritumiem, kas norāda uz avārijām/pārstartēšanām
```

[comment]: # ({/f9d7543b-6b6fb273})

[comment]: # ({7e32d94e-11c2ea25})
##### stddevpop(/host/key,(sec|#num)<:time shift>) {#stddevpop}

Populācijas standartnovirze savāktajās vērtībās noteiktajā novērtēšanas periodā. Skatiet arī: [Standartnovirze](https://en.wikipedia.org/wiki/Standard_deviation).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach funkcija](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Piemēri:

```default
stddevpop(/host/system.cpu.util[,user],10m)>7 #trigeris, ja CPU lietojums stipri svārstās (populācijas standartnovirze ir virs 7 10 minūšu laikā)
```

[comment]: # ({/7e32d94e-11c2ea25})

[comment]: # ({23ca7fe4-1db77c44})
##### stddevsamp(/host/key,(sec|#num)<:time shift>) {#stddevsamp}

Izlases standartnovirze savāktajām vērtībām noteiktajā novērtēšanas periodā. Skatiet arī: [Standartnovirze](https://en.wikipedia.org/wiki/Standard_deviation).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach funkcija](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Lai šī funkcija darbotos, ir nepieciešamas vismaz divas datu vērtības.

Piemēri:

```default
stddevsamp(/host/system.cpu.util[,user],10m)>7 #trigeris, ja CPU lietojums stipri svārstās (izlases standartnovirze ir virs 7 10 minūšu laikā)
```

[comment]: # ({/23ca7fe4-1db77c44})

[comment]: # ({89b5406f-0ecf79eb})
##### sum(/host/key,(sec|#num)<:time shift>) {#sum}

Savākto vērtību summa definētajā novērtēšanas periodā.<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītās [foreach funkcijas](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Piemēri:

```default
sum(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #aprēķina kopējo ienākošās tīkla plūsmas apjomu visiem Linux serveriem
sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) #aprēķina kopējo diska vietas apjomu visiem MySQL serveriem
sum(last_foreach(/*/net.dns[*,*,*])) #aprēķina kopējo veiksmīgo DNS pārbaužu skaitu
```

[comment]: # ({/89b5406f-0ecf79eb})

[comment]: # ({907627c8-6f6556f2})
##### sumofsquares(/host/key,(sec|#num)<:time shift>) {#sumofsquares}

Savākto vērtību kvadrātu summa noteiktajā novērtēšanas periodā.<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītās [foreach function](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parametri: skatiet [common parameters](#common-parameters).

Piemēri:

```default
sumofsquares(/host/calculated.net.if.rate,1m) #tīkla datplūsmas ātruma kvadrātu summa (ienākošā pret izejošo)
sumofsquares(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #jaunāko ienākošās tīkla datplūsmas vērtību kvadrātu summa visos Linux serveros
```

[comment]: # ({/907627c8-6f6556f2})

[comment]: # ({04d271f7-d299bd33})
##### varpop(/host/key,(sec|#num)<:time shift>) {#varpop}

Savākto vērtību populācijas dispersija noteiktajā novērtēšanas periodā. Skatiet arī: [Dispersija](https://en.wikipedia.org/wiki/Variance).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach funkcija](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Piemēri:

```default
varpop(/host/system.cpu.util[,user],10m)>50 #trigeris, ja CPU lietojums stipri svārstās (dispersija ir virs 50 10 minūšu laikā)
```

[comment]: # ({/04d271f7-d299bd33})

[comment]: # ({9c60c2c9-b1bc041c})
##### varsamp(/host/key,(sec|#num)<:time shift>) {#varsamp}

Savākto vērtību izlases dispersija noteiktajā novērtēšanas periodā. Skatiet arī: [Dispersija](https://en.wikipedia.org/wiki/Variance).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach funkcija](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parametri: skatiet [kopīgos parametrus](#common-parameters).

Lai šī funkcija darbotos, ir nepieciešamas vismaz divas datu vērtības.

Piemēri:

```default
varsamp(/host/system.cpu.util[,user],10m)>50 #trigeris, ja CPU lietojums stipri svārstās (izlases dispersija ir virs 50 10 minūšu laikā)
```

[comment]: # ({/9c60c2c9-b1bc041c})

[comment]: # ({ba58f5e4-541616fc})
Skatīt [visas atbalstītās funkcijas](/manual/config/triggers/expression#functions).

[comment]: # ({/ba58f5e4-541616fc})