[comment]: # translation:outdated

[comment]: # ({ee60e21e-ee60e21e})
# 1 集計関数

特に明記されていない限り、ここにリストされているすべての機能は次の言語でサポートされています。

-   [トリガー式](/manual/config/triggers/expression)
-   [計算項目](/manual/config/items/itemtypes/calculated)

集計関数は次のいずれかで機能します。

-   アイテムの履歴。例:`min(/host/key,1h)`
-   [foreach 関数](/manual/appendix/functions/aggregate/foreach) のパラメータ。例:`min(last_foreach(/*/key))`

関数パラメーターに関する一般的な注意事項。

-   関数パラメータはコンマで区切られます。
-   オプションの関数パラメーター (またはパラメーター部分) は `<` `>` で示されます
-   機能固有のパラメーターは、各機能で説明されています
-   `/host/key` と `(sec|#num)<:time shift>` はパラメータを引用符で囲んではいけません

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

[comment]: # ({4d343eb8-4d343eb8})
##### 共通パラメータ

-   `/host/key` はホストアイテムの履歴を参照する関数の一般的なパラメーターの一つ目です。必須です。
-   `(sec|#num)<:time shift>` は、ホストのアイテム履歴を参照する関数の一般的なパラメーターの二つ目です。
    -   **sec** - 秒単位の最大[評価期間](/manual/config/triggers#evaluation_period) (タイム[サフィックス](/manual/appendix/suffixes) を使用できます) または
    -   **\#num** - 最新の収集値の最大[評価範囲](/manual/config/triggers#evaluation_period) (先頭にハッシュ マークがある場合)
    -   **time shift** (オプション) 評価ポイントを時間内に戻すことができます。 時間シフトの指定については[詳細](/manual/config/triggers/expression#time_shift)を参照してください。

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

[comment]: # ({49359e13-ad86e84b})
#### 集計関数

|関数|<|<|
|--|--|--|
|**説明**|**関数固有のパラメータ**|**コメント**|
|**avg** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内のアイテムの平均値|[共通パラメータ](#common-parameters)を参照|サポートされている値のタイプ: float,int<br><br>例:<br>=> **avg**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間の平均値<br>=> **avg**(/host/key,**1h:now-1d**) → [現在](/manual/config/triggers#evaluation_period)の25 時間前から24 時間前までの 1 時間の平均値<br>=> **avg**(/host/key,**\#5**) → 最新の 5 つの値の平均値<br>=> **avg**(/host/key,**\#5:now-1d**) → 過去 24 時間に受信した値を除く、最新の 5 つの値の平均値<br><br>時間シフトは、現在の平均値を少し前の平均値と比較する必要がある場合に便利です。|
|**bucket\_percentile** (item filter,time period,percentage)|<|<|
|ヒストグラムのバケットからパーセンタイルを計算します|**item filter** - [item filter](/manual/appendix/functions/aggregate/foreach#item_filter)参照<br>**time period** - [time period](/manual/appendix/functions/aggregate/foreach#time_period)参照<br>**percentage** - パーセンテージ(0-100)|計算項目でのみサポートされます。<br><br>この関数は `histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))` のエイリアスです|
|**count** (func\_foreach(item filter,<time period>))|<|<|
|foreach 関数によって返される配列内の値の数|**func\_foreach** - 戻り値の数をカウントする foreach 関数 (サポートされている引数付き)。 詳細については[foreach 関数](/manual/appendix/functions/aggregate/foreach) を参照してください。|サポートされている値の型: int<br><br>例:<br>=> **count**(max\_foreach(/\*/net.if.in\[\*\],1h)) → [現在](/manual/config/triggers#evaluation_period)から1 時間までにデータを受信した net.if.in アイテムの数<br><br>履歴関連の foreach 関数 (max\_foreach、avg\_foreach など) で **count()** を使用すると、パフォーマンスに影響を与える可能性があります。 設定データではそのような影響はありません。|
|**histogram\_quantile** (quantile,bucket1,value1,bucket2,value2,...)|<|<|
|ヒストグラムのバケットから φ 変位値を計算します|**quantile** - 0 ≤ φ ≤ 1<br>**bucketN, valueN** - [bucket\_rate\_foreach](/manual/appendix/functions/aggregate/foreach)のパラメーターまたは応答の手動で入力されたペア (>=2)|計算項目のみ対応。<br><br>機能的にはPromQLの"[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)"に対応。<br><br>最後の 'Infinity' バケット (*"+inf"*) の値が 0 の場合、-1 を返します。<br><br>例:<br>=> **histogram\_quantile**(0.75,1.0,last(/host/rate\_bucket\[1.0\]),"+Inf",last(/host/rate\_bucket\[Inf\])<br>=> **histogram\_quantile**(0.5,bucket\_rate\_foreach(//item\_key,30s))|
|**item\_count** (item filter)|<|<|
|構成内のフィルター条件に一致する既存アイテムの数|**item filter** - ホストグループ、ホスト、アイテムキー、タグによる参照が可能。 ワイルドカードがサポートされています。 詳細については、[アイテム フィルター](/manual/appendix/functions/aggregate/foreach#item_filter)を参照してください。|サポートされている値のタイプ: int<br><br>*count(exists\_foreach(item\_filter))* 関数のエイリアスとして機能します。<br><br>例:<br>=> **item\_count**(/\*/agent.ping?\[group="Host group 1"\]) → "ホスト グループ 1”に *agent.ping* 項目があるホストの数|
|**kurtosis** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値の確率分布"テーリング"<br><br>[尖度](https://en.wikipedia.org/wiki/Kurtosis)参照|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **kurtosis**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間の尖度|
|**mad** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値の中央絶対偏差<br><br>[絶対偏差中央値](https://en.wikipedia.org/wiki/Median_absolute_deviation)参照|[共通パラメータ](#common parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **mad**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間の絶対偏差中央値|
|**max** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内のアイテムの最高値|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **max**(/host/key,**1h**) - **min**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間以内の最大値と最小値の差 (値のデルタ) を計算します。|
|**min** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内のアイテムの最低値|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **max**(/host/key,**1h**) - **min**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間以内の最大値と最小値の差 (値のデルタ) を計算します。|
|**skewness** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値の確率分布の非対称性<br><br>[歪度](https://en.wikipedia.org/wiki/Skewness)参照|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **skewness**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間の歪度|
|**stddevpop** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値の母標準偏差<br><br>[標準偏差](https://en.wikipedia.org/wiki/Standard_deviation)参照|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **stddevpop**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間の標準偏差|
|**stddevsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値のサンプル標準偏差<br><br>[標準偏差](https://en.wikipedia.org/wiki/Standard_deviation)参照|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>この関数が機能するには少なくとも 2 つのデータ値が必要です。<br><br>例:<br>=> **stddevsamp**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間のサンプル標準偏差|
|**sum** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値の合計|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **sum**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間の値の合計|
|**sumofsquares** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値の二乗和|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **sumofsquares**(/host/key,**1h**) → [現在]から過去 1 時間の平方和(/manual/config/triggers#evaluation_period)|
|**varpop** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値の母分散。<br><br>[分散](https://en.wikipedia.org/wiki/Variance)参照|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>例:<br>=> **varpop**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間の母集団分散|
|**varsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<|
|定義された期間内に収集された値の標本分散<br><br>[分散](https://en.wikipedia.org/wiki/Variance)参照|[共通パラメータ](#common-parameters)参照|サポートされている値のタイプ: float, int<br><br>この関数が機能するには少なくとも 2 つのデータ値が必要です<br><br>例:<br>=> **varsamp**(/host/key,**1h**) → [現在](/manual/config/triggers#evaluation_period)から過去 1 時間の標本分散|

[comment]: # ({/49359e13-ad86e84b})