予測関数
ここに一覧表示されているすべての関数は、以下でサポートされています。
関数は追加情報なしで一覧表示されています。関数をクリックすると、詳細を確認できます。
共通パラメータ
/host/keyは、ホストのアイテム履歴を参照する関数に共通する必須の第1パラメータです(sec|#num)<:time shift>は、ホストのアイテム履歴を参照する関数に共通する第2パラメータです。ここで:
関数の詳細
関数パラメータに関する一般的な注意事項:
- 関数パラメータはカンマで区切ります
- オプションの関数パラメータ（またはパラメータの一部）は
<>で示します - 関数固有のパラメータは各関数で説明します
/host/keyおよび(sec|#num)<:time shift>パラメータは決して引用符で囲まないでください
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)<:time shift>,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に達するまでの時間サポートされているすべての関数を参照してください。