条件付きデバッグ機能によって、定義した条件に基づき、特定の機能のデバッグおよびロギングを選択して有効にすることができます。この機能は、多くの機能がサポートされているシステムで有用です。

条件付きデバッグでは、多数の機能が導入されていて大規模に稼働しているネットワークにおけるきめ細かなデバッグが可能です。これにより、システム内の細かなインスタンスに対しても、詳細なデバッグを実行できます。これは、何千ものセッションのうちの特定のセッションのみをデバッグするような場合に、非常に有用です。条件は複数指定することもできます。

条件とは、機能またはアイデンティティをいいます。アイデンティティは、インターフェイス、IP アドレス、MAC アドレスなどです。

これは、処理する機能オブジェクトを区別せずに出力を生成する、一般的なデバッグ コマンドとは対照的です。一般的なデバッグ コマンドは、多数のシステム リソースを消費し、システム パフォーマンスに影響します。

ラジオアクティブ トレース（RA）により、冗長性のレベルを高めた状態で、システムの全体にわたって目的とする動作を連鎖的に実行できます。また、複数のスレッド、プロセス、および関数呼び出しにわたって、デバッグ情報を条件に基づいて（DEBUG レベルまで、または指定のレベルまで）出力する方法を提供します。

（注）

ラジオアクティブ トレースではファーストホップ セキュリティ（FHS）がサポートされています。 ファースト ホップ セキュリティ機能の詳細については、[System Management] > [Wireless Multicast] > [Information About Wireless Multicast] > [Information About IPv6 Snooping] を参照してください。 証明書が有効でない場合、ラジオアクティブ トレース フィルタは機能しません。 メッシュ機能の問題を効果的にデバッグできるようにするため、ログの収集時に、イーサネット アドレスと無線 MAC アドレスの両方を RA トレースの条件付き MAC として追加してください。 ワイヤレス IP のデバッグを有効にするには、debug platform condition feature wireless ip ip-address コマンドを使用します。

条件付きデバッグと組み合わせた放射線トレースによって、条件に関連するすべての実行コンテキストをデバッグする単一のデバッグ 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 ディレクトリ内のトレースファイルは次の形式で配置されます。

1. Process-name_Process-ID_running-counter.timestamp.gz

   例：IOSRP_R0-0.bin_0.14239.20151101234827.gz

2. Process-name_pmanlog_Process-ID_running-counter.timestamp.bin.gz

   例：wncmgrd_R0-0.27958_1.20180902081532.bin.gz

特定のマルチキャスト受信者を特定するには、参加者または受信側クライアントの MAC アドレス、グループのマルチキャスト IP アドレスおよびスヌーピング VLAN を指定します。また、デバッグのトレース レベルを有効にします。デバッグ レベルでは、詳細なトレースとシステムへの高い可視性が提供されます。

debug platform condition feature multicast controlplane mac client-mac-addr ip group-ip-addr vlan id level debug level

トレース ファイルの推奨ワークフローの概要は次のとおりです。

1. 特定の時間帯のトレースログを要求する場合。

   たとえば 1 日。

   使用するコマンドは、次のとおりです。

   Device#show logging process wncd to-file flash:wncd.txt

2. ロケーション（/flash:）にトレースログのテキストファイルが生成されます。

3. スイッチデバイスの外にファイルをコピーします。ファイルをコピーすることによって、オフラインでトレースログが使用できます。ファイルのコピーについての詳細は、次のセクションを参照してください。

4. ロケーション（/flash:）からトレースログファイル（.txt）を削除します。これにより、他の操作に十分な領域がスイッチデバイスに確保されます。

パケットトレース機能は、クラウドソフトウェアの Cisco Catalyst 9800 シリーズ ワイヤレス コントローラのデータ プレーン パケット トレースを実行する方法について、その詳細を網羅するものです。

この機能では、次の問題が特定されます。

• 設定ミス

• キャパシティの過負荷

• トラブルシューティング中のソフトウェアのバグ

この機能により、システム内のパケットに何が生じているかが特定されます。条件付きデバッグパケットトレース機能は、ユーザー定義の条件に関するパケット単位の処理の詳細をアカウンティングおよびキャプチャするために使用されます。

次の手順を使用して、コントローラ上のパケットをトレースできます。

1. コントローラ上でトレースする必要がある、選択したパケットまたはトラフィックについて、条件付きデバッグを有効にします。

2. パケットトレースを有効にします（AP 単位またはクライアント単位）。

（注）	AP とコントローラが同じ VLAN 内にある場合は、MAC アドレスをフィルタとして使用する AP 単位の条件付きデバッグを使用する必要があります。これらが同じ VLAN 内にない場合、MAC アドレスを使用する AP 単位のパケットトレースでは、MAC アドレスが変化するため、パケットがキャプチャされません。

クライアント放射性トレース、パケットキャプチャ、およびさまざまな show コマンドの出力のログ収集は、ワイヤレスクライアントの問題の障害対応に役立ちます。以前のリリースでは、ログはさまざまな個別の手順とコマンドによって収集されていました。現在、クライアント デバッグ バンドルは、単一の debug コマンドを使用して tar ファイルに収集された、放射性トレースデバッグログ、コントロールプレーンでのパケットキャプチャ、およびクライアントに関連する show コマンドの出力を照合します。Cisco IOS XE Cupertino 17.11.1 以降、クライアント デバッグ バンドルは AP ログを既存のコントローラバンドルとともに照合します。

（注）	クライアント デバッグ バンドルは、ステートフル スイッチ オーバー（SSO）を使用した高可用性（HA）ではサポートされません。

（注）	AP コンソールで all コマンドオプションを有効にすると、コマンドはすべてのクライアントのデバッグロギングをアクティブにします。これにより、コンソールに過剰な量のログが出力される可能性があります。