Multi-Vendor SNMP Support — Guia Tecnica

Multi-Vendor SNMP Support — Guia Tecnica

Fecha: 13-03-2026 Version: v1.0.37 Archivos clave:

• network/migrations/0032-0035 — VendorProfile enrichment
• network/migrations/0037 — SNMPv3 fields en DeviceProfile
• network/services/device_discovery/snmp_auth.py — Central SNMP auth abstraction (v2c/v3)
• network/services/mib_assistant.py — Level 2 MIB Assistant
• network/services/device_discovery/auto_classifier.py — Level 3 Auto-Classifier
• network/api/vendor.py — API endpoints
• Documentation/archive/plans/MULTI_VENDOR_SUPPORT_PLAN.md — Plan completo

Resumen

Sistema de 3 niveles para soportar >90% de equipos de datacenter via SNMP sin intervencion manual del usuario:

Nivel 1: Pre-built VendorProfiles

Migrations

Perfiles por Categoria

WiFi Access Points: Cisco, Aruba, Ruckus, Ubiquiti, Meraki, Fortinet, MikroTik, Cambium, Xirrus, Extreme, HP, TP-Link, Zyxel, D-Link, Netgear

Switches/Routers: Cisco, Juniper, Arista, Huawei, HP/ProCurve, Dell, MikroTik

Firewalls: Fortinet (FortiGate), Palo Alto, Cisco ASA

UPS: APC/Schneider, Eaton, CyberPower, Vertiv/Liebert + generic-ups (UPS-MIB RFC 1628)

PDU: APC, Raritan + generic

NAS/Storage: Synology, QNAP + generic

Impresoras: generic-printer (Printer-MIB RFC 3805)

Standard MIBs (todos los vendors)

Todas las 1,605 VendorProfiles incluyen deep_discovery_oids con:

SNMPv3 Support (v1.0.37)

Todos los vendors se pueden consultar con SNMPv3 USM. Los OIDs son idénticos a v2c — SNMPv3 solo cambia la autenticación y el cifrado del transporte.

Nota: SNMPv3 NO mejora la calidad de los datos de monitoreo — los OIDs retornan exactamente los mismos valores. Es una feature de seguridad (autenticación + cifrado en tránsito) para entornos que requieren/exigen v3 o que tienen v2c deshabilitado.

Vendor-specific monitoring_oids

Bandwidth Monitoring OIDs (todos los vendors)

El Agent Sentinel pollea estos OIDs por target para calcular bandwidth (Mbps), errores y discards. El ifIndex concreto lo determina AutoConfigService._select_primary_interface() durante el auto-provisioning (ver AUTO_PROVISION_GUIDE.md §6.1).

HC→Legacy Fallback (snmp_bandwidth.py): Si ifHCInOctets + ifHCOutOctets delta = 0 pero legacy delta > 0, usa contadores legacy 32-bit. Necesario para Xirrus donde HC counters devuelven 0 permanentemente en interfaces ethernet.

Cálculo: Mbps = delta_octets × 8 / dt_seconds / 1,000,000

Protecciones: Spike clamp > 10 Gbps (descarta y resetea baseline). Error/discard clamp > 100k/min.

Quirks por Vendor — Bandwidth SNMP

Xirrus (XR/XD series)

Cambium (XE series)

Nivel 2: MIB Assistant

Servicio: network/services/mib_assistant.py

Flujo:

1. Usuario sube un archivo .mib via POST /api/vendor-profiles/{slug}/upload-mib
2. MibManager compila y extrae OIDs
3. Usuario llama POST /api/vendor-profiles/{slug}/mib-assistant/analyze
4. Gemini Flash (gemini-3-flash-preview) clasifica los OIDs en categorias
5. Si Gemini no disponible, fallback a reglas por keywords
6. Usuario confirma via POST /api/vendor-profiles/{slug}/mib-assistant/apply
7. OIDs propuestos se fusionan en VendorProfile (no sobreescribe existentes)

API Endpoints

POST /api/vendor-profiles/{slug}/mib-assistant/analyze
  -> Analiza OIDs de CustomMibs con Gemini Flash
  <- { device_type, confidence, monitoring_oids, deep_discovery_oids }

POST /api/vendor-profiles/{slug}/mib-assistant/apply
  Body: { monitoring_oids: {...}, deep_discovery_oids: {...} }
  <- { vendor_slug, monitoring_added, deep_discovery_added, ... }

Funciones principales

Prompt de Gemini

El prompt pide a Gemini:

• Clasificar cada OID en categorias (monitoring, hardware, wireless, clients, etc.)
• Para monitoring: especificar type (gauge/walk_sum/walk_first) y unit
• Para deep_discovery: especificar get/walk
• Devolver JSON puro con confianza

Fallback (sin Gemini)

Cuando la API de Gemini no esta disponible, _fallback_classify() usa keyword matching:

• “cpu” → monitoring.cpu_usage (gauge, percent)
• “memory” → monitoring.memory_usage (gauge, percent)
• “temperature” → monitoring.temperature (gauge, celsius)
• “client/station” → monitoring.connected_clients (walk_sum, count)
• Y categoriza en deep_discovery por keywords: interface, disk, battery, etc.

Nivel 3: Auto-Classifier

Servicio: network/services/device_discovery/auto_classifier.py

Integrado en: DeviceDiscoveryService.provision_device() (service.py) Punto de insercion: Despues de Stage 2 SNMP, cuando ni sysObjectID ni sysDescr matchean un VendorProfile.

Algoritmo de clasificacion

5 metodos combinados, cada uno asigna puntos:

Confianza minima: 20% para activar (muy conservador — cualquier signal es suficiente)

Device Types reconocidos

Integracion en pipeline

Stage 2: SNMP
    ├── sysObjectID match? → VendorProfile found ✓
    ├── sysDescr match?    → VendorProfile found ✓
    └── Neither matched?   → AUTO-CLASSIFIER
                              ├── classify_from_all_data(snmp, http, nmap)
                              ├── confidence >= 20%?
                              │   ├── Set generic profile (generic/generic-ups/generic-printer)
                              │   ├── Set detected_vendor from generic profile
                              │   └── snmp_data['auto_classified'] = True
                              └── confidence < 20%?
                                  └── No vendor, continue as unknown

Enterprise OID Hints

Cuando el sysObjectID tiene un enterprise number conocido pero no hay VendorProfile con ese prefix:

ENTERPRISE_HINTS = {
    318: "ups",       # APC
    534: "ups",       # Eaton
    476: "ups",       # Vertiv
    3808: "ups",      # CyberPower
    850: "ups",       # Tripp Lite
    6574: "nas",      # Synology
    24681: "nas",     # QNAP
    789: "nas",       # NetApp
    674: "server",    # Dell iDRAC
    232: "server",    # HP iLO
    13742: "pdu",     # Raritan
    1718: "pdu",      # ServerTech
    21239: "pdu",     # Geist/Vertiv
}

Ejemplos de Clasificacion

Caso 1: UPS APC no reconocido

Input:  sysDescr="APC Smart-UPS 3000", sysObjectID="1.3.6.1.4.1.318.1.3.17", hostname="ups-rack01"
Output: device_type=ups, confidence=85%, profile=generic-ups
Reason: enterprise OID 318, sysDescr 'ups', hostname 'ups-'

Caso 2: Switch con 48 puertos

Input:  sysDescr="Generic L2 Switch", hostname="sw-core-01", 48 interfaces
Output: device_type=switch, confidence=35%, profile=generic
Reason: hostname 'sw-', 48 interfaces

Caso 3: NAS Synology

Input:  sysDescr="Linux NAS 5.10.0-synology", sysObjectID="1.3.6.1.4.1.6574.1", hostname="nas-backup"
Output: device_type=nas, confidence=85%, profile=generic
Reason: enterprise OID 6574, sysDescr 'nas', hostname 'nas-'

Testing

Auto-Classifier

from network.services.device_discovery.auto_classifier import classify_from_snmp_data

result = classify_from_snmp_data({
    'sys_descr': 'APC Smart-UPS 3000',
    'sys_object_id': '1.3.6.1.4.1.318.1.3.17',
    'hostname': 'ups-rack01',
    'interfaces': {},
})
# → device_type=ups, confidence=85, profile=generic-ups

MIB Assistant (fallback sin Gemini)

from network.services.mib_assistant import _fallback_classify

oids = [
    {'name': 'cpuUsage', 'oid': '1.3.6.1.4.1.99.1', 'type': 'get', 'access': 'readonly'},
    {'name': 'memTotal', 'oid': '1.3.6.1.4.1.99.2', 'type': 'get', 'access': 'readonly'},
]
result = _fallback_classify(oids, 'switch')
# → monitoring_oids: {cpu_usage: {...}, memory_usage: {...}}

MIB Assistant (con Gemini)

# Requiere GEMINI_API_KEY en env
curl -X POST http://localhost:8000/api/vendor-profiles/cisco/mib-assistant/analyze

Archivos Modificados

Mantenido por: Claude (Anthropic) + Equipo CreaRack

Nivel 1 Ampliacion: AV / Digital Signage (Migration 0036)

Perfiles por Categoria

Media Players: SpinetiX (PEN 29888), Crestron (PEN 3212), Extron (PEN 17049), BrightSign (PEN 44804)

Projectors: Barco (PEN 10103), Christie (PEN 19124), NEC/Sharp (PEN 119)

Audio DSP: QSC (PEN 30815), Shure (PEN 20918), Biamp (PEN 37890)

Displays: LG Display (PEN 2116)

Monitoring OIDs (vendor-specific)

Deep Discovery (vendor-specific)

Nota: Vendors sin monitoring_oids (Extron, Barco, etc.) usan standard MIBs. Enriquecer via MIB Assistant (Level 2) subiendo MIBs vendor-specific.

Auto-Classifier: Nuevos Device Types

Enterprise OID Hints (auto-classifier)

29888: "media_player",  # SpinetiX
3212: "media_player",   # Crestron
17049: "media_player",  # Extron
10103: "projector",     # Barco
44804: "media_player",  # BrightSign
19124: "projector",     # Christie
30815: "audio_dsp",     # QSC
20918: "audio_dsp",     # Shure
37890: "audio_dsp",     # Biamp

Véase también

• [[crearack-tech—backend—auto-provision-guide]] — guía técnica de Auto-Provision
• [[crearack-tech—backend—network-management-implementation]] — implementación de gestión de red
• [[crearack-tech—backend—network-observatory]] — Network Observatory en backend
• [[crearack-tech—architecture—wireless-monitor]] — plan de monitorización wireless
• [[entity—network—model—vendorprofile]] — modelo VendorProfile
• [[entity—network—model—custommib]] — modelo CustomMIB
• [[crearack—redes-infra—conceptos-snmp]] — conceptos básicos de SNMP