2 トリガー条件式

概要

トリガーで使用される式は非常に柔軟です。 これらを使用して、監視している統計情報に関する複雑な論理テストを作成できます。

単純な式では、いくつかのパラメータを持つ関数がアイテムに適用されます。 関数は、演算子と定数を使用してしきい値と比較される結果を返します。

単純で有用な式の構文は、function(/host/key,parameter)<operator><constant>です。

例:

min(/Zabbix server/net.if.in[eth0,bytes],5m)>100K

これは、過去5分間に受信したバイト数が常に100キロバイトを超えていた場合にトリガーされます。

構文はまったく同じですが、機能的な観点からは、トリガー式には2つのタイプがあります:

• 問題式 - 問題の条件を定義します
• 復旧式 (オプション) - 問題解決の追加条件を定義します

問題式のみを定義する場合、この式は問題のしきい値と問題の復旧しきい値の両方として使用されます。 問題式がTRUEと評価されると、問題が発生します。 問題式がFALSEと評価されると、問題は解決されます。

問題式と補足的な復旧式の両方を定義する場合、問題の解決はより複雑になります: 問題式がFALSEであるだけでなく、復旧式もTRUEでなければなりません。 これはヒステリシスを作成し、トリガーのフラッピングを回避するのに役立ちます。

関数

関数を使用すると、収集した値の計算（平均、最小、最大、合計）、文字列の検索、現在時刻やその他の要素の参照が可能です。

サポートされている関数の完全なリストが利用可能です。

通常、関数は比較のために数値を返します。 文字列を返す場合は、= および <> 演算子で比較が可能です（例を参照）。

関数パラメータ

関数パラメータでは、以下を指定できます。

• ホストとアイテムキー（ホストアイテムの履歴のみを参照する関数の場合）
• 関数固有のパラメータ
• 他の式（ホストアイテムの履歴を参照する関数では利用できません。例については他の式を参照してください）

