Integración - SNMP

Desarrollo
1

¡Hola a todos! Os presento SNMP, una integración externa para Gladys 5.1+ que lee vuestros equipos de red en SNMP (v1, v2c, v3) y los convierte en dispositivos de Gladys: accesibles o no, tiempo de respuesta, tiempo de actividad, tráfico, CPU, batería… Todo se mantiene local, nada pasa por la nube.

Qué hace la integración

Cada equipo SNMP se convierte en un dispositivo de Gladys. Elegís qué información se sube con perfiles:

Perfil Lo que recibe Gladys Para qué equipos
(siempre) Accesible (sí/no), tiempo de respuesta (ms), tiempo de actividad (días) Todos
interfaces Por puerto: enlace activo, ancho de banda de entrada y salida (kbit/s) Conmutadores, enrutadores, puntos de acceso Wi-Fi
host Carga de CPU, memoria utilizada, disco más lleno (%) NAS, servidores Linux/Windows
ups Carga de batería, autonomía, batería baja, presencia de corriente, voltaje, carga, potencia SAIs Eaton, APC con tarjeta de red…
OID personalizado Cualquier OID, con categoría, unidad y escala Todo lo demás (temperatura de un NAS, tóner…)

Un OID también puede ser modificable: se convierte en un interruptor en Gladys, controlado por un SET SNMP. Útil para un enchufe de PDU o un puerto PoE.

Cada dispositivo muestra un distintivo local, o inaccesible cuando deja de responder.

Escenas y panel de control (Gladys 5.1)

Disparadores — un solo evento por cambio, nunca en cada consulta:

  • Un agente SNMP deja de responder (variables: nombre, host, razón)
  • Un agente SNMP responde de nuevo (variables: nombre, host, duración de la caída en minutos)
  • Una interfaz de red cambia de estado (filtro activo / caído)

Acciones de escena — nunca detienen la escena en caso de fallo, devuelven éxito y error:

  • Leer un valor SNMP
  • Escribir un valor SNMP (cortar un enchufe de PDU, reiniciar un puerto PoE…)
  • Consultar un agente ahora

Widget « Agentes SNMP » — cuántos equipos responden, una línea por equipo con su tiempo de respuesta, un botón « Consultar ». Elegí un equipo en sus ajustes para ver también sus valores en tiempo real (CPU, memoria, batería…).

Ejemplo: « si el SAI pasa a batería, enviarme un mensaje y apagar el NAS », o « si el router no responde desde hace 5 minutos, cortar y volver a encender su enchufe ».

Instalación y configuración

  1. Activá SNMP en tus equipos. Lo más simple: v2c con una comunidad de solo lectura (elegí la tuya en lugar de public). SNMPv3 authPriv (SHA + AES) es soportado.
  2. En Gladys (5.1 mínimo), instalá la integración SNMP desde el catálogo de integraciones.
  3. En la pestaña Configuración, listá tus equipos, separados por comas, en el formato host[:puerto];nombre;perfiles:
192.168.1.1;Router, 192.168.1.10;NAS;host, 192.168.1.20;SAI;ups
  1. Hacé clic en Probar conexión: cada equipo dice si responde, en cuánto tiempo, y su nombre de sistema.
  2. Agregá los dispositivos desde la pestaña Descubrimiento.

Para seguir puertos de switch, agregar tus propios OID o poner identificación diferente por equipo, pegá mejor una lista JSON (ver la documentación). Dos botones ayudan a llenarla: Listar interfaces (índice y nombre de cada puerto) y Explorar un OID (para encontrar el valor correcto en una MIB del fabricante).

Límites conocidos

  • No hay descubrimiento automático: los equipos se declaran manualmente.
  • No hay traps SNMP por ahora, solo consulta (una vez por minuto como máximo).
  • CPU, memoria, disco y carga del SAI se muestran en categoría « desconocida » con una unidad %, por falta de categoría Gladys adecuada.
  • En una red grande, aumentá el intervalo de actualización (300 s por ejemplo) para no cargar el historial.

Enlaces y comentarios

Es una primera versión: ¡me interesan tus comentarios! Decime qué equipos has probado (marca, modelo, versión SNMP), qué funciona, qué falta. Para un error, una issue de GitHub con los registros (sin la comunidad ni las claves) me ayuda mucho.