組み込みイベント マネージャについて

ここでは、デバイス上の重要なイベントを検出し、処理するように、EEM を設定する方法について説明します。

EEM の機能の履歴

Table 1 この機能のリリース履歴を示します。リリース 3.x 以降のリリースで導入または変更された機能のみが表に記載されています。

Table 1. EEM の機能の履歴

機能名

リリース

機能情報

組み込みイベント マネージャ(EEM)

8.1(1)

追加済み cli インターフェイスに割り当てるには、 action number コマンドを使用します。

ゾーン、FCNS、および FLOGI

6,211

この機能により、ユーザはデフォルトのゾーン、FCNS、および FLOGI システム ポリシーのカスタム制限を構成できます。

組み込みイベント マネージャ(EEM)

4.1(3)

Embedded Event Manager(EEM)の設定方法に関する新しい章が追加されました。

EEM について

Embedded Event Manager はデバイス上で発生するイベントをモニタし、設定に基づいて各イベントの回復またはトラブルシューティングのためのアクションを実行します。

EEM の概要

EEM は次の 3 種類の主要コンポーネントからなります。

  • イベント文:別の Cisco NX-OS コンポーネントからモニタし、アクション、回避策、または通知が必要になる可能性のあるイベント。
  • アクションステートメント:電子メールの送信やインターフェイスの無効化などの、イベントから回復するために EEM が実行できるアクション。
  • ポリシー:イベント文とアクションステートメントの組み合わせ。指定されたイベントが発生すると、構成されたアクションが実行されます。

ポリシー

EEM ポリシーは、イベント文および 1 つまたは複数のアクション文からなります。イベント文では、探すイベントとともに、イベントのフィルタリング特性を定義します。アクション文では、イベントの発生時に EEM が実行するアクションを定義します。

EEM ポリシー文 に、EEM ポリシーの基本的な 2 種類の文を示します。

Figure 1. EEM ポリシー文

EEM ポリシーを設定するには、CLI または VSH スクリプトを使用します。


Note


EEM ポリシー照合は、MDS スイッチ上ではサポートされません。

EEM はスーパーバイザ上でイベント ログを維持します。

Cisco NX-OS には、設定済みのさまざまなシステム ポリシーがあります。これらのシステム ポリシーでは、デバイスに関連する多数の一般的なイベントおよびアクションが定義されています。システム ポリシー名は、2 個の下線記号(__)から始まります。

次に、Cisco MDS 9000 シリーズ スイッチで使用できる事前構成済みのシステム ポリシーの一部を示します。

  • ゾーン

    • __zone_dbsize_max_per_vsan:ゾーン データベースのサイズが VSAN の最大制限である 4000000 バイトを超えた場合の Syslog 警告。

    • __zone_members_max_per_sw:ゾーン メンバー数がスイッチの最大制限である 32000 を超えた場合の Syslog 警告。

    • __zone_zones_max_per_sw:ゾーン数がスイッチの最大制限である 16000 を超えた場合の Syslog 警告。

    • __zone_zonesets_max_per_sw:ゾーンセット数がスイッチの最大制限である 1000 を超えた場合の Syslog 警告。

  • ファブリック ログイン(FLOGI)

    • __flogi_fcids_max_per_switch:スイッチ内の flogis の数が 2000 を超えた場合の Syslog 警告。

    • __flogi_fcids_max_per_module:モジュール内の flogis の数が 400 を超えた場合の Syslog 警告。

    • __flogi_fcids_max_per_intf:インターフェイスの flogis の数が 256 を超えた場合の Syslog 警告。


Note


上記の 3 つの FLOGI ポリシーはすべて上書き可能です。
  • ファイバ チャネル ネーム サーバー(FCNS)

    • __fcns_entries_max_per_switch:スイッチごとのすべての VSAN で検証されるネーム サーバ エントリの最大制限を構成します。

アクション:Syslog を表示します


Note


ユーザは、別のコンポーネントのポリシーのイベントを構成しないでください。

使用するネットワークに合わせてユーザ ポリシーを作成できます。ユーザ ポリシーで定義されたアクションは、システム ポリシーで定義されたアクションと共に実行されます。ユーザー ポリシーを設定する場合には、 CLI によるユーザー ポリシーの定義を参照してください。

一部のシステム ポリシーは上書きすることもできます。オーバーライド ポリシーは、システム ポリシーを置き換えます。イベントまたはアクションの上書きが可能です。

  show event manager system-policy コマンドを使用して、構成済みのシステム ポリシーを表示して、上書き可能なポリシーを判断します。

