Documentation
8 予測関数
ここに挙げたすべての関数は、以下の関数でサポートされています。
関数の一覧には追加情報は記載されていません。関数をクリックすると詳細が表示されます。
共通パラメータ
/host/keyはホストアイテムの履歴を参照する関数の一般的なパラメーターの一つ目です。必須です。(sec|#num)<:time shift>は、ホストのアイテム履歴を参照する関数の一般的なパラメーターの二つ目です。
関数の詳細
関数のパラメータに関する一般的な注意事項:
- 関数のパラメータはカンマで区切ります。
- オプションの関数パラメータ（またはパラメータ部分）は、
<>で示されます。 - 関数固有のパラメータは、各関数で説明されています。
/host/keyおよび(sec|#num)<:timeshift>パラメータは引用符で囲んではなりません。
forecast(/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>)
アイテムの将来値、最大値、最小値、差分、または平均値
サポートされる値の型: Float、Integer
パラメーター:
- 共通パラメーター を参照してください。
- time - 予測期間（秒単位）（時間サフィックスを使用できます）。負の値もサポートされています。
- fit (オプション。二重引用符で囲む必要があります) - 履歴データをフィッティングするために使用する関数。サポートされている近似値:
linear - 線形関数 (デフォルト)
polynomialN - N 次多項式 (1 <= N <= 6)
exponential - 指数関数
logarithmic - 対数関数
power - べき乗関数
polynomial1 は linear と同等であることに注意してください。 - mode (オプション。二重引用符で囲む必要があります) - 要求される出力。サポートされているモード:
value - 値 (デフォルト)
max - 最大値
min - 最小値
delta - max-min
avg - 平均
value は、now+timeの時点における項目値を推定することに注意してください。max、min、delta、および avg は、nowからnow+timeまでの区間における項目値の推定値を調べます。
コメント:
- 返される値が 1.7976931348623158E+308 より大きい場合、または -1.7976931348623158E+308 より小さい場合、返される値はそれぞれ 1.7976931348623158E+308 または -1.7976931348623158E+308 に切り詰められます。
- 式内で誤って使用されている場合（項目タイプが間違っている、パラメータが無効）のみサポート対象外となり、それ以外の場合はエラー時に -1 を返します。
- 予測トリガー関数 に関する追加情報も参照してください。
例:
forecast(/host/key,#10,1h) # 過去10個の値に基づいて、1時間後のアイテムの値を予測します。
forecast(/host/key,1h,30m) # 過去1時間のデータに基づいて、30分後のアイテムの値を予測します。
forecast(/host/key,1h:now-1d,12h) # 1日前の1時間に基づいて、12時間後のアイテムの値を予測します。
forecast(/host/key,1h,10m,"exponential") # 過去1時間のデータと指数関数に基づいて、10分後のアイテムの値を予測します。
forecast(/host/key,1h,2h,"polynomial3","max") # 過去1時間のデータと3次多項式に基づいて、今後2時間でアイテムが到達できる最大値を予測します。
forecast(/host/key,#2,-20m) # 過去2つの値に基づいて、20分前のアイテムの値を推定します（これはさらに長い場合があります）特にアイテムが1時間に1回など、めったに更新されない場合は、last() を使用するよりも正確です。timeleft(/host/key,(sec|#num)<:timeshift>,threshold,<fit>)
アイテムが指定されたしきい値に達するまでに必要な時間（秒）
サポートされる値の型：Float、Integer
パラメーター：
- 共通パラメーター を参照してください。
- threshold - 到達すべき値（単位サフィックス を使用できます。）
- fit (オプション。二重引用符で囲む必要があります) - forecast() を参照してください。
コメント:
- 返される値が 1.7976931348623158E+308 より大きい場合、返される値は 1.7976931348623158E+308 に切り詰められます。
- しきい値に達しない場合は 1.7976931348623158E+308 を返します。
- 式で誤って使用されている場合（項目タイプが間違っている、パラメータが無効）のみサポート対象外となり、それ以外の場合はエラー時に -1 を返します。
- 予測トリガー関数 に関する追加情報も参照してください。
例:
timeleft(/host/key,#10,0) # 過去10回分のデータに基づき、アイテムの値が0に達するまでの時間
timeleft(/host/key,1h,100) # 過去1時間分のデータに基づき、アイテムの値が100に達するまでの時間
timeleft(/host/key,1h:now-1d,100) # 1日前の1時間分に基づき、アイテムの値が100に達するまでの時間
timeleft(/host/key,1h,200,"polynomial2") # 過去1時間分のデータに基づき、アイテムが2次多項式のように振舞うと仮定して、アイテムの値が200に達するまでの時間サポートされているすべての関数を参照してください。