1 Funcions d'afegit

Excepte on s'hi especifiqui el contrari, totes les funcions llistades aquí són admeses a:

• Les expressions de trigger
• Els elements calculats
• Les macros d'expressió

Les funcions d'afegit poden funcionar amb:

• l'històric d'elements, com ara min(/host/key,1h)
• les funcions foreach com a paràmetre únic; com per exemple min(last_foreach(/*/key)) (només elements calculats; no es pot emprar a triggers)

Les funcions es llisten sense informació addicional. Feu clic a la funció per veure'n tots els detalls.

Paràmetres comuns

• /host/key és un paràmetre comú obligatori per les funcions sobre l'històric de l'element d'equip
• (sec|#num)<:time shift> és un segon paràmetre habitual per funcions referents a l'històric de l'element d'equip, on:
  • sec - període d'avaluació màxim en segons (es poden emprar els sufixes), o
  • #num - període d'avaluació màxim en nombre de valors recollits (si van precedits per el símbol de la graella)
  • canvi horari (facultatiu) permet canviar el punt d'avaluació en el temps. Veieu més detalls sobre la especificació del canvi horari.

Detalls de la funció

Algunes notes generals sobre paràmetres de funció:

• Els paràmetres de funció són separats per una coma
• Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb < >
• Els paràmetres específics de la funció es descriuen amb cada funció
• Els paràmetres /host/key i (sec|#num)<:time shift> no s'han de citar mai entre cometes

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

El valor mitjà d'un element dins del període d'avaluació definit.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Paràmetres: veieu paràmetres comuns.

El canvi de temps és útil quan cal comparar el valor mitjà actual amb el valor mitjà fa un temps.

Exemples:

     avg(/host/key,1h) #el valor mitjà de l'última hora fins ara
     avg(/host/key,1h:now-1d) #el valor mitjà d'una hora des de fa 25 hores fins a fa 24 hores d'ara
     avg(/host/key,#5) #el valor mitjà dels cinc valors més recents
     avg(/host/key,#5:now-1d) #el valor mitjà dels cinc valors més recents, excloent els valors rebuts en les darreres 24 hores
     avg(/host/proc.num,5m)>300 #desencadenar si el nombre mitjà de processos en els darrers 5 minuts ha estat superior a 300

bucket_percentile(item filter,time period,percentage)

Calcula el percentil a partir dels dipòsits d'un histograma.

Paràmetres:

• filtre d'elements - veieu filtre d'elements;
  
• període de temps - veieu període de temps;
  
• percentatge - percentatge (0-100).

Comentaris:

• Admès només en articles calculats;
• Aquesta funció és un àlies de a histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1)).

count(func_foreach(filtre d'elements,<període de temps>),<operador>,<patró>)

El recompte de valors d'una matriu retornats per una funció foreach.
Funcions foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Paràmetres:

• func_foreach - funció foreach per a la qual s'ha de comptar el nombre de valors retornats (amb arguments compatibles). Veieu funcions foreach per obtenir més informació. Tingueu en compte que count_foreach i bucket_rate_foreach admeten paràmetres addicionals.
• filtre d'elements - veieu filtre d'elements;
  
• període de temps - veieu període de temps;
  
• operador (ha d'estar entre cometes). "Operadors" admesos:
  eq - igual
  ne - no igual
  gt - major
  ge - major o igual
  lt - menys<br >le - menor o igual
  like - coincideix si conté un patró (distingeix entre majúscules i minúscules)
  bitand - per bits AND
  regexp - coincideix amb majúscules i minúscules de l'expressió regular donada a pattern
  iregexp - coincidència sense distinció entre majúscules i minúscules de l'expressió regular donada a pattern
  
• patró - el patró requerit (els arguments de cadena han d'estar entre cometes); suportat si s'especifica operador al tercer paràmetre.

Comentaris:

• L'ús de count() amb una funció foreach relacionada amb l'historial (max_foreach, avg_foreach, etc.) pot comportar implicacions de rendiment, mentre que emprar exists_foreach(), que només funciona amb dades de configuració, no tindrà tal efecte.
• Els paràmetres opcionals operador o patró no es poden deixar buits després d'una coma, només s'ometen completament.
• Amb bitand com a tercer paràmetre, el quart paràmetre patró es pot especificar com a dos números, separats per '/': número_a_comparar_amb/màscara. count() calcula "AND per bits" a partir del valor i la màscara i compara el resultat amb número_per_comparar_amb. Si el resultat de "AND bit a bit" és igual a nombre_a_comparar_amb, es compta el valor.
  Si número_a_comparar_amb i màscara són iguals, només cal especificar la màscara (sense '/').
• Amb regexp o iregexp com a tercer paràmetre, el quart paràmetre pattern pot ser una expressió regular ordinària o global (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global de les expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemat a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.

Exemples:

count(max_foreach(/*/net.if.in[*],1h)) #el nombre d'elements net.if.in que han rebut dades durant la darrera hora fins ara
count(last_foreach(/*/vfs.fs.dependent.size[*,pused]),"gt",95) #el nombre de sistemes de fitxers amb més del 95% d'espai de disc emprat

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

Calcula el quantil φ a partir de les galledes d'un histograma.
Admet les funcions foreach: bucket_rate_foreach.

Paràmetres:

• quantil - 0 ≤ φ ≤ 1;
  
• bucketN, valueN - parelles introduïdes manualment (>=2) de paràmetres o la resposta de bucket_rate_foreach.

Comentaris:

• Admès només en articles calculats;
• Funcionalment correspon a 'histogram_quantile' de PromQL;
• Retorna -1 si els valors de l'últim dipòsit 'Infinit' ("+inf") són iguals a 0.

Exemples:

    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)

Nombre d'elements existents a la configuració que coincideixen amb els criteris de filtre.
Tipus de valor compatible: Enter.

Paràmetre:

• filtre d'elements - criteris per a la tria d'elements, permet fer referència per grup d'equips, equip, clau d'element i etiquetes. S'admeten els comodins. Consulteu filtre d'elements per obtindre més informació.
  

Comentaris:

• Admès només en articles calculats;
• Funciona com un àlies per a la funció count(exists_foreach(item_filter)).

Exemples:

 item_count(/*/agent.ping?[group="Host group 1"]) #el nombre d'equips amb l'element *agent.ping* al "Grup d'equips 1"

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

La "cua" de la distribució de probabilitat en els valors recollits dins del període d'avaluació definit. Veieu també: Kurtosis.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: last_foreach.

Paràmetres: veieu paràmetres comuns.

Exemples:

kurtosis(/host/system.cpu.util[,user],5m)>5 #trigger en pics aguts d'ús de CPU durant 5 minuts

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

Desviació absoluta mitjana dels valors recollits dins del període d'avaluació definit. Veieu també: Desviació absoluta mitjana.
Tipus de valors admesos: Flotant, Enter. Admet les funcions foreach: last_foreach.

Paràmetres: veieu paràmetres comuns.

Exemples:

     last(/host/system.cpu.util[,user])>avg(/host/system.cpu.util[,user],1h)+3*mad(/host/system.cpu.util[,user],1h) #trigger si el darrer valor s'ús de CPU és significant estadísticament

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

Valor més alt d'un element dins del període d'avaluació definit.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Paràmetres: veieu paràmetres comuns.

Exemples:

     max(/host/key,1h) - min(/host/key,1h) #calculeu la diferència entre els valors màxim i mínim de la darrera hora (el delta dels valors)
     max(last_foreach(/*/vfs.fs.size[*,pused]?[group="Linux servers"])) #retorna l'ús de disc més gran de tots els servidors Linux

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

Valor més baix d'un element dins del període d'avaluació definit.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Paràmetres: veieu paràmetres comuns.

Exemple:

     max(/host/key,1h) - min(/host/key,1h) #calculeu la diferència entre els valors màxim i mínim de la darrera hora (el delta dels valors)
     min(last_foreach(/*/vfs.file.contents["/sys/class/net/enp0s3/operstate"]?[group="Linux servers"])) #retorna l'estat operatiu mínim per a qualsevol interfície a través de tots els servidors de Linux

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

Asimetria de la distribució de probabilitat en els valors recollits dins del període d'avaluació definit. Veieu també: Skewness.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: last_foreach.

Paràmetres: veieu paràmetres comuns.

Exemples:

     skewness(/host/vm.memory.size[used],5m)<-20 #triggeren les caigudes negatives sobtades que indiquen xocs / reinicis

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

Desviació estàndard de la població en els valors recollits dins del període d'avaluació definit. Veieu també: Desviació estàndard.
Tipus de valors admesos: Flotant, Enter. Admet les funcions foreach: last_foreach.

Paràmetres: veieu paràmetres comuns.

Exemple:

     stddevpop(/host/system.cpu.util[,user],10m)>7 #Ús de la CPU fluctua molt (la desviació de població estàndard és per sobre de 7)

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

Desviació estàndard de la mostra dels valors recollits dins del període d'avaluació definit. Veieu també: Desviació estàndard.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: last_foreach.

Paràmetres: veieu paràmetres comuns.

Es requereixen almenys dos valors de dades perquè aquesta funció funcioni.

Exemples:

     stddevsamp(/host/system.cpu.util[,user],10m)>7 #L'ús de la CPU fluctua molt (la desviació estàndard de la mostra és per sobre de 7)

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

Suma dels valors recollits durant el període d'avaluació definit.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Paràmetres: veieu paràmetres comuns.

Exemple:

     sum(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #la suma dels darrers valors per al trànsit de xarxa entrant a través de tots els servidors Linux

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

Suma dels quadrats als valors recollits durant el període d'avaluació definit.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: last_foreach.

Paràmetres: veieu paràmetres comuns.

Exemples:

sumofsquares(/host/calculated.net.if.rate,1m) #la suma de quadrats per a la taxa de trànsit de xarxa (entrada vs sortida)
sumofsquares(last_foreach(//net.if.in[*]?[ group="Linux servers"])) #la suma de quadrats per als darrers valors de trànsit de xarxa entrants en tots els servidors Linux

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

Variància de la població dels valors recollits dins del període d'avaluació definit. Veieu també: Variance.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: last_foreach.

Paràmetres: veieu paràmetres comuns.

Exemples:

varpop(/host/system.cpu.util[,user],10m)>50 #CPU l'ús fluctua molt (la variància és superior a 50)

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

Variància mostral dels valors recollits dins del període d'avaluació definit. Veieu també: Variance.
Tipus de valors admesos: Flotant, Enter.
Admet les funcions foreach: last_foreach.

Paràmetres: veieu paràmetres comuns.

Es requereixen almenys dos valors de dades perquè aquesta funció funcioni.

Exemple:

varsamp(/host/system.cpu.util[,user],10m)>50 #CPU l'ús fluctua molt (la variància de la mostra és superior a 50)

Veieu totes les funcions admeses.