Cisco WLC

Pack Assets

Templates

The Centreon Plugin Pack Cisco WLC brings a host template:

• Net-Cisco-Wlc-SNMP-custom

It brings the following service templates:

Service Alias	Service Template	Service Description	Default	Discovery
Ap-Channel-Interference-Global	Net-Cisco-Wlc-Ap-Channel-Interference-Global-SNMP	Check channel interferences of all access points
Ap-Channel-Noise-Global	Net-Cisco-Wlc-Ap-Channel-Noise-Global-SNMP	Check channel noises of all access points
Ap-Status-Global	Net-Cisco-Wlc-Ap-Status-Global-SNMP	Check status of all access points	X
Ap-Users	Net-Cisco-Wlc-Ap-Users-SNMP	Check total users of all access points
Cpu	Net-Cisco-Wlc-Cpu-SNMP	Check CPU usage	X
Hardware-Global	Net-Cisco-Wlc-Hardware-Global-SNMP	Check all hardware	X
Memory	Net-Cisco-Wlc-Memory-SNMP	Check the rate of the utilization of memory	X
Traffic-Generic-Id	Net-Cisco-Wlc-Traffic-Generic-Id-SNMP	Check traffic of an network interface
Traffic-Generic-Name	Net-Cisco-Wlc-Traffic-Generic-Name-SNMP	Check traffic of an network interface
Traffic-Global	Net-Cisco-Wlc-Traffic-Global-SNMP	Check traffic of multiple network interfaces		X

Discovery rules

Rule Name	Description
Net-Cisco-Wlc-SNMP-Traffic-Name	Discover network interfaces and monitor bandwidth utilization

Collected metrics & status

Ap-Channel-Interference-Global

Metric Name	Unit
channels#accesspoint.interference.power.count	count
channels#accesspoint.interference.utilization.percentage	%

Ap-Channel-Noise-Global

Metric Name	Unit
channels#accesspoint.noise.power.dbm	dBm

Ap-Status-Global

Metric Name	Unit
accesspoints.total.count	count
accesspoints.associated.count	count
accesspoints.disabled.count	count
accesspoints.disassociating.count	count
accesspoints.downloading.count	count
accesspoints.enabled.count	count
status
interfaces#accesspoint.radio.interface.channels.utilization.percentage	%
interfaces#radio-status

Ap-Users

Metric Name	Unit
users.total.count	users
users.aaapending.count	users
users.associated.count	users
users.authenticated.count	users
users.blacklisted.count	users
users.disassociated.count	users
users.idle.count	users
users.powersave.count	users
users.probing.count	users
users.tobedeleted.count	users
ssid#ssid.users.total.count	users
ap#accesspoint.users.total.count	users

Cpu

Metric Name	Unit
cpu.utilization.percentage	%

Hardware-Global

Could not retrieve metrics

Memory

Metric Name	Unit
memory.usage.bytes	B
memory.free.bytes	B
memory.usage.percentage	%

Traffic-Generic-Id

Metric Name	Unit
int#interface.traffic.in.bitspersecond	b/s
int#interface.traffic.out.bitspersecond	b/s

Traffic-Generic-Name

Metric Name	Unit
int#interface.traffic.in.bitspersecond	b/s
int#interface.traffic.out.bitspersecond	b/s

Traffic-Global

Metric Name	Unit
int#interface.traffic.in.bitspersecond	b/s
int#interface.traffic.out.bitspersecond	b/s

Prerequisites

SNMP Configuration

To use this pack, the SNMP service must be properly configured on your Cisco WLC server. Please refer to the official documentation from CISCO:

• CISCO WLC

Network flow

The target server must be reachable from the Centreon poller on the UDP/161 SNMP port.

Setup

Online License

1. Install the plugin package on every Centreon poller expected to monitor Cisco WLC resources:

yum install centreon-plugin-Network-Cisco-Wlc-Snmp

2. On the Centreon web interface, on page Configuration > Plugin Packs, install the Cisco WLC Centreon Plugin Pack.

Offline License

1. Install the plugin package on every Centreon poller expected to monitor Cisco WLC resources:

yum install centreon-plugin-Network-Cisco-Wlc-Snmp

2. Install the Cisco WLC Centreon Plugin Pack RPM on the Centreon central server:

yum install centreon-pack-network-cisco-wlc-snmp

3. On the Centreon web interface, on page Configuration > Plugin Packs, install the Cisco WLC Centreon Plugin Pack.

Configuration

Host

• Log into Centreon and add a new host through Configuration > Hosts.
• Fill the Name, Alias & IP Address/DNS fields according to your Cisco WLC server settings.
• Apply the Net-Cisco-Wlc-SNMP-custom template to the host.

When using SNMP v3, use the SNMPEXTRAOPTIONS Macro to add specific authentication parameters More information in the Troubleshooting SNMP section.

Mandatory	Macro	Description
	SNMPEXTRAOPTIONS	Configure your own SNMPv3 credentials combo

How to check in the CLI that the configuration is OK and what are the main options for?

Once the plugin is installed, log into your Centreon poller's CLI using the centreon-engine user account (su - centreon-engine) and test the plugin by running the following command:

/usr/lib/centreon/plugins//centreon_cisco_wlc.pl \
    --plugin=network::cisco::wlc::snmp::plugin \
    --mode=ap-status \
    --hostname=10.0.0.1 \
    --snmp-community='my-snmp-community' \
    --snmp-version=2c \
    --filter-name='' \
    --filter-group='' \
    --warning-radio-status='' \
    --critical-radio-status='' \
    --warning-radio-interface-channels-utilization='' \
    --critical-radio-interface-channels-utilization='' \
    --warning-total='' \
    --critical-total='' \
    --warning-total-associated='' \
    --critical-total-associated='' \
    --warning-total-disassociating='' \
    --critical-total-disassociating='' \
    --warning-total-enabled='' \
    --critical-total-enabled='' \
    --warning-total-disabled='' \
    --critical-total-disabled='' \
    --warning-status='' \
    --critical-status='' \
    --use-new-perfdata

The expected command output is shown below:

OK: total: %s associated: %s disassociating: %s downloading: %s enabled: %s disabled: %s   channels utilization: %s %% | 'accesspoints.total.count'=300;;;0; 'accesspoints.associated.count'=300;;;0; 'accesspoints.disassociating.count'=0;;;0; 'accesspoints.downloading.count'=0;;;0; 'accesspoints.enabled.count'=0;;;0; 'accesspoints.disabled.count'=0;;;0; 'accesspoint.radio.interface.channels.utilization.percentage'=70%;;;0;100 

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_cisco_wlc.pl \
    --plugin=network::cisco::wlc::snmp::plugin \
    --mode=ap-status \
    --help

All available modes can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_cisco_wlc.pl \
    --plugin=network::cisco::wlc::snmp::plugin \
    --list-mode

Troubleshooting

Please find the troubleshooting documentation for Centreon Plugins typical issues.