1 トリガーの設定
概要
トリガーを設定するには、次の手順を実行します。
- データ収集 > ホスト に移動します
- ホストの行にある トリガー をクリックします
- 右側の トリガーの作成 をクリックします（既存のトリガーを編集する場合は、トリガー名をクリックします）
- フォームにトリガーのパラメータを入力します
トリガーおよびその計算時間の詳細については、一般情報も参照してください。
設定
トリガータブには、トリガーの主要な属性がすべて含まれています。
必須の入力フィールドには、赤いアスタリスクが付いています。
| Parameter | Description |
|---|---|
| Name | トリガー名。 サポートされているマクロは次のとおりです: {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 マクロは、比較的単純で明快な式内の定数を参照している場合に正しく展開されます。例えば、名前が "Processor load above $1 on {HOST.NAME}" の場合、式が last(/New host/system.cpu.load[percpu,avg1])>5 であれば、自動的に "Processor load above 5 on New host" に変わります。 |
| Event name | 定義されている場合、この名前が障害イベント名の作成に使用されます。デフォルトでは、イベント名はトリガー名と同じです。 イベント名は、障害データを含む意味のあるアラートを作成するために使用できます（例を参照）。 トリガー名と同じマクロセットに加えて、{TIME}、{TIMESTAMP}、および {?EXPRESSION} 式マクロがサポートされています。 |
| Operational data | 運用データでは、マクロとともに任意の文字列を定義できます。マクロは、Monitoring > Problems でリアルタイムデータに動的に展開されます。一方、トリガー名内のマクロ（上記参照）は障害発生時点の値に展開され、静的な障害名の基礎となりますが、運用データ内のマクロは最新情報を動的に表示する機能を維持します。トリガーレベルで運用データが設定されていない場合、式に含まれるすべてのアイテムの最新値が表示されます。 トリガー名と同じマクロセットがサポートされています。 |
| Severity | ボタンをクリックして、必要なトリガーの深刻度を設定します。 |
| Expression | 障害の条件を定義するために使用される論理式。 時間サフィックスおよびメモリサイズサフィックスがサポートされています。 式に含まれるすべての条件が満たされると、つまり式が TRUE と評価されると障害が作成されます。Recovery expression で追加の復旧条件が指定されていない限り、式が FALSE と評価されるとすぐに障害は解決されます。 |
| OK event generation | OKイベント生成オプション: Expression - 障害イベントと同じ式に基づいてOKイベントが生成されます。 Recovery expression - 障害式が FALSE と評価され、かつ復旧式が TRUE と評価された場合にOKイベントが生成されます。 None - この場合、トリガーが自動的にOK状態に戻ることはありません。 |
| Recovery expression | 元の障害式がすでに FALSE と評価された後に、障害が解決される前に満たす必要がある追加条件を定義する論理式（任意）。 復旧式は、トリガーのヒステリシスに役立ちます。障害式がまだ TRUE の場合、復旧式だけで障害を解決することはできません。 このフィールドは、OK event generation で 'Recovery expression' が選択されている場合にのみ使用できます。 |
| PROBLEM event generation mode | 障害イベントを生成するモード: Single - トリガーが初めて 'Problem' 状態になったときに単一のイベントが生成されます。 Multiple - トリガーが 'Problem' と評価されるたびにイベントが生成されます。 |
| OK event closes | OKイベントがクローズする対象を選択します: All problems - このトリガーのすべての障害。 All problems if tag values match - イベントタグ値が一致するトリガー障害のみ。 |
| Tag for matching | イベント相関に使用するイベントタグ名を入力します。 このフィールドは、OK event closes プロパティで 'All problems if tag values match' が選択されている場合に表示され、この場合は必須です。 |
| Allow manual close | このトリガーによって生成された障害イベントの手動クローズを許可するにはチェックします。手動クローズは、障害イベントを確認応答する際に可能です。 |
| Menu entry name | 空でない場合、ここで入力した名前（最大64文字）が、Menu entry URL パラメータで指定されたトリガーURLのラベルとして、複数のWebインターフェース上の場所で使用されます。空の場合、デフォルト名 Trigger URL が使用されます。 トリガー名と同じマクロセットに加えて、{EVENT.ID}、{HOST.ID}、および {TRIGGER.ID} がサポートされています。 |
| Menu entry URL | 空でない場合、ここで入力したURL（最大2048文字）は、複数のWebインターフェース上の場所にあるevent menuでリンクとして利用できます。例えば、Monitoring > Problems または Problems ダッシュボードウィジェットで障害名をクリックしたときです。 トリガー名と同じマクロセットに加えて、{EVENT.ID}、{HOST.ID}、および {TRIGGER.ID} がサポートされています。注: secret値を持つユーザーマクロはURL内では展開されません。 |
| Description | このトリガーに関する追加情報を提供するためのテキストフィールドです。特定の障害を修正するための手順、担当スタッフの連絡先詳細などを含めることができます。 トリガー名と同じマクロセットがサポートされています。 |
| Enabled | 必要に応じて、このボックスのチェックを外すことでトリガーを無効にできます。 無効化されたトリガーの障害はWebインターフェースに表示されなくなりますが、削除はされません。 |
Tags タブでは、トリガーレベルの タグを定義できます。このトリガーのすべての障害には、 ここで入力した値のタグが付けられます。
さらに、トリガーがそのテンプレートに由来する場合、Inherited and trigger tags オプションを使用してテンプレートレベルで定義されたタグを表示できます。 同じタグを持つテンプレートが複数ある場合、これらのタグは1回だけ表示され、テンプレート名はカンマで区切られます。 トリガーはホストレベルのタグを「継承」して表示することはありません。
| Parameter | Description |
|---|---|
| Name/Value | トリガーイベントを識別するためのカスタムタグを設定します。 タグは、タグ名と値のペアです。名前のみを使用することも、値と組み合わせることもできます。トリガーは同じ名前で異なる値を持つ複数のタグを持つことができます。 ユーザーマクロ、コンテキスト付きユーザーマクロ、ローレベルディスカバリマクロ、および {{ITEM.VALUE}}、{{ITEM.LASTVALUE}} を使用したマクロ関数がイベントタグでサポートされています。ローレベルディスカバリマクロはマクロコンテキスト内で使用できます。{TRIGGER.ID} マクロはトリガータグ値でサポートされています。これは、トリガープロトタイプから作成されたトリガーを識別したり、例えばメンテナンス中にこれらのトリガーからの障害を抑制したりするのに役立つ場合があります。 展開後の値の合計長が255を超える場合、255文字に切り詰められます。 イベントタグでサポートされるすべてのマクロを参照してください。 イベントタグは、イベント相関やアクション条件で使用でき、Monitoring > Problems または Problems ウィジェットでも確認できます。 |
Dependencies タブには、トリガーのすべての依存関係 が含まれています。
新しい依存関係を追加するには、Add をクリックします。
既存のトリガーを開き、 Clone ボタンを押してから別の 名前で保存することでも、トリガーを設定できます。
評価式のテスト
設定したtrigger 式が、受け取った値によってどのような式結果になるかをテストすることが可能である。
例として、公式テンプレートにある以下の式を挙げる。
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
または
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}式をテストするには、式フィールドの下にあるExpression constructorをクリックします。
Expressionコンストラクタでは、個々の式がすべてリストアップされます。テスト・ウィンドウを開くには、
式リストの下にある Test をクリックします。
テスト画面では、サンプル値（この例では '80' , '70' , '0' , '1'）を入力し、Testボタンをクリックすると、 式の結果を確認することができます。
個々の表現だけでなく、全体の表現の結果も見ることができます。
"TRUE "は、指定された式が正しいことを意味する。このケースAでは、"80" は{$TEMP_WARN}の指定値(この例では "70"です)より大きい。
予想通り、"TRUE "の結果が表示される。
"FALSE "は、指定された式が正しくないことを意味します。この場合この特定のケースBでは、
{$TEMP_WARN_STATUS}の "1 "が "1 "と等しい必要がある。"1" は、指定された値、この例では "0 "と等しくなければならない。
予想通り、"FALSE"の結果が表示される。
式のタイプは "OR "である。指定された条件のうち少なくとも1つ（この例ではAまたはB）が
指定された条件（この例ではAまたはB）の少なくとも1つが "TRUE" であれば、全体の結果も"TRUE"となります。
つまり、現在値が警告値を超えており、問題が発生していることを意味します。