1 トリガーの設定
概要
トリガーを設定するには、以下の手順を実行します。
- データ収集 > ホスト に移動します
- ホストの行でトリガーをクリックします
- 右側のトリガーの作成をクリックします（または既存のトリガーを編集する場合はトリガー名をクリックします）
- フォームにトリガーのパラメータを入力します
トリガーおよびその計算タイミングの一般情報も参照してください。
設定
トリガータブには、すべての基本的なトリガー属性が含まれています。
すべての必須入力フィールドには赤いアスタリスクが付いています。
| パラメータ | 説明 |
|---|---|
| 名前 | トリガー名。 サポートされているマクロは、{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マクロを使用して、式の最初、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」に変更されます。 |
| イベント名 | 定義されている場合、この名前がトリガー名の代わりに問題イベント名の作成に使用されます。 イベント名は、問題データを含む意味のあるアラートを作成するために使用できます（例を参照）。 トリガー名と同じマクロセットに加え、{TIME}、{TIMESTAMP}、{?EXPRESSION}式マクロがサポートされています。 |
| 運用データ | 運用データでは、マクロとともに任意の文字列を定義できます。マクロは監視 > 問題でリアルタイムデータに動的に解決されます。トリガー名のマクロ（上記参照）は、問題発生時の値に解決され、静的な問題名の基礎となりますが、運用データのマクロは、最新情報を動的に表示する機能を維持します。トリガーレベルで運用データが設定されていない場合、式内のすべてのアイテムの最新値が表示されます。 トリガー名と同じマクロセットがサポートされています。 |
| 深刻度 | ボタンをクリックして必要なトリガー深刻度を設定します。 |
| 式 | 問題の条件を定義するために使用される論理式。 時間サフィックスおよびメモリサイズサフィックスがサポートされています。 式に含まれるすべての条件が満たされた後、つまり式がTRUEと評価された場合に問題が作成されます。追加の復旧条件が復旧式で指定されていない限り、式がFALSEと評価されるとすぐに問題は解決されます。 |
| OKイベント生成 | OKイベント生成オプション： 式 - 問題イベントと同じ式に基づいてOKイベントが生成されます； 復旧式 - 問題式がFALSEと評価され、復旧式がTRUEと評価された場合にOKイベントが生成されます； なし - この場合、トリガーは自動的にOK状態に戻ることはありません。 |
| 復旧式 | 元の問題式がすでにFALSEと評価された後、問題が解決される前に満たす必要がある追加の条件を定義する論理式（オプション）。 復旧式は、トリガーのヒステリシスに便利です。問題式がまだTRUEの場合、復旧式だけで問題を解決することはできません。 このフィールドは、「OKイベント生成」で「復旧式」が選択されている場合にのみ利用できます。 |
| PROBLEMイベント生成モード | 問題イベントを生成するモード： 単一 - トリガーが初めて「問題」状態になったときに単一のイベントが生成されます； 複数 - トリガーのすべての「問題」評価時にイベントが生成されます。 |
| OKイベントでクローズ | OKイベントでクローズするかどうかを選択します： すべての問題 - このトリガーのすべての問題； タグ値が一致するすべての問題 - イベントタグ値が一致するトリガー問題のみ。 |
| 一致するタグ | イベントの相関に使用するイベントタグ名を入力します。 このフィールドは、「OKイベントでクローズ」プロパティで「タグ値が一致するすべての問題」が選択されている場合に表示され、この場合は必須です。 |
| 手動クローズを許可 | このトリガーによって生成された問題イベントの手動クローズを許可する場合はチェックします。手動クローズは、問題イベントの確認時に可能です。 |
| メニューエントリ名 | 空でない場合、ここに入力された名前（最大64文字）は、メニューエントリURLパラメータで指定されたトリガーURLのラベルとして、いくつかのフロントエンドの場所で使用されます。空の場合、デフォルト名Trigger URLが使用されます。 トリガー名と同じマクロセットに加え、{EVENT.ID}、{HOST.ID}、{TRIGGER.ID}がサポートされています。 |
| メニューエントリURL | 空でない場合、ここに入力されたURL（最大2048文字）は、イベントメニューのリンクとして、たとえば監視 > 問題や問題ダッシュボードウィジェットで問題名をクリックしたときなど、いくつかのフロントエンドの場所で利用できます。 トリガー名と同じマクロセットに加え、{EVENT.ID}、{HOST.ID}、{TRIGGER.ID}がサポートされています。注：シークレット値を持つユーザーマクロはURLで解決されません。 |
| 説明 | このトリガーに関する詳細情報を提供するためのテキストフィールド。特定の問題の修正手順、担当者の連絡先などを含めることができます。 トリガー名と同じマクロセットがサポートされています。 |
| 有効 | このボックスのチェックを外すと、必要に応じてトリガーが無効になります。 無効なトリガーの問題はフロントエンドに表示されなくなりますが、削除はされません。 |
タグタブでは、トリガーレベルのタグを定義できます。このトリガーのすべての問題は、ここで入力した値でタグ付けされます。
さらに、継承およびトリガータグオプションを使用すると、トリガーがそのテンプレートから来ている場合、テンプレートレベルで定義されたタグを表示できます。 同じタグを持つ複数のテンプレートがある場合、これらのタグは1回だけ表示され、テンプレート名はカンマで区切られます。 トリガーはホストレベルのタグを「継承」して表示することはありません。
| パラメータ | 説明 |
|---|---|
| 名前/値 | トリガーイベントをマークするためのカスタムタグを設定します。 タグはタグ名と値のペアです。名前だけを使用することも、値とペアにすることもできます。トリガーには同じ名前で異なる値の複数のタグを持たせることができます。 イベントタグでは、ユーザーマクロ、コンテキスト付きユーザーマクロ、ローレベルディスカバリーマクロ、および {{ITEM.VALUE}}、{{ITEM.LASTVALUE}}、ローレベルディスカバリーマクロを使用したマクロ関数がサポートされています。ローレベルディスカバリーマクロはマクロコンテキスト内で使用できます。{TRIGGER.ID}マクロはトリガータグ値でサポートされています。これは、トリガープロトタイプから作成されたトリガーを識別したり、たとえばメンテナンス中にこれらのトリガーからの問題を抑制したりするのに役立ちます。 展開された値の合計長が255を超える場合は、255文字に切り捨てられます。 イベントタグでサポートされているすべてのマクロを参照してください。 イベントタグは、イベントの相関、アクション条件に使用でき、監視 > 問題または問題ウィジェットでも表示されます。 |
依存関係タブには、トリガーのすべての依存関係が含まれています。
追加をクリックして新しい依存関係を追加します。
既存のトリガーを開いてクローンボタンを押し、別の名前で保存することで、トリガーを設定することもできます。
評価式のテスト
設定した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"となります。
つまり、現在値が警告値を超えており、問題が発生していることを意味します。