Ruckus Smartzone
Overviewβ
Ruckus SmartZone network controllers simplify the complexity of scaling and managing wired switches, and wireless access points through a common interface to support private-cloud network-as-a-service (NaaS) offerings in addition to general enterprise networks.
Plugin-Pack assetsβ
Monitored objectsβ
- Ruckus Access Point
- Ruckus Controllers
Discovery rulesβ
Rule name | Description |
---|---|
Net-Ruckus-Smartzone-SNMP-Ap-Name | Discover access point attached to your controller |
Net-Ruckus-Smartzone-SNMP-Disk-Name | Discover storage point attached to your controller |
Net-Ruckus-Smartzone-SNMP-Traffic-Name | Discover interfaces attached to your controller |
Monitored metricsβ
- Access-Point
- Cpu
- Interfaces
- Load
- Memory
- Storage
- System
Metric name | Description |
---|---|
connection_status | The connection status. |
config_status | The registration status, which could either be pending, approved, rejected or swapped. |
registration_status | The AP configuration status. |
accesspoint.connection.client.devices.authorized.count | The number of stations. Unit: Count |
accesspoint.traffic.in.bitspersecond | Incoming traffic going through the access point. Unit: bits/second |
accesspoint.traffic.out.bitspersecond | Outgoing traffic going through the access point. Unit: bits/second |
Metric name | Description |
---|---|
cpu.utilization.percentage | CPU utilization. Unit : % |
core.cpu.utilization.percentage | Per Core CPU utilization. Unit : % |
Metric name | Description |
---|---|
status | Status of the interface |
interface.traffic.in.bitspersecond | Incoming traffic going through the interface. Unit: bits/second |
interface.traffic.out.bitspersecond | Outgoing traffic going through the interface. Unit: bits/second |
interface.packets.in.error.percentage | Incoming errored packets going through the interface. Units: % |
interface.packets.in.discard.percentage | Incoming discarded packets going through the interface. Units: % |
interface.packets.out.error.percentage | Outgoing errored packets going through the interface. Units: % |
interface.packets.out.discard.percentage | Outgoing discarded packets going through the interface. Units: % |
Metric name | Description |
---|---|
load1 | System load 1 minute-sample |
load5 | System load 5 minutes-sample |
load15 | System load 15 minutes-sample |
Metric name | Description |
---|---|
memory.usage.bytes | Memory usage on the device. Unit : Bytes |
memory.free.bytes | Free memory on the device. Unit : Bytes |
memory.usage.percentage | Percentage of Memory usage on the device. Unit : % |
memory.buffer.bytes | Buffered Memory allocation. Unit : Bytes |
memory.cached.bytes | Cached Memory allocation. Unit : Bytes |
memory.shared.bytes | Shared Memory allocation. Unit : Bytes |
Metric name | Description |
---|---|
storage.space.usage.bytes | Used space on a disk partition. Unit: Bytes |
Metric name | Description |
---|---|
system.connection.accesspoints.count | The number of APs. Unit: Count |
system.connection.client.devices.authorized.count | The number of associated clients. Unit: Count |
system.traffic.in.bitspersecond | Incoming traffic going through the system. Unit: bits/second |
system.traffic.out.bitspersecond | Outgoing traffic going through the system. Unit: bits/second |
Prerequisitesβ
Ruckus device configurationβ
To use this pack, the SNMP service must be properly configured on your Ruckus device. Ruckus provides an official documentation to achieve this: http://docs.ruckuswireless.com/smartzone/3.6.1/sz100-vsze-administrator-guide/GUID-F08BF334-2116-47A5-900C-B6AA4FC5E62A
Network flowβ
Your centreon server must be able to reach the Ruckus device over UDP/161 SNMP port.
Setupβ
- Online License
- Offline License
- Install the Centreon Plugin package on every Centreon poller expected to monitor Ruckus Smartzone ressources:
yum install centreon-plugin-Network-Ruckus-Smartzone-Snmp
- On the Centreon Web interface, install the 'Ruckus Smartzone' Centreon Plugin-Pack on the "Configuration > Plugin Packs > Manager" page
- Install the Centreon Plugin package on every Centreon poller expected to monitor Ruckus Smartzone ressources:
yum install centreon-plugin-Network-Ruckus-Smartzone-Snmp
- Install the Centreon Plugin-Pack RPM on the Centreon Central server:
yum install centreon-pack-network-ruckus-smartzone-snmp.noarch
- On the Centreon Web interface, install the 'Ruckus Smartzone' Centreon Plugin-Pack on the "Configuration > Plugin Packs > Manager" page
Configurationβ
- Log into Centreon and add a new Host through "Configuration > Hosts".
- Apply the template "Net-Ruckus-Smartzone-SNMP-custom" and configure the 'SNMP Community' and 'SNMP Version' fields to match the device configuration.
When using SNMP v3, set extra parameters with SNMPEXTRAOPTIONS macro :
Mandatory | Nom | Description |
---|---|---|
SNMPEXTRAOPTIONS | Any extra option you may want to add to the command (eg. a --verbose flag) |
FAQβ
How do I test my configuration through the CLI and what do the main parameters stand for ?β
Once the Centreon plugin installed, you can test it logging with the centreon-engine user:
/usr/lib/centreon/plugins//centreon_ruckus_smartzone_snmp.pl \
--plugin=network::ruckus::smartzone::snmp::plugin \
--mode=cpu \
--hostname=ruckus.int.centreon.com \
--snmp-version='2c' \
--snmp-community='ruckus_smartzone' \
--verbose
The command above checks the CPU utilization of your Ruckus box (--mode=cpu
). You must always define the IP address/FQDN of the device (--hostname=ruckus.int.centreon.com
) as well as the SNMP versions and community (--snmp-version='2c' --snmp-community='ruckus_smartzone'
)
You can display all modes that come with the plugin with the command below:
/usr/lib/centreon/plugins//centreon_ruckus_smartzone_snmp.pl \
--plugin=network::ruckus::smartzone::snmp::plugin \
--list-mode
You can display options of a specific mode by using the --help
flag. Here is an example to display cpu mode parameters:
/usr/lib/centreon/plugins//centreon_ruckus_smartzone_snmp.pl \
--plugin=network::ruckus::smartzone::snmp::plugin \
--mode=cpu \
--help
UNKNOWN: SNMP GET Request : Timeoutβ
This message generally means that you are not using the right SNMP version or community. It could also indicate that a third-party device like a firewall is blocking the SNMP UDP/161 request.
UNKNOWN: SNMP GET Request : Cant get a single value.β
This error message often refers to the following issues:
- the Ruckus device doesn't support the MIB used by the plugin
- the targeted SNMP OID cannot be fetched because of insufficient privileges on the device. SNMP Agent must be capable of accessing to the enterprise branch Ruckus : .1.3.6.1.4.1.25053.