How to Use Mac WiFi Diagnostics to Troubleshoot Connections

macOS includes a built-in Wireless Diagnostics tool that can capture WiFi logs, scan for interference, and identify specific problems with your connection. It is more powerful than most people realize and often pinpoints the root cause of issues in under a minute.

How to Open Wireless Diagnostics

1. Hold down the Option key on your keyboard.
2. Click the WiFi icon in the menu bar (top right of screen).
3. Select Open Wireless Diagnostics from the menu.
4. Alternatively: Spotlight Search (Cmd+Space) → type "Wireless Diagnostics" → press Return.

The Option-click menu itself is worth knowing: even without opening the app, it shows your current channel, band, RSSI, noise, and Tx rate inline. The app's extra windows live under the Window menu once it is open. This works the same on macOS Ventura, Sonoma, and Sequoia; on Monterey and earlier the app is identical, only the surrounding System Preferences naming differs.

What Each Mode Does

Mode	What It Does	Best For
Assistant (default)	Guided diagnostic - walks you through steps and shows recommendations	First-time users, general issues
Info	Shows current WiFi details - channel, band, signal strength, noise, PHY mode	Checking signal quality
Logs	Starts continuous logging of WiFi events to a file	Capturing intermittent drops
Scan	Lists all nearby networks with their channel, signal, and security type	Finding channel congestion
Performance	Real-time graphs of signal quality, transmit rate, and noise floor	Testing different locations in your home
Sniffer	Captures raw WiFi packets to a file (requires Wireshark to analyze)	Advanced debugging

How to Read the Numbers (RSSI, Noise, Tx Rate)

The Info and Performance windows - and the Option-click menu - report three values that explain most WiFi misery:

Metric	Healthy Range	What a Bad Value Means
RSSI (signal)	-50 to -65 dBm	Below -75 dBm: too far from router or too many walls
Noise	Around -90 dBm or lower	Above -80 dBm: interference from other electronics nearby
SNR (signal minus noise)	25 dB or more	Under 15 dB: drops and retries even with "full bars"
Tx Rate	Hundreds of Mbps on 5GHz up close	Far below your plan speed: the wireless link is the bottleneck

For a fast snapshot without opening any windows, run sudo wdutil info in Terminal - it prints the same SSID, channel, RSSI, noise, and Tx rate data, plus the system's captive portal and connectivity state. If signal looks fine but speeds are still poor, continue with the slow WiFi guide.

How to Use the Scan Mode to Find Channel Congestion

1. Open Wireless Diagnostics → Window menu → Scan.
2. Click Scan Now.
3. Look at the Channel column. If many networks near you share the same channel, that is causing congestion.
4. Note which 2.4GHz channels are least used (1, 6, and 11 are the only non-overlapping options).
5. Log into your router admin panel and manually set your router's 2.4GHz channel to the least congested one.
6. The Scan summary also recommends the best 2.4GHz and 5GHz channels for your environment - it does the analysis for you.

How to Capture Logs for Intermittent Drops

1. Open Wireless Diagnostics → Window menu → Logs.
2. Click Start Logging.
3. Leave it running while you use your Mac normally and wait for the next drop.
4. When it drops, click Stop Logging. The log file is saved to your Desktop or to /var/tmp depending on macOS version (in Finder, Cmd+Shift+G → /var/tmp).
5. Open the log and look for "disassociated" or "deauthenticated" events - these show exactly why the connection dropped.
6. Match what you find against the causes in the WiFi keeps disconnecting guide - power management and channel congestion produce distinctly different log signatures.

If Diagnostics Doesn't Reveal the Problem

1. Confirm the basics from Terminal - ipconfig getifaddr en0 should print your IP; ping -c 5 1.1.1.1 should get replies. An IP with no replies points at the router or gateway, not WiFi.
2. Separate DNS from connectivity - If pings succeed but websites stall, flush DNS with sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder and test name resolution with the DNS lookup tool.
3. Power-cycle the interface - networksetup -setairportpower en0 off, wait 10 seconds, networksetup -setairportpower en0 on.
4. Escalate to the full checklists - Connection refused entirely: Mac won't connect. Connection unstable: WiFi keeps disconnecting.

Frequently Asked Questions

What is a good WiFi signal strength (RSSI) on a Mac?

RSSI is shown as a negative number: closer to zero is stronger. Around -50 dBm is excellent, -60s is good, -70s is marginal, and below -80 dBm connections become slow and unstable. Compare it to the noise figure too - you want the gap between signal and noise (SNR) to be roughly 25 dB or more for reliable performance.

Where does Wireless Diagnostics save its report on a Mac?

When the Assistant finishes, it writes a compressed diagnostics archive to /var/tmp with a name beginning WirelessDiagnostics followed by a timestamp. In Finder press Cmd+Shift+G and enter /var/tmp to find it. Manual logging sessions started from the Window menu save their capture files to the same location or your Desktop depending on macOS version.

What does the 'sudo wdutil info' command show?

wdutil is the command-line companion to Wireless Diagnostics. Running sudo wdutil info in Terminal prints a live snapshot of the WiFi interface: current SSID, channel and band, RSSI and noise, transmit rate, security type, and the system's captive portal and connectivity state. It is the fastest way to read signal quality without opening any windows.

Related Guides