Cisco IOS と NX-OS ソフトウェア : Cisco IOS Embedded Event Manager(EEM)

Show stacks コマンド 設定からの出力をキャプチャする EEM アプレット

2016 年 10 月 28 日 - 機械翻訳について
その他のバージョン: PDFpdf | 英語版 (2015 年 8 月 22 日) | フィードバック

概要

このドキュメントでは、show stacks コマンドから出力を取得するために、Cisco IOS® Embedded Event Manager(EEM)アプレットを設定する方法について説明します。 Cisco Technical Assistance Center(TAC)では、通常、Simple Network Management Protocol(SNMP)によって発生する高 CPU 使用率の問題をトラブルシューティングするために、この出力が必要です。

著者:Cisco TAC エンジニア、Andres Porras および Luis Jimenez

前提条件

要件

次の項目に関する知識があることが推奨されます。

  • Simple Network Management Protocol(SNMP)
  • Cisco IOS Embedded Event Manager(EEM)
  • Syslog

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づくものです。

  • Cisco IOS リリース 15.1(4)M6
  • Cisco 2811 サービス統合型ルータ

: Cisco IOS リリース 12.4(22)T 以降でサポートされる EEM を両方のアプレットで使用しているため、このドキュメントの設定は以前の Cisco IOS ソフトウェア バージョンで機能します。 ただし、これはテストされていません。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されたものです。 このドキュメントで使用するすべてのデバイスは、クリアな(デフォルト)設定で作業を開始しています。 ネットワークが稼働中の場合は、コマンドが及ぼす潜在的な影響を十分に理解しておく必要があります。

設定

次の EEM アプレットはshow stacks コマンドから出力を取得するプロセスを自動化します。 次の注意してください。

  • 両方のアプレットで SNMP エンジンのプロセス ID(PID)を使用します。 PID を見つけるには、show processes cpu コマンドを入力します。 この例では、PID は 188 です。

    2811#show processes cpu | include SNMP ENGINE
    PID Runtime(ms) Invoked uSecs 5Sec 1Min 5Min TTY Process
    188 40 1 40000 0.00% 0.04% 0.01% 0 SNMP ENGINE
    2811#
  • 待機アクションを使用するためには、EEM のバージョン 3.0 以上が必要です。 EEM のバージョンを見つけるには、show event manager version コマンドを入力します。
  • 認証、認可、アカウンティング(AAA)を使用する Cisco IOS ソフトウェア デバイスは、どのユーザが CLI 操作を実行できるかを定義する必要があります。 この設定には、event manager session cli username ユーザ コマンドを使用します。ここで、user は EEM アプレットですべての CLI コマンドを実行することを許可されたユーザの名前です。
  • 一部のファイル システムでは出力をリダイレクトするための「apend」オプションがサポートされていない場合があります。 アプレットを設定する前に、ファイル システムに出力をリダイレクトできるように、これを手動でテストしてください。

show stacks コマンドは、指定されたプロセスにより処理されるタスクを表示します。 CPU 使用率が高い問題をトラブルシューティングする場合、この状態が発生するときにどのタスクが実行されているかを見つけると役立ちます。

50 % を超える CPU 使用率

この EEM アプレットは、CPU 使用率が 50 % を超えたとき、これを検出します。 そのとき、show stacks コマンドからの出力が 9 秒間サンプリングされ、フラッシュ内の SNMP_STACK.txt というファイルに記録されます。 この情報は、TAC が CPU 使用率の高い原因を特定するのに役立ちます。

この例では、SNMP による CPU 使用率が高い状態を調査しています。 別のプロセスにより発生した CPU 使用率が高い問題を調査するために、同じような EEM アプレットを使用して別の出力セットを収集できます。

event manager applet SNMP_STACK
event snmp oid 1.3.6.1.4.1.9.9.109.1.1.1.1.6.1 get-type exact entry-op gt
entry-val "50" exit-op lt exit-val "15" poll-interval 2 maxrun 20
action 0.0 syslog msg "High CPU DETECTED"
action 0.1 cli command "enable"
action 1.1 cli command "show clock | append flash:SNMP_STACK.TXT"
action 1.2 cli command "show proc cpu sort | append flash:SNMP_STACK.TXT"
action 2.1 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 2.2 wait 1
action 2.3 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 2.4 wait 1
action 2.5 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 2.6 wait 1
action 2.7 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 2.8 wait 1
action 2.9 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.1 wait 1
action 3.2 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.3 wait 1
action 3.4 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.5 wait 1
action 3.6 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.7 wait 1
action 3.8 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"

%SNMP-3-INPUT_QFULL_ERR Syslog メッセージ

この EEM アプレットは %SNMP-3-INPUT_QFULL_ERR の syslog メッセージが生成された場合にアクティブになります。 そのとき、show stacks コマンドからの出力が 9 秒間サンプリングされ、フラッシュ内の SNMP_STACK.txt というファイルに記録されます。 この情報は、TAC が CPU 使用率の高い原因を特定するのに役立ちます。

event manager applet SNMP_STACK
event syslog pattern "%SNMP-3-INPUT_QFULL_ERR"
action 1.0 cli command "enable"
action 2.1 cli command "show clock | append flash:SNMP_STACK.TXT"
action 2.2 cli command "show proc cpu sort | append flash:SNMP_STACK.TXT"
action 3.1 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.2 wait 1
action 3.3 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.4 wait 1
action 3.5 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.6 wait 1
action 3.7 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.8 wait 1
action 3.9 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.1 wait 1
action 4.2 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.3 wait 1
action 4.4 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.5 wait 1
action 4.6 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.7 wait 1
action 4.8 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.9 wait 1

確認

現在、この設定に使用できる確認手順はありません。

トラブルシューティング

現在のところ、この設定に関する特定のトラブルシューティング情報はありません。

関連情報



Document ID: 116142