1 Aggregaatfuncties

Tenzij anders vermeld, worden alle hier vermelde functies ondersteund in:

• Trigger-expressies
• Berekende items

Aggregaatfuncties kunnen werken met:

• Geschiedenis van items, bijvoorbeeld min(/host/key,1h)
• foreach-functies als enige parameter, bijvoorbeeld min(last_foreach(/*/key)) (alleen in berekende items; kan niet worden gebruikt in triggers)

De functies worden vermeld zonder aanvullende informatie. Klik op de functie om de volledige details te zien.

Gemeenschappelijke parameters

• /host/key is een veelvoorkomende verplichte eerste parameter voor de functies die verwijzen naar de geschiedenis van het host-item
• (sec|#num)<:tijdsverschuiving> is een veelvoorkomende tweede parameter voor de functies die verwijzen naar de geschiedenis van het host-item, waarbij:
  • sec - maximale evaluatieperiode in seconden (tijds suffixen kunnen worden gebruikt), of
  • #num - maximale evaluatiebereik in nieuwste verzamelde waarden (indien voorafgegaan door een hekje)
  • tijdsverschuiving (optioneel) maakt het mogelijk om het evaluatiepunt terug in de tijd te verplaatsen. Zie meer details over het specificeren van tijdsverschuiving.

Functiedetails

Enkele algemene opmerkingen over functieparameters:

• Functieparameters zijn gescheiden door een komma
• Optionele functieparameters (of parameterdelen) worden aangegeven met < >
• Functie-specifieke parameters worden bij elke functie beschreven
• De parameters /host/key en (sec|#num)<:tijdsverschuiving> mogen nooit tussen aanhalingstekens worden geplaatst

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

Het gemiddelde van een item binnen de gedefinieerde evaluatieperiode.
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parameters: zie algemene parameters.

Tijdsverschuiving is handig wanneer het nodig is om de huidige gemiddelde waarde te vergelijken met de gemiddelde waarde van enige tijd geleden.

Voorbeelden:

avg(/host/key,1u) #de gemiddelde waarde van het afgelopen uur tot nu toe
       avg(/host/key,1u:now-1d) #de gemiddelde waarde van een uur van 25 uur geleden tot 24 uur geleden vanaf nu
       avg(/host/key,#5) #de gemiddelde waarde van de laatste vijf waarden
       avg(/host/key,#5:now-1d) #de gemiddelde waarde van de laatste vijf waarden exclusief de waarden die in de afgelopen 24 uur zijn ontvangen

bucket_percentile(item filter,time period,percentage)

Berekent het percentiel van de buckets van een histogram.

Parameters:

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

Opmerkingen:

• Alleen ondersteund in berekende items;
• Deze functie is een alias voor histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1)).

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

The count of values in an array returned by a foreach function.
Supported foreach functions: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parameters:

• func_foreach - foreach function for which the number of returned values should be counted (with supported arguments). See foreach functions for details.
• item filter - see item filter;
  
• time period - see time period;
  
• operator (must be double-quoted). Supported operators:
  eq - equal
  ne - not equal
  gt - greater
  ge - greater or equal
  lt - less
  le - less or equal
  like - matches if contains pattern (case-sensitive)
  bitand - bitwise AND
  regexp - case-sensitive match of the regular expression given in pattern
  iregexp - case-insensitive match of the regular expression given in pattern
  
• pattern - the required pattern (string arguments must be double-quoted); supported if operator is specified in the third parameter.

Comments:

• Using count() with a history-related foreach function (max_foreach, avg_foreach, etc.) may lead to performance implications, whereas using exists_foreach(), which works only with configuration data, will not have such effect.
• Optional parameters operator or pattern can't be left empty after a comma, only fully omitted.
• With bitand as the third parameter, the fourth pattern parameter can be specified as two numbers, separated by '/': number_to_compare_with/mask. count() calculates "bitwise AND" from the value and the mask and compares the result to number_to_compare_with. If the result of "bitwise AND" is equal to number_to_compare_with, the value is counted.
  If number_to_compare_with and mask are equal, only the mask need be specified (without '/').
• With regexp or iregexp as the third parameter, the fourth pattern parameter can be an ordinary or global (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.

Examples:

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

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

Berekent de φ-kwantielwaarde uit de buckets van een histogram.
Ondersteunde foreach-functie: bucket_rate_foreach.

Parameters:

• quantile - 0 ≤ φ ≤ 1;
  
• bucketN, valueN - handmatig ingevoerde paren (>=2) van parameters of de respons van bucket_rate_foreach.

Opmerkingen:

• Alleen ondersteund in berekende items;
• Functioneel overeenkomend met 'histogram_quantile' van PromQL;
• Geeft -1 terug als waarden van de laatste 'Infinity'-bucket ("+inf") gelijk zijn aan 0.

Voorbeelden:

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)

The count of existing items in configuration that match the filter criteria.
Supported value type: Integer.

Parameter:

• item filter - criteria for item selection, allows referencing by host group, host, item key, and tags. Wildcards are supported. See item filter for more details.
  

Comments:

• Supported only in calculated items;
• Works as an alias for the count(exists_foreach(item_filter)) function.

Examples:

item_count(/*/agent.ping?[group="Host group 1"]) #the number of hosts with the *agent.ping* item in the "Host group 1"

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

De "staartigheid" van de kansverdeling in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Kurtosis.
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functie: last_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

kurtosis(/host/key,1u) #kurtosis voor het afgelopen uur tot nu toe

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

De mediaan van de absolute afwijking in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Mediaan van absolute afwijking.
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functie: last_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

mad(/host/key,1u) #mediaan van absolute afwijking voor het afgelopen uur tot nu toe

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

De hoogste waarde van een item binnen de gedefinieerde evaluatieperiode.
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

max(/host/key,1u) - min(/host/key,1u) #bereken het verschil tussen de maximale en minimale waarden van het afgelopen uur tot nu toe (het verschil van waarden)

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

De laagste waarde van een item binnen de gedefinieerde evaluatieperiode.
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

max(/host/key,1u) - min(/host/key,1u) #bereken het verschil tussen de maximale en minimale waarden van het afgelopen uur tot nu toe (het verschil van waarden)

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

De asymmetrie van de kansverdeling in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Asymmetrie (Skewness).
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functie: last_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

skewness(/host/key,1u) #de asymmetrie voor het afgelopen uur tot nu toe

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

De populatiestandaardafwijking in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Standaardafwijking (Standard deviation).
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functie: last_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

stddevpop(/host/key,1u) #de populatiestandaardafwijking voor het afg

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

De steekproefstandaardafwijking in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Standaardafwijking (Standard deviation).
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functie: last_foreach.

Parameters: zie algemene parameters.

Voor deze functie zijn minimaal twee gegevenswaarden vereist.

Voorbeeld:

stddevsamp(/host/key,1u) #de steekproefstandaardafwijking voor het afgelopen uur tot nu toe

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

De som van verzamelde waarden binnen de gedefinieerde evaluatieperiode.
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

sum(/host/key,1u) #de som van waarden voor het afgelopen uur tot nu toe

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

De som van de kwadraten van verzamelde waarden binnen de gedefinieerde evaluatieperiode.
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functie: last_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

sumofsquares(/host/key,1u) #de som van kwadraten voor het afgelopen uur tot nu toe

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

De populatievariantie van verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Variantie (Variance).
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functie: last_foreach.

Parameters: zie algemene parameters.

Voorbeeld:

varpop(/host/key,1u) #de populatievariantie voor het afgelopen uur tot nu toe

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

De steekproefvariantie van verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Variantie (Variance).
Ondersteunde waardestypen: Float, Integer.
Ondersteunde foreach-functie: last_foreach.

Parameters: zie algemene parameters.

Voor deze functie zijn minimaal twee gegevenswaarden vereist.

Voorbeeld:

varsamp(/host/key,1u) #de steekproefvariantie voor het afgelopen uur tot nu toe

Zie alle ondersteunde functies.