ホストとアイテムキーは /host/key の形式で指定できます。
最初のパラメータでホスト名を省略する（つまり function(//key,parameter,...) のように記述する）ことは、特定のコンテキストでのみサポートされています。

• 計算アイテムの計算式内
• 式マクロ内（以下で使用可能）:
  • イベント名フィールド
  • グラフ名
  • "ホスト"および"トリガー"のマップ要素のラベル

これらのコンテキストでは、{HOST.HOST}マクロも使用できます。
イベント名フィールドや"トリガー"マップ要素の場合、トリガー式内の特定のアイテムを参照するために{HOST.HOST<1-9>}を使用できます。
これらのコンテキストでホスト名を省略したり、{HOST.HOST}に置き換えたりした場合、参照はトリガー式内の最初のアイテムまたはグラフの最初のアイテムを指します。
これらのサポートされているコンテキスト以外でトリガー式内のホスト名を省略すると、エラーとなります。
イベント名マクロでのダブルスラッシュの使用例については、例18を参照してください。

参照されるアイテムは、サポートされている状態でなければなりません（nodata()関数のみ、サポートされていないアイテムにも計算されます）。

他のトリガー式を関数パラメータとして使用する場合、トリガー内では履歴関数以外に制限されますが、この制限は計算アイテムには適用されません。

Item key

The referenced item must be in a supported state (except for nodata() function, which is calculated for unsupported items as well).

Omission of the host name in the first parameter (i.e. as in function(//key,parameter,...)) is only supported in certain contexts:

• In the formula of calculated items
• In expression macros, which can be used in:
  • The Event name field
  • Graph name
  • The label of "Host" and "Trigger" map elements

In these contexts, you may also use the {HOST.HOST} macro. {HOST.HOST<1-9>} could be used in the case of the Event name field and the "Trigger" map element to refer to a specific item in the trigger expression. When the host name is omitted or replaced by {HOST.HOST} in these contexts, the reference points to the first item in the trigger expression or to the first item in the graph. Outside of these supported contexts, omitting the host name in trigger expressions will result in an error. See Compare long-term CPU loads example for an illustration of double-slash usage in Event name macros.

関数固有のパラメータ

関数固有のパラメータはアイテムキーの後に配置され、アイテムキーとはカンマで区切られます。 これらのパラメータの完全なリストについては、サポートされている関数を参照してください。

ほとんどの数値関数は、パラメータとして時間を受け取ります。 秒または時間のサフィックスを使用して時間を指定できます。 ハッシュマーク（#）を前に付けると、パラメータの意味が異なります。

ハッシュマーク付きのパラメータは、last関数では意味が異なり、N番目に前の値を示します。たとえば、値が30, 70, 20, 60, 50（最新から最も古い順）であれば:

• last(/host/key,#2) は '70' を返します
• last(/host/key,#5) は '50' を返します

時間シフト

関数パラメータとして時間または値のカウントを指定する場合、オプションで時間シフトがサポートされています。 このパラメータを使用すると、過去のある期間のデータを参照できます。

時間シフトは now で始まり（現在時刻を指定）、+N<時間単位> または -N<時間単位> を続けてN単位の時間を加算または減算します。

例えば、avg(/host/key,1h:now-1d) は、1日前の1時間の平均値を返します。

絶対時間期間での時間シフト

絶対時間期間は、時間シフトパラメータでサポートされています。例えば、1日の場合は0時から0時、1週間の場合は月曜日から日曜日、1ヶ月の場合は月初から月末までです。

絶対時間期間での時間シフトは now で始まり（現在時刻を指定）、任意の数の時間操作を続けます。/<時間単位> は時間単位の開始と終了を定義します（例：1日の場合は0時から0時）、+N<時間単位> または -N<時間単位> はN単位の時間を加算または減算します。

時間シフトの値は0以上である必要があり、時間期間の最小値は1であることに注意してください。

その他の式

関数のパラメータには、次の構文のように他の式を含めることができます。

min(min(/host/key,1h),min(/host2/key2,1h)*10)

関数がアイテムの履歴を参照する場合、他の式は使用できないことに注意してください。 たとえば、次の構文は許可されていません。

min(/host/key,#5*10)

演算子

トリガーでサポートされている演算子は次のとおりです (実行の優先順位が高い順):

¹ 文字列オペランドは、以下の場合でも数値にキャストされます:

• 他のオペランドが数値の場合
• = または <> 以外の演算子がオペランドに使用されている場合

(キャストに失敗した場合 - 数値オペランドは文字列オペランドにキャストされ、両方のオペランドが文字列として比較されます。)

not、and、or 演算子は大文字と小文字を区別し、小文字でなければなりません。 また、スペースまたは括弧で囲む必要があります。

単項 - および not を除くすべての演算子は、左から右への結合性を持ちます。 単項 - および not は非結合性です（つまり、--1 や not not 1 の代わりに -(-1) や not (not 1) を使用する必要があります）。

評価結果:

• <、<=、>、>=、=、<> 演算子は、指定された関係が真であればトリガー式で '1' を、偽であれば '0' を返します。 少なくとも1つのオペランドがUnknownの場合、結果はUnknownになります。
• and は既知のオペランドの場合、両方のオペランドが '0' と等しくない場合は '1' を返し、それ以外の場合は '0' を返します。不明なオペランドの場合、and は1つのオペランドが '0' と等しい場合のみ '0' を返し、それ以外の場合は 'Unknown' を返します。
• or は既知のオペランドの場合、いずれかのオペランドが '0' と等しくない場合は '1' を返し、それ以外の場合は '0' を返します。不明なオペランドの場合、or は1つのオペランドが '0' と等しくない場合のみ '1' を返し、それ以外の場合は 'Unknown' を返します。
• 論理否定演算子 not の既知のオペランドに対する結果は、オペランドの値が '0' と等しくない場合は '0'、オペランドの値が '0' と等しい場合は '1' です。 不明なオペランドの場合、not は 'Unknown' を返します。

Unknown expression state

It is possible that an unknown operand appears in a trigger expression when:

• unsupported item is used
• function evaluation, for a supported item, results in error

In this case the trigger expression generally evaluates to Unknown (as it cannot be evaluated)

It is possible to get notified on unknown triggers.

Exceptions

Despite an unknown operand, trigger expressions can be evaluated to known result (Problem/OK) in some cases:

• The nodata() function is evaluated regardless of whether the referenced item is supported or not.
• Expressions with AND/OR can be evaluated to known result in two cases:
  • Case 1: "1 or some_function(unsupported_item1) or some_function(unsupported_item2) or ..." evaluates to known result ('1' or "Problem"),
  • Case 2: "0 and some_function(unsupported_item1) and some_function(unsupported_item2) and ..." evaluates to known result ('0' or "OK").
• If the function evaluation for a supported item results in error, the function value becomes Unknown and it takes part as unknown operand in further expression evaluation.

Unknown operands may "disappear" only in logical expressions as described above. In arithmetic expressions unknown operands always lead to Unknown (except division by 0).

If a trigger expression with several unsupported items evaluates to Unknown, the error message in the frontend refers to the last unsupported item evaluated.

値のキャッシュ

トリガーの評価に必要な値は、Zabbixサーバーによってキャッシュされます。 このため、サーバーの再起動後しばらくの間、トリガーの評価によってデータベースの負荷が高くなります。 アイテムの履歴値が削除された場合（手動またはハウスキーパーによる）、値のキャッシュはクリアされません。そのため、サーバーはトリガー関数で定義された期間より古い値になるか、サーバーが再起動されるまでキャッシュされた値を使用します。