トリガーを設定する前に、問題状態とは何か、また対応を取るためにどれだけの時間が必要かを定義する必要があります。次に、望ましくない状況が発生する可能性を通知するトリガーを設定する方法は2つあります。1つ目は、「対応までの時間」が経過した時点でシステムが問題状態にあると予想される場合に、トリガーが発生するようにする方法です。2つ目は、システムが「対応までの時間」未満で問題状態に到達すると予想される場合に、トリガーが発生するようにする方法です。対応するトリガー関数は forecast と timeleft です。なお、両方の関数で使用される基礎となる統計分析は基本的に同一です。ほぼ同様の結果が得られるため、好みに応じてどちらの方法でもトリガーを設定できます。

パラメータ

両方の関数は、ほぼ同じパラメータセットを使用します。参照用として、サポートされている関数の一覧を使用してください。

時間間隔

まず最初に、予測を行うために Zabbix が分析すべき履歴期間を指定する必要があります。これは、time period パラメータと任意のタイムシフトを使用して、avg、count、delta、max、min、sum 関数と同様の使い慣れた方法で行います。

予測期間

（forecast のみ）
パラメータ time は、履歴データ内で見つかった依存関係を Zabbix が将来のどこまで外挿するかを指定します。time_shift を使用するかどうかにかかわらず、time は常に現在の時点から数えられます。

到達すべきしきい値

(timeleft のみ)
パラメータ threshold は、解析対象のアイテムが到達しなければならない値を指定します。
上側から到達するか下側から到達するかは問いません。f(t) （以下を参照）が求められたら、方程式 f(t) = threshold を解き、現在に最も近く、かつ現在より右側にある根を返す必要があります。そのような根が存在しない場合は、1.7976931348623158E+308 を返します。

アイテムの値がしきい値に近づいた後にそれを横切る場合、 timeleft はその交点がすでに過去にあるとみなし、存在する場合は threshold レベルとの次の交点に切り替えます。ベストプラクティスとしては、予測は通常の障害診断の代替ではなく、補完として使用することが推奨されます。¹

フィット関数

デフォルトのfitはlinear関数です。ただし、監視対象のシステムがより複雑な場合は、選択できるオプションがさらにあります。

`fit`	x = f(t)
linear	x = a + b*t
polynomialN²	x = a~0~ + a~1~t + a~2~t² + ... + a~n~*tⁿ
exponential	x = aexp(bt)
logarithmic	x = a + b*log(t)
power	x = a*t^b

モード

（forecast のみ）
トリガー関数が評価されるたびに、指定された履歴期間のデータを取得し、そのデータに指定された関数を当てはめます。したがって、データがわずかに異なれば、当てはめられる関数もわずかに異なります。単純に、将来の指定時点における当てはめ関数の値を計算するだけでは、現在からその将来時点までの間に、分析対象のアイテムがどのように振る舞うと予想されるかは分かりません。fit の一部のオプション（polynomial など）では、将来の単純な値は誤解を招く可能性があります。

`mode`	forecast の結果
value	f(now + `time`)
max	max~now\ <=\ t\ <=\ now\ +\ `time`~ f(t)
min	min~now\ <=\ t\ <=\ now\ +\ `time`~ f(t)
delta	max - min
avg	定義に従った f(t) の平均値（now <= t <= now + `time`）

詳細

非常に大きな数での計算を避けるため、指定期間内の最初の値のタイムスタンプに 1 ns を加えたものを、新しいゼロ時刻として扱います（現在のエポック時刻は 10⁹ のオーダー、エポック時刻の二乗は 10¹⁸、倍精度は約 10^-16 です）。1 ns を加えるのは、log(t) の計算を含む対数近似および べき乗 近似において、すべての時刻の値を正にするためです。時刻のシフトは、線形、多項式、指数近似には影響しません（計算がより容易かつ高精度になる点を除く）が、対数関数および べき乗 関数の形状は変化します。

起こり得るエラー

このような場合、関数は -1 を返します。

指定された評価期間にデータが存在しない場合。
数学演算の結果が定義されていない場合³。
数値計算上の問題が発生した場合（残念ながら、入力データの一部の組み合わせでは、倍精度浮動小数点形式の範囲と精度が不十分になることがあります）⁴。

選択した近似が提供されたデータを十分に表していない場合や、正確な予測を行うにはデータが少なすぎる場合でも、警告やエラーは示されません。

例とエラーへの対処

ホストの空きディスク容量が不足しそうなときに警告を受け取るには、次のようなトリガー式を使用できます:

timeleft(/host/vfs.fs.size[/,free],1h,0)<1h

ただし、エラーコード -1 が影響し、トリガーが障害状態になる場合があります。一般的には、これは予測が正しく機能しておらず、その原因を調べるためにより詳しく確認すべきであるという警告を受け取れるため、望ましい動作です。しかし、場合によっては望ましくありません。というのも、-1 は単に直近1時間にホストの空きディスク容量に関するデータが取得されなかったことを意味するだけの場合があるためです。誤検知のアラートが多すぎる場合は、より複雑なトリガー式の使用を検討してください ⁵:

timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1

forecast の場合は、状況が少し複雑になります。まず、 forecast(/host/item,(...))<... のような式か、 forecast(/host/item,(...))>... のような式かによって、 -1 がトリガーを障害状態にする場合としない場合があります。

さらに、アイテムの値が負になることが通常である場合、-1 は有効な予測値である可能性があります。しかし、実際の環境でそのような状況が発生する可能性はごくわずかです（演算子 = の動作についてはこちらを参照してください）。したがって、-1 を障害として扱いたい場合は ... or forecast(/host/item,(...))=-1 を、障害として扱いたくない場合は ... and forecast(/host/item,(...))<>-1 を追加してください。

脚注

¹ たとえば、単純なトリガー timeleft(/host/item,1h,X) < 1h は、アイテムの値が X に近づいたときに障害状態になり、その後 X に達すると突然復旧する場合があります。問題がアイテムの値が X 未満であることであれば、次を使用してください: last(/host/item) < X or timeleft(/host/item,1h,X) < 1h 問題がアイテムの値が X を超えることであれば、次を使用してください: last(/host/item) > X or timeleft(/host/item,1h,X) < 1h

² 多項式の次数は 1 から 6 まで指定でき、polynomial1 は linear と同等です。ただし、高次の多項式は注意して使用してください。評価期間に多項式係数を決定するのに必要な点数より少ないデータ点しか含まれていない場合、多項式の次数は引き下げられます（たとえば polynomial5 が要求されても、点が 4 つしかない場合は polynomial3 が当てはめられます）。

³ たとえば、exponential または power 関数の当てはめでは、アイテム値の log() を計算します。データに 0 または負の数が含まれている場合、log() は正の値に対してのみ定義されているため、エラーになります。

⁴ linear、exponential、logarithmic、power の当てはめでは、必要な計算はすべて明示的に記述できます。polynomial では、追加の手順なしで計算できるのは value のみです。avg の計算では、多項式の原始関数を（解析的に）計算する必要があります。max、min、delta の計算では、多項式の導関数を（解析的に）計算し、その根を（数値的に）求める必要があります。f(t) = 0 を解くには、多項式の根を（数値的に）求める必要があります。

⁵ ただし、この場合は -1 によってトリガーが障害状態から復旧してしまう可能性があります。完全に防ぐには、次を使用してください: timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and ({TRIGGER.VALUE}=0 and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 or {TRIGGER.VALUE}=1)

What’s next?

4 イベント

Docs

7 予測トリガー関数

概要

関数