[comment]: # attributes: notoc

[comment]: # ({14681e09-a4f8cca1})
# 5 トレンド関数

トレンド関数は、[ヒストリ関数](/manual/config/triggers/expression/history)とは対照的に、計算に[トレンド](/manual/config/items/history_and_trends#keeping-trends)データを使用します。

トレンドは1時間ごとの集計値を保存します。
トレンド関数はこれらの1時間ごとの平均値を使用するため、長期的な分析に役立ちます。

トレンド関数の結果はキャッシュされるため、同じパラメータで同じ関数を複数回呼び出しても、データベースからの情報取得は1回だけです。
トレンド関数のキャッシュは、[TrendFunctionCacheSize](/manual/appendix/config/zabbix_server#trendfunctioncachesize)サーバーパラメータで制御されます。

トレンド関数**のみ**を参照するトリガーは、式内で最小の時間間隔ごとに1回評価されます。
例えば、次のようなトリガーの場合

```default
trendavg(/host/key,1d:now/d) > 1 or trendavg(/host/key2,1w:now/w) > 2
```

は1日ごとに1回評価されます。
トリガーにトレンド関数とヒストリ関数（または[日付と時刻](/manual/config/triggers/expression/time)、[nodata()](/manual/config/triggers/expression/history#nodata)）の両方が含まれている場合は、[通常の原則](/manual/config/triggers#calculation-time)に従って計算されます。

ここに記載されているすべての関数は、以下でサポートされています。

-   [トリガー式](/manual/config/triggers/expression)
-   [計算アイテム](/manual/config/items/itemtypes/calculated)
-   [式マクロ](/manual/config/macros/expression_macros)

関数は追加情報なしでリストされています。
関数をクリックすると、詳細が表示されます。

|関数|説明|
|--|--------|
|[baselinedev](#baselinedev)|直近のデータ期間と、前のシーズンの同じデータ期間との間の偏差数（stddevpopアルゴリズムによる）を返します。|
|[baselinewma](#baselinewma)|加重移動平均アルゴリズムを使用して、複数の等しい期間（「シーズン」）の同じ時間枠のデータを平均化することでベースラインを計算します。|
|[trendavg](#trendavg)|指定した期間内のトレンド値の平均。|
|[trendcount](#trendcount)|指定した期間内のトレンド値を計算するために使用された、正常に取得されたヒストリ値の数。|
|[trendmax](#trendmax)|指定した期間内のトレンド値の最大値。|
|[trendmin](#trendmin)|指定した期間内のトレンド値の最小値。|
|[trendstl](#trendstl)|検出期間中の異常値の割合を返します。これは0から1までの小数値で、`((異常値の数)/(値の総数))`です。|
|[trendsum](#trendsum)|指定した期間内のトレンド値の合計。|

[comment]: # ({/14681e09-a4f8cca1})

[comment]: # ({9b47c9ce-2a63633f})
##### 共通パラメータ

-   `/host/key`は共通の必須の最初のパラメータです
-   `time period:time shift`は共通の2番目のパラメータで、以下の通りです:
    -   **time period** - 期間（最小値は'1h'）、\<N>\<time unit>で定義されます。`N`は時間単位の数、`time unit`はh（時間）、d（日）、w（週）、M（月）、y（年）です。
    -   **time shift** - [期間のオフセット](/manual/config/triggers/expression#time-shift)（関数の例を参照）

[comment]: # ({/9b47c9ce-2a63633f})

[comment]: # ({405ac9eb-bbe5ecf2})
### 関数の詳細

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

-   関数パラメータはカンマで区切ります
-   オプションの関数パラメータ（またはパラメータの一部）は `<` `>` で示します
-   関数固有のパラメータは各関数で説明します
-   `/host/key` および `time period:time shift` パラメータは決して引用符で囲まないでください

[comment]: # ({/405ac9eb-bbe5ecf2})

[comment]: # ({e17e8d2f-f42e2c92})
##### baselinedev(/host/key,data period:time shift,season unit,num seasons) {#baselinedev}

直近のデータ期間と過去のシーズンの同じデータ期間との間の偏差の数（stddevpopアルゴリズムによる）を返します。<br>

パラメータ:

-   [共通パラメータ](#common-parameters)を参照<br>
-   **data period** - シーズン内のデータ収集期間。<N><time unit>で定義されます。<br>`N` - 時間単位の数<br>`time unit` - h（時間）、d（日）、w（週）、M（月）、y（年）のいずれか。season以下でなければなりません。<br>
-   **season unit** - 1シーズンを定義するカレンダー単位（h、d、w、M、y）。data periodより小さくできません。<br>
-   **num seasons** - 評価するシーズンの数

例:

```default
baselinedev(/host/key,1d:now/d,"M",6) #直近1日と過去6ヶ月の同じ日との間の標準偏差（母集団）を計算します。前月に日付が存在しない場合は、その月の最終日が使用されます（7月31日は1月31日、2月28日、... 6月30日と比較されます）
baselinedev(/host/key,1h:now/h,"d",10)  #直近1時間と過去10日間の同じ時刻との間の標準偏差（母集団）を計算します
```

[comment]: # ({/e17e8d2f-f42e2c92})

[comment]: # ({508adac0-447a9dac})
##### baselinewma(/host/key,data period:time shift,season unit,num seasons) {#baselinewma}

加重移動平均アルゴリズムを使用して、複数の等しい期間（「シーズン」）の同じ時間枠からデータを平均化することでベースラインを計算します。<br>

パラメータ:

-   [共通パラメータ](#common-parameters)を参照<br>
-   **data period** - シーズン内でのデータ収集期間。<N><time unit>で定義されます。<br>`N` - 時間単位の数<br>`time unit` - h（時間）、d（日）、w（週）、M（月）、y（年）。シーズン以下でなければなりません。<br>Time shift - シーズン内でのデータ収集期間の終了を定義するオフセット（例を参照）<br>
-   **season unit** - 1シーズンを定義するカレンダー単位（h, d, w, M, y）。data periodより小さくできません。<br>
-   **num seasons** - 評価するシーズン数

例:

```default
baselinewma(/host/key,1h:now/h,"d",3) #昨日で終了する直近3日間の同じ時刻（時単位）からベースラインを計算します。"now"が月曜13:30の場合、金曜・土曜・日曜の12:00-12:59のデータが分析されます
baselinewma(/host/key,2h:now/h,"d",3) #昨日で終了する直近3日間の同じ2時間枠からベースラインを計算します。"now"が月曜13:30の場合、金曜・土曜・日曜の11:00-12:59のデータが分析されます
baselinewma(/host/key,1d:now/d,"M",4) #直近の完全な月の前の4か月間で「昨日」と同じ日付のデータからベースラインを計算します。該当日が存在しない場合は月末日が使用されます。今日が9月1日の場合、7月31日、6月30日、5月31日、4月30日のデータが分析されます。
```

[comment]: # ({/508adac0-447a9dac})

[comment]: # ({2e9dd145-50d2db8d})
##### trendavg(/host/key,time period:time shift) {#trendavg}

定義された期間内のトレンド値の平均。

パラメータ:

-   [共通パラメータ](#common-parameters)を参照

例:

```default
trendavg(/host/key,1h:now/h) #直前1時間の平均 (例: 12:00-13:00)
trendavg(/host/key,1h:now/h-1h) #2時間前の平均 (11:00-12:00)
trendavg(/host/key,1h:now/h-2h) #3時間前の平均 (10:00-11:00)
trendavg(/host/key,1M:now/M-1y) #1年前の直前月の平均
```

[comment]: # ({/2e9dd145-50d2db8d})

[comment]: # ({533dfdf1-d66e1f00})
##### trendcount(/host/key,time period:time shift) {#trendcount}

定義された期間内でトレンド値を計算するために使用された履歴値のうち、正常に取得された値の数。

パラメータ:

-   [共通パラメータ](#common-parameters)を参照

例:

```default
trendcount(/host/key,1h:now/h) #直前1時間の値の数（例：12:00-13:00）
trendcount(/host/key,1h:now/h-1h) #2時間前の値の数（11:00-12:00）
trendcount(/host/key,1h:now/h-2h) #3時間前の値の数（10:00-11:00）
trendcount(/host/key,1M:now/M-1y) #1年前の前月の値の数
```

[comment]: # ({/533dfdf1-d66e1f00})

[comment]: # ({f0a89e58-43665d11})
##### trendmax(/host/key,time period:time shift) {#trendmax}

定義された期間内のトレンド値の最大値。

パラメータ:

-   [共通パラメータ](#common-parameters)を参照

例:

```default
trendmax(/host/key,1h:now/h) #直前の1時間の最大値 (例: 12:00-13:00)
trendmax(/host/key,1h:now/h) - trendmin(/host/key,1h:now/h) → 直前の1時間 (12:00-13:00) の最大値と最小値の差分 (トレンドデルタ) を計算
trendmax(/host/key,1h:now/h-1h) #2時間前の最大値 (11:00-12:00)
trendmax(/host/key,1h:now/h-2h) #3時間前の最大値 (10:00-11:00)
trendmax(/host/key,1M:now/M-1y) #1年前の前月の最大値
```

[comment]: # ({/f0a89e58-43665d11})

[comment]: # ({793872d7-3c0143a2})
##### trendmin(/host/key,time period:time shift) {#trendmin}

定義された期間内のトレンド値の最小値。

パラメータ:

-   [共通パラメータ](#common-parameters)を参照

例:

```default
trendmin(/host/key,1h:now/h) #直前1時間の最小値（例：12:00-13:00）
trendmax(/host/key,1h:now/h) - trendmin(/host/key,1h:now/h) → 直前1時間（12:00-13:00）の最大値と最小値の差分（トレンドデルタ）を計算
trendmin(/host/key,1h:now/h-1h) #2時間前の最小値（11:00-12:00）
trendmin(/host/key,1h:now/h-2h) #3時間前の最小値（10:00-11:00）
trendmin(/host/key,1M:now/M-1y) #1年前の直前月の最小値
```

[comment]: # ({/793872d7-3c0143a2})

[comment]: # ({0ebc63ad-aba289ed})
##### trendstl(/host/key,eval period:time shift,detection period,season,<deviations>,<devalg>,<s window>) {#trendstl}

検出期間中の異常値の割合を返します。0から1までの小数値で、`((異常値の数)/(値の総数))`です。

パラメータ:

-   [共通パラメータ](#common-parameters)を参照<br>
-   **eval period** - 分解する必要がある期間（最小値は'1h'）、<N><time unit>で定義<br>`N` - 時間単位の数<br>`time unit` - h（時間）、d（日）、w（週）、M（月）、y（年）<br>
-   **detection period** - 異常値を計算するためのeval periodの終了前の期間（最小値は'1h'、eval periodより長くすることはできません）、<N><time unit>で定義<br>`N` - 時間単位の数<br>`time unit` - h（時間）、d（日）、w（週）<br>
-   **season** - 繰り返しパターン（「シーズン」）が予想される最短期間（最小値は'2h'、eval periodより長くすることはできません。eval period内のエントリ数は、得られる周波数（season/h）の2倍より大きくなければなりません）、<N><time unit>で定義<br>`N` - 時間単位の数<br>`time unit` - h（時間）、d（日）、w（週）
-   **deviations** - 異常値と見なす偏差の数（devalgで計算、10進数可）（1以上、デフォルトは3）
-   **devalg**（ダブルクォーテーションで囲む必要あり） - 偏差アルゴリズム。*stddevpop*、*stddevsamp*、*mad*（デフォルト）から選択
-   **s window** - 季節性抽出のためのloessウィンドウのスパン（ラグ数、デフォルトは"10 * eval period内のエントリ数 + 1"）

例:

```default
trendstl(/host/key,100h:now/h,10h,2h) #直近100時間のトレンドデータを分析し、その期間の直近10時間の異常値の割合を求める。周期性は2hと仮定し、評価期間の残差系列値がその残差系列のMADの3偏差に達した場合に異常値と見なす
trendstl(/host/key,100h:now/h-10h,100h,2h,2.1,"mad") #10時間前までの100時間のトレンドデータを分析し、その全期間の異常値の割合を求める。周期性は2hと仮定し、評価期間の残差系列値がその残差系列のMADの2.1偏差に達した場合に異常値と見なす
trendstl(/host/key,100d:now/d-1d,10d,1d,4,,10) #1日前までの100日間のトレンドデータを分析し、その期間の直近10日の異常値の割合を求める。周期性は1dと仮定し、評価期間の残差系列値がその残差系列のMADの4偏差に達した場合に異常値と見なす。季節性抽出のためのloessウィンドウのデフォルトスパン"10 * eval period内のエントリ数 + 1"を10ラグに上書き
trendstl(/host/key,1M:now/M-1y,1d,2h,,"stddevsamp") #1年前の前月を分析し、その期間の最終日の異常値の割合を求める。周期性は2hと仮定し、評価期間の残差系列値がその残差系列の標本標準偏差の3偏差に達した場合に異常値と見なす
```

[comment]: # ({/0ebc63ad-aba289ed})

[comment]: # ({f897c466-1b9f4c40})
##### trendsum(/host/key,time period:time shift) {#trendsum}

定義された期間内のトレンド値の合計。

パラメータ:

-   [共通パラメータ](#common-parameters)を参照

例:

```default
trendsum(/host/key,1h:now/h) #直前1時間の合計（例：12:00-13:00）
trendsum(/host/key,1h:now/h-1h) #2時間前の合計（11:00-12:00）
trendsum(/host/key,1h:now/h-2h) #3時間前の合計（10:00-11:00）
trendsum(/host/key,1M:now/M-1y) #1年前の直前月の合計
```

[comment]: # ({/f897c466-1b9f4c40})

[comment]: # ({ba58f5e4-9e520569})
[サポートされているすべての関数](/manual/config/triggers/expression#functions)を参照してください。

[comment]: # ({/ba58f5e4-9e520569})
