この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
条件付きデバッグ機能によって、定義した条件に基づき、特定の機能のデバッグおよびロギングを選択して有効にすることができます。この機能は、多くの機能がサポートされているシステムで有用です。
条件付きデバッグでは、多数の機能が導入されていて大規模に稼働しているネットワークにおけるきめ細かなデバッグが可能です。これにより、システム内の細かなインスタンスに対しても、詳細なデバッグを実行できます。これは、何千ものセッションのうちの特定のセッションのみをデバッグするような場合に、非常に有用です。条件は複数指定することもできます。
条件とは、機能またはアイデンティティをいいます。アイデンティティは、インターフェイス、IP アドレス、MAC アドレスなどです。
これは、処理する機能オブジェクトを区別せずに出力を生成する、一般的なデバッグ コマンドとは対照的です。一般的なデバッグ コマンドは、多数のシステム リソースを消費し、システム パフォーマンスに影響します。
ラジオアクティブ トレース（RA）により、冗長性のレベルを高めた状態で、システムの全体にわたって目的とする動作を連鎖的に実行できます。また、複数のスレッド、プロセス、および関数呼び出しにわたって、デバッグ情報を条件に基づいて（DEBUG レベルまで、または指定のレベルまで）出力する方法を提供します。
 （注） |
|
条件付きデバッグと組み合わせた放射線トレースによって、条件に関連するすべての実行コンテキストをデバッグする単一のデバッグ CLI を取得できます。これは、ボックス内の機能のさまざまな制御フロー プロセスを認識していなくても行うことができ、これらのプロセスでデバッグを個別に発行する必要もありません。
（注） |
プラットフォームに適用されているデバッグ条件を削除するには、clear platform condition all コマンドを使用します。 |
デフォルトでは、トレースファイルログは各プロセスで生成され、/tmp/rp/trace または /tmp/fp/trace ディレクトリに保存されます。この一時ディレクトリで、トレース ログがファイルに書き込まれます。各ファイルは 1 MB サイズです。これらのログ（プロセス単位）は show platform software trace message process_namechassis active R0 コマンドを使用して確認できます。このディレクトリでは、特定のプロセスのこうしたファイルを、最大 25 件保持できます。/tmp ディレクトリのトレースファイルがその 1 MB 制限またはブート時に設定されたサイズに達した場合、ローテーションから外れ、tracelogs ディレクトリの /crashinfo パーティションの下にあるアーカイブの場所に移動します。
/tmp ディレクトリが 1 つのプロセスで保持するトレースファイルは 1 つのみです。ファイルがそのファイル サイズの制限に達すると、ローテーションから外れ、/crashinfo/tracelogs に移動します。アーカイブ ディレクトリに蓄積されるファイルは最大 25 ファイルであり、その後は最も古いものから順に、/tmp から新たにローテーションされたファイルに置換されます。ファイルサイズはプロセスに依存し、一部のプロセスではより大きなファイルサイズ（最大 10MB）が使用されます。同様に、tracelogs ディレクトリ内のファイル数もプロセスによって決定されます。たとえば、WNCD プロセスでは、プラットフォームに応じて、インスタンスごとに 400 ファイルの制限が使用されます。
crashinfo ディレクトリ内のトレースファイルは次の形式で配置されます。
例：IOSRP_R0-0.bin_0.14239.20151101234827.gz
例：wncmgrd_R0-0.27958_1.20180902081532.bin.gz
| ステップ 1 |
を選択します。 |
| ステップ 2 |
[Add] をクリックします。 |
| ステップ 3 |
[MAC/IP Address] を入力します。MAC アドレスは、xx:xx:xx:xx:xx:xx、xx-xx-xx-xx-xx-xx、または xxxx.xxxx.xxxx のいずれかの形式で指定できます。 |
| ステップ 4 |
[Apply to Device] をクリックします。 |
| ステップ 5 |
条件付きデバッグを開始する場合は [Start]、停止する場合は [Stop] をクリックしします。 |
| ステップ 6 |
[Generate] をクリックして、放射線トレースログを作成します。 |
| ステップ 7 |
オプションボタンをクリックして、時間間隔を設定します。 |
| ステップ 8 |
トレースファイル名の横に表示される [Download Logs] アイコンをクリックして、ログをローカルフォルダにダウンロードします。 |
| ステップ 9 |
トレースファイル名の横に表示される [View Logs] アイコンをクリックして、GUI ページでログファイルを表示します。[Load More] をクリックして、ログファイルの他の行を表示します。 |
| ステップ 10 |
[Apply to Device] をクリックします。 |
条件付きデバッグを設定するには、次の手順に従います。
| コマンドまたはアクション | 目的 | |||
|---|---|---|---|---|
| ステップ 1 |
debug platform condition feature wireless mac {mac-address } 例: |
指定された MAC アドレスを使用する機能の条件付きデバッグを設定します。
|
||
| ステップ 2 |
debug platform condition start 例: |
条件付きデバッグを開始します（上記のいずれかの条件に一致すると放射線トレースを開始します）。
|
||
| ステップ 3 |
show platform condition または show debug 例: |
現在設定されている条件を表示します。 |
||
| ステップ 4 |
debug platform condition stop 例: |
条件付きデバッグを停止します（放射線トレースを停止します）。
|
||
| ステップ 5 |
show logging profile wireless [counter | [last]{x days/hours} | filter mac{<mac address>} [to-file]{<destination>} 例: |
最新のワイヤレスプロファイルからのログを表示します。
|
||
| ステップ 6 |
show logging process <process name> 例: |
プロセスに固有のログコレクションを表示します。 |
||
| ステップ 7 |
clear platform condition all 例: |
すべての条件をクリアします。 |
（注） |
コマンド request platform software trace filter-binary wireless {mac-address } は次の 3 つのフラッシュファイルを生成します。
|
その中でも、mac_log <..date..> は最も重要なファイルで、デバッグする MAC 用のメッセージが含まれます。コマンド show platform software trace filter-binary も同じフラッシュ ファイルを生成し、また、画面に mac_log を出力します。
たとえば 1 日。
使用するコマンドは、次のとおりです。
デバイス#show logging process wncd to-file flash:wncd.txt
ロケーション（/flash:）にトレースログのテキストファイルが生成されます。
デバイスの外にファイルをコピーします。ファイルをコピーすることによって、オフラインでトレースログが使用できます。ファイルのコピーについての詳細は、次のセクションを参照してください。
ロケーション（/flash:）からトレースログファイル（.txt）を削除します。これにより、他の操作に十分な領域がデバイスに確保されます。
トレース ファイルの例を以下に示します。
デバイス# dir flash:/tracelogs
Directory of crashinfo:/tracelogs/
50664 -rwx 760 Sep 22 2015 11:12:21 +00:00 plogd_F0-0.bin_0.gz
50603 -rwx 991 Sep 22 2015 11:12:08 +00:00 fed_pmanlog_F0-0.bin_0.9558.20150922111208.gz
50610 -rw- 11 Nov 2 2015 00:15:59 +00:00 timestamp
50611 -rwx 1443 Sep 22 2015 11:11:31 +00:00 auto_upgrade_client_sh_pmanlog_R0-.bin_0.3817.20150922111130.gz
50669 -rwx 589 Sep 30 2015 03:59:04 +00:00 cfgwr-8021_R0-0.bin_0.gz
50612 -rwx 1136 Sep 22 2015 11:11:46 +00:00 reflector_803_R0-0.bin_0.1312.20150922111116.gz
50794 -rwx 4239 Nov 2 2015 00:04:32 +00:00 IOSRP_R0-0.bin_0.14239.20151101234827.gz
50615 -rwx 131072 Nov 2 2015 00:19:59 +00:00 linux_iosd_image_pmanlog_R0-0.bin_0
トレース ファイルは、次に示すさまざまなオプションのいずれかを使用して、コピーできます。
デバイス# copy flash:/tracelogs ?
crashinfo: Copy to crashinfo: file system
flash: Copy to flash: file system
ftp: Copy to ftp: file system
http: Copy to http: file system
https: Copy to https: file system
null: Copy to null: file system
nvram: Copy to nvram: file system
rcp: Copy to rcp: file system
running-config Update (merge with) current system configuration
scp: Copy to scp: file system
startup-config Copy to startup configuration
syslog: Copy to syslog: file system
system: Copy to system: file system
tftp: Copy to tftp: file system
tmpsys: Copy to tmpsys: file system
TFTP サーバーにコピーするための一般的な構文は次のとおりです。
デバイス# copy source: tftp:
デバイス# copy crashinfo:/tracelogs/IOSRP_R0-0.bin_0.14239.20151101234827.gz tftp:
Address or name of remote host []? 2.2.2.2
Destination filename [IOSRP_R0-0.bin_0.14239.20151101234827.gz]?
（注） |
tracelog および他の目的に使用可能な空き容量があることを確認するために、生成されたレポート/アーカイブ ファイルをスイッチからクリアすることが重要です。 |
次に、show platform condition コマンドの出力例を示します。
デバイス# show platform condition
Conditional Debug Global State: Stop
Conditions Direction
----------------------------------------------------------------------------------------------|---------
MAC Address 0024.D7C7.0054 N/A
Feature Condition Type Value
-----------------------|-----------------------|--------------------------------
デバイス#次に、show debug コマンドの出力例を示します。
デバイス# show debug
IOSXE Conditional Debug Configs:
Conditional Debug Global State: Start
Conditions Direction
----------------------------------------------------------------------------------------------|---------
MAC Address 0024.D7C7.0054 N/A
Feature Condition Type Value
-----------------------|-----------------------|--------------------------------
Packet Infra debugs:
Ip Address Port
------------------------------------------------------|----------
デバイス#次の表に、条件付きデバッグの確認に使用できる各種コマンドを示します。
|
コマンド |
目的 |
|---|---|
|
show platform condition |
現在設定されている条件を表示します。 |
|
show debug |
現在設定されているデバッグ条件を表示します。 |
|
show platform software trace filter-binary |
最新のトレース ファイルからマージされたログを表示します。 |
|
request platform software trace filter-binary |
システムにマージされたトレース ファイルの履歴ログを表示します。 |
次に、show platform software trace message ios chassis active R0 | inc sisf コマンドの出力例を示します。
デバイス# show platform software trace message ios chassis active R0 | inc sisf
2017/10/26 13:46:22.104 {IOSRP_R0-0}{1}: [parser]: [5437]: UUID: 0, ra: 0 (note): CMD: 'show platform software trace message ios switch active R0 | inc sisf' 13:46:22 UTC Thu Oct 26 2017
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): FF8E802918 semaphore system unlocked
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Unlocking, count is now 0
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): FF8E802918 semaphore system unlocked
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Unlocking, count is now 1
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Gi1/0/5 vlan 10 aaaa.bbbb.cccc Setting State to 2
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Gi1/0/5 vlan 10 aaaa.bbbb.cccc Start timer 0
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Gi1/0/5 vlan 10 aaaa.bbbb.cccc Timer value/granularity for 0 :299998/1000
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Gi1/0/5 vlan 10 aaaa.bbbb.cccc Updated Mac Timer : 299998
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Gi1/0/5 vlan 10 aaaa.bbbb.cccc Before Timer : 350000
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Gi1/0/5 vlan 10 aaaa.bbbb.cccc Timer 0, default value is 350000
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Allocating timer wheel for 0
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Gi1/0/5 vlan 10 aaaa.bbbb.cccc No timer running
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Granularity for timer MAC_T1 is 1000
2017/10/26 13:46:10.667 {IOSRP_R0-0}{1}: [sisf]: [5437]: UUID: 4800000000060, ra: 7 (debug): Gi1/0/5 vlan 10 aaaa.bbbb.cccc Current State :MAC-STALE, Req Timer : MAC_T1 Current Timer MAC_T1
フィードバック