Troubleshoot With Wireless Debug Analyzer

Available Languages

Download Options

  • PDF     (434.9 KB)
    View with Adobe Reader on a variety of devices
  • ePub     (545.5 KB)
    View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
  • Mobi (Kindle)     (371.6 KB)
    View on Kindle device or Kindle app on multiple devices
Updated:April 5, 2023
Document ID:220344

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

    Introduction

    This document describes one of the most popular tools for wireless debug analysis hosted on cisco.com - Wireless Debug Analyzer. Wireless Debug Analyzer parses debug log files for AireOS and Cat9800 Wireless LAN Controllers. It makes it easier to troubleshoot issues with wireless client association, authentication, roaming, and connectivity issues.

    Background Information

     This tool aims to provide logical analysis based on log sequence to match against known issues. For AireOS the tool can also parse through the output of "debug client <mac1> <mac2> ..." as well as some portions of "debug aaa/webauth/mdns". For Catalyst 9800 WLC, the tool can parse through always-on traces and radio-active trace logs generated from WLC. For 9800 RA traces, there is an advanced insights dashboard that is newly added.

    9800 Advanced Debug Insights is a new insight dashboard to analyze RA traces quickly. It provides a quick summary of client roam stats, onboard time, delete reasons, and the number of client sessions per WLAN(Success & Failures). It also provides a high-level table view of all client connection attempts with a start, the end time stamp for each session, delete reason, Auth method, and AP name, and further detailed view can also be seen with all the transactions between clients, AP, WLC in a sequence diagram.  

    Standard Wireless debugs produce tons of lines of information which takes a long time to collect, analyze and eventually determine the cause.

    Approximately 35% of SRs (Volume) is to troubleshoot client issues (drops, disconnects, roam failures). To analyze them manually is time and bandwidth-consuming. Manual analysis is prone to errors. The dashboard gives a holistic & detailed view.

    Access

    The standalone tool can be accessed here: https://cway.cisco.com/wireless-debug-analyzer/

    Steps :

    1. Upload the debug file 

    2. Hit the Parse button (Table View)

    3. Click "Show Advanced Debug Insights" (Only for C9800 RA Traces)

    Dashboards

    The tool provides Various dashboard views to help with the analysis.

    madc_1-1680698991746

    1. Dashboard View

    Picture1

    2.  Client Session Details (Just Scroll to the bottom of the page)

    Picture2

    3. Client Session Detailed - Sequence Diagram

    Picture3

    Access Tool from C9800 Web Interface 

    One could collect RA Trace from C9800 WLC  "troubleshoot" section and feed it to the Debug Analyzer:

    madc_0-1680698715809

    Revision History

    Revision Publish Date Comments
    1.0
    05-Apr-2023
    Initial Release
    TAC Authored

    Contributed by Cisco Engineers

    • Shankar Ramanathan
      TAC
    • Madhuri C
      TAC

    Was this Document Helpful?

    FeedbackFeedback

    Contact Cisco

    This Document Applies to These Products