Cisco Nexus 9000 シリーズ NX-OS システム管理コンフィギュレーション ガイド リリース 6.x
オンボード障害ロギングの設定
オンボード障害ロギングの設定

オンボード障害ロギングの設定

この章では、Cisco NX-OS デバイスで Onboard Failure Logging(OBFL)機能を設定する方法について説明します。

この章は、次の項で構成されています。

OBFL の概要

Cisco NX-OS には永続ストレージに障害データを記録する機能があるので、あとから記録されたデータを取得して表示し、分析できます。 この OBFL 機能は、障害および環境情報をモジュールの不揮発性メモリに保管します。 この情報は、障害モジュールの分析に役立ちます。

OBFL は次のタイプのデータを保存します。

  • 最初の電源投入時刻
  • モジュールのシャーシ スロット番号
  • モジュールの初期温度
  • ファームウェア、BIOS、FPGA、および ASIC のバージョン
  • モジュールのシリアル番号
  • クラッシュのスタック トレース
  • CPU hog 情報
  • メモリ リーク情報
  • ソフトウェア エラー メッセージ
  • ハードウェア例外ログ
  • 環境履歴
  • OBFL 固有の履歴情報
  • ASIC 割り込みおよびエラー統計の履歴
  • ASIC レジスタ ダンプ

OBFL のライセンス要件

製品

ライセンス要件

Cisco NX-OS

OBFL にはライセンスは不要です。 ライセンス パッケージに含まれていない機能は nx-os イメージにバンドルされており、無料で提供されます。 Cisco NX-OS ライセンス方式の詳細については、Cisco NX-OS Licensing Guide』を参照してください。

OBFL の前提条件

network-admin ユーザ権限が必要です。

OBFL の注意事項と制約事項

OBFL に関する注意事項および制約事項は、次のとおりです。

  • OBFL はデフォルトでイネーブルになっています。
  • OBFL フラッシュがサポートする書き込みおよび消去の回数には制限があります。 イネーブルにするロギング数が多いほど、この書き込みおよび消去回数に早く達してしまいます。

(注)  


この機能の Cisco NX-OS コマンドは、Cisco IOS のコマンドとは異なる場合があるので注意してください。

OBFL のデフォルト設定

次の表に、OBFL パラメータのデフォルト設定を示します。

パラメータ(Parameters) デフォルト
OBFL すべての機能がイネーブル

OBFL の設定

Cisco NX-OS デバイス上で OBFL 機能を設定できます。

はじめる前に

グローバル コンフィギュレーション モードになっていることを確認します。