上書きポリシーを構成する場合は、 ポリシーの上書きを参照してください。


Note


  show running-config eem コマンドを使用して、各ポリシーの構成を確認してください。イベント文が指定されていて、アクション文が指定されていない上書きポリシーを設定した場合、アクションは開始されません。また、障害も通知されません。

Note


上書きポリシーには、必ずイベント文を指定します。上書きポリシーにイベント文が含まれていないと、システム ポリシーで可能性のあるイベントがすべて上書きされます。

イベント文

イベントは、回避、通知など、何らかのアクションが必要なデバイス アクティビティです。これらのイベントは通常、インターフェイスやファンの誤動作といったデバイスの障害に関連します。

EEM の概要 EEM ではイベント フィルタを定義して、クリティカル イベントまたは指定された時間内で繰り返し発生したイベントだけが関連付けられたアクションのトリガーになるようにします。

EEM が処理するイベントを示します。

Figure 2. EEM の概要

イベント文では、ポリシー実行のトリガーになるイベントを指定します。設定できるイベント文は、1 つのポリシーに 1 つだけです。

EEM はイベント文に基づいてポリシーをスケジューリングし、実行します。EEM はイベントおよびアクション コマンドを検証し、定義に従ってコマンドを実行します。

アクション文

アクション文では、ポリシーによって実行されるアクションを記述します。各ポリシーに複数のアクション文を設定できます。ポリシーにアクションを関連付けなかった場合、EEM はイベント観察を続けますが、アクションは実行されません。

EEM がアクション文でサポートするアクションは、次のとおりです。

  • CLI コマンドの実行。
  • カウンタのアップデート。
  • 例外の記録。
  • モジュールの強制的シャットダウン。
  • デバイスをリロードします。
  • 電力のバジェット超過による特定モジュールのシャットダウン。
  • Syslog メッセージの生成。
  • Call Home イベントの生成。
  • SNMP 通知の生成。
  • システム ポリシー用デフォルト アクションの使用。

Note


トリガーされたイベントでデフォルト アクションも処理されるようにする場合は、EEM アクションをポリシーのタイプに応じて event-default または policy-default で明示的に設定する必要があります。たとえば、一致文で CLI コマンドを照合する場合、EEM ポリシーに event-default アクション文を追加する必要があります。event-default アクション文が追加されないと、EEM では CLI コマンドを実行できません。

Note


ユーザ ポリシーまたは上書きポリシーの中に、相互に否定したり、関連付けられたシステム ポリシーに悪影響を与えたりするようなアクション文がないかどうかを確認してください。

VSH スクリプト ポリシー

テキスト エディタを使用し、VSH スクリプトでポリシーを作成することもできます。このようなポリシーにも、他のポリシーと同様、イベント文およびアクション文(複数可)を使用します。また、これらのポリシーでシステム ポリシーを補うことも上書きすることもできます。スクリプト ポリシーの作成後、そのポリシーをデバイスにコピーしてアクティブにします。スクリプト ポリシーを構成する場合は、 VSH スクリプトによるポリシーの定義を参照してください。

環境変数

すべてのポリシーに使用できる、EEM の環境変数を定義できます。環境変数は、複数のポリシーで使用できる共通の値を設定する場合に便利です。たとえば、外部電子メール サーバの IP アドレスに対応する環境変数を作成できます。

パラメータ置換フォーマットを使用することによって、アクション文で環境変数を使用できます。

アクション

次の例では、「EEM action」というリセット理由を指定し、モジュール 1 を強制的にシャットダウンするアクション文の例を示します。


switch (config-eem-policy)# action 1.0 forceshut module 1 reset-reason “EEM action”

環境変数を使用するアクション文

シャットダウンの理由に default-reason という環境変数を定義すると、次の例のように、リセット理由を環境変数に置き換えることができます。


switch (config-eem-policy)# action 1.0 forceshut module 1 reset-reason $default-reason

この環境変数は、任意のポリシーで再利用できます。環境変数の詳細については、 環境変数の定義を参照してください。

EEM イベント相関

Cisco NX-OS Release 5.2 以降では、イベントの組み合わせに基づいて EEM ポリシーをトリガーできます。まず、 tag キーワードを使用して EEM ポリシーに複数のイベントを作成し区別します。次に、一連のブール演算子を使用して(and 、 or 、および not )を使用して、回数および時間をもとに、カスタム処理をトリガするこれらのイベントの組み合わせを定義できます。

