Monitor Aruba Central wireless infrastructure
Add Aruba Central orchestrator nodes for monitoring, monitor performance metrics, access points, SSIDs for the wireless controller, switches, and wireless devices.
What does NPM monitor for Aruba Central infrastructure?
Monitored WAP entity | Metrics |
---|---|
Wireless Controller |
|
Access Point |
|
Client |
|
Monitored switch/wireless entity | Metrics |
---|---|
Inventory Device |
|
CPU/ Memory Load |
|
Device Info |
|
Response Time and Status |
|
IP Addresses |
|
Network Topology |
|
Network Topology Port/ Vlan |
|
Interfaces status and discovery |
|
Interface Statistics |
|
These metrics are polled via a batch request. Polling additional metrics would require additional requests and might result in exceeding the API requests limit. See details on Aruba Central Polling request.
Requirements
- Aruba Central account with at least the Aruba Central View Only role permissions. See Aruba Central User Roles...
Limitations
-
Aruba Central has a limit of 5,000 API calls per day. As a consequence:
-
Performance metrics, such as response time or availability are polled via REST API authorization requests. As a result, the response times are longer than for other nodes, and thus using default thresholds might result in marking the node status as critical. To address this, customize the Response Time thresholds when adding the nodes.
-
Utilization metrics are not collected - Utilization requests are too expensive request wise and could easily drain the daily limit of 5000 requests, and thus are not collected.
-
When the daily limit of requests is reached, non-status polling stops. You can see an event and an error in the Aruba Central log.
-
-
If you have SSO enabled, create the token for accessing Aruba Central’s REST API using the offline approach. Then, refresh the token API used in your automated workflows. See Obtaining Token Using Offline Token Mechanism in Aruba documentation.
Before you begin
Prepare your Aruba Central customer and client details. You will need this information when adding your Aruba Central infrastructure for monitoring.
Log in to the Aruba Central management console and gather the following details:
- Customer ID
- Username and password
- Client ID
- Client Secret
- Base URL
See Aruba Central API for details about where to find the details.
Add Aruba Central infrastructure to NPM
-
Log in to the SolarWinds Platform Web Console as an administrator.
-
Click Settings > Manage Nodes, and click Add a Node.
-
In Polling Method, select Orchestrators: API.
The Polling Hostname or IP Address is disabled and arubanetworks.com is used as the default host name.
-
Select Aruba Central Devices and provide the required information. Log in to the Aruba Management Console to find out the following details:
- Customer ID
- Username
- Password
- Client ID
- Client Secret
- Base URL
These details are necessary to load groups.
-
If you have multiple groups in Aruba Central, click Get Groups, and select a group. If you have only one group, it is selected by default.
Polling Aruba Central uses the global HTTP proxy settings. To change the defaults, click the Configure your HTTP proxy link.
-
Specify what you want to poll for Aruba Central devices. Select or clear the following boxes to regulate the number of API requests and mitigate the rate limit for Aruba Central.
- Enable Topology polling for devices managed as API-only nodes: Enable this to poll LLDP data required for topology calculation from Aruba Central switches/wireless
- Enable polling for Wireless devices: Enable/disable to poll wireless access points
- Enable Interface(s) status and statistics polling for API Only Monitored Switch Nodes: Enable or disable polling for switch interface (ports) status and statistics.
- Enable Interface(s) status and statistics polling for API Only Monitored Wireless Nodes: Enable or disable polling for wireless interface (ports) status and statistics.
-
Review and adjust the device properties.
-
Review your Aruba Central user and client details, as well as proxy settings.
-
To edit how often the node status, or monitored statistics are updated, change the values in the Polling area.
Aruba Central supports 5000 requests a day. This limit is relevant for the value in Collect Statistics Every field. A single poll might require up to 4 requests, be aware that if you poll statistics more frequently than the default settings or if NPM is not the only piece of software using the requests, you might get gaps in data when the daily limit is exceeded. See Aruba Central API Gateway for details about the Aruba API calls per day limit.
-
Enter values for custom properties for the node.
The Custom Properties area is empty if you have not defined any custom properties for the monitored nodes. See "Add custom properties to nodes" in the SolarWinds Platform Administrator Guide.
-
To adjust when the status of the node changes to Warning or Critical, edit alerting thresholds for the metric. Select the Override box and set thresholds for the node.
Response times for Aruba Central nodes might be 1-2 seconds. Consider adjusting the thresholds accordingly.
-
-
Click OK, Add Node.
The Aruba Central is now added as a node. After the first poll, you can see the data from the device in the SolarWinds Platform Web Console.
On the Manage Nodes view, click the added node to see the node details in the Wireless Controller view, or drill down into thin access points listed on the view. Check Node Details to verify that the Machine Type of the new device is ArubaCentral Cloud Orchestrator.
Add Aruba devices connected to the orchestrator
When you have added the orchestrator for monitoring, you need to add switches and wireless devices you want to monitor.
-
In SolarWinds Platform Web Console, click Settings > Manage Nodes.
-
On the Manage Nodes view, click the added orchestrator node.
-
On the Orchestrator Details view, click Discover ArubaCentral Devices in the Management widget.
-
On the Request Hostnames and APIs, select what you want to add and click Continue. Hostnames and IP addresses for selected devices are collected.
-
Complete the wizard by clicking Discover on the last tab. The wizard discovers the ArubaCentral devices connected to the orchestrator.
SolarWinds recommends that you do not monitor VoIP interfaces or NULL interfaces.
-
Discovered devices are listed in the Network Sonar Results wizard. Complete the wizard to add devices for monitoring.
When you finish the wizard, you can see the added switches/wireless devices on the Manage Nodes view, added as nodes.
Orchestrator Inventory
You can see the list of ArubaCentral devices connected to managed orchestrators in the Orchestrator Inventory widget. Devices managed by SolarWinds Observability Self-Hosted are marked in the Managed by Platform column.
To add unmanaged devices, click the Discover ArubaCentral Devices button and add the devices for monitoring.
Request frequency and limits
The total number of requests per day can be calculated by multiplying requests per poll, the number of polls requested per hour and the number of hours in a day.
In formula terms:
Total requests per day = Requests per poll * Polls per hour * Hours per day
The per-day requests below are calculated under the assumption that no pagination occurs. If you have pagination set up, each page counts as a request.
Request frequency and limits
Requests | Value | Recommendation | Notes |
---|---|---|---|
Aruba Central daily requests | 5,000 requests per day | Reset at midnight GMT | |
Status Poll request quota | 1 request per poll | 600 seconds by default | 1*6*24=144 requests per day |
Stats Collection Requests | 4 requests per poll | 30 mins by default | 4*2*24=192 requests per day |
Device Status Collection Requests | 2 requests per poll | 10 mins by default | 2*6*24=288 requests per day |
Device Response Time Collection | 2 requests per poll | 10 minutes by default | 2*6*24=288 requests per day |
CPU Memory Collection | 2 requests per poll | 30 minutes by default | 2*2*24=96 requests per day |
Device details Collection | 2 requests per poll | 30 minutes by default | 2*2*24=96 requests per day |
IP Address Collection | 2 requests per poll | 30 minutes by default | 2*2*24=96 requests per day |
Orchestrator Inventory Collection | 2 requests per poll | 30 minutes by default | 2*2*24=96 requests per day |
Topology Collection | 3 requests per poll | 120 minutes by default | 3*0.5*24=36 requests per day |
Interfaces Status Poll | 2 requests per poll | switches: 10 minutes by default | 2*6*24=288 requests per day |
Wireless Status Poll | 10 minutes by default | 2*6*24=288 requests per day. | |
Interfaces Stats Poll | 1 request per poll | 5 minutes by default | 1*12*24=288 requests per day |
Wireless Stats Collection | 10 minutes by default | 1*6*24=144 requests per day. | |
Interfaces Rediscovery Poll | 1 request per poll | Switches: 240 minutes by default | 1*0.25*24=6 requests per day |
Wireless Stats Collection | 240 minutes by default | 1*0.25*24=6 requests per day. | |
Interfaces Status Poll |
2 requests per poll |
Switches: 10 minutes by default |
2*6*24=288 requests per day |
Wireless Stats Collection | 10 minutes by default | 1*6*24=144 requests per day |
API calls used for polling wireless access points
API request | Purpose |
---|---|
/oauth2/authorize/central/api/login | Login and status poller |
/oauth2/authorize/central/api | Obtaining an authorization code |
/oauth2/token | Acquiring or refreshing the access token |
/monitoring/v2/aps | Statistics collection poller - gets information on APs and wireless interfaces. |
/monitoring/v1/clients/wireless | Statistics collection poller - gets information on clients. |
/rapids/v1/rogue_aps | Statistics collection poller - gets information on AP rogues |
/monitoring/v2/bssids | Statistics collection poller - gets information on SSIDs |
/configuration/v2/groups | Adding or editing node's “Get Groups” |
/monitoring/v1/switches | List Switches |
/monitoring/v1/switches/${DeviceSerial}/ports | Statistics collection poller - gets information on AP rogues |
/monitoring/v3/aps/bandwidth_usage | Get the average bandwidth usage for access points over a time |
/monitoring/v1/aps/${DeviceSerial} | Get AP details |
/topology_external_api/${SiteId} | Get LLDP data required for topology calculation |
/monitoring/v1/switches/${DeviceSerial}/ports | Get Port details |
/monitoring/v1/switches/${DeviceSerial}/vlan | Get VLan details |
Manage API rate limits
Due to the Aruba Central rate limit of 5,000 API calls per day, polling for switch interfaces (ports) and wireless interfaces (ports) status and statistics may exceed the daily threshold.
To mitigate this, specify what you want to poll and how frequently:
- Enable or disable polling interface status or statistics.
- Customize polling intervals for polling interface data (globally or for individual devices)
- Customize the orchestrator polling interval.
Enable/Disable interface status/statistics pollers
Select checkboxes to regulate the number of API request and mitigate the rate limit for Aruba Central.
- Enable Topology polling for devices managed as API-only nodes: Enable this to poll LLDP data required for topology calculation from Aruba Central switches/wireless
- Enable polling for Wireless devices: Enable/disable to poll wireless access points
- Enable Interface(s) status and statistics polling for API Only Monitored Switch Nodes: Enable or disable polling for switch interface (ports) status and statistics.
- Enable Interface(s) status and statistics polling for API Only Monitored Wireless Nodes: Enable or disable polling for wireless interface (ports) status and statistics.
Customize Aruba Central interface poller intervals
New polling intervals settings to override default poll intervals for Aruba Central pollers in order to decrease data collection frequency and help overcome API rate limit issues.
The interface status and statistics poller intervals are applied only if the respective pollers are enabled. To enable/disable pollers, see Enable/Disable interface status/statistics pollers.
Global Polling Settings
Define global settings for interface status/statistics/rediscovery polling that apply to both switches and access points (APs).
-
In the SolarWinds Platform Web Console, click Settings > All Settings > Polling Settings.
-
On Polling settings, find the Aruba Central section, and specify polling intervals.
-
Submit your changes.
Specify polling settings for individual devices
You can override global polling settings for individual switches and AP.
-
Click Settings > Manage Nodes.
-
Find the switch/AP you want to edit.
-
Click Edit.
-
Scroll down to ArubaCentral settings, select the Override global value for the polling interval you want to change, and provide the required polling interval.
-
Submit your changes.
Your changes are applied. If a box is selected, the globally set polling interval for this device is overriden with your entry. If the box is cleared, the global polling settings are used for polling the device.
Modify Aruba Central orchestrator polling intervals
By default, the node status polling is set to 600 secs (10 mins) and statistics collection to 30 mins. You can modify these polling settings when adding or editing the orchestrator node.
-
Click Settings > Manage Nodes.
-
Find the orchestrator you want to edit.
-
Click Edit Properties.
-
Scroll down to Polling and adjust the frequency for polling node status and statistics.
-
Submit your changes.
Troubleshooting
To help diagnose and resolve issues with Aruba Central devices in NPM, configure logging level for relevant logs. In th Log Adjuster, set the recommended level for individual logs. See Adjust logging levels with the Log Adjuster for details.
Logs for | Logs include | Default log path | Recommended logging level |
---|---|---|---|
Declarative Wireless Collector | Details on processing wireless data | C:\ProgramData\SolarWinds\Logs\Orion\Wireless\Declarative\Wireless.Declarative.PollersJobs_[#####].log
|
WARNING |
Collector Service | Details on processing of polled data and storing into the DB by collector | C:\ProgramData\SolarWinds\Collector\Logs\Collector.Service.log
|
ERROR |
Interfaces Collector | Details about the interface collector | C:\ProgramData\SolarWinds\Logs\Orion\Interfaces\Interfaces.Collector.Jobs_[%processid].log
|
WARNING |
Core Poller | Details of poller execution of API requests and core jobs | C:\ProgramData\SolarWinds\Logs\Orion\Core.Collector.Jobs_[%processid].log
|
ERROR |