手順
     コマンドまたはアクション目的
    ステップ 1configure terminal


    例:
    switch# configure terminal
    switch(config)#
    
     

    グローバル コンフィギュレーション モードを開始します。

     
    ステップ 2hw-module logging onboard


    例:
    switch(config)# hw-module logging onboard
    Module: 7 Enabling ... was successful.
    Module: 10 Enabling ... was successful.
    Module: 12 Enabling ... was successful.
    
     

    すべての OBFL 機能をイネーブルにします。

     
    ステップ 3hw-module logging onboard counter-stats


    例:
    switch(config)# hw-module logging onboard counter-stats
    Module: 7 Enabling counter-stats ... was successful.
    Module: 10 Enabling counter-stats ... was successful.
    Module: 12 Enabling counter-stats ... was successful.
    
     

    OBFL カウンタ統計情報をイネーブルにします。

     
    ステップ 4hw-module logging onboard cpuhog


    例:
    switch(config)# hw-module logging onboard cpuhog
    Module: 7 Enabling cpu-hog ... was successful.
    Module: 10 Enabling cpu-hog ... was successful.
    Module: 12 Enabling cpu-hog ... was successful.
    
     

    OBFL CPU hog イベントをイネーブルにします。

     
    ステップ 5hw-module logging onboard environmental-history


    例:
    switch(config)# hw-module logging onboard environmental-history
    Module: 7 Enabling environmental-history ... was successful.
    Module: 10 Enabling environmental-history ... was successful.
    Module: 12 Enabling environmental-history ... was successful.
    
     

    OBFL 環境履歴をイネーブルにします。

     
    ステップ 6hw-module logging onboard error-stats


    例:
    switch(config)# hw-module logging onboard error-stats
    Module: 7 Enabling error-stats ... was successful.
    Module: 10 Enabling error-stats ... was successful.
    Module: 12 Enabling error-stats ... was successful.
    
     

    OBFL エラー統計をイネーブルにします。

     
    ステップ 7hw-module logging onboard interrupt-stats


    例:
    switch(config)# hw-module logging onboard interrupt-stats
    Module: 7 Enabling interrupt-stats ... was successful.
    Module: 10 Enabling interrupt-stats ... was successful.
    Module: 12 Enabling interrupt-stats ... was successful.
    
     

    OBFL 割り込み統計をイネーブルにします。

     
    ステップ 8hw-module logging onboard module slot


    例:
    switch(config)# hw-module logging onboard module 7
    Module: 7 Enabling ... was successful.
    
     

    モジュールの OBFL 情報をイネーブルにします。

     
    ステップ 9hw-module logging onboard obfl-logs


    例:
    switch(config)# hw-module logging onboard obfl-logs
    Module: 7 Enabling obfl-log ... was successful.
    Module: 10 Enabling obfl-log ... was successful.
    Module: 12 Enabling obfl-log ... was successful.
    
     

    ブート動作時間、デバイス バージョン、および OBFL 履歴をイネーブルにします。

     
    ステップ 10show logging onboard


    例:
    switch(config)# show logging onboard
    
     
    (任意)

    OBFL に関する情報を表示します。

     
    ステップ 11copy running-config startup-config


    例:
    switch(config)# copy running-config startup-config
    
     
    (任意)

    実行コンフィギュレーションを、スタートアップ コンフィギュレーションにコピーします。

     

    OBFL コンフィギュレーションの確認

    モジュールのフラッシュに保存されている OBFL 情報を表示するには、次のいずれかの作業を行います。

    コマンド 目的
    show logging onboard boot-uptime ブートおよび動作時間の情報を表示します。
    show logging onboard counter-stats すべての ASIC カウンタについて、統計情報を表示します。
    show logging onboard credit-loss OBFL クレジット損失のログを表示します。
    show logging onboard device-version デバイス バージョン情報を表示します。
    show logging onboard endtime 指定した終了時刻までの OBFL ログを表示します。
    show logging onboard environmental-history 環境履歴を表示します。
    show logging onboard error-stats エラー統計情報を表示します。
    show logging onboard exception-log 例外ログ情報を表示します。
    show logging onboard interrupt-stats 割り込み統計情報を表示します。
    show logging onboard module slot 指定したモジュールの OBFL 情報を表示します。
    show logging onboard obfl-history 履歴情報を表示します。
    show logging onboard obfl-logs ログ情報を表示します。
    show logging onboard stack-trace カーネル スタック トレース情報を表示します。
    show logging onboard starttime 指定した開始時刻からの OBFL ログを表示します。
    show logging onboard status OBFL ステータス情報を表示します。

    OBFL の設定ステータスを表示するには、show logging onboard status コマンドを使用します。

    switch# show logging onboard status
    ----------------------------
    OBFL Status
    ----------------------------
    Switch OBFL Log: Enabled
     
    Module: 4 OBFL Log: Enabled
    cpu-hog Enabled
    credit-loss Enabled
    environmental-history Enabled
    error-stats Enabled
    exception-log Enabled
    interrupt-stats Enabled
    mem-leak Enabled
    miscellaneous-error Enabled
    obfl-log (boot-uptime/device-version/obfl-history) Enabled
    register-log Enabled
    request-timeout Enabled
    stack-trace Enabled
    system-health Enabled
    timeout-drops Enabled
    stack-trace Enabled
     
    Module: 22 OBFL Log: Enabled
    cpu-hog Enabled
    credit-loss Enabled
    environmental-history Enabled
    error-stats Enabled
    exception-log Enabled
    interrupt-stats Enabled
    mem-leak Enabled
    miscellaneous-error Enabled
    obfl-log (boot-uptime/device-version/obfl-history) Enabled
    register-log Enabled
    request-timeout Enabled
    stack-trace Enabled
    system-health Enabled
    timeout-drops Enabled
    stack-trace Enabled
    
    

    上記の各 show コマンド オプションの OBFL 情報を消去するには、clear logging onboard コマンドを使用します。

    OBFL のコンフィギュレーション例

    モジュール 2 で環境情報について OBFL をイネーブルにする例を示します。

    switch# configure terminal
    switch(config)# hw-module logging onboard module 2 environmental-history
    

    その他の関連資料

    関連資料

    関連項目 マニュアル タイトル
    コンフィギュレーション ファイル Cisco Nexus 9000 Series NX-OS Fundamentals Configuration Guide