1 Funzioni aggregate

Salvo diversa indicazione, tutte le funzioni elencate qui sono supportate in:

• Espressioni dei trigger
• Item calcolati
• Macro di espressione

Le funzioni aggregate possono operare con:

• la cronologia degli item, ad esempio min(/host/key,1h)
• le funzioni foreach come unico parametro, ad esempio min(last_foreach(/*/key)) (solo negli item calcolati; non possono essere usate nei trigger)

Le funzioni sono elencate senza informazioni aggiuntive. Fare clic sulla funzione per visualizzare tutti i dettagli.

Parametri comuni

• /host/key è un primo parametro comune obbligatorio per le funzioni che fanno riferimento alla cronologia degli item del host
• (sec|#num)<:time shift> è un secondo parametro comune per le funzioni che fanno riferimento alla cronologia degli item del host, dove:
  • sec - massimo periodo di valutazione in secondi (è possibile usare i suffissi di tempo), oppure
  • #num - massimo intervallo di valutazione negli ultimi valori raccolti (se preceduto da un cancelletto)
  • time shift (opzionale) consente di spostare indietro nel tempo il punto di valutazione. Vedi maggiori dettagli sulla specifica del time shift.

Dettagli della funzione

Alcune note generali sui parametri della funzione:

• I parametri della funzione sono separati da una virgola
• I parametri opzionali della funzione (o parti di parametro) sono indicati da < >
• I parametri specifici della funzione sono descritti per ciascuna funzione
• I parametri /host/key e (sec|#num)<:time shift> non devono mai essere racchiusi tra virgolette

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

Il valore medio di un item nel periodo di valutazione definito.
Tipi di valore supportati: Float, Integer.
Funzioni foreach supportate: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri: vedere i parametri comuni.

Lo spostamento temporale è utile quando è necessario confrontare il valore medio corrente con il valore medio di qualche tempo fa.

Esempi:

avg(/host/key,1h) #il valore medio dell'ultima ora fino a questo momento
avg(/host/key,1h:now-1d) #il valore medio di un'ora compresa tra 25 ore fa e 24 ore fa rispetto a ora
avg(/host/key,#5) #il valore medio degli ultimi cinque valori
avg(/host/key,#5:now-1d) #il valore medio degli ultimi cinque valori, escludendo i valori ricevuti nelle ultime 24 ore

bucket_percentile(item filter,time period,percentage)

Calcola il percentile dai bucket di un istogramma.

Parametri:

• item filter - vedi item filter;
  
• time period - vedi time period;
  
• percentage - percentuale (0-100).

Commenti:

• Supportata solo negli item calcolati;
• Questa funzione è un alias per histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1)).

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

Il conteggio dei valori in un array restituito da una funzione foreach.
Funzioni foreach supportate: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri:

• func_foreach - funzione foreach per la quale deve essere conteggiato il numero di valori restituiti. Vedere funzioni foreach per i dettagli. Si noti che count_foreach e bucket_rate_foreach supportano parametri aggiuntivi.
• item filter - vedere item filter;
  
• time period - vedere time period;
  
• operator (deve essere tra doppi apici). operator supportati:
  eq - uguale
  ne - diverso
  gt - maggiore
  ge - maggiore o uguale
  lt - minore
  le - minore o uguale
  like - corrisponde se contiene il pattern (con distinzione tra maiuscole e minuscole)
  bitand - AND bit a bit
  regexp - corrispondenza con distinzione tra maiuscole e minuscole dell'espressione regolare fornita in pattern
  iregexp - corrispondenza senza distinzione tra maiuscole e minuscole dell'espressione regolare fornita in pattern
  
• pattern - il pattern richiesto (gli argomenti stringa devono essere tra doppi apici); supportato se operator è specificato nel terzo parametro.

Commenti:

• L'uso di count() con una funzione foreach correlata alla cronologia (max_foreach, avg_foreach, ecc.) può avere implicazioni sulle prestazioni, mentre l'uso di exists_foreach(), che funziona solo con i dati di configurazione, non avrà tale effetto.
• I parametri facoltativi operator o pattern non possono essere lasciati vuoti dopo una virgola, ma solo omessi completamente.
• Con bitand come terzo parametro, il quarto parametro pattern può essere specificato come due numeri separati da '/': number_to_compare_with/mask. count() calcola l'"AND bit a bit" dal valore e dalla mask e confronta il risultato con number_to_compare_with. Se il risultato dell'"AND bit a bit" è uguale a number_to_compare_with, il valore viene conteggiato.
  Se number_to_compare_with e mask sono uguali, è necessario specificare solo la mask (senza '/').
• Con regexp o iregexp come terzo parametro, il quarto parametro pattern può essere un'espressione regolare ordinaria o globale (che inizia con '@'). Nel caso delle espressioni regolari globali, la distinzione tra maiuscole e minuscole viene ereditata dalle impostazioni dell'espressione regolare globale. Ai fini della corrispondenza regexp, i valori float saranno sempre rappresentati con 4 cifre decimali dopo '.'. Si noti inoltre che, per i numeri grandi, la differenza tra la rappresentazione decimale (memorizzata nel database) e quella binaria (utilizzata da Zabbix server) può influire sulla quarta cifra decimale.

Esempi:

count(max_foreach(/*/net.if.in[*],1h)) #il numero di item net.if.in che hanno ricevuto dati nell'ultima ora fino ad ora
count(last_foreach(/*/vfs.fs.size[*,pused]),"gt",95) #il numero di file system con oltre il 95% dello spazio disco utilizzato

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

Calcola il φ-quantile dai bucket di un istogramma.
Supporta la funzione foreach: bucket_rate_foreach.

Parametri:

• quantile - 0 ≤ φ ≤ 1;
  
• bucketN, valueN - coppie inserite manualmente (>=2) di parametri oppure la risposta di bucket_rate_foreach.

Commenti:

• Supportata solo negli item calcolati;
• Corrisponde funzionalmente a 'histogram_quantile' di PromQL;
• Restituisce -1 se i valori dell'ultimo bucket 'Infinity' ("+inf") sono uguali a 0.

Esempi:

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)

Il conteggio degli item esistenti nella configurazione che corrispondono ai criteri del filtro.
Tipo di valore supportato: Integer.

Parametro:

• item filter - criteri per la selezione degli item; consente il riferimento per gruppo di host, host, chiave item e tag. I caratteri jolly sono supportati. Vedere item filter per maggiori dettagli.
  

Commenti:

• Supportato solo negli item calcolati;
• Funziona come alias per la funzione count(exists_foreach(item_filter)).

Esempi:

item_count(/*/agent.ping?[group="Host group 1"]) #il numero di host con l'item *agent.ping* nel "Host group 1"

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

La "pesantezza delle code" della distribuzione di probabilità nei valori raccolti entro il periodo di valutazione definito. Vedi anche: Kurtosis.
Tipi di valore supportati: Float, Integer.
Funzione foreach supportata: last_foreach.

Parametri: vedere i parametri comuni.

Esempio:

kurtosis(/host/key,1h) #kurtosis per l'ultima ora fino ad ora

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

La deviazione assoluta mediana dei valori raccolti nel periodo di valutazione definito. Vedi anche: Median absolute deviation.
Tipi di valore supportati: Float, Integer.
Funzione foreach supportata: last_foreach.

Parametri: vedere i parametri comuni.

Esempio:

mad(/host/key,1h) #deviazione assoluta mediana per l'ultima ora fino ad ora

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

Il valore più alto di un item nel periodo di valutazione definito.
Tipi di valore supportati: Float, Integer.
Funzioni foreach supportate: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri: vedere i parametri comuni.

Esempio:

max(/host/key,1h) - min(/host/key,1h) #calcola la differenza tra i valori massimo e minimo nell'ultima ora fino ad ora (il delta dei valori)

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

Il valore più basso di un item nel periodo di valutazione definito.
Tipi di valore supportati: Float, Integer.
Funzioni foreach supportate: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri: vedere i parametri comuni.

Esempio:

max(/host/key,1h) - min(/host/key,1h) #calcola la differenza tra i valori massimo e minimo nell'ultima ora fino ad ora (il delta dei valori)

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

L'asimmetria della distribuzione di probabilità nei valori raccolti entro il periodo di valutazione definito. Vedere anche: Skewness.
Tipi di valore supportati: Float, Integer.
Funzione foreach supportata: last_foreach.

Parametri: vedere i parametri comuni.

Esempio:

skewness(/host/key,1h) #l'asimmetria per l'ultima ora fino ad ora

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

La deviazione standard della popolazione nei valori raccolti entro il periodo di valutazione definito. Vedi anche: Deviazione standard.
Tipi di valore supportati: Float, Integer.
Funzione foreach supportata: last_foreach.

Parametri: vedere i parametri comuni.

Esempio:

stddevpop(/host/key,1h) #la deviazione standard della popolazione per l'ultima ora fino ad ora

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

La deviazione standard campionaria dei valori raccolti nel periodo di valutazione definito. Vedi anche: Deviazione standard.
Tipi di valore supportati: Float, Integer.
Funzione foreach supportata: last_foreach.

Parametri: vedere i parametri comuni.

Per il funzionamento di questa funzione sono richiesti almeno due valori di dati.

Esempio:

stddevsamp(/host/key,1h) #la deviazione standard campionaria per l'ultima ora fino ad ora

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

La somma dei valori raccolti nel periodo di valutazione definito.
Tipi di valore supportati: Float, Integer.
Funzioni foreach supportate: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parametri: vedere i parametri comuni.

Esempio:

sum(/host/key,1h) #la somma dei valori dell'ultima ora fino ad ora

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

La somma dei quadrati nei valori raccolti entro il periodo di valutazione definito.
Tipi di valore supportati: Float, Integer.
Funzione foreach supportata: last_foreach.

Parametri: vedere i parametri comuni.

Esempio:

sumofsquares(/host/key,1h) #la somma dei quadrati per l'ultima ora fino ad ora

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

La varianza della popolazione dei valori raccolti entro il periodo di valutazione definito. Vedi anche: Varianza.
Tipi di valore supportati: Float, Integer.
Funzione foreach supportata: last_foreach.

Parametri: vedere i parametri comuni.

Esempio:

varpop(/host/key,1h) #la varianza della popolazione per l'ultima ora fino ad ora

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

La varianza campionaria dei valori raccolti entro il periodo di valutazione definito. Vedi anche: Variance.
Tipi di valore supportati: Float, Integer.
Funzione foreach supportata: last_foreach.

Parametri: vedere i parametri comuni.

Per il funzionamento di questa funzione sono richiesti almeno due valori di dati.

Esempio:

varsamp(/host/key,1h) #la varianza campionaria per l'ultima ora fino ad ora

Vedere tutte le funzioni supportate.