8 予測関数
ここに一覧表示されているすべての関数は、以下でサポートされています。
関数は追加情報なしで一覧表示されています。関数をクリックすると、詳細を確認できます。
共通パラメータ
/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に達するまでの時間サポートされているすべての関数を参照してください。