Supervisión de Catalyst 9800 WLC mediante SNMP con OID
Contenido
Introducción
Este documento describe cómo configurar el Protocolo simple de administración de red (SNMP) para monitorear el Controlador de LAN inalámbrica (WLC) Cisco 9800.
Prerequisites
Requirements
- Servidor/herramienta SNMP
- Conocimiento básico de 9800 WLC y protocolo(s) SNMP
Componentes Utilizados
Todas las pruebas se realizaron en MacOS 10.14 y un WLC 9800-CL con la versión de imagen 17.5.1. Algunos de los OID mencionados en este artículo no existen en versiones de imagen anteriores.
La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.
SNMP frente a telemetría
Los WLCs antiguos de AireOS dependen de SNMP como el protocolo principal para monitorear. La mayoría de la información relevante como el conteo del cliente, el número de puntos de acceso unidos, el procesador y el uso de la memoria se pueden obtener a través de consultas SNMP de la herramienta que monitorea al WLC.
Con el 9800 WLC, el foco se ha puesto en la telemetría. La telemetría funciona en un modelo "push" donde el WLC envía información relevante al servidor sin el requisito de ser consultado. El Catalyst 9800 todavía ofrece SNMP para propósitos heredados. Parte de la información puede ser exclusiva de la telemetría y algunos de los OID previamente disponibles en AireOS aún no están disponibles en 9800.
Configuración de SNMP en WLC
Desde Cisco IOS XE® Bengaluru 17.6.1, el puerto de servicio Ethernet (interfaz de administración VRF/GigabitEthernet 0) es compatible con el controlador inalámbrico Catalyst de Cisco serie 9800.
Antes de esta versión, el WLC Catalyst 9800 solo se puede monitorear con SNMP a través de su interfaz de administración inalámbrica o a través de la interfaz de administración de redundancia (en el caso de un WLC en espera en un clúster HA en las versiones 17.5.1 y superiores).
A través de la interfaz web
SNMPv2c es una versión basada en la comunidad de SNMP y toda la comunicación entre los dispositivos está en texto sin formato. SNMPv3 es la versión más segura que ofrece comprobaciones de integridad del mensaje, autenticación y cifrado de los paquetes. SNMPv1 está bastante obsoleto, pero aún existe para proporcionar compatibilidad de software heredado. No se menciona en este artículo.
1. Inicie sesión en la interfaz web del WLC 9800. En Administration > Management > SNMP y asegúrese de que SNMP esté habilitado globalmente. En Cadenas de comunidad, se muestran todas las comunidades configuradas actualmente y su nivel de permisos:
2. Antes de crear un usuario SNMP V3, es necesario definir un grupo SNMP V3. Para crear un grupo de usuarios con permiso de lectura y escritura, establezca la Vista de lectura y la Vista de escritura en v1default. Deje el cuadro de campo Write View de grupo de sólo lectura en blanco:
3. En la ficha Usuarios de SNMP v3, puede ver todos los usuarios configurados, así como sus privilegios y protocolos utilizados para la autenticación y el cifrado. El botón Nuevo le permite crear un nuevo usuario.
Hay 3 modos de seguridad disponibles:
- AuthPriv: Los mensajes se autentican y cifran.
- AuthNoPriv: Los mensajes se autentican pero no se cifran.
- NoAuthNoPriv: No se aplica seguridad a los mensajes.
4. Seleccione SHA como protocolo de autenticación y al menos AES-128 como protocolo de privacidad recomendado.
A través de la línea de comandos
SNMP también se puede configurar a través de la interfaz de línea de comandos (CLI). CLI ofrece parámetros de configuración adicionales, como la capacidad de asignar una lista de acceso a una comunidad v2 o a un usuario v3. Ejemplo de configuración de una comunidad de lectura y escritura v2, un grupo de lectura y escritura v3 y un usuario v3 que pertenece a este grupo:
snmp-server manager
snmp-server community <community-name> RW <access-list-number>
snmp-server community <community-name> RO <access-list-number>
snmp-server group <v3-group-name> v3 auth write v1default
snmp-server user <v3-user-name> <v3-group-name> v3 auth sha <auth-password> priv aes 128 <encryption-password> access <access-list-number>Este es un ejemplo de una lista de acceso que sólo permite el dispositivo en una dirección IP de: 192.168.10.10. Para consultar la comunidad WLC v2 denominada "ReadWriteCommunity":
ip access-list standard 50
10 permit 192.168.10.10
20 deny any
snmp-server manager
snmp-server community ReadWriteCommunity RW 50Nombres de objetos e ID de objetos (OID)
¿Qué son los nombres de objeto y los OID?
Los ID de objeto, o OID para abreviar, son identificadores únicos que representan una variable u objeto determinado. Por ejemplo, el uso actual del procesador se considera una variable, cuyos valores se pueden recuperar con la llamada en su ID de objeto. Cada OID es único y no puede haber dos iguales; es similar a una dirección MAC.
Estos identificadores se alinean con una jerarquía de árbol y se puede realizar un seguimiento de cada OID hasta su raíz. Cada proveedor tiene su propia sucursal con una raíz común. Una analogía puede ser una dirección de casa, donde la raíz es el país o estado, con su ciudad, código postal, calle y, finalmente, el número de casa.
Los números seguidos por un punto representan cada paso que toma para llegar a un punto determinado en ese árbol o rama.
Todos estos valores se almacenan en una Base de información de administración, o MIB para abreviar en cada dispositivo de red. Cada identificador tiene un nombre y una definición (rango de valores posibles, tipo, etc.).
No es necesario cargar una MIB en su herramienta de monitoreo SNMP para utilizar SNMP para consultar un dispositivo. Mientras se conozca un OID válido, el dispositivo responde con el valor almacenado en la variable que representa el OID. Sin embargo, si carga la MIB en su herramienta de consulta, proporciona la ventaja de traducir los nombres de objeto a sus IDs y explica su descripción.
En este ejemplo, la herramienta SNMP consulta al agente SNMP de un dispositivo su descripción del sistema con el uso de OID 1.3.6.1.2.1.1.1.0.
MIBs y una lista de todos los nombres de objeto e IDs en Cisco WLCs
Cisco ofrece MIB para 9800 WLC. No es fácil de leer, sin embargo, MIB contiene todos los nombres de objeto disponibles y sus descripciones.
Todos los modelos 9800 (9800-80, 9800-40, 9800-L, 9800-CL, EWC) utilizan la misma MIB que se puede descargar en Cisco Feature Navigator. El más reciente es el que tiene la fecha más reciente, no el que tiene el nombre de versión de código más alto.
Los archivos de almacenamiento descargados contienen varios archivos de texto .my que se pueden importar a cualquier servidor SNMP de terceros o simplemente abrir con un editor de texto. Para buscar el OID de un nombre de objeto específico, primero debe buscar el archivo exacto que lo contiene.
Por ejemplo, todos los objetos relacionados con la supervisión del estado físico de los dispositivos (como la CPU y la memoria) se encuentran dentro de una MIB denominada CISCO-PROCESS-MIB.my.
"cpmCPUMemoryUsed" es el nombre de objeto que se utiliza para proporcionar la cantidad de memoria utilizada por el WLC en bytes. Todos los archivos MIB se alinean con una sintaxis similar. La información sobre el objeto de memoria utilizado es similar a la siguiente:
cpmCPUMemoryUsed OBJECT-TYPE
SYNTAX Gauge32
UNITS "kilo-bytes"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The overall CPU wide system memory which is currently
under use."
::= { cpmCPUTotalEntry 12 }La mayor parte del software de terceros que se supervisa se basa en OID y no en nombres de objetos. La traducción entre el nombre de objeto y el ID de objeto se puede realizar con la herramienta Cisco SNMP Object Navigator.
Para utilizar esta herramienta, introduzca el nombre del objeto en la barra de búsqueda y la salida proporcionará el OID y una breve descripción. Además, se puede utilizar la misma herramienta para buscar el nombre del objeto del OID proporcionado.
Utilice los OID para Monitorear el Estado del WLC
Después de la adquisición, el OID del objeto que se debe monitorear, se puede ejecutar la primera consulta SNMP. Los ejemplos de este capítulo muestran cómo adquirir una memoria libre de WLC (OID = 1.3.6.1.4.1.9.9.48.1.1.1.5) para SNMPv2 community private y snmpadmin de usuario SNMPv3 con contraseña de autenticación SHA: Cisco123# y contraseña de privacidad AES: Cisco123#. La interfaz de administración del controlador se encuentra en: 10.48.39.133.
Supervisión mediante Snmpwalk
Snmpwalk es una aplicación SNMP que utiliza solicitudes SNMP GETNEXT para consultar una entidad de red para obtener un árbol de información. Está presente de forma predeterminada en MacOS y en la mayoría de las distribuciones Linux. Para SNMPv2c, el comando cumple con esta sintaxis:
snmpwalk -v2c -c <community_name> <WLC_management_interface_ip> <OID>
Este es otro ejemplo:
VAPEROVI:~ vaperovi$ snmpwalk -v2c -c private 10.48.39.133 1.3.6.1.4.1.9.9.109.1.1.1.1.12
SNMPv2-SMI::enterprises.9.9.109.1.1.1.1.12.2 = 3783236 <-------- Free Memory in Bytes
Si se utiliza SNMPv3, el comando se adhiere a la sintaxis:
snmpwalk -v3 -l authPriv -u <username> -a [MD5|SHA] -A <auth_password> -x [AES|DES] -X <priv_password> <WLC_management_interface_ip> <OID>
Seleccione MD5/SHA y AES/DES en función de cómo creó el usuario SNMPv3 en el controlador. Este es otro ejemplo:
VAPEROVI:~ vaperovi$ snmpwalk -v3 -l authPriv -u snmpadmin -a SHA -A Cisco123# -x AES -X Cisco123# 10.48.39.133 1.3.6.1.4.1.9.9.109.1.1.1.1.12
SNMPv2-SMI::enterprises.9.9.109.1.1.1.1.12.2 = 3783236 <-------- Free Memory in Bytes
#snmpwalk output still shows v2 even though v3 is used
Monitor a través de Python3 y biblioteca de pysnmp
Los fragmentos de código se escriben para Python 3.9 y utilizan el módulo pysnmp (pip install pysnmp) para ejecutar consultas SNMP para la utilización de memoria del WLC de Catalyst 9800-CL. Estos ejemplos utilizan la misma comunidad SNMPv2 y usuario SNMPv3 creados en los capítulos anteriores. Simplemente reemplace los valores de variable e integre el código dentro de sus propias secuencias de comandos personalizadas.
Ejemplo de SNMPv2:
from pysnmp.hlapi import *
communityName = 'private'
ipAddress = '10.48.39.133'
OID = '1.3.6.1.4.1.9.9.109.1.1.1.1.12'
for (errorIndication,
errorStatus,
errorIndex,
varBinds) in nextCmd(SnmpEngine(),
CommunityData(communityName),
UdpTransportTarget((ipAddress, 161)),
ContextData(),
ObjectType(ObjectIdentity(OID)),
lexicographicMode=False):
if errorIndication:
print(errorIndication)
elif errorStatus:
print('%s at %s' % (errorStatus.prettyPrint(),
errorIndex and varBinds[int(errorIndex) - 1][0] or '?'))
else:
for varBind in varBinds:
print(' = '.join([x.prettyPrint() for x in varBind]))Salida imprime:
SNMPv2-SMI::enterprises.9.9.109.1.1.1.1.12.2 = 3783236
Ejemplo de SNMPv3:
from pysnmp.hlapi import *
username = 'snmpadmin'
ipAddress = '10.48.39.133'
OID = '1.3.6.1.4.1.9.9.109.1.1.1.1.12'
authKey = 'Cisco123#'
privKey = 'Cisco123#'
for (errorIndication,
errorStatus,
errorIndex,
varBinds) in nextCmd(SnmpEngine(),
UsmUserData(username, authKey, privKey,
authProtocol=usmHMACSHAAuthProtocol,
privProtocol=usmAesCfb128Protocol),
UdpTransportTarget((ipAddress, 161)),
ContextData(),
ObjectType(ObjectIdentity(OID)),
lexicographicMode=False):
if errorIndication:
print(errorIndication)
elif errorStatus:
print('%s at %s' % (errorStatus.prettyPrint(),
errorIndex and varBinds[int(errorIndex) - 1][0] or '?'))
else:
for varBind in varBinds:
print(' = '.join([x.prettyPrint() for x in varBind]))Integración con software de terceros (Grafana+Prometheus/PRTG Network Monitor/SolarWinds)
La infraestructura Cisco Prime permite supervisar y configurar fácilmente varios dispositivos de red, incluidos los controladores inalámbricos. Prime Infrastructure viene precargado con todos los OID e integraciones con WLC, y consiste en la adición de las credenciales de WLC a Prime. Con 9800 WLC, Prime depende principalmente de la telemetría para recopilar la mayoría de los detalles del WLC, mientras que la pequeña porción de información se obtiene a través de SNMP.
Por otro lado, Cisco WLC también se puede integrar con varias soluciones de terceros para la supervisión, siempre que se conozcan los OID. Programas como Grafana+Prometheus, PRTG Network Monitor y servidores SolarWinds permiten importar MIB u OID y mostrar los valores en un gráfico fácil de usar.
Esta integración puede requerir algunos ajustes en el lado del servidor SNMP. En este ejemplo, el servidor de supervisión PRTG se proporciona con el OID de utilización de CPU por núcleo, que devuelve la cadena "0%/1%, 1%/1%, 0%/1%, 0%/1%". PRTG espera un valor entero y genera un error.
Integración con CUCM
Cisco Unified Communications Manager (CUCM) cuenta con una función de seguimiento de terminales inalámbricos que le permite realizar un seguimiento aproximado de la ubicación del cliente en función del punto de acceso al que esté conectado el cliente. Para que esta función funcione, CUCM debe extraer información del WLC mediante consultas SNMP.
Tabla de OIDs Monitorizados con Mayor Frecuencia
La tabla incluye algunos de los nombres de objeto más comunes y sus OID, con la consideración de que los MIB presentan los datos en una sintaxis no amigable para el usuario:
| Descripción |
Nombre del Objeto |
OID (ID del objeto) |
Respuesta esperada |
| Uso general de la CPU en % los últimos 5 segundos (equivalente a "show process cpu platform") |
cpmCPUTotal5sec |
1.3.6.1.4.1.9.9.109.1.1.1.1.3 |
ENTERO: 5 |
| Uso general de la CPU en % durante los últimos 1 min |
cpmCPUTotal1min |
1.3.6.1.4.1.9.9.109.1.1.1.1.4 |
ENTERO: 5 |
| Uso general de la CPU en % durante los últimos 5 minutos |
cpmCPUTotal5min |
1.3.6.1.4.1.9.9.109.1.1.1.1.5 |
ENTERO: 5 |
| Uso de la CPU en % los últimos 5 minutos, por núcleo |
cpmCore5min |
.1.3.6.1.4.1.9.9.109.1.1.2.1.5.5 (de 0 a 0,X en función del número de núcleos) |
ENTERO: 5 |
| Memoria utilizada actual en bytes |
cpmCPUMemoryUsed |
1.3.6.1.4.1.9.9.109.1.1.1.1.12 |
ENTERO: 3783236 |
| Memoria libre actual en bytes |
cpmCPUMemoryFree |
1.3.6.1.4.1.9.9.109.1.1.1.1.13 |
ENTERO: 4263578 |
| La menor cantidad de memoria libre desde el último arranque en bytes |
cpmCPUMemoryLowest |
1.3.6.1.4.1.9.9.109.1.1.1.1.15 |
ENTERO: 4251212 |
| Motivo de la última recarga |
por quéRecargar |
1.3.6.1.4.1.9.2.1.2 |
CADENA: "recargar" |
| Imagen de software de todos los AP unidos |
bsnAPSoftwareVersion |
1.3.6.1.4.1.14179.2.2.1.1.8 |
CADENA: "17.5.1.12 " |
| Número de modelo de todos los AP unidos |
bsnAPModel |
1.3.6.1.4.1.14179.2.2.1.1.16 |
CADENA: AIR-AP1840I-E-K9 |
| Número de clientes |
cLApActiveClientCount |
.1.3.6.1.4.1.9.9.513.1.1.1.1.72 |
Entero |
| Número de puntos de acceso unidos |
cLApGlobalAPConnectCount |
1.3.6.1.4.1.9.9.513.1.3.35 |
Indicador32: 1 |
| Estado de la unidad de alimentación |
ciscoEnvMonSupplyStatusTable |
.1.3.6.1.4.1.9.9.13.1.5(agregado mediante CSCwb73163) |
tabla |
| Estado del ventilador |
ciscoEnvMonFanStatusTable |
.1.3.6.1.4.1.9.9.13.1.4 (agregado mediante CSCwb73163) |
tabla |
Actualmente, hay solicitudes de mejora abiertas para soportar el número total de clientes OID y el número de puntos de acceso unidos bajo el ID de bug de Cisco: CSCvu26309 - El OID SNMP para el Recuento de Clientes no está Presente en 9800.
En el momento de este artículo, no se admite el estado de la unidad de alimentación (PSU) ni el estado del ventilador. Se ha abierto una solicitud de mejora en
Id. de error de Cisco: CSCwa23598 - 9800 WLC Enhancement / Support for PSU and Fan State SNMP OID (1.3.6.1.4.1.9.9.13).
Supervisión de WLC en espera en HA
Puede monitorear un WLC en espera en el cluster de alta disponibilidad desde la versión 17.5.1. El WLC en espera puede ser monitoreado directamente a través de RMI o consultando el WLC activo.
Monitoree el WLC en espera directamente
El WLC en espera se puede monitorear directamente solamente para los WLC que se ejecutan en el tipo RMI + RP HA. Esto se hace a través de la dirección IP de la interfaz de administración de redundancia (RMI) en espera del WLC en espera.
En este escenario, sólo se soportan los OID de IF-MIB, lo que hace posible monitorear el estado de todas las interfaces en el WLC en espera. Ejemplo de salida de 9800-CL WLC:
| Descripción |
Nombre del Objeto |
OID (ID del objeto) |
Respuesta esperada |
| Nombre de interfaz |
ifDescr |
1.3.6.1.2.1.2.2.1.2 |
SNMPv2-SMI::mib-2.2.2.1.2.1 = GigabitEthernet1 |
| Estado operativo de la interfaz (1=arriba, 2=abajo) |
ifOperStatus |
1.3.6.1.2.1.2.2.1.8 |
SNMPv2-SMI::mib-2.2.2.1.8.1 = 2 |
Monitorear el WLC en espera a través del WLC activo
El estado de WLC en espera también se puede monitorear con la consulta al WLC activo. Solamente se soportan oficialmente CISCO-LWAPP-HA-MIB y CISCO-PROCESS-MIB. Cuando se consulta un WLC activo en HA, la primera respuesta representa el valor del WLC activo, mientras que la segunda respuesta representa el valor del WLC en espera.
| Descripción |
Nombre del Objeto |
OID (ID del objeto) |
Respuesta esperada |
| Uso general de la CPU en % durante los últimos 5 s |
cpmCPUTotal5sec |
1.3.6.1.4.1.9.9.109.1.1.1.1.3 |
SNMPv2-SMI::enterprise.9.9.109.1.1.1.1.3.5 = 3 |
| Uso general de la CPU en % durante los últimos 1 min |
cpmCPUTotal1min |
1.3.6.1.4.1.9.9.109.1.1.1.1.4 |
SNMPv2-SMI::enterprise.9.9.109.1.1.1.1.4.5 = 8 |
| Uso general de la CPU en % durante los últimos 5 minutos |
cpmCPUTotal5min |
1.3.6.1.4.1.9.9.109.1.1.1.1.5 |
SNMPv2-SMI::enterprise.9.9.109.1.1.1.1.5.5 = 10 |
| Memoria utilizada actual en bytes |
cpmCPUMemoryUsed |
1.3.6.1.4.1.9.9.109.1.1.1.1.12 |
SNMPv2-SMI::enterprise.9.9.109.1.1.1.1.12.5 = 4318980 |
| Memoria libre actual en bytes |
cpmCPUMemoryFree |
1.3.6.1.4.1.9.9.109.1.1.1.1.13 |
SNMPv2-SMI::enterprise.9.9.109.1.1.1.1.12.5 = 4318739 |
| La menor cantidad de memoria libre desde el último arranque en bytes |
cpmCPUMemoryLowest |
1.3.6.1.4.1.9.9.109.1.1.1.1.15 |
SNMPv2-SMI::enterprise.9.9.109.1.1.1.1.15.5 = 3763868 |
| Estado del WLC en espera (1=arriba, 0=abajo) |
cLHaPeerHotStandbyEvent |
1.3.6.1.4.1.9.9.843.1.3.4 |
SNMPv2-SMI::enterprise.9.9.843.1.3.4.0 = 1 |
Historial de revisiones
| Revisión | Fecha de publicación | Comentarios |
|---|---|---|
8.0 |
27-Oct-2026
|
Actualización de ortografía, gramática, espaciado, inserción de líneas horizontales para separar secciones para facilitar la lectura, alertas fijas de CCW y texto alternativo. |
7.0 |
01-Jul-2025
|
Ventilador, fuente de alimentación y OID de recuento de clientes añadidos |
6.0 |
31-Mar-2025
|
URL MIB fija |
5.0 |
15-Nov-2023
|
Agregado por OID de núcleo de CPU |
4.0 |
01-Apr-2022
|
OID adicionales mencionados |
2.0 |
01-Oct-2021
|
Versión inicial |
1.0 |
12-Oct-2021
|
Versión inicial |
ComentariosContacte a Cisco
- Abrir un caso de soporte
- (Requiere un Cisco Service Contract)