NetBox como fuente de verdad: el centro de control que tu red ISP necesita
Hay una pregunta que los equipos de red en ISPs responden de formas muy distintas: ¿cuál es la fuente de verdad de tu red?
Las respuestas más comunes son: una hoja de Excel compartida en Drive, un wiki interno que nadie actualiza, la cabeza del ingeniero más antiguo del equipo, o —en el mejor de los casos— alguna combinación de todo eso.
El problema no es que estos sistemas sean malos. Es que son inconsistentes. Cuando la documentación y la realidad divergen, los incidentes tardan más en resolverse, los cambios se hacen con más riesgo, y la automatización se vuelve imposible porque no hay una fuente de datos confiable de la que partir.
NetBox resuelve ese problema.
Qué es NetBox y por qué se convirtió en el estándar
NetBox es una plataforma open-source de documentación y modelado de infraestructura de red. Fue desarrollada originalmente por el equipo de ingeniería de DigitalOcean y hoy es mantenida por NetBox Labs, con una comunidad masiva de contribuidores y deployments en cientos de ISPs, carriers, data centers y empresas enterprise en todo el mundo.
Lo que lo diferencia de un wiki o una hoja de cálculo es que no es solo un repositorio de datos: es un modelo estructurado de tu infraestructura con relaciones entre objetos, validaciones, una API REST y GraphQL completa, y un sistema de webhooks que permite disparar acciones externas ante cambios en los datos.
En términos prácticos: NetBox no documenta tu red estática. Es la base desde la que podés operar, automatizar y evolucionar tu red dinámicamente.
Las capacidades core: qué modela NetBox
IPAM — Gestión de espacio de direcciones IP
El módulo de IPAM (IP Address Management) de NetBox es uno de los más completos del mercado open-source:
- Prefijos y bloques: jerarquía completa de prefijos IPv4 e IPv6 con agregados, roles (loopback, management, cliente, transit), y estados (activo, reservado, deprecado).
- Asignación de IPs: cada dirección IP se puede asignar a una interfaz específica de un dispositivo, con soporte de DNS name, roles, y comentarios.
- VRFs: soporte completo de VRF (Virtual Routing and Forwarding) con espacios de direccionamiento separados por cliente o por servicio.
- VLANs: gestión de VLANs con grupos, roles y asignación a sitios e interfaces.
- Rangos de IPs: rangos para pools de DHCP, CGNAT, o asignación dinámica.
Para un ISP que hoy gestiona el espacio IP en Excel, migrar a NetBox IPAM es el cambio operativo de mayor impacto inmediato. La búsqueda, la auditoría de uso, y la detección de solapamientos se vuelven instantáneas.
DCIM — Infraestructura física y lógica
El módulo DCIM (Data Center Infrastructure Management) modela la infraestructura física:
- Sitios y ubicaciones: jerarquía de regiones, sitios, edificios, plantas, y salas.
- Racks: documentación de racks con elevación visual (rack diagram), potencia, peso, y ocupación.
- Dispositivos: cada dispositivo tiene tipo, fabricante, modelo, número de serie, posición en rack, y estado operativo.
- Interfaces: todas las interfaces de cada dispositivo, con tipo (Ethernet, fibra, LAG, loopback), velocidad, y conexiones entre ellas.
- Cableado: trazado completo de cables físicos entre dispositivos, incluyendo paneles de parcheo y trazado a través de path endpoints.
Para un ISP con nodos de distribución en múltiples ciudades, esto significa poder saber —desde una sola interfaz— qué hay en cada rack, cómo están conectados los equipos, y cuál es el estado de cada puerto, sin necesitar acceso físico al sitio.
Virtualización
NetBox modela entornos virtualizados con la misma granularidad que el hardware físico:
- Clusters de virtualización (VMware, Proxmox, KVM) con sus hosts físicos
- Máquinas virtuales con interfaces, IPs, y relación con el host
- Discos y recursos asignados
Para ISPs que operan plataformas de servicios sobre virtualización (CPE virtual, firewalls virtualizados, funciones de red como NATaaS), esto permite mantener la coherencia entre el modelo de red físico y el virtual en un mismo sistema.
Circuitos y proveedores
El módulo de circuitos modela los enlaces WAN y los proveedores de tránsito:
- Proveedores: registro de carriers, ISPs upstream, y proveedores de última milla con contactos y SLAs.
- Tipos de circuito: categorías propias (fibra dark, IP transit, MPLS, etc.)
- Circuitos: cada enlace WAN con su ID de circuito, velocidad, fecha de instalación, y termination points (a qué interfaces de qué dispositivos conecta en cada extremo).
Para un ISP con múltiples upstreams y cientos de circuitos de cliente, esto reemplaza directamente la hoja de Excel de “mapa de circuitos” y la hace consultable vía API.
Gestión de contexto de configuración
NetBox permite asociar config contexts a dispositivos, roles, sitios, o regiones. Un config context es un JSON que define variables específicas para un subconjunto de dispositivos.
Esto es la base para la generación de configuraciones templatizadas: en lugar de tener un template que asume que todos los routers son iguales, el config context provee las variables específicas de cada dispositivo (ASN local, prefijos anunciados, peers BGP, community strings) que el sistema de automatización usa para generar la configuración correcta.
Tenant management
NetBox soporta multi-tenancy: cada objeto (IP, dispositivo, circuito, VLAN) puede ser asignado a un tenant. Para un ISP, esto significa poder filtrar toda la vista de la red por cliente: ver todas las IPs, circuitos, VLANs y dispositivos asociados a un cliente específico en un solo lugar.
La API: donde NetBox deja de ser documentación y se convierte en motor
La API REST y GraphQL de NetBox es lo que transforma la plataforma de “documentación estructurada” a “fuente de verdad operativa”. Cada objeto en NetBox es accesible, filtrable, y modificable vía API con autenticación por token.
Casos de uso concretos:
Aprovisionamiento automático de clientes: cuando un nuevo cliente es dado de alta en el CRM o sistema de ticketing, un webhook dispara un script que crea el circuito en NetBox, asigna una IP del pool correspondiente, y genera la configuración del equipo de acceso usando los datos del modelo.
Generación de configuraciones con Ansible: los playbooks de Ansible usan NetBox como inventario dinámico (nb_inventory plugin). En lugar de mantener un inventario de hosts estático, Ansible consulta NetBox en cada ejecución y trabaja sobre el estado actual documentado.
Validación pre-cambio: antes de aplicar un cambio de routing, un script consulta NetBox para verificar que los prefijos involucrados están documentados, tienen ROAs válidos, y están asignados al cliente correcto. El cambio no se aplica si la validación falla.
Auditoría de drift de configuración: un proceso periódico compara la configuración activa de los equipos (recolectada vía Netmiko o NAPALM) con el modelo en NetBox. Las diferencias generan alertas o tickets automáticamente.
Integración con sistemas de monitoreo: Zabbix, Prometheus, y Grafana pueden consultar NetBox para descubrir automáticamente qué dispositivos monitorear y con qué parámetros, en lugar de requerir inventarios manuales en cada sistema.
Webhooks y event rules: NetBox como disparador de acciones
A partir de versión 3.x, NetBox incorporó un sistema de event rules que permite ejecutar webhooks o scripts ante cualquier cambio en el modelo:
- Se crea un nuevo prefijo IP → webhook notifica al sistema de monitoreo para incluirlo en el scope de alertas
- Un circuito cambia a estado “activo” → webhook dispara el proceso de aprovisionamiento en el equipo de acceso
- Una IP es asignada a una interfaz → webhook actualiza el registro DNS correspondiente
Este mecanismo convierte a NetBox en el hub central de orquestación: los cambios en la documentación de red se propagan automáticamente a los sistemas operativos.
Plugins: extender NetBox para casos específicos
El ecosistema de plugins de NetBox es amplio y maduro. Algunos de los más relevantes para ISPs:
- netbox-bgp: modela sesiones BGP, peering, route policies, y comunidades. Cubre exactamente la capa que el modelo base de NetBox no incluye.
- netbox-napalm: integra NAPALM para conectar NetBox directamente con los equipos y comparar estado documentado vs. estado real en tiempo real.
- netbox-routing: modela tablas de ruteo, prefijos anunciados, y relaciones entre protocolos de routing.
- netbox-dns: gestión de zonas DNS integrada, con asignación automática de registros A/AAAA al asignar IPs a interfaces.
- validity: validación de configuraciones de red directamente desde NetBox con reglas definibles por el operador.
Hoja de ruta de implementación
Implementar NetBox en un ISP que parte de cero con documentación estructurada no es un proyecto de un fin de semana, pero tampoco requiere meses de consultoría. Un enfoque pragmático:
Fase 1 — IPAM primero (2-4 semanas)
El IPAM es el módulo de mayor impacto inmediato y el más fácil de poblar: la información existe en Excel o en la cabeza del equipo, y migrarla a NetBox es un proceso relativamente directo. Al finalizar esta fase, el equipo tiene un registro autoritativo de todo el espacio IP, VRFs, y VLANs.
Fase 2 — Inventario de dispositivos (2-4 semanas)
Modelar los dispositivos del core, distribución y acceso: fabricante, modelo, sitio, rack, y estado. Incluir las interfaces principales con sus conexiones. Al finalizar, NetBox responde “qué hay en cada sitio” de forma confiable.
Fase 3 — Circuitos y proveedores (1-2 semanas)
Registrar todos los upstreams, peers, y circuitos de clientes con sus termination points. Esto cierra el modelo de “qué conecta con qué y por dónde”.
Fase 4 — Integración con automatización (4-8 semanas)
Con el modelo poblado y confiable, empezar a construir los flujos de automatización: inventario dinámico para Ansible, config contexts para generación de configuraciones, webhooks para integración con otros sistemas.
Por qué el orden importa
La tentación al implementar NetBox es querer modelar todo al mismo tiempo. El resultado suele ser un sistema parcialmente poblado que nadie confía porque “puede estar desactualizado”.
El principio correcto es completitud antes que amplitud: es mejor tener el IPAM completo y confiable al 100% que tener IPAM + DCIM + circuitos todos al 60% de precisión. Un sistema parcialmente confiable crea más problemas que uno con scope limitado pero autoritativo.
La confianza en NetBox como fuente de verdad se construye cuando el equipo aprende que “si está en NetBox, es correcto”. Esa confianza requiere disciplina en el proceso de actualización, no solo en la implementación inicial.
Cómo acompañamos la implementación desde Ayuda.LA
NetBox es open-source y está muy bien documentado. Cualquier equipo técnico puede instalarlo y empezar a usarlo. El desafío no es técnico: es de proceso, modelado, y migración de datos.
En Ayuda.LA trabajamos con ISPs y empresas enterprise en Latinoamérica en implementaciones completas de NetBox:
Diseño del modelo de datos: definir cómo representar tu infraestructura específica en NetBox — qué roles usar, cómo estructurar la jerarquía de sitios, qué config contexts tiene sentido crear, cómo modelar los tipos de circuito de tu red.
Migración de datos: extraer la información existente (Excel, wikis, sistemas propietarios) y cargarla en NetBox de forma estructurada mediante scripts de importación que dejan el modelo limpio y consistente.
Integración con herramientas existentes: conectar NetBox con Ansible, Zabbix, sistemas de tickets (OTRS, Jira, Freshdesk), y cualquier otro sistema que use tu organización. Incluye desarrollo de webhooks y scripts de sincronización.
Desarrollo de flujos de automatización: diseñar e implementar los primeros flujos de aprovisionamiento automático basados en NetBox como fuente de verdad: desde el alta de cliente hasta la generación y aplicación de configuración.
Capacitación del equipo: entrenamiento práctico del equipo NOC e ingeniería en el uso diario de NetBox y en el mantenimiento del modelo a medida que la red evoluciona.
Si tu red no tiene hoy una fuente de verdad confiable, implementar NetBox es probablemente la inversión de infraestructura de procesos con mayor retorno en el mediano plazo.
Hablemos sobre tu implementación de NetBox →
¿Querés evaluar cómo implementar NetBox en tu red ISP o data center? Escribinos a [email protected] — respondemos todos los mensajes.