[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]: # ({ac717204-ee60e21e})
# 1 Agregētā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ātajos vienumos](/manual/config/items/itemtypes/calculated)
-   [izteiksmju makrosos](/manual/config/macros/expression_macros)

Agregētās funkcijas var darboties ar vienu no šiem:

-   vienumu vēsturi, piemēram, `min(/host/key,1h)`
-   [foreach funkcijām](/manual/appendix/functions/aggregate/foreach) kā
    vienīgo parametru, piemēram, `min(last_foreach(/*/key))` (tikai aprēķinātajos vienumos; nevar izmantot trigeros)

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

|Funkcija|Apraksts|
|--|--------|
|[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)|Varbūtību sadalījuma "astes" izteiktība savāktajās vērtībās noteiktajā novērtēšanas periodā.|
|[mad](#mad)|Mediānas absolūtā novirze savāktajās vērtībās noteiktajā novērtēšanas periodā.|
|[max](#max)|Augstākā vienuma vērtība noteiktajā novērtēšanas periodā.|
|[min](#min)|Zemākā vienuma vērtība noteiktajā novērtēšanas periodā.|
|[skewness](#skewness)|Varbūtību sadalījuma asimetrija savāktajās vērtībās noteiktajā novērtēšanas periodā.|
|[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 noteiktajā novērtēšanas periodā.|
|[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]: # ({/ac717204-ee60e21e})

[comment]: # ({2acead3e-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#evaluation-period) sekundēs (var izmantot laika [piedēkļus](/manual/appendix/suffixes)), vai
    -   **\#num** - maksimālais [izvērtēšanas diapazons](/manual/config/triggers#evaluation-period) pēdējās savāktajās vērtībās (ja 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 laika nobīdes norādīšanu.

[comment]: # ({/2acead3e-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]: # ({85535fd1-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/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parametri: skatiet [kopējos 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 pirms kāda laika.

Piemēri:

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

[comment]: # ({/85535fd1-f5993b4c})

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

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

Parametri: 

-   **item filter** - skatiet [item filter](/manual/appendix/functions/aggregate/foreach#item-filter-syntax);<br>
-   **time period** - skatiet [time period](/manual/appendix/functions/aggregate/foreach#time-period);<br>
-   **percentage** - procentuālā vērtība (0-100).

Piezīmes:

-   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) #aprēķina 95. procentiles atbildes laiku 5 minūšu periodā
bucket_percentile(/*/apiserver_request_duration_seconds_bucket[*],10m,99) #aprēķina 99. procentiles API latentumu
```

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

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

Ar foreach funkciju atgriezto vērtību skaits masīvā.<br>
Atbalstītās [foreach funkcijas](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parametri: 

-   **func_foreach** - foreach funkcija, kurai jāskaita atgriezto vērtību skaits. Sīkāku informāciju skatiet [foreach funkcijas](/manual/appendix/functions/aggregate/foreach). Ņemiet vērā, ka count_foreach un bucket_rate_foreach atbalsta [papildu parametrus](/manual/appendix/functions/aggregate/foreach#additional-parameters).
-   **item filter** - skatiet [item filter](/manual/appendix/functions/aggregate/foreach#item-filter-syntax);<br>
-   **time period** - skatiet [time period](/manual/appendix/functions/aggregate/foreach#time-period);<br>
-   **operator** (jābūt dubultpēdiņās). Atbalstītie `operators`:<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 paraugu (reģistrjutīgs)<br>*bitand* - bitu līmeņa 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 paraugs (string argumentiem jābūt dubultpēdiņās); atbalstīts, ja trešajā parametrā ir norādīts *operator*.

Piezīmes: 

-   Izmantojot **count()** ar vēstures datiem saistītu foreach funkciju (max_foreach, avg_foreach u. c.), var rasties veiktspējas ietekme, savukārt, izmantojot **exists_foreach()**, kas darbojas tikai ar konfigurācijas datiem, šādas ietekmes nebūs.
-   Neobligātos parametrus *operator* vai *pattern* nevar atstāt tukšus pēc komata — tie ir vai nu pilnībā jāizlaiž, vai jānorāda.
-   Ja trešais parametrs ir *bitand*, ceturto `pattern` parametru var norādīt kā divus skaitļus, kas atdalīti ar '/': **skaitlis_salīdzināšanai/ar_masu**. count() aprēķina vērtības un *maskas* "bitu līmeņa AND" un salīdzina rezultātu ar *skaitlis_salīdzināšanai*. Ja "bitu līmeņa AND" rezultāts ir vienāds ar *skaitlis_salīdzināšanai*, vērtība tiek ieskaitīta.<br>Ja *skaitlis_salīdzināšanai* un *mask* ir vienādi, pietiek norādīt tikai *mask* (bez '/').
-   Ja trešais parametrs ir *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 mantota no globālo regulāro izteiksmju iestatījumiem. Regulārās izteiksmes atbilstības noteikšanai peldošā komata vērtības vienmēr tiks attēlotas ar 4 decimālzīmēm aiz '.'. Ņemiet vērā arī to, ka lieliem skaitļiem atšķirība decimālajā (datubāzē glabātajā) un binārajā (Zabbix serveris izmantotajā) attēlojumā var ietekmēt 4. decimālzīmi.

Piemēri:

```default
count(max_foreach(/*/net.if.in[*],1h)) #aprēķina net.if.in vienumu skaitu, kas saņēma datus pēdējās stundas laikā līdz šim brīdim
count(last_foreach(/*/vfs.fs.size[*,pused]),"gt",95) #aprēķina failu sistēmu skaitu, kurās izmantoti vairāk nekā 95% diska vietas
```

[comment]: # ({/6e12bb62-3c498650})

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

Aprēķina φ-kvantili no histogrammas spaiņiem.<br>
Atbalstītā [foreach funkcija](/manual/appendix/functions/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/appendix/functions/aggregate/foreach) atbilde.

Piezīmes:

-   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]: # ({/f07c0983-f3ad7158})

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

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

Parametrs: 

-   **item filter** - vienumu atlases kritēriji, ļauj atsaukties pēc host grupas, host, vienuma atslēgas un tagiem. Tiek atbalstīti aizstājējzīmes. Plašāku informāciju skatiet [item filter](/manual/appendix/functions/aggregate/foreach#item-filter-syntax).<br>

Komentāri:

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

Piemēri:

```default
item_count(/*/agent.ping?[group="Host group 1"]) #aprēķina to hostu skaitu, kuriem ir vienums agent.ping grupā "Host group 1"
```

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

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

Varbūtības sadalījuma "astainums" savāktajās vērtībās 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/appendix/functions/aggregate/foreach): *last_foreach*.

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

Piemēri:

```default
kurtosis(/host/system.cpu.util[,user],5m)>5 #trigger on sharp spikes of CPU utilization over 5 minutes
```

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

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

Mediānais absolūtais novirzes rādītājs savāktajās vērtībās noteiktajā novērtēšanas periodā. Skatiet arī: [Mediānais absolūtais novirzes rādītājs](https://en.wikipedia.org/wiki/Median_absolute_deviation).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach function](/manual/appendix/functions/aggregate/foreach): *last_foreach*.

Parametri: skatiet [kopējos 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 izmantošanas vērtība ir statistiski nozīmīga
```

[comment]: # ({/1b18c768-bfb43a27})

[comment]: # ({9ac9dd89-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 functions](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parametri: skatiet [common parameters](#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ž lielāko diska noslodzi visos Linux serveros
```

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

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

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

Parametri: skatiet [common parameters](#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 jebkuram interfeisam visos Linux serveros
```

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

[comment]: # ({8d966168-6b6fb273})
##### šķībums(/host/key,(sec|#num)<:time shift>) {#skewness}

Varbūtību sadalījuma asimetrija savāktajās vērtībās 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 function](/manual/appendix/functions/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]: # ({/8d966168-6b6fb273})

[comment]: # ({0b3aca57-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ī: [Standarta novirze](https://en.wikipedia.org/wiki/Standard_deviation).<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach funkcija](/manual/appendix/functions/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 būtiski svārstās (populācijas standartnovirze ir virs 7 10 minūšu laikā)
```

[comment]: # ({/0b3aca57-11c2ea25})

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

Izlases 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 function](/manual/appendix/functions/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 būtiski svārstās (izlases standartnovirze ir virs 7 10 minūšu laikā)
```

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

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

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

Parametri: skatiet [kopējos parametrus](#common-parameters).

Piemēri:

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

[comment]: # ({/740c263a-0ecf79eb})

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

Kvadrātu summa savāktajās vērtībās noteiktajā novērtēšanas periodā.<br>
Atbalstītie vērtību tipi: *Float*, *Integer*.<br>
Atbalstītā [foreach funkcija](/manual/appendix/functions/aggregate/foreach): *last_foreach*.

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

Piemēri:

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

[comment]: # ({/57e39842-6f6556f2})

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

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

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

Piemēri:

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

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

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

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

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

Šīs funkcijas darbībai ir nepieciešamas vismaz divas datu vērtības.

Piemēri:

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

[comment]: # ({/146891fb-b1bc041c})

[comment]: # ({ba59dd3a-541616fc})
Skatiet [visas atbalstītās funkcijas](/manual/appendix/functions).

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