<!--startmeta
custom_edit_url: "https://github.com/netdata/netdata/edit/master/src/go/plugin/go.d/collector/snmp/npm-catalog/integrations/aruba_wireless_controller.md"
meta_yaml: "https://github.com/netdata/netdata/edit/master/src/go/plugin/go.d/collector/snmp/npm-catalog/metadata.yaml"
sidebar_label: "Aruba Wireless Controller"
learn_status: "Published"
learn_rel_path: "Network Performance Monitoring/Device Metrics/Integrations"
keywords: ['aruba', 'wireless', 'controller', 'snmp', 'wlc', 'npm']
message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NPM CATALOG metadata.yaml FILE"
endmeta-->

<!-- markdownlint-disable-file -->

# Aruba Wireless Controller


<img src="https://netdata.cloud/img/SNMP.png" width="150"/>


Plugin: go.d.plugin
Module: snmp

<img src="https://img.shields.io/badge/maintained%20by-Netdata-%2300ab44" />

## Overview

Monitor Aruba Wireless Controller (wlc) with Netdata over SNMP. Netdata recognizes the device automatically by its `sysObjectID` (recognized across 38 device identifiers) and collects the metrics this profile declares — on top of the generic SNMP baseline — with no manual OID configuration.

Netdata's SNMP collector matches the device to the **aruba-wireless-controller.yaml** profile via `sysObjectID`/`sysDescr`, then polls the OIDs it declares.

This integration is supported on all platforms.

This integration supports multiple instances configured side-by-side.


### Default Behavior

#### Auto-Detection

Auto-detected as Aruba Wireless Controller via sysObjectID/sysDescr.

#### Limits

The default configuration for this integration does not impose any limits.

#### Performance Impact

The default configuration for this integration is not expected to impose a significant performance impact on the system.

## Setup


You can configure the **snmp** collector in two ways:

| Method                | Best for                                                                                 | How to                                                                                                                                 |
|-----------------------|------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
| [**UI**](#via-ui)     | Fast setup without editing files                                                         | Go to **Nodes → Configure this node → Collectors → Jobs**, search for **snmp**, then click **+** to add a job. |
| [**File**](#via-file) | If you prefer configuring via file, or need to automate deployments (e.g., with Ansible) | Edit `go.d/snmp.conf` and add a job.                                                                        |

:::important

UI configuration requires paid Netdata Cloud plan.

:::


### Prerequisites

#### SNMP access

SNMP must be enabled on the device and reachable from the Netdata Agent acting as the site's SNMP hub.


### Configuration

#### Options

Configure the SNMP collector with the device hostname and SNMP credentials. See the SNMP collector reference for all options.


#### via UI

Configure the **snmp** collector from the Netdata web interface:

1. Go to **Nodes**.
2. Select the node **where you want the snmp data-collection job to run** and click the :gear: (**Configure this node**). That node will run the data collection.
3. The **Collectors → Jobs** view opens by default.
4. In the Search box, type _snmp_ (or scroll the list) to locate the **snmp** collector.
5. Click the **+** next to the **snmp** collector to add a new job.
6. Fill in the job fields, then click **Test** to verify the configuration and **Submit** to save.
    - **Test** runs the job with the provided settings and shows whether data can be collected.
    - If it fails, an error message appears with details (for example, connection refused, timeout, or command execution errors), so you can adjust and retest.


#### via File

The configuration file name for this integration is `go.d/snmp.conf`.

The file format is YAML. Generally, the structure is:

```yaml
update_every: 1
autodetection_retry: 0
jobs:
  - name: some_name1
  - name: some_name2
```
You can edit the configuration file using the [`edit-config`](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/configuration/README.md#edit-configuration-files) script from the
Netdata [config directory](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/configuration/README.md#locate-your-config-directory).

```bash
cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config go.d/snmp.conf
```

##### Examples
There are no configuration examples.



## Alerts

There are no alerts configured by default for this integration.



## Metrics

On top of the **generic SNMP baseline** (the *Generic SNMP Device* integration — interfaces, system, IP/TCP/UDP, host resources), this Aruba Wireless Controller profile adds the metrics below. Each is collected **only where the device exposes the matching OID** — inclusion means the profile requests it; availability depends on the device model and software.

**57 metrics** in 11 groups; each row is a chart context usable in alerts.

| Group | Metrics |
|---|---|
| Network / HighAvailability | 4 |
| Network / Interface | 4 |
| Network / Packet | 1 |
| Network / Wireless | 23 |
| System / CPU | 1 |
| System / HighAvailability | 3 |
| System / Memory | 1 |
| System / Storage | 2 |
| System / Uptime | 1 |
| System / User | 5 |
| Uncategorized | 12 |

### Network / HighAvailability

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_haAPHbtTunnels` | `{tunnel}` | per ha_membership | Number of AP hbt GRE tunnels |
| `snmp.device_prof_haActiveVapTunnels` | `{tunnel}` | per ha_membership | Number of active per VAP GRE tunnels |
| `snmp.device_prof_haStandbyVapTunnels` | `{tunnel}` | per ha_membership | Number of standby per VAP GRE tunnels |
| `snmp.device_prof_haTotalVapTunnels` | `{tunnel}` | per ha_membership | Total number of per VAP GRE tunnels |

### Network / Interface

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_ifAdminStatus` | `{status}` | per interface, interface | Current administrative state of the interface |
| `snmp.device_prof_ifHighSpeed` | `bit/s` | per interface, interface | Estimate of the interface's current bandwidth |
| `snmp.device_prof_ifNumber` | `{interface}` | device | Number of network interfaces regardless of their current state present on this system |
| `snmp.device_prof_ifOperStatus` | `{status}` | per interface, interface | Current operational state of the interface |

### Network / Packet

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_wlsxSysExtPacketLossPercent` | `%` | device | Packet loss percentage |

### Network / Wireless

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_apBSSBwRate` | `kbit/s` | per ap_stats_channel | Bandwidth rate in Kbps of the ap on this BSSID |
| `snmp.device_prof_apBSSFrameFragmentationRate` | `%` | per ap_stats_channel | Frame fragmentation rate on this BSSID |
| `snmp.device_prof_apBSSFrameLowSpeedRate` | `%` | per ap_stats_channel | Frame low speed rate on this BSSID |
| `snmp.device_prof_apBSSFrameNonUnicastRate` | `%` | per ap_stats_channel | Frame non unicast packet rate on this BSSID |
| `snmp.device_prof_apBSSFrameReceiveErrorRate` | `%` | per ap_stats_channel | Frame receive error rate on this BSSID |
| `snmp.device_prof_apBSSFrameRetryRate` | `%` | per ap_stats_channel | Frame retry rate on this BSSID |
| `snmp.device_prof_apBSSRxBytes` | `By/s` | per ap_stats_channel | Total bytes received by the ap on this BSSID |
| `snmp.device_prof_apBSSRxPackets` | `{packet}/s` | per ap_stats_channel | Total packets received by the ap on this BSSID |
| `snmp.device_prof_apBSSTxBytes` | `By/s` | per ap_stats_channel | Total bytes transmitted by the ap on this BSSID |
| `snmp.device_prof_apBSSTxPackets` | `{packet}/s` | per ap_stats_channel | Total packets transmitted by the ap on this BSSID |
| `snmp.device_prof_apChannelBwRate` | `kbit/s` | per ap_stats_channel | Bandwidth rate in Kbps of the apChannel |
| `snmp.device_prof_apChannelFrameFragmentationRate` | `%` | per ap_stats_channel | Number of fragments as a percentage of the total packets transmitted on this channel |
| `snmp.device_prof_apChannelFrameLowSpeedRate` | `%` | per ap_stats_channel | Number of low data rate packets as a percentage of the total packets transmitted and received on this channel |
| `snmp.device_prof_apChannelFrameNonUnicastRate` | `%` | per ap_stats_channel | Number of broadcast and multicast packets as a percentage of the total packets transmitted on this channel |
| `snmp.device_prof_apChannelFrameReceiveErrorRate` | `%` | per ap_stats_channel | Number of error packets as a percentage of the total packets received on this channel |
| `snmp.device_prof_apChannelFrameRetryRate` | `%` | per ap_stats_channel | Number of retry packets as a percentage of the total packets transmitted and received on this channel |
| `snmp.device_prof_apChannelNoise` | `dB` | per ap_essid, ap_phy_type, ap_type, ap_current_channel, ap_load_balancing | Noise on the channel |
| `snmp.device_prof_apSignalToNoiseRatio` | `dB` | per ap_essid, ap_phy_type, ap_type, ap_current_channel, ap_load_balancing | Signal to noise ratio for the BSSID |
| `snmp.device_prof_wlanStaRSSI` | `dB` | per wlan_sta_phy_type, wlan_sta_access_point_essid, wlan_sta_channel, wlan_sta_vlan_id, wlan_sta_is_authenticated, wlan_sta_is_associated, wlan_sta_ht_mode | Signal to noise ratio for the station |
| `snmp.device_prof_wlanStaRxBytes64` | `By` | per wlan_sta_channel_num | Number of bytes received by this station, 64-bit value |
| `snmp.device_prof_wlanStaTransmitRate` | `bit/s` | per wlan_sta_phy_type, wlan_sta_access_point_essid, wlan_sta_channel, wlan_sta_vlan_id, wlan_sta_is_authenticated, wlan_sta_is_associated, wlan_sta_ht_mode | Transmit rate with which the station is associated with this system |
| `snmp.device_prof_wlanStaTxBytes64` | `By` | per wlan_sta_channel_num | Number of bytes transmitted by this station, 64-bit value |
| `snmp.device_prof_wlanStaUpTime` | `cs` | per wlan_sta_phy_type, wlan_sta_access_point_essid, wlan_sta_channel, wlan_sta_vlan_id, wlan_sta_is_authenticated, wlan_sta_is_associated, wlan_sta_ht_mode | Time since the station associated to the current BSSID |

### System / CPU

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_cpu_usage` | `%` | device | The current CPU utilization |

### System / HighAvailability

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_haActiveAPs` | `{access_point}` | device | Number of active APs |
| `snmp.device_prof_haStandbyAPs` | `{access_point}` | device | Number of standby APs |
| `snmp.device_prof_haTotalAPs` | `{access_point}` | device | Total number of APs |

### System / Memory

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_memory_usage` | `%` | device | Memory usage percentage |

### System / Storage

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_sysXStorageSize` | `MBy` | per sys_x_storage_type, sys_x_storage_name | Size of the storage filesystem in MB |
| `snmp.device_prof_sysXStorageUsed` | `MBy` | per sys_x_storage_type, sys_x_storage_name | Size of the storage filesystem in MB |

### System / Uptime

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_systemUptime` | `s` | device | Time since the system was last rebooted or powered on. |

### System / User

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_wlsxNumOfUsers8021x` | `{user}` | device | Number of 802.1x users |
| `snmp.device_prof_wlsxNumOfUsersCP` | `{user}` | device | Number of Captive Portal users |
| `snmp.device_prof_wlsxNumOfUsersMAC` | `{user}` | device | Number of MAC users |
| `snmp.device_prof_wlsxNumOfUsersStateful8021x` | `{user}` | device | Number of stateful 802.1x users |
| `snmp.device_prof_wlsxNumOfUsersVPN` | `{user}` | device | Number of VPN users |

### Uncategorized

| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
| `snmp.device_prof_lldpStatsRemTablesAgeouts` | — | device |  |
| `snmp.device_prof_lldpStatsRemTablesDeletes` | — | device |  |
| `snmp.device_prof_lldpStatsRemTablesDrops` | — | device |  |
| `snmp.device_prof_lldpStatsRemTablesInserts` | — | device |  |
| `snmp.device_prof_lldpStatsRemTablesLastChangeTime` | — | device |  |
| `snmp.device_prof_lldpStatsRxPortAgeoutsTotal` | — | per lldp_loc_port_num |  |
| `snmp.device_prof_lldpStatsRxPortFramesDiscardedTotal` | — | per lldp_loc_port_num |  |
| `snmp.device_prof_lldpStatsRxPortFramesErrors` | — | per lldp_loc_port_num |  |
| `snmp.device_prof_lldpStatsRxPortFramesTotal` | — | per lldp_loc_port_num |  |
| `snmp.device_prof_lldpStatsRxPortTLVsDiscardedTotal` | — | per lldp_loc_port_num |  |
| `snmp.device_prof_lldpStatsRxPortTLVsUnrecognizedTotal` | — | per lldp_loc_port_num |  |
| `snmp.device_prof_lldpStatsTxPortFramesTotal` | — | per lldp_loc_port_num |  |
