トリガーの設定
このページでは、Zabbix Webインターフェースでトリガーを設定する方法について説明します。
公式の Zabbix テンプレートには、あらかじめ定義されたトリガーが含まれていることに注意してください。
Linux の監視 にテンプレートを適用する手順については、ガイドを参照してください。
設定済みのトリガーを 一括更新 することもできます。
その他のリソース:
- トリガーによる障害検出（概要）
- トリガーの例（ユースケース別）
- トリガーの式と関数（構文の詳細）
- ベストプラクティス
設定
トリガーを設定するには、次の手順を実行します。
- データ収集 > ホスト に移動します。
- ホストの行にある トリガー をクリックします。
- 右側の トリガーの作成 をクリックします（既存のトリガーを編集する場合は、トリガー名をクリックします）。
- フォームにトリガーのパラメータを入力します。
トリガー タブには、トリガーの基本的な属性がすべて含まれています。
必須入力フィールドには、赤いアスタリスクが付いています。
| パラメータ | 説明 |
|---|---|
| 名前 | トリガー名。 サポートされる マクロ は、{HOST.HOST}、{HOST.NAME}、{HOST.PORT}、{HOST.CONN}、{HOST.DNS}、{HOST.IP}、{ITEM.VALUE}、{ITEM.VALUE.AGE}、{ITEM.VALUE.DATE}、{ITEM.VALUE.TIME}、{ITEM.VALUE.TIMESTAMP}、{ITEM.LASTVALUE}、{ITEM.LASTVALUE.AGE}、{ITEM.LASTVALUE.DATE}、{ITEM.LASTVALUE.TIME}、{ITEM.LASTVALUE.TIMESTAMP}、{ITEM.LOG.*}、および {$MACRO} ユーザーマクロです。 $1、$2...$9 マクロを使用して、式の1番目、2番目...9番目の定数を参照できます。 注: $1-$9 マクロは、比較的単純で分かりやすい式内の定数を参照する場合に正しく展開されます。たとえば、式が last(/New host/system.cpu.load[percpu,avg1])>5 の場合、名前「New host の Processor load above $1」は自動的に「New host の Processor load above 5」に変わります。 |
| イベント名 | 定義すると、この名前が障害イベント名の作成に使用されます。デフォルトでは、イベント名はトリガー名と同じです。 イベント名を使用して、障害データを含む意味のあるアラートを作成できます（例を参照）。 トリガー名と同じマクロに加えて、{TIME}、{TIMESTAMP}、および {?EXPRESSION} 式マクロがサポートされます。 |
| 運用データ | 監視 > 障害 に動的なリアルタイムデータを表示するため、マクロを含む文字列（最大2048文字）を入力します。または、このフィールドを空のままにすると、トリガーの式に含まれるすべてのアイテムの最新の値が表示されます。 トリガー名と同じマクロがサポートされ、動的に展開できます。例: {ITEM.VALUE<1-9>} は、トリガーの状態が変更された時点（障害の作成、解決、手動クローズ、または相関によるクローズ）のアイテム値に展開されます。 {ITEM.LASTVALUE<1-9>} は、アイテムの最新の値に展開されます。 障害を手動でクローズしても新しい値は生成されないため、どちらのマクロも障害発生時の値を表示することに注意してください。また、最新の値が 履歴表示の最大期間 より古い場合、どちらのマクロも UNKNOWN に展開されます（［管理 > 一般］(/manual/web_interface/frontend_sections/administration/general#gui) を参照）。jsonpath マクロ関数はWebインターフェースではサポートされないため、監視 > 障害 では UNKNOWN に展開されます。このマクロ関数は、たとえば通知で {EVENT.OPDATA} が使用された場合など、Zabbixサーバーによってのみ展開されます。 |
| 深刻度 | ボタンをクリックして、必要なトリガーの 深刻度 を設定します。 |
| 式 | 障害の条件を定義する論理 式。 時間のサフィックス と メモリサイズのサフィックス がサポートされます。 式に含まれるすべての条件が満たされ、式が TRUE と評価されると、障害が作成されます。復旧条件式 に追加の復旧条件が指定されていない限り、式が FALSE と評価されるとすぐに障害は解決されます。 |
| OKイベントの生成 | OKイベントの生成オプション: 式 - 障害イベントと同じ式に基づいてOKイベントを生成します。 復旧条件式 - 障害の式が FALSE、かつ復旧条件式が TRUE と評価された場合にOKイベントを生成します。 なし - この場合、トリガーは自動的にOK状態に戻りません。 |
| 復旧条件式 | 元の障害の式がすでに FALSE と評価された後、障害が解決される前に満たす必要がある追加条件を定義する論理 式（任意）。 復旧条件式は、トリガーの ヒステリシス に役立ちます。障害の式が TRUE のままの場合、復旧条件式だけで障害を解決することはできません。 このフィールドは、OKイベントの生成 で「復旧条件式」が選択されている場合のみ使用できます。 |
| PROBLEMイベント生成モード | 障害イベントを生成するモード: 単一 - トリガーが初めて「障害」状態になったときに、1つのイベントを生成します。 複数 - トリガーが「障害」と評価されるたびにイベントを生成します。 |
| OKイベントのクローズ対象 | OKイベントでクローズする対象を選択します: すべての障害 - このトリガーのすべての障害。 タグの値が一致する場合はすべての障害 - イベントタグの値が一致する、このトリガーの障害のみ。 |
| 照合用タグ | イベント相関に使用するイベントタグ名を入力します。 このフィールドは、OKイベントのクローズ対象 で「タグの値が一致する場合はすべての障害」が選択されている場合に表示され、その場合は必須です。 |
| 手動クローズを許可 | このトリガーによって生成された障害イベントの 手動クローズ を許可する場合にチェックします。障害イベントを確認するときに手動でクローズできます。 |
| メニューエントリ名 | 空でない場合、ここに入力した名前（最大64文字）が、複数のWebインターフェースの場所で、メニューエントリURL パラメータに指定されたトリガーURLのラベルとして使用されます。空の場合、デフォルト名の トリガーURL が使用されます。 トリガー名と同じマクロに加えて、{EVENT.ID}、{HOST.ID}、{TRIGGER.ID} がサポートされます。 |
| メニューエントリURL | 空でない場合、ここに入力したURL（最大2048文字）は、複数のWebインターフェースの場所にある イベントメニュー のリンクとして使用できます。たとえば、監視 > 障害 で障害名をクリックした場合や、［障害］ ダッシュボードウィジェットをクリックした場合です。 トリガー名と同じマクロに加えて、{EVENT.ID}、{HOST.ID}、{TRIGGER.ID} がサポートされます。注: 秘密の値を持つユーザーマクロはURL内で展開されません。 |
| 説明 | このトリガーに関する追加情報を入力するテキストフィールド。特定の障害を修正する手順や、担当者の連絡先などを入力できます。 トリガー名と同じマクロがサポートされます。 |
| 有効 | 必要に応じて、このチェックボックスのチェックを外すとトリガーが無効になります。 無効なトリガーの障害はWebインターフェースに表示されなくなりますが、削除はされません。 |
タグ タブでは、トリガーレベルの タグ を定義できます。
このトリガーのすべての障害には、ここで入力した値のタグが付けられます。
さらに、継承されたタグとトリガータグ オプションを使用すると、トリガーがテンプレートに由来する場合に、テンプレートレベルで定義されたタグを表示できます。 同じタグを持つテンプレートが複数ある場合、これらのタグは1回だけ表示され、テンプレート名はコンマで区切られます。 トリガーはホストレベルのタグを「継承」して表示することはありません。
| パラメータ | 説明 |
|---|---|
| 名前/値 | トリガーイベントを識別するカスタムタグを設定します。 タグは、タグ名と値の組み合わせです。名前だけを使用することも、値と組み合わせることもできます。トリガーには、同じ名前で異なる値を持つ複数のタグを設定できます。 ユーザーマクロ、コンテキスト付きユーザーマクロ、ローレベルディスカバリマクロ、および {{ITEM.VALUE}}、{{ITEM.LASTVALUE}} を使用するマクロ 関数 がイベントタグでサポートされます。ローレベルディスカバリマクロは、マクロコンテキスト内で使用できます。{TRIGGER.ID} マクロはトリガータグの値でサポートされます。トリガープロトタイプから作成されたトリガーを識別したり、たとえばメンテナンス中にこれらのトリガーによる障害を抑制したりする場合に役立ちます。 展開後の値の合計長が255文字を超える場合、255文字に切り詰められます。 イベントタグでサポートされるすべての マクロ を参照してください。 イベントタグ は、イベント相関やアクションの条件で使用でき、監視 > 障害 または 障害 ウィジェットにも表示されます。 |
依存関係 タブには、トリガーのすべての 依存関係 が含まれています。
新しい依存関係を追加するには、追加 をクリックします。
既存のトリガーを開き、複製 ボタンをクリックしてから、別の名前で保存することでもトリガーを設定できます。
トリガー式のテスト
受信した値に応じて、式の結果がどうなるかをテストできます。
公式テンプレートの次の式を例として使用します。
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
or
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}式をテストするには、式フィールドの下にある Expression constructor をクリックします。
Expression constructor には、個々の式がすべて一覧表示されます。
テストウィンドウを開くには、式一覧の下にある Test をクリックします。
テストウィンドウでは、サンプル値（この例では '80'、'70'、'0'、'1'）を入力し、Test ボタンをクリックすることで式の結果を確認できます。
個々の式の結果と、式全体の結果の両方を確認できます。
"TRUE" は、指定した式が正しいことを意味します。
このケース A では、"80" は指定値 {$TEMP_WARN} より大きく、この例では "70" です。
予想どおり、"TRUE" の結果が表示されます。
"FALSE" は、指定した式が正しくないことを意味します。
このケース B では、{$TEMP_WARN_STATUS} の "1" は、指定値であるこの例の "0" と等しくなければなりません。
予想どおり、"FALSE" の結果が表示されます。
選択されている式の種類は "OR" です。
指定された条件の少なくとも 1 つ（この場合は A または B）が TRUE であれば、全体の結果も TRUE になります。
つまり、現在の値が警告値を超えており、障害が発生していることを意味します。