[comment]: # translation:outdated

[comment]: # attributes: notoc

[comment]: # (terms:  avg, bucket_percentile, count, histogram_quantile, item_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp )

[comment]: # (tags:  count )

[comment]: # ({cbe17b03-ee60e21e})
# 1 Aggregatfunktionen

Sofern nicht anders angegeben, werden alle hier aufgeführten Funktionen unterstützt in:

-   [Auslöserausdrücken](/manual/config/triggers/expression)
-   [Formeln für berechnete Datenpunkte](/manual/config/items/itemtypes/calculated)
-   [Ausdrucksmakros](/manual/config/macros/expression_macros)

Aggregatfunktionen können arbeiten mit:

-   der Historie von Datenpunkten, zum Beispiel `min(/host/key,1h)`
-   [foreach-Funktionen](/manual/config/triggers/expression/aggregate/foreach) als
    einzigem Parameter, zum Beispiel `min(last_foreach(/*/key))` (nur in Formeln für berechnete Datenpunkte; für die Verwendung in Auslösern den berechneten Datenpunkt über seinen Schlüssel referenzieren)

Die Funktionen sind ohne zusätzliche Informationen aufgeführt. Klicken Sie auf die Funktion, um die vollständigen Details anzuzeigen.

|Function|Description|
|--|--------|
|[avg](#avg)|Der Durchschnittswert eines Datenpunkts innerhalb des definierten Auswertungszeitraums.|
|[bucket_percentile](#bucket-percentile)|Berechnet das Perzentil aus den Buckets eines Histogramms.|
|[count](#count)|Die Anzahl der Werte in einem von einer foreach-Funktion zurückgegebenen Array.|
|[histogram_quantile](#histogram-quantile)|Berechnet das φ-Quantil aus den Buckets eines Histogramms.|
|[item_count](#item-count)|Die Anzahl vorhandener Datenpunkte in der Konfiguration, die den Filterkriterien entsprechen.|
|[kurtosis](#kurtosis)|Die „Schwänzigkeit“ der Wahrscheinlichkeitsverteilung der erfassten Werte innerhalb des definierten Auswertungszeitraums.|
|[mad](#mad)|Die mediane absolute Abweichung der erfassten Werte innerhalb des definierten Auswertungszeitraums.|
|[max](#max)|Der höchste Wert eines Datenpunkts innerhalb des definierten Auswertungszeitraums.|
|[min](#min)|Der niedrigste Wert eines Datenpunkts innerhalb des definierten Auswertungszeitraums.|
|[skewness](#skewness)|Die Asymmetrie der Wahrscheinlichkeitsverteilung der erfassten Werte innerhalb des definierten Auswertungszeitraums.|
|[stddevpop](#stddevpop)|Die Standardabweichung der Grundgesamtheit der erfassten Werte innerhalb des definierten Auswertungszeitraums.|
|[stddevsamp](#stddevsamp)|Die Stichproben-Standardabweichung der erfassten Werte innerhalb des definierten Auswertungszeitraums.|
|[sum](#sum)|Die Summe der erfassten Werte innerhalb des definierten Auswertungszeitraums.|
|[sumofsquares](#sumofsquares)|Die Summe der Quadrate der erfassten Werte innerhalb des definierten Auswertungszeitraums.|
|[varpop](#varpop)|Die Varianz der Grundgesamtheit der erfassten Werte innerhalb des definierten Auswertungszeitraums.|
|[varsamp](#varsamp)|Die Stichprobenvarianz der erfassten Werte innerhalb des definierten Auswertungszeitraums.|

[comment]: # ({/cbe17b03-ee60e21e})

[comment]: # ({2acead3e-4d343eb8})
#### Allgemeine Parameter

-   `/host/key` ist ein allgemeiner obligatorischer erster Parameter für die Funktionen,
    die auf die Historie des Host-Datenpunkts verweisen
-   `(sec|#num)<:time shift>` ist ein allgemeiner zweiter Parameter für die
    Funktionen, die auf die Historie des Host-Datenpunkts verweisen, wobei:
    -   **sec** - maximaler [Auswertungszeitraum](/manual/config/triggers#evaluation-period) in Sekunden
        (Zeit-[Suffixe](/manual/appendix/suffixes) können verwendet werden), oder
    -   **\#num** - maximaler [Auswertungsbereich](/manual/config/triggers#evaluation-period) in den zuletzt
        erfassten Werten (wenn ihm ein Hash-Zeichen vorangestellt ist)
    -   **time shift** (optional) ermöglicht es, den Auswertungszeitpunkt
        zeitlich zurückzuverschieben. Siehe [weitere
        Details](/manual/config/triggers/expression#time-shift) zur
        Angabe von time shift.

[comment]: # ({/2acead3e-4d343eb8})

[comment]: # ({c645f0e4-fe53c04c})
### Funktionsdetails

Einige allgemeine Hinweise zu Funktionsparametern:

-   Funktionsparameter werden durch ein Komma getrennt
-   Optionale Funktionsparameter (oder Parameterteile) werden durch
    `<` `>` gekennzeichnet
-   Funktionsspezifische Parameter werden bei jeder Funktion beschrieben
-   Die Parameter `/host/key` und `(sec|#num)<:time shift>` dürfen niemals
    in Anführungszeichen gesetzt werden

[comment]: # ({/c645f0e4-fe53c04c})

[comment]: # ({2844b0b7-f5993b4c})
##### avg(/host/key,(sec|#num)<:time shift>) {#avg}

Der Durchschnittswert eines Datenpunkts innerhalb des definierten Auswertungszeitraums.<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktionen](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Die Zeitverschiebung ist nützlich, wenn der aktuelle Durchschnittswert mit dem Durchschnittswert zu einem früheren Zeitpunkt verglichen werden soll.

Beispiele:

```default
avg(/host/key,1h) #berechnet den Durchschnittswert für die letzte Stunde bis jetzt
avg(/host/key,#5) #berechnet den Durchschnittswert der fünf neuesten Werte
avg(/host/key,1h:now-1d) #berechnet den Durchschnittswert für eine Stunde im Zeitraum von vor 25 Stunden bis vor 24 Stunden
avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) #berechnet die durchschnittliche Prozessorlast für alle MySQL-Server
avg(/host/proc.num,5m)>300 #Auslöser, wenn die durchschnittliche Anzahl der Prozesse in den letzten 5 Minuten über 300 lag
```

[comment]: # ({/2844b0b7-f5993b4c})

[comment]: # ({ae55eda6-af24d13f})
##### bucket_percentile(item filter,time period,percentage) {#bucket-percentile}

Berechnet das Perzentil aus den Buckets eines Histogramms.<br>

Parameter: 

-   **item filter** - siehe [item filter](/manual/config/triggers/expression/aggregate/foreach#item-filter-syntax);<br>
-   **time period** - siehe [time period](/manual/config/triggers/expression/aggregate/foreach#time-period);<br>
-   **percentage** - Prozentsatz (0-100).

Kommentare:

-   Nur in berechneten Datenpunkten unterstützt;
-   Diese Funktion ist ein Alias für `histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))`.

Beispiele:

```default
bucket_percentile(/*/http_request_duration_seconds_bucket[*],5m,95) #calculate the 95th percentile response time over 5 minutes
bucket_percentile(/*/apiserver_request_duration_seconds_bucket[*],10m,99) #calculate the 99th percentile API latency
```

[comment]: # ({/ae55eda6-af24d13f})

[comment]: # ({4520f3ef-3c498650})
##### count(func_foreach(item filter,<time period>),<operator>,<pattern>) {#count}

Die Anzahl der Werte in einem Array, das von einer foreach-Funktion zurückgegeben wird.<br>
Unterstützte [foreach-Funktionen](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parameter: 

-   **func_foreach** - foreach-Funktion, für die die Anzahl der zurückgegebenen Werte gezählt werden soll. Siehe [foreach-Funktionen](/manual/config/triggers/expression/aggregate/foreach) für Details. Beachten Sie, dass count_foreach und bucket_rate_foreach [zusätzliche Parameter](/manual/config/triggers/expression/aggregate/foreach#additional-parameters) unterstützen.
-   **item filter** - siehe [item filter](/manual/config/triggers/expression/aggregate/foreach#item-filter-syntax);<br>
-   **time period** - siehe [time period](/manual/config/triggers/expression/aggregate/foreach#time-period);<br>
-   **operator** (muss in doppelte Anführungszeichen gesetzt werden). Unterstützte `operators`:<br>*eq* - gleich<br>*ne* - ungleich<br>*gt* - größer als<br>*ge* - größer oder gleich<br>*lt* - kleiner als<br>*le* - kleiner oder gleich<br>*like* - trifft zu, wenn das Muster enthalten ist (Groß-/Kleinschreibung wird beachtet)<br>*bitand* - bitweises UND<br>*regexp* - Groß-/Kleinschreibung beachtende Übereinstimmung mit dem in `pattern` angegebenen regulären Ausdruck<br>*iregexp* - Groß-/Kleinschreibung ignorierende Übereinstimmung mit dem in `pattern` angegebenen regulären Ausdruck<br>
-   **pattern** - das erforderliche Muster (String-Argumente müssen in doppelte Anführungszeichen gesetzt werden); unterstützt, wenn *operator* im dritten Parameter angegeben ist.

Kommentare: 

-   Die Verwendung von **count()** mit einer verlaufsbezogenen foreach-Funktion (max_foreach, avg_foreach usw.) kann Auswirkungen auf die Performance haben, während die Verwendung von **exists_foreach()**, das nur mit Konfigurationsdaten arbeitet, keinen solchen Effekt hat.
-   Optionale Parameter *operator* oder *pattern* können nach einem Komma nicht leer gelassen, sondern nur vollständig weggelassen werden.
-   Wenn *bitand* als dritter Parameter verwendet wird, kann der vierte Parameter `pattern` als zwei durch '/' getrennte Zahlen angegeben werden: **number_to_compare_with/mask**. count() berechnet ein „bitweises UND“ aus dem Wert und der *mask* und vergleicht das Ergebnis mit *number_to_compare_with*. Wenn das Ergebnis des „bitweisen UND“ gleich *number_to_compare_with* ist, wird der Wert gezählt.<br>Wenn *number_to_compare_with* und *mask* gleich sind, muss nur die *mask* angegeben werden (ohne '/').
-   Wenn *regexp* oder *iregexp* als dritter Parameter verwendet wird, kann der vierte Parameter `pattern` ein gewöhnlicher oder [globaler](/manual/regular_expressions#global-regular-expressions) (beginnend mit '@') regulärer Ausdruck sein. Bei globalen regulären Ausdrücken wird die Groß-/Kleinschreibung aus den Einstellungen des globalen regulären Ausdrucks übernommen. Für den Zweck des regexp-Abgleichs werden Float-Werte immer mit 4 Dezimalstellen nach dem '.' dargestellt. Beachten Sie außerdem, dass bei großen Zahlen Unterschiede zwischen der dezimalen (in der Datenbank gespeicherten) und der binären (vom Zabbix-Server verwendeten) Darstellung die 4. Dezimalstelle beeinflussen können.

Beispiele:

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

[comment]: # ({/4520f3ef-3c498650})

[comment]: # ({3ba37963-f3ad7158})
##### histogram_quantile(quantile,bucket1,value1,bucket2,value2,...) {#histogram-quantile}

Berechnet das φ-Quantil aus den Buckets eines Histogramms.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *bucket_rate_foreach*.

Parameter: 

-   **quantile** - 0 ≤ φ ≤ 1;<br>
-   **bucketN, valueN** - manuell eingegebene Parameterpaare (>=2) oder die Antwort von [bucket_rate_foreach](/manual/config/triggers/expression/aggregate/foreach).

Kommentare:

-   Nur in berechneten Datenpunkten unterstützt;
-   Entspricht funktional '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram-quantile)' aus PromQL;
-   Gibt -1 zurück, wenn die Werte des letzten 'Infinity'-Buckets (*"+inf"*) gleich 0 sind.

Beispiele:

```default
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))
```

[comment]: # ({/3ba37963-f3ad7158})

[comment]: # ({b14d0146-c8e3133a})
##### item_count(item filter) {#item-count}

Die Anzahl der in der Konfiguration vorhandenen Datenpunkte, die den Filterkriterien entsprechen.<br>
Unterstützter Werttyp: *Integer*.

Parameter: 

-   **item filter** - Kriterien für die Auswahl von Datenpunkten; ermöglicht Referenzen nach Host-Gruppe, Host, Datenpunktschlüssel und Tags. Platzhalter werden unterstützt. Siehe [item filter](/manual/config/triggers/expression/aggregate/foreach#item-filter-syntax) für weitere Details.<br>

Kommentare:

-   Nur in berechneten Datenpunkten unterstützt;
-   Funktioniert als Alias für die Funktion *count(exists_foreach(item_filter))*.

Beispiele:

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

[comment]: # ({/b14d0146-c8e3133a})

[comment]: # ({356d9069-88a54099})
##### kurtosis(/host/key,(sec|#num)<:time shift>) {#kurtosis}

Die „Schwänzigkeit“ der Wahrscheinlichkeitsverteilung der erfassten Werte innerhalb des definierten Auswertungszeitraums. Siehe auch: [Kurtosis](https://en.wikipedia.org/wiki/Kurtosis).<br>
Unterstützte Werttypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
kurtosis(/host/system.cpu.util[,user],5m)>5 #trigger on sharp spikes of CPU utilization over 5 minutes
```

[comment]: # ({/356d9069-88a54099})

[comment]: # ({98a81503-bfb43a27})
##### mad(/host/key,(sec|#num)<:time shift>) {#mad}

Die mittlere absolute Abweichung vom Median der erfassten Werte innerhalb des definierten Auswertungszeitraums. Siehe auch: [Median absolute deviation](https://en.wikipedia.org/wiki/Median_absolute_deviation).<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
last(/host/system.cpu.util[,user])>avg(/host/system.cpu.util[,user],1h)+3*mad(/host/system.cpu.util[,user],1h) #Auslöser, wenn der letzte CPU-Auslastungswert statistisch signifikant ist
```

[comment]: # ({/98a81503-bfb43a27})

[comment]: # ({e93a3513-5882010b})
##### max(/host/key,(sec|#num)<:time shift>) {#max}

Der höchste Wert eines Datenpunkts innerhalb des definierten Auswertungszeitraums.<br>
Unterstützte Werttypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktionen](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
max(/host/key,1h) - min(/host/key,1h) #berechnet die Differenz zwischen den maximalen und minimalen Werten innerhalb der letzten Stunde bis jetzt (die Delta der Werte)
max(last_foreach(/*/vfs.fs.size[*,pused]?[group="Linux servers"])) #gibt die höchste Festplattenauslastung über alle Linux-Server zurück
```

[comment]: # ({/e93a3513-5882010b})

[comment]: # ({cfe7b652-ffd1e499})
##### min(/host/key,(sec|#num)<:time shift>) {#min}

Der niedrigste Wert eines Datenpunkts innerhalb des definierten Auswertungszeitraums.<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktionen](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
max(/host/key,1h) - min(/host/key,1h) #calculate the difference between the maximum and minimum values within the last hour until now (the delta of values)
min(last_foreach(/*/vfs.file.contents["/sys/class/net/enp0s3/operstate"]?[group="Linux servers"])) #return the minimum operational state for any interface across all Linux servers
```

[comment]: # ({/cfe7b652-ffd1e499})

[comment]: # ({f9d7543b-6b6fb273})
##### skewness(/host/key,(sec|#num)<:time shift>) {#skewness}

Die Asymmetrie der Wahrscheinlichkeitsverteilung der erfassten Werte innerhalb des definierten Auswertungszeitraums. Siehe auch: [Skewness](https://en.wikipedia.org/wiki/Skewness).<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
skewness(/host/vm.memory.size[used],5m)<-20 #Auslöser bei plötzlichen negativen Einbrüchen, die auf Abstürze/Neustarts hinweisen
```

[comment]: # ({/f9d7543b-6b6fb273})

[comment]: # ({7e32d94e-11c2ea25})
##### stddevpop(/host/key,(sec|#num)<:time shift>) {#stddevpop}

Die Populationsstandardabweichung der erfassten Werte innerhalb des definierten Auswertungszeitraums. Siehe auch: [Standardabweichung](https://en.wikipedia.org/wiki/Standard_deviation).<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
stddevpop(/host/system.cpu.util[,user],10m)>7 #Auslöser, wenn die CPU-Auslastung stark schwankt (die Populationsstandardabweichung liegt über 7 innerhalb von 10 Minuten)
```

[comment]: # ({/7e32d94e-11c2ea25})

[comment]: # ({23ca7fe4-1db77c44})
##### stddevsamp(/host/key,(sec|#num)<:time shift>) {#stddevsamp}

Die Stichproben-Standardabweichung der erfassten Werte innerhalb des definierten Auswertungszeitraums. Siehe auch: [Standardabweichung](https://en.wikipedia.org/wiki/Standard_deviation).<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Mindestens zwei Datenwerte sind erforderlich, damit diese Funktion arbeitet.

Beispiele:

```default
stddevsamp(/host/system.cpu.util[,user],10m)>7 #Auslöser, wenn die CPU-Auslastung stark schwankt (die Stichproben-Standardabweichung liegt über 7 innerhalb von 10 Minuten)
```

[comment]: # ({/23ca7fe4-1db77c44})

[comment]: # ({89b5406f-0ecf79eb})
##### sum(/host/key,(sec|#num)<:time shift>) {#sum}

Die Summe der erfassten Werte innerhalb des definierten Auswertungszeitraums.<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktionen](/manual/config/triggers/expression/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
sum(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #calculate the total incoming network traffic for all Linux servers
sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) #calculate the total disk space for all MySQL servers
sum(last_foreach(/*/net.dns[*,*,*])) #calculate the total number of successful DNS checks
```

[comment]: # ({/89b5406f-0ecf79eb})

[comment]: # ({907627c8-6f6556f2})
##### sumofsquares(/host/key,(sec|#num)<:time shift>) {#sumofsquares}

Die Summe der Quadrate der erfassten Werte innerhalb des definierten Auswertungszeitraums.<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
sumofsquares(/host/calculated.net.if.rate,1m) #die Summe der Quadrate für die Netzwerkverkehrsrate (eingehend vs. ausgehend)
sumofsquares(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #die Summe der Quadrate der neuesten eingehenden Netzwerkverkehrswerte über alle Linux-Server hinweg
```

[comment]: # ({/907627c8-6f6556f2})

[comment]: # ({04d271f7-d299bd33})
##### varpop(/host/key,(sec|#num)<:time shift>) {#varpop}

Die Populationsvarianz der erfassten Werte innerhalb des definierten Auswertungszeitraums. Siehe auch: [Varianz](https://en.wikipedia.org/wiki/Variance).<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Beispiele:

```default
varpop(/host/system.cpu.util[,user],10m)>50 #Auslöser, wenn die CPU-Auslastung stark schwankt (Varianz liegt über 50 innerhalb von 10 Minuten)
```

[comment]: # ({/04d271f7-d299bd33})

[comment]: # ({9c60c2c9-b1bc041c})
##### varsamp(/host/key,(sec|#num)<:time shift>) {#varsamp}

Die Stichprobenvarianz der erfassten Werte innerhalb des definierten Auswertungszeitraums. Siehe auch: [Varianz](https://en.wikipedia.org/wiki/Variance).<br>
Unterstützte Wertetypen: *Float*, *Integer*.<br>
Unterstützte [foreach-Funktion](/manual/config/triggers/expression/aggregate/foreach): *last_foreach*.

Parameter: siehe [allgemeine Parameter](#common-parameters).

Mindestens zwei Datenwerte sind erforderlich, damit diese Funktion funktioniert.

Beispiele:

```default
varsamp(/host/system.cpu.util[,user],10m)>50 #Auslöser, wenn die CPU-Auslastung stark schwankt (Stichprobenvarianz liegt über 50 innerhalb von 10 Minuten)
```

[comment]: # ({/9c60c2c9-b1bc041c})

[comment]: # ({ba58f5e4-541616fc})
Siehe [alle unterstützten Funktionen](/manual/config/triggers/expression#functions).

[comment]: # ({/ba58f5e4-541616fc})