show ap spectrum channel-metrics

show ap spectrum channel-metrics {ap-name |ip-addr | ip6-addr } [freq-band {2.4ghz | 5ghz | 6ghz}]

Description

This command shows channel quality, availability, and utilization metrics as seen by a spectrum monitor.

Parameter

Description

ap-name

Name of the spectrum monitor for which you want to view spectrum information.

ip-addr

IP address of the spectrum monitor.

ip6-addr

IPv6 address of the spectrum monitor.

freq-band {2.4ghz | 5ghz} ( 之前的版本ArubaOS8.9.0.0)

View information for a specific radio type, either 2.4 GHz or 5 GHz.

freq-band {2.4ghz | 5ghz | 6ghz} ( ForArubaOS8.9.0.0or later versions)

View information for a specific radio type, either 2.4 GHz, 5 GHz, or 6 GHz.

NOTE:The 6ghz sub-parameter is applicable to Wi-Fi 6E APs only.

这个图表显示通道利用率达ta, showing the percentage of each channel that is currently being used by Wi-Fi devices, and the percentage of each channel being used by non-Wi-Fi devices and 802.11 adjacent channel interference (ACI).

ACI refers to the interference on a channel created by a transmitter operating in an adjacent channel. A transmitter on a nonadjacent or partially overlapping channel may also cause interference, depending on the transmit power of the interfering transmitter and/or the distance between the devices. In general, ACI may be caused by a Wi-Fi transmitter or a non-Wi-Fi interferer. However, whenever the term ACI appears in Spectrum Analysis graphs, it refers to the ACI caused by Wi-Fi transmitters. The channel utilization option in the Channel Metrics Chart shows the percentage of the channel utilization due to both ACI and non-Wi-Fi interfering devices. Unlike the ACI shown in theshow ap spectrum interference-poweroutput, the ACI shown in this graph indicates the percentage of channel time that is occupied by ACI or unavailable for Wi-Fi communication due to ACI.

The Channel Metrics table can also show channel availability, the percentage of each channel that is available for use, or display the current relative quality of selected channels in the 2.4 GHz or 5 GHz radio bands. In the spectrum analysis feature, channel quality is a relative measure that indicates the ability of the channel to support reliable Wi-Fi communication. Channel quality, which is represented as a percentage in this chart, is a weighted metric derived from key parameters that can affect the communication quality of a wireless channel, including noise, non- Wi-Fi (interferer) utilization and duty-cycles, and certain types of retries. Note that channel quality is not directly related to Wi-Fi channel utilization, as a higher quality channel may or may not be highly utilized.

A hybrid AP on a 20 MHz channel will see 40 MHz Wi-Fi data as non- Wi-Fi data.

Example

The output of this example shows part of the channel metrics table for channels seen by the spectrum monitor ap123:

(host) [mynode] #show ap spectrum channel-metrics ap-name ap123 freq-band 2.4ghz

Channel Metrics Table

---------------------

Channel Quality(%) Availability(%) Utilization(%) WiFi Util(%) Interference Util(%)

------- ---------- --------------- -------------- ------------ --------------------

1 97 57 43 40 3

2 80 58 42 22 20

3 63 58 42 5 37

4 71 57 43 16 27

5 88 54 46 36 10

6 98 51 49 47 2

7 88 54 46 35 11

8 69 56 44 14 30

9 60 57 43 3 40

10 30 29 71 1 70

11 0 0 100 0 100

12 25 50 50 0 50

13 50 99 1 0 1

14 99 99 1 0 1

1+/5- 63 54 46 36 10

2+/6- 63 51 49 47 2

3+/7- 63 51 49 47 2

4+/8- 69 51 49 47 2

5+/9- 60 51 49 47 2

6+/10- 30 29 71 1 70

7+/11- 0 0 100 0 100

The output of this command includes the following information:

Description

channel

An 802.11a or 802.11g radio channel.

Quality(%)

Current relative quality of selected channels in the 802.11a or 802.11g radio bands, as determined by the percentage of packet retries, the current noise floor, and the duty cycle for non- Wi-Fi devices on that channel.

Availability(%)

The percentage of the channel currently available for use.

Utilization(%)

The percentage of the channel being used.

WiFi Util(%)

The percentage of the channel currently being used by Wi-Fi devices.

Interference Util(%)

The percentage of the channel currently being used by non- Wi-Fi interference + Wi-Fi ACI (Adjacent Channel Interference)

Related Commands

Command

Description

ap spectrum local-override

Converts an AP or AM into a spectrum monitor by adding it to the spectrum local-override list.

rf dot11a-radio-profilemodespectrum-mode

Sets an 802.11a radio so that the device operates as a spectrum monitor and can send spectrum analysis data to a desktop or laptop client.

rf dot11g-radio-profilemodespectrum-mode

Sets an 802.11g radio so that the device operates as a spectrum monitor and can send spectrum analysis data to a desktop or laptop client.

Command History

Release

Modification

ArubaOS8.9.0.0

The6 ghzsub-parameter was introduced forfreq-bandparameter. (ForArubaOS8.9.0.0 or later versions)

ArubaOS8.0.0.0

Command introduced.

Command Information

Platforms

License

Command Mode

All platforms.

Base operating system.

Enable or Config mode on themanaged deviceorcontrollerwhere the AP terminates.