高可用性

Cisco NX-OS は、EEM のステートレス リスタートをサポートします。リブートまたはスーパーバイザ スイッチオーバーの後、Cisco NX-OS は実行コンフィギュレーションを適用します。

EEM のライセンス要件

次の表に、この機能のライセンス要件を示します。

製品

ライセンス要件

NX-OS

EEM にはライセンスは不要です。ライセンス パッケージに含まれていない機能はすべて Cisco NX-OS システム イメージにバンドルされており、追加費用は一切発生しません。

EEM の前提条件

EEM の前提条件は、次のとおりです。

  • EEM を設定するには、network-admin のユーザ権限が必要です。

注意事項と制約事項

EEM 設定時の注意事項と制約事項は次のとおりです。

  • ユーザ ポリシーまたは上書きポリシー内のアクション文が、相互に否定したり、関連付けられたシステム ポリシーに悪影響を与えたりするようなことがないようにする必要があります。
  • トリガーされたイベントでデフォルト アクションも処理されるようにする場合は、EEM アクションをポリシーのタイプに応じて event-default または policy-default で明示的に設定する必要があります。たとえば、match 文で CLI コマンドを照合する場合、EEM ポリシーに event-default アクション文を追加する必要があります。この文がないと、EEM では CLI コマンドを実行できません。
  • イベント文が指定されていて、アクション文が指定されていない上書きポリシーを設定した場合、アクションは開始されません。また、障害も通知されません。
  • 上書きポリシーにイベント文が含まれていないと、システム ポリシーで可能性のあるイベントがすべて上書きされます。
  • 複数のイベント文が EEM ポリシーに存在する場合は、各イベント文に tag キーワードと一意な tag 引数が必要です。

デフォルト設定

Table 1 EEM パラメータのデフォルト設定を示します。

Table 2. デフォルトの EEM パラメータ

パラメータ

デフォルト

システム ポリシー

アクティブ

Embedded Event Manager の設定

CLI によるユーザー ポリシーの定義

CLI を使用したユーザ ポリシーを定義できます。

CLI を使用したユーザ ポリシーを定義するには、次の手順に従います。

Procedure


Step 1

configure terminal

コンフィギュレーション モードに入ります。

Step 2

event manager applet applet-name

EEM にアプレットを登録し、アプレット コンフィギュレーション モードを開始します。  applet-name は、29 文字以内の英数字のストリング(大文字と小文字を区別)で指定します。

Step 3

description policy-description

(任意)ポリシーの説明になるストリングを設定します。文字列には最大 80 文字の英数字を使用できます。文字列は引用符で囲みます。

Step 4

event event-statement

ポリシーのイベント文を構成します。詳細については、 イベント文の構成を参照してください。

Step 5

maxrun 最大ランタイム

Embedded Event Manager(EEM)でのアプレットの最大ランタイムを構成します。範囲は 0 ~ 2147483647 秒です。

Step 6

次のいずれかを実行します。

  • tag tagname1 {and | andnot } tagname2 [{and | andnot } tagname3 [{and | andnot } tagname4 ]] happens occurs in seconds

(オプション)ポリシー内の複数のイベントを相互に関連付けます。

次の範囲は、0 ~ 9 です。 occurs 範囲は 1 ~ 4294967295 です。  seconds 値の範囲は 0 ~ 4294967295 秒です。

Step 7

action action-statement

ポリシーのアクション文を構成します。詳細については、 アクション文の構成を参照してください。

アクション文が複数の場合は、ステップ 5 を繰り返します。

Step 8

show event manager policy internal name

(任意)構成したポリシーに関する情報を表示します。

Step 9

copy running-config startup-config

(任意)この構成の変更を保存します。


イベント文の構成

イベント文を構成するには、EEM 構成モードでつぎのいずれかのコマンドを使用します。

コマンド

目的

event cli [tag tag_name match expression ] [count repeats |time seconds ]

正規表現と一致する CLI コマンドが入力された場合に、イベントがトリガします。

  tag tag_name キーワードと引数のペアは、複数のイベントがポリシーに含まれている場合、この特定のイベントを識別します。

繰り返し 範囲は 1 ~ 65000 です。time の範囲は 0 ~ 4294967295 秒です。0 は無制限を示します。

event counter name counter entry-val entry entry-op {eq|ge|gt|le|lt|ne }[exit-val exit exit-op exit {eq|ge|gt|le|lt|ne }]

カウンタが、開始演算子に基づいて開始のしきい値を超えた場合(値より大きい、小さいなど)にイベントを発生させます。イベントはただちにリセットされます。任意で、カウンタが終了のしきい値を超えたあとでリセットされるように、イベントを設定できます。値は、 counter の名前では、大文字と小文字を区別し、最大 28 の英数字を使用できます。  entry および exit 値の範囲は 0 ~ 2147483647 です。

event fanabsent [fan number ] time seconds

秒数で構成された時間を超えて、ファンがデバイスから取り外されている場合に、イベントを発生させます。ファン番号の範囲は、さまざまなスイッチに依存します (たとえば、9513 スイッチの場合、範囲は 1 から 2 です。9506/9509 スイッチの場合、範囲は 1 です)。seconds の範囲は 10 ~ 64000 です。

event fanbad [fan number ] time seconds

秒数で構成された時間を超えて、ファンが故障状態の場合に、イベントを発生させます。ファン番号の範囲は、さまざまなスイッチに依存します (たとえば、9513 スイッチの場合、範囲は 1 から 2 です。9506/9509 スイッチの場合、範囲は 1 です)。seconds の範囲は 10 ~ 64000 です。

event memory {critical | minor |severe}

メモリのしきい値を超えた場合にイベントを発生させます。

event module-failure type failure-type module { slot | all { slot | count repeats [time seconds]

モジュールが構成された障害タイプになった場合に、イベントを発生させます。

  slot の範囲は、さまざまなスイッチに依存します(たとえば、9513 スイッチの場合、範囲は 1 ~ 13 です。9509 スイッチの場合、範囲は 1 ~ 9 です)。値は、 繰り返し 範囲は 0 ~ 4294967295 です。  seconds 範囲は 0 ~ 4294967295 です。

event oir {fan | module | powersupply } {anyoir | insert | remove [number] }

構成されたデバイス構成要素(ファン、モジュール、または電源モジュール)がデバイスに取り付けられた場合、またはデバイスから取り外された場合に、イベントを発生させます。任意で、ファン、モジュール、または電源モジュールの具体的な番号を設定できます。  number 範囲は次のとおりです。

  • ファン番号は、さまざまなスイッチに依存しています。
  • モジュール番号は、さまざまなスイッチに依存しています。
  • 電源モジュール番号の範囲は 1 ~ 2 です。
event policy-default count repeats [time seconds ]

システム ポリシーで構成されているイベントを使用します。このオプションは、ポリシーを上書きする場合に使用します。

  繰り返し 範囲は 1 ~ 65000 です。値は、 seconds 範囲は 0 ~ 4294967295 です。

event poweroverbudget

電力バジェットが構成された電源モジュールの容量を超えた場合に、イベントを発生させます。

event snmp oid oid get-type {exact | next } entry-op {eq | ge | gt | le | lt |ne } entry -val entry [exit-comb {and | or }] exit-op {eq | ge | gt | le | lt |ne } exit -val exit exit-time time polling-interval interval

SNMP OID が、開始演算子に基づいて開始のしきい値を超えた場合(値より大きい、小さいなど)にイベントを発生させます。イベントはただちにリセットされます。または任意で、カウンタが終了のしきい値を超えたあとでリセットされるように、イベントを設定できます。OID はドット付き10 進表記です。値は、 entry および exit の値の範囲は 0 ~ 18446744073709551615 です。時間の範囲は 0 ~ 2147483647 です。間隔の範囲は 1 ~ 2147483647 です。

event syslog {occurs occurs number | pattern syslog pattern | period time intervals | priority syslog priority | tag tag_name }

syslog ログファイルに記録されたメッセージに基づいてイベントをトリガーします。

occurs occurs number:発生回数を指定します。指定できる範囲は 1 ~ 65000 です。

pattern syslog pattern:syslog パターンを指定します。通常の正規表現パターンの一致が使用されます。最長で英数字 256 文字です。

period time interval:メッセージ間の最大時間間隔を指定します。値の範囲は 0 ~ 4294967295 秒です。

priority syslog priority:syslog の優先順位を指定します。
  • alerts:アラート ログ メッセージを指定します。

  • critical:重大なログ メッセージを指定します。

  • debugging:デバッグ メッセージを指定します。

  • emergencies:Emergency(致命的)ログ メッセージを指定します。

  • errors:エラー ログ メッセージを指定します。

  • informational:情報ログ メッセージを指定します。

  • notification:Notification(通告)ログ メッセージを指定します。

  • pattern:パターン一致を指定します。

  • warnings:警告メッセージを指定します。

tag tag_name:タグ名を指定します。最長で英数字 29 文字です。

tag tag_name キーワード引数のペアは、複数のイベントがポリシーに含まれている場合、この特定のイベントを識別します。

event temperature [module slot ] [sensor sensor number ]threshold {any | major | minor }

温度センサーが設定されたしきい値を超えた場合に、イベントを発生させます。  slot 範囲は、さまざまなスイッチに依存しています。センサー範囲は MDS モジュールの 1 ~ 8 ですが、現在の MDS モジュールは 1 ~ 3 の範囲のみを使用し、一部のモジュールは 1 ~ 2 の範囲を使用します。

アクション文の構成

アクション文を設定するには、EEM コンフィギュレーション モードで次のいずれかのコマンドを使用します。

コマンド

目的

action number add variable-name

EEM アプレットが action トリガされたときに、EEM アクション コマンドを指定します。追加アクションを元に戻すには、 no このコマンドの形式を使用します。

action number append variable-name

EEM アプレットがトリガされたときに、変数値を既存の変数文字列に追加します。追加のアクションを取り消すには、このコマンドの no 形式を使用します。

action number break

EEM アプレットがトリガーされたときに、アクションのループを終了します。ブレーク アクションを無効にするには、 no このコマンドの形式を使用します。

action number cli command command-name

EEM アプレットがトリガされたときに、構成された VSH CLI コマンドを実行します。CLI コマンドのアクションを無効にするには、 no このコマンドの形式を使用します。VSH コマンド名の有効な値は 256 文字です。

Cisco MDS NX-OS リリース 8.1(1) から、 command キーワードが追加されました。  command キーワードは、Cisco NX-OS CLI に送信されるメッセージを指定します。コマンド名はダブルクォーテーションで囲んで追加してください。

action number cli local command command-name

イベントがトリガされたのと同じカードでアクション コマンドを実行します。を無効にするにはaction cli local command 、この no このコマンドの形式を使用します。VSH コマンド名の有効な値は 256 文字です。

Cisco MDS NX-OS リリース 8.1(1) から、 command キーワードが追加されました。  command キーワードは、Cisco NX-OS CLI に送信されるメッセージを指定します。コマンド名はダブルクォーテーションで囲んで追加してください。

action number comment string

EEM アプレットがトリガされたときに、アプレットに追加するコメントのアクションを指定します。コメント アクションを無効にするには、 no このコマンドの形式を使用します。文字列シーケンスの有効な値は 256 文字です。

action number continue

EEM アプレットがトリガされたときに、アクションのループを継続するアクションを指定します。コメント アクションを無効にするには、 no このコマンドの形式を使用します。

action number [. number ] counter name counter value val op {dec | inc | nop | set }

設定された値および操作でカウンタを変更します。アクション ラベルのフォーマットは number1.number2 です。

[番号(number)] は 16 桁までの任意の数値にできます。次の number2 の範囲はは 0 ~ 9 です。

counter name は大文字と小文字を区別し、最大 29 の英数字を使用できます。値は、 val には 0 ~ 2147483647 の整数または置換パラメータを指定できます。

action number decrement decrement-name

EEM アプレットがトリガされたときに、変数の値をデクリメントするアクションを指定します。アプレットからアクションを削除するには、 no このコマンドの形式を使用します。

action number divide divide-name EEM アプレットがトリガされたときに、与えられた序数の値で非除数を割ります。計算プロセスを削除するには、 no このコマンドの形式を使用します。
action number eem EEM アプレットがトリガされたときに、EEM アクション コマンドを指定します。EEM アクション コマンドを削除するには、 no このコマンドの形式を使用します。
action number else

EEM アプレットがトリガされたときに、if / else 条件付きアクション ブロックの else 条件付きアクション ブロックの開始を指定します。else 条件付きアクション ブロックを削除するには、 no このコマンドの形式を使用します。

action number elseif

EEM アプレットがトリガされたときに、if / else 条件付きアクション ブロックの elseif 条件付きアクション ブロックの開始を指定します。else 条件付きアクション ブロックを削除するには、このコマンドの フォームを使用します。 no このコマンドの形式を使用します。

action number end

EEM アプレットがトリガされたときに、if / else および while 条件付きアクション ブロックの条件付きアクション ブロックの終了を指定します。else 条件付きアクション ブロックを削除するには、 no このコマンドの形式を使用します。

action number [. number ] event-default

関連付けられたイベントのデフォルト アクションを実行します。アクション ラベルのフォーマットは number1.number2 です。

number は 16 桁までの任意の数値にできます。次の number2 の範囲はは 0 ~ 9 です。

action number exit

EEM アプレットがトリガされたときに、実行中のアプレット構成を終了します。実行中のアプレットからの即時終了のプロセスをキャンセルするには、 no このコマンドの形式を使用します。

action number file {close | delete | gets | open | puts | read | write}

EEM アプレット ファイルの動作を構成するには、アプレット構成モードで action file コマンドを使用します。構成を無効化するには、 no このコマンドの形式を使用します。

action number foreach foreach-name

デリミタをトークン化されたパターンとして使用した入力文字列の繰り返しを指定します。入力文字列の繰り返しを削除するには、 no このコマンドの形式を使用します。

action number if if-name

EEM アプレットがトリガされたときに、if 条件付きブロック開始を特定します。アプレットの構成モードで action if コマンドを使用してください。次の if 条件付きアクション ブロックを削除するには、 no このコマンドの形式を使用します。

action number increment increment-name

EEM アプレットがトリガされたときに、変数の値を増分するアクションを指定します。アプレットからアクションを削除するには、 no このコマンドの形式を使用します。

action number multiply multiply-name

EEM アプレットがトリガされたときに、変数値に指定された整数値を掛けるアクションを指定します。計算プロセスを削除するには、 no このコマンドの形式を使用します。

action number overbudgetshut [module module-name]

電力バジェット超過の問題により、1 つまたは複数のモジュールまたはシステム全体を強制的にシャットダウンします。

action number policy-default

上書きしているポリシーのデフォルト アクションを実行します。構成から action policy コマンドを削除するには、 no このコマンドの形式を使用します。

action number publish-event

EEM アプレットに指定されたイベントがトリガされたときに、アプリケーション固有のイベントを発行するアクションを指定します。アプリケーション固有のイベントを発行するアクションを削除するには、 no このコマンドの形式を使用します。

action number puts

EEM アプレットがトリガされたときにデータを直接ローカル TTY に出力するアクションを有効にします。この機能を無効にするには、 no このコマンドの形式を使用します。

action number regexp regexp-name

EEM アプレットがトリガされたときに入力文字列の正規表現パターンと比較します。この機能を無効にするには、 no このコマンドの形式を使用します。

action number reload

1 つまたは複数のモジュールまたはシステム全体を強制的にリロードします。

action number set set-name

EEM アプレットがトリガされたときに、変数の値を設定します。EEM アプレット変数の値を削除するには、 no このコマンドの形式を使用します。

action number [. number2 ] snmp-trap {[intdata1 data [intdata2 data [strdata string]]]}

構成されたデータを使用して SNMP トラップを送信します。 [番号(number)] は 16 桁までの任意の数値にできます。次の number2 の範囲は、0 ~ 9 です。

  data 引数には、最大 80 桁の任意の数を指定できます。  [文字列(String)] には最大 80 文字の英数字を使用できます。

action number string

EEM アプレットの string action コマンドを指定します。文字列の操作アクションを削除するには、 no このコマンドの形式を使用します。

action number wait wait-value

EEM アプレットのアクションの待機時間を指定します。この機能を無効にするには、 no このコマンドの形式を使用します。

action number while while-number

EEM アプレットがトリガされたときに条件付きブロックのループの開始を特定します。この機能を無効にするには、 no このコマンドの形式を使用します。

action number [. number2] exceptionlog module module syserr error devid id errtype type errcode code phylayer layer ports list harderror error [desc string ]

EEM アプレットがトリガされたときに特定の条件が発生した場合、例外をログに記録します。

action number [. number number2 ] forceshut [module slot | xbar xbar number ] reset-reason seconds

モジュール、クロスバー、またはシステム全体を強制的にシャットダウンします。アクション ラベルのフォーマットは number1.number2 です。

number は 16 桁までの任意の数値にできます。次の number2 の範囲は、0 ~ 9 です。

  slot 範囲は、さまざまなスイッチに依存しています。  xbar-number の範囲は 1 ~ 2 で、MDS 9513 モジュールでのみ使用できます。

リセット理由は、引用符で囲んだ最大 80 文字の英数字ストリングです。

action number [. number ] overbudgetshut [module slot [- slot ]]

電力バジェット超過の問題により、1 つまたは複数のモジュールまたはシステム全体を強制的にシャットダウンします。

[番号(number)] は 16 桁までの任意の数値にできます。次の範囲は、0 ~ 9 です。 number2 の範囲は、0 ~ 9 です。

  slot 範囲は、さまざまなスイッチに依存しています。

action number [. number ] policy-default

上書きしているポリシーのデフォルト アクションを実行します。アクション ラベルのフォーマットは number1.number2 です。

[番号(number)] は 16 桁までの任意の数値にできます。次の範囲は、0 ~ 9 です。 number2 の範囲は、0 ~ 9 です。

action number [. number ] reload [module slot [- slot ]]

1 つまたは複数のモジュールまたはシステム全体を強制的にリロードします。

number は 16 桁までの任意の数値にできます。次の範囲は、0 ~ 9 です。 number2 の範囲は、0 ~ 9 です。

  slot 範囲は、さまざまなスイッチに依存しています。

action number [. number2 ] syslog [priority prio-val ] msg error message

構成されたプライオリティで、カスタマイズした syslog メッセージを送信します。[番号(number)] は 16 桁までの任意の数値にできます。次の number2 の範囲は、0 ~ 9 です。

  error-message には最大 256 文字の英数字を引用符で囲んで使用できます。


Note


トリガーされたイベントでデフォルト アクションも処理されるようにする場合は、EEM アクションをポリシーのタイプに応じて event-default または policy-default で明示的に設定する必要があります。たとえば、match 文で CLI コマンドを照合する場合、EEM ポリシーに event-default アクション文を追加する必要があります。この文がないと、EEM では CLI コマンドを実行できません。 コマンドを使用して、すべての CLI ベースの EEM ポリシーを terminal event-manager bypass バイパスできます。元に戻すには、 terminal no event-manager bypass コマンドを使用します。

VSH スクリプトによるポリシーの定義

VSH スクリプトを使用してポリシーを定義するには、次の手順に従います。

Procedure


Step 1

テキスト エディタで、ポリシーを定義する CLI コマンド リストを指定します。

Step 2

テキスト ファイルに名前をつけて保存します。

Step 3

ファイルを次のシステム ディレクトリにコピーします。

bootflash://eem/user_script_policies


VSH スクリプト ポリシーの登録およびアクティブ化

VSH スクリプトで定義したポリシーを登録してアクティブにするには、次の手順に従います。

Procedure


Step 1

configure terminal

コンフィギュレーション モードに入ります。

Step 2

event manager policy policy-script

EEM スクリプト ポリシーを登録してアクティブにします。値は、 policy-script は、29 文字以内の英数字のストリング(大文字と小文字を区別)で指定します。

Step 3

show event manager internal policy name

(任意)構成したポリシーに関する情報を表示します。

Step 4

copy running-config startup-config

(任意)この構成の変更を保存します。


ポリシーの上書き

システム ポリシーを上書きするには、次の手順に従います。

Procedure


Step 1

configure terminal

コンフィギュレーション モードに入ります。

Step 2

show event manager policy-state system-policy

(任意)上書きするシステム ポリシーの情報をしきい値を含めて表示します。  show event manager system-policy コマンドを使用して、システム ポリシーの名前を探します。

Step 3

[no ] event manager applet applet-name override system-policy

システム ポリシーを上書きし、アプレット コンフィギュレーション モードを開始します。  applet-name は、29 文字以内の英数字のストリング(大文字と小文字を区別)で指定します。次の system-policy は、システム ポリシーの 1 つにする必要があります。

Step 4

description policy-description

(任意)ポリシーの説明になるストリングを設定します。string には最大 80 文字の英数字を使用できます。ストリングは引用符で囲みます。

Step 5

[no ] event event-statement

ポリシーのイベント文を設定します。詳細については、 イベント文の構成 次の no キーワードを使用すると、上書きされたイベントがあればそれを削除します。

  • 上書きされたポリシーを削除しても、デフォルトのシステム ポリシーは削除されません。

  • それぞれのゾーン、FCNS、または FLOGI 制限値を変更することにより、上書きされたポリシーを変更できます。

Step 6

action action-statement

ポリシーのアクション文を設定します。詳細については、 アクション文の構成 

アクション文が複数の場合は、ステップ 6 を繰り返します。

  • ゾーン、FLOGI、および FCNS は、アクションとして syslog メッセージの生成のみをサポートします。

  • アクションが構成されていない場合、デフォルトのシステム ポリシーに関連付けられたデフォルトのアクションが実行されます。アクションが構成されている場合、構成されたアクションとデフォルトのアクションの両方が実行されます。この機能は、ゾーン、FLOGI、および FCNS システム ポリシーにのみ適用されます。

Step 7

show event manager policy-state name

(任意)設定したポリシーに関する情報を表示します。

Step 8

copy running-config startup-config

(任意)この設定の変更を保存します。

Note

 
ゾーン、FLOGI、および FCNS EEM ポリシーの複数の上書きは許可されていません。

環境変数の定義

EEM ポリシーでパラメータとして機能する変数を定義するには、次の手順に従ってください。

Procedure


Step 1

configure terminal

コンフィギュレーション モードに入ります。

Step 2

event manager environment variable-name variable-value

EEM 用の環境変数を作成します。値は、 variable-name は、29 文字以内の英数字のストリング(大文字と小文字を区別)で指定します。  variable-value には最大 39 文字の英数字を引用符で囲んで使用できます。

Step 3

show event manager environment

(任意)設定した環境変数に関する情報を表示します。

Step 4

copy running-config startup-config

(任意)この設定の変更を保存します。


EEM の構成確認

EEM 構成情報を表示するには、次のいずれかの作業を実行します。

コマンド

目的

show event manager environment [variable-name | all ]

イベント マネージャの環境変数に関する情報を表示します。

show event manager event-types [event | all | module slot ]

イベント マネージャのイベント タイプに関する情報を表示します。

show event manager history events [ detail ] [ maximum num-events ] [ severity { catastrophic | minor | moderate | severe }]

すべてのポリシーについて、イベント履歴を表示します。

show event manager policy internal [policy-name] [inactive ]

設定したポリシーに関する情報を表示します。

show event manager policy-state policy-name

しきい値を含め、ポリシーの状態に関する情報を表示します。

show event manager script system [policy-name} all ]

スクリプト ポリシーに関する情報を表示します。

show event manager system-policy [all ]

定義済みシステム ポリシーに関する情報を表示します。

show running-config eem

EEM の実行コンフィギュレーションに関する情報を表示します。

show startup-config eem

EEM のスタートアップ コンフィギュレーションに関する情報を表示します。

EEM の設定例

モジュール 3 の中断のないアップグレード エラーのしきい値だけを変更することによって、__lcm_module_failure システム ポリシーを上書きする例を示します。次の例では、syslog メッセージも送信されます。その他のすべての場合、システム ポリシー __lcm_module_failure の設定値が適用されます。


event manager applet example2 override __lcm_module_failure
 event module-failure type hitless-upgrade-failure module 3 count 2
 action 1 syslog priority errors msg module 3 “upgrade is not a hitless upgrade!”
 action 2 policy-default

次の例では、FCNS データベース エントリの数を 1500 に変更して、上書きされたポリシーを変更します。また、デフォルトのシステム ポリシーの構成済みおよびデフォルトの syslog メッセージの両方を生成します。


event manager applet fcns_policy override __fcns_entries_max_per_switch
event fcns entries max-per-switch 1500 
      action 1.0 syslog priority warnings msg  FCNS DB entries have reached the EEM limit

次の例では、上書きされたポリシーのイベントを削除します。


no event manager applet zone_policy

次に、CLI コマンドの実行を許可し、ユーザがデバイスで構成モードを開始すると SNMP 通知を送る EEM ポリシーを作成する例を示します。


event manager applet TEST
event cli match "conf t"
action 1.0 snmp-trap strdata "Configuration change"
action 2.0 event-default

Note


EEM ポリシーに event-default アクション文を追加する必要があります。この文がないと、EEM では CLI コマンドを実行できません。

次に、EEM アプレットが起動されたときに実行される VSH コマンド文字列を構成する例を示します。


switch# configure terminal
switch(config)# event manager applet cli-applet
switch(config-applet)# action 1.0 cli command “show interface e 3/1“

その他の参考資料

EEM の実装に関する詳細情報については、次の項を参照してください。

MIB

MIB

MIB のリンク

  • CISCO-EMBEDDED-EVENT-MGR-MIB

MIB を検索およびダウンロードするには、次の URL にアクセスしてください。

http://www.cisco.com/en/US/products/ps5989/prod_technical_reference_list.html