Table of Contents
1 Aggregatiefuncties
Tenzij anders vermeld, worden alle hier vermelde functies ondersteund in:
Aggregatiefuncties 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)
Enkele algemene opmerkingen over functieparameters:
- Functieparameters worden gescheiden door een komma
- Optionele functieparameters (of parameterdelen) worden aangegeven met
<> - Functie-specifieke parameters worden beschreven bij elke functie
- Parameters zoals
/host/keyen(sec|#num)<:tijdverschuiving>mogen nooit tussen aanhalingstekens staan
Algemene parameters
/host/keyis een algemene verplichte eerste parameter voor de functies verwijzend naar de geschiedenis van het hostitem(sec|#num)<:time shift>is een gebruikelijke tweede parameter voor de functies die verwijzen naar de geschiedenis van het hostitem, waarbij:- sec - maximaal evaluatie periode in seconden (tijd achtervoegsels kan worden gebruikt), of
- #num - maximum evaluatie bereik in de laatste verzamelde waarden (indien voorafgegaan door een hekje)
- tijdverschuiving (optioneel) maakt het mogelijk om het evaluatiepunt te verplaatsen terug in de tijd. Bekijk meer details](/manual/config/triggers/expression#time_shift) aan tijdverschuiving aangeven.
Aggregate functies
| FUNCTIE | ||
|---|---|---|
| Beschrijving | Functie-specifieke parameters | Opmerkingen |
| avg (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Gemiddelde waarde van een item binnen de gedefinieerde evaluatieperiode. | Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Voorbeelden: => avg(/host/key,1u) → gemiddelde waarde voor het afgelopen uur tot nu => avg(/host/key,1u:nu-1d) → gemiddelde waarde voor een uur van 25 uur geleden tot 24 uur geleden vanaf nu => avg(/host/key,#5) → gemiddelde waarde van de vijf meest recente waarden => avg(/host/key,#5:nu-1d) → gemiddelde waarde van de vijf meest recente waarden, exclusief de waarden ontvangen in de laatste 24 uur Tijdsverschuiving is handig wanneer er behoefte is om de huidige gemiddelde waarde te vergelijken met de gemiddelde waarde van enige tijd geleden. |
| bucket_percentile (itemfilter,tijdsperiode,percentage) | ||
| Berekent het percentiel uit de buckets van een histogram. | itemfilter - zie itemfilter tijdsperiode - zie tijdsperiode percentage - percentage (0-100) |
Alleen ondersteund in berekende items. Deze functie is een alias voor histogram_quantile(percentage/100, bucket_rate_foreach(itemfilter, tijdsperiode, 1)) |
| count (func_foreach(itemfilter,<tijdsperiode>)) | ||
| Aantal waarden in een array teruggegeven door een foreach functie. | func_foreach - foreach functie waarvoor het aantal teruggegeven waarden moet worden geteld (met ondersteunde argumenten). Zie foreach functies voor details. | Ondersteund waardestype: int Ondersteunde foreach functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Voorbeeld: => count(max_foreach(/*/net.if.in[*],1u)) → aantal net.if.in items die gegevens hebben ontvangen in het afgelopen uur tot nu Merk op dat het gebruik van count() met een history-gerelateerde foreach functie (max_foreach, avg_foreach, enz.) kan leiden tot prestatie-implicaties, terwijl het gebruik van exists_foreach(), dat alleen met configuratiegegevens werkt, geen dergelijk effect zal hebben. |
| histogram_quantile (quantiel,bucket1,waarde1,bucket2,waarde2,...) | ||
| Berekent het φ-quantiel uit de buckets van een histogram. | quantiel - 0 ≤ φ ≤ 1 bucketN, waardeN - handmatig ingevoerde paren (>=2) van parameters of reactie van bucket_rate_foreach |
Alleen ondersteund in berekende items. Ondersteunde foreach functies: bucket_rate_foreach Functioneel komt dit overeen met 'histogram_quantile' in PromQL. Geeft -1 terug als de waarden van de laatste bucket 'Infinity' ("+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) | ||
| Aantal bestaande items in de configuratie die overeenkomen met de filtercriteria. | itemfilter - criteria voor itemselectie, maakt verwijzing mogelijk op basis van hostgroep, host, item sleutel en tags. Wildcards worden ondersteund. Zie itemfilter voor meer details. | Alleen ondersteund in berekende items. Ondersteund waardestype: int Werkt als een alias voor de count(exists_foreach(item_filter)) functie. Voorbeeld: => item_count(/*/agent.ping?[group="Host group 1"]) → aantal hosts met het agent.ping item in de "Hostgroep 1" |
| kurtosis (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| "Staartigheid" van de kansverdeling in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Kurtosis |
Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: last_foreach Voorbeeld: => kurtosis(/host/key,1u) → kurtosis voor het afgelopen uur tot nu |
| mad (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Mediaan absolute afwijking in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Mediaan absolute afwijking |
Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: last_foreach Voorbeeld: => mad(/host/key,1u) → mediaan absolute afwijking voor het afgelopen uur tot nu |
| max (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Hoogste waarde van een item binnen de gedefinieerde evaluatieperiode. | Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Voorbeeld: => max(/host/key,1u) - min(/host/key,1u) → het verschil berekenen tussen de maximale en minimale waarden van het afgelopen uur tot nu (verschil van waarden) |
| min (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Laagste waarde van een item binnen de gedefinieerde evaluatieperiode. | Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Voorbeeld: => max(/host/key,1u) - min(/host/key,1u) → het verschil berekenen tussen de maximale en minimale waarden van het afgelopen uur tot nu (verschil van waarden) |
| skewness (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Asymmetrie van de kansverdeling in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Schuifheid |
Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: last_foreach Voorbeeld: => skewness(/host/key,1u) → schuifheid voor het afgelopen uur tot nu |
| stddevpop (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Populatiestandaardafwijking in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Standaardafwijking |
Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: last_foreach Voorbeeld: => stddevpop(/host/key,1u) → populatiestandaardafwijking voor het afgelopen uur tot nu |
| stddevsamp (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Steekproefstandaardafwijking in verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Standaardafwijking |
Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: last_foreach Er zijn minimaal twee gegevenswaarden nodig voor deze functie om te werken. Voorbeeld: => stddevsamp(/host/key,1u) → steekproefstandaardafwijking voor het afgelopen uur tot nu |
| sum (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Som van verzamelde waarden binnen de gedefinieerde evaluatieperiode. | Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Voorbeeld: => sum(/host/key,1u) → som van waarden voor het afgelopen uur tot nu |
| sumofsquares (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| De som van kwadraten in verzamelde waarden binnen de gedefinieerde evaluatieperiode. | Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: last_foreach Voorbeeld: => sumofsquares(/host/key,1u) → som van kwadraten voor het afgelopen uur tot nu |
| varpop (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Populatievariantie van verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Variantie |
Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: last_foreach Voorbeeld: => varpop(/host/key,1u) → populatievariantie voor het afgelopen uur tot nu |
| varsamp (/host/key,(sec|#num)<:tijdsverschuiving>) | ||
| Steekproefvariantie van verzamelde waarden binnen de gedefinieerde evaluatieperiode. Zie ook: Variantie |
Zie gemeenschappelijke parameters. | Ondersteunde waardestypes: float, int Ondersteunde foreach functies: last_foreach Er zijn minimaal twee gegevenswaarden nodig voor deze functie om te werken. Voorbeeld: => varsamp(/host/key,1u) → steekproefvariantie voor het afgelopen uur tot nu |