8 予測関数
ここに記載されているすべての関数は、以下でサポートされています。
関数は追加情報なしで一覧表示されています。詳細については、関数をクリックしてください。
共通パラメータ
/host/keyは、ホストのアイテム履歴を参照する関数に共通する必須の第1パラメータです(sec|#num)<:time shift>は、ホストのアイテム履歴を参照する関数に共通する第2パラメータで、以下を意味します:
関数の詳細
関数のパラメータに関する一般的な注意事項:
- 関数のパラメータはカンマで区切ります。
- オプションの関数パラメータ（またはパラメータ部分）は、
<>で示されます。 - 関数固有のパラメータは、各関数で説明されています。
/host/keyおよび(sec|#num)<:timeshift>パラメータは引用符で囲んではなりません。
forecast(/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>)
アイテムの将来の値、最大値、最小値、差分、または平均値を返します。
サポートされる値のタイプ: Float、Integer。
パラメータ:
- 共通パラメータを参照してください。
- time - 予測期間を秒単位で指定します（例:
1、60）。時間のサフィックスも使用できます（例:30s、1m）。負の値も指定できます。 - 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に達するまでの時間サポートされているすべての関数を参照してください。