1 Agregācijas funkcijas

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

• Trigeru izteiksmēs
• Aprēķinātajos vienumos
• Izteiksmju makrosos

Agregācijas funkcijas var darboties ar:

• vienumu vēsturi, piemēram, min(/host/key,1h)
• foreach funkcijām 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.

Kopīgie 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 novērtēšanas periods sekundēs (var izmantot laika sufiksus), vai
  • #num - maksimālais novērtēšanas diapazons pēdējās savāktajās vērtībās (ja pirms tā ir jaucējzīme)
  • time shift (neobligāts) ļauj pārvietot novērtēšanas punktu atpakaļ laikā. Skatiet papildinformāciju par time shift norādīšanu.

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

avg(/host/key,(sec|#num)<:time shift>)

Vienuma vidējā vērtība noteiktajā novērtēšanas periodā.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītās foreach funkcijas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri: skatiet kopīgos parametrus.

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:

avg(/host/key,1h) #vidējā vērtība pēdējā stundā līdz šim brīdim
avg(/host/key,1h:now-1d) #vidējā vērtība vienas stundas periodam no pirms 25 stundām līdz pirms 24 stundām no pašreizējā brīža
avg(/host/key,#5) #piecu jaunāko vērtību vidējā vērtība
avg(/host/key,#5:now-1d) #piecu jaunāko vērtību vidējā vērtība, izņemot vērtības, kas saņemtas pēdējo 24 stundu laikā

bucket_percentile(vienums filtrs,laika periods,procenti)

Aprēķina procentili no histogrammas spaiņiem.

Parametri:

• vienums filtrs - skatiet vienums filtrs;
  
• laika periods - skatiet laika periods;
  
• procenti - procentuālā vērtība (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)).

count(func_foreach(vienums filter,<time period>),<operator>,<pattern>)

Masīvā esošo vērtību skaits, ko atgriež foreach funkcija.
Atbalstītās foreach funkcijas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri:

• func_foreach - foreach funkcija, kurai jāuzskaita atgriezto vērtību skaits. Sīkāku informāciju skatiet sadaļā foreach functions. Ņemiet vērā, ka count_foreach un bucket_rate_foreach atbalsta papildu parametrus.
• item filter - skatiet vienums filter;
  
• time period - skatiet laika periods;
  
• operator (jābūt dubultpēdiņās). Atbalstītie operators:
  eq - vienāds
  ne - nav vienāds
  gt - lielāks
  ge - lielāks vai vienāds
  lt - mazāks
  le - mazāks vai vienāds
  like - atbilst, ja satur šablonu (reģistrjutīgs)
  bitand - bitu AND
  regexp - reģistrjutīga atbilstība regulārajai izteiksmei, kas norādīta pattern
  iregexp - reģistrnejutīga atbilstība regulārajai izteiksmei, kas norādīta pattern
  
• 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 utt.), 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 nevar atstāt tukšus aiz komata, 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.
  Ja number_to_compare_with un mask ir vienādi, jānorāda tikai mask (bez '/').
• Ja kā trešais parametrs tiek izmantots regexp vai iregexp, ceturtais pattern parametrs var būt parasta vai globāla (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. Regexp atbilstības vajadzībām peldošā komata vērtības vienmēr tiks attēlotas ar 4 zīmēm aiz '.'. Ņemiet arī vērā, 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:

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

histogram_quantile(quantile,bucket1,value1,bucket2,value2,...)

Aprēķina φ-kvantiļu no histogrammas spaiņiem.
Atbalstītā foreach function: bucket_rate_foreach.

Parametri:

• quantile - 0 ≤ φ ≤ 1;
  
• bucketN, valueN - manuāli ievadīti parametru pāri (>=2) vai bucket_rate_foreach atbilde.

Komentāri:

• Atbalstīts tikai aprēķinātajos vienumos;
• Funkcionāli atbilst PromQL funkcijai 'histogram_quantile';
• Atgriež -1, ja pēdējā 'Infinity' spaiņa ("+inf") vērtības ir vienādas ar 0.

Piemēri:

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)

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

Parametrs:

• vienuma filtrs — vienumu atlases kritēriji, ļauj atsaukties pēc hostu grupas, hosta, vienuma atslēgas un tagiem. Tiek atbalstītas aizstājējzīmes. Plašāku informāciju skatiet vienuma filtrs.
  

Komentāri:

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

Piemēri:

item_count(/*/agent.ping?[group="Host group 1"]) #hostu skaits ar vienumu *agent.ping* grupā "Host group 1"

kurtosis(/host/key,(sec|#num)<:time shift>)

Savākto vērtību varbūtības sadalījuma "astu smagums" noteiktajā novērtēšanas periodā. Skatiet arī: Kurtosis.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītā foreach funkcija: last_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

kurtosis(/host/key,1h) #kurtosis pēdējai stundai līdz šim brīdim

mad(/host/key,(sec|#num)<:time shift>)

Mediānā absolūtā novirze savāktajās vērtībās definētajā novērtēšanas periodā. Skatiet arī: Mediānā absolūtā novirze.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītā foreach funkcija: last_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

mad(/host/key,1h) #mediānā absolūtā novirze pēdējai stundai līdz šim brīdim

max(/host/key,(sec|#num)<:time shift>)

Vienuma augstākā vērtība definētajā novērtēšanas periodā.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītās foreach funkcijas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

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(/host/key,(sec|#num)<:time shift>)

Zemākā vienuma vērtība definētajā novērtēšanas periodā.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītās foreach funkcijas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

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)

skewness(/host/key,(sec|#num)<:time shift>)

Asimetrija savākto vērtību varbūtību sadalījumā noteiktajā novērtēšanas periodā. Skatiet arī: Skewness.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītā foreach funkcija: last_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

skewness(/host/key,1h) #šķībums pēdējai stundai līdz šim brīdim

stddevpop(/host/key,(sec|#num)<:time shift>)

Populācijas standartnovirze savāktajām vērtībām noteiktajā novērtēšanas periodā. Skatiet arī: Standartnovirze.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītā foreach funkcija: last_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

stddevpop(/host/key,1h) #populācijas standartnovirze pēdējai stundai līdz šim brīdim

stddevsamp(/host/key,(sec|#num)<:time shift>)

Izlases standartnovirze savāktajām vērtībām noteiktajā novērtēšanas periodā. Skatiet arī: Standartnovirze.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītā foreach funkcija: last_foreach.

Parametri: skatiet kopīgos parametrus.

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

Piemērs:

stddevsamp(/host/key,1h) #izlases standartnovirze pēdējai stundai līdz šim brīdim

sum(/host/key,(sec|#num)<:time shift>)

Savākto vērtību summa definētajā novērtēšanas periodā.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītās foreach functions: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

sum(/host/key,1h) #vērtību summa par pēdējo stundu līdz šim

sumofsquares(/host/key,(sec|#num)<:time shift>)

Savākto vērtību kvadrātu summa definētajā novērtēšanas periodā.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītās foreach function: last_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

sumofsquares(/host/key,1h) #kvadrātu summa pēdējai stundai līdz šim brīdim

varpop(/host/key,(sec|#num)<:time shift>)

Savākto vērtību populācijas dispersija definētajā novērtēšanas periodā. Skatiet arī: Variance.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītā foreach function: last_foreach.

Parametri: skatiet kopīgos parametrus.

Piemērs:

varpop(/host/key,1h) #populācijas dispersija pēdējai stundai līdz šim brīdim

varsamp(/host/key,(sec|#num)<:time shift>)

Savākto vērtību izlases dispersija noteiktajā novērtēšanas periodā. Skatiet arī: Dispersija.
Atbalstītie vērtību tipi: Float, Integer.
Atbalstītā foreach funkcija: last_foreach.

Parametri: skatiet kopīgos parametrus.

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

Piemērs:

varsamp(/host/key,1h) #izlases dispersija pēdējai stundai līdz šim

Skatīt visas atbalstītās funkcijas.