Monitoreo externo
VergeOS no admite SNMP. Esta guía cubre las rutas compatibles para el monitoreo externo: el Exportador de Prometheus (ioMetrics), la API REST e IPMI, además de herramientas orientadas primero a SNMP como SolarWinds.
Descripción general
Esta página describe cómo integrar VergeOS con plataformas externas de monitoreo y observabilidad. VergeOS prioriza la API y expone la salud de la plataforma, el rendimiento y los datos de sensores de hardware a través de tres rutas compatibles.
SNMP no es compatible
VergeOS no incluye un agente SNMP, un MIB ni un mecanismo de traps. SNMP fue diseñado a finales de la década de 1980 para administrar dispositivos de red de hardware, como routers, switches e impresoras, no plataformas modernas definidas por software. VergeOS prioriza la API: cada métrica y recurso que expondría un agente SNMP ya está disponible a través de la API REST y del Exportador de Prometheus, que proporcionan datos estructurados más ricos mediante HTTP estándar. Esto refleja el cambio más amplio de la industria, con Microsoft dejando obsoleto el servicio SNMP en Windows Server 2012, y con plataformas nativas de la nube e hipervisores estandarizándose en el formato de exposición de Prometheus. Si su herramienta de monitoreo heredada requiere SNMP, consulte Herramientas SNMP-first a continuación para ver las soluciones alternativas disponibles.
Rutas de monitoreo compatibles
métricas de vSAN, clúster y nodo
Punto de partida recomendado para la mayoría de los entornos
Recolectores personalizados, sondeo de cualquier recurso
Integraciones específicas de herramientas, comprobaciones automatizadas
Exportador de Prometheus (ioMetrics)
El Exportador de Prometheus de VergeOS (ioMetrics) es la ruta recomendada para métricas a nivel de plataforma. Recopila métricas de la capa vSAN, del clúster y del nodo desde VergeOS y las expone en formato estándar de Prometheus, listas para ser recuperadas por Prometheus, Grafana, VictoriaMetrics o cualquier sistema compatible con Prometheus.
Por qué esta es la ruta recomendada
De primera mano — mantenido en la organización verge-io
Basado en estándares — cualquier herramienta de monitoreo compatible con Prometheus puede consumir la salida
Consulte la Exportador de Prometheus (ioMetrics) página para obtener la descripción general dentro del producto, las métricas expuestas y los enlaces al proyecto de código abierto.
API REST
La API REST de VergeOS expone cada recurso que la interfaz de usuario puede leer, lo que la convierte en la ruta correcta para recolectores personalizados, comprobaciones de salud automatizadas o integraciones con herramientas que no hablan Prometheus.
Autenticación
Los recolectores de monitoreo externos se ejecutan durante mucho tiempo y deben autenticarse con una clave de API en lugar de un token de sesión. Las claves de API se crean por usuario y pueden restringirse por IP y tener una fecha de expiración. Consulte Claves de API para la configuración y la Guía de API para la lista completa de métodos de autenticación compatibles.
Documentación Swagger
La referencia completa de la API, exacta según la versión, está disponible dentro de VergeOS:
Haga clic en el icono de usuario en la parte superior derecha de la interfaz de VergeOS.
Seleccione Sistema.
Seleccione Documentación de la API.
La página Swagger enumera cada tabla y operación, con ejemplos que pueden ejecutarse directamente contra el sistema.
Por dónde empezar
Para información sobre convenciones HTTP, filtrado, ordenación y solicitudes de ejemplo, consulte la Guía de API en la base de conocimientos.
Cuándo usar la API REST para el monitoreo
La herramienta de monitoreo admite sondeo HTTP pero no Prometheus
Una métrica o recurso específico no está expuesto por el Exportador de Prometheus
Se necesita un recolector personalizado para integrarlo con una plataforma de observabilidad interna
IPMI
Para el estado de hardware y los datos de sensores por nodo — temperatura, velocidad de ventiladores, voltaje, consumo de energía, errores de hardware — VergeOS expone directamente la interfaz IPMI del nodo.
Navegue a Infraestructura > Nodos desde el menú superior.
Haga doble clic en el nodo deseado para abrir el panel del nodo.
En el IPMI submenú, haga clic en Conectar para abrir la interfaz web IPMI en una nueva pestaña, o Probar para verificar la conectividad desde VergeOS.
Para configurar credenciales IPMI almacenadas y probar la conectividad, consulte la IPMI página.
Herramientas SNMP-first
Herramientas como SolarWinds, LogicMonitor, PRTGy Nagios a menudo se configuran para monitorear la infraestructura mediante SNMP. VergeOS no tiene una integración lista para usar para estas herramientas porque no hay ningún agente SNMP al que apuntarlas.
Compruebe primero la compatibilidad nativa con Prometheus
Algunas de estas plataformas ahora ingieren métricas de Prometheus de forma nativa — LogicMonitor (OpenMetrics DataSource) y SolarWinds Observability (integración de Prometheus). Si su plataforma es una de ellas, apúntela al Exportador de Prometheus y omita el resto de esta sección. Las dos opciones siguientes cubren herramientas que no hablan Prometheus — incluido el SolarWinds Platform / SAM, PRTGy Nagios.
Opción 1 — Recolector REST personalizado
La mayoría de las plataformas de monitoreo empresarial permiten recolectores HTTP/REST personalizados:
SolarWinds
Consultor de API (SAM)
LogicMonitor
Fuente de datos con script (Groovy / HTTP)
PRTG
Sensor personalizado HTTP XML/REST
Nagios
check_http / complemento personalizado
Apunte el recolector a la API REST de VergeOS, autentíquese según la Guía de APIy analice la respuesta JSON. Esta es la ruta de menor sobrecarga: no hay ningún proceso intermedio que mantener y el recolector se comunica directamente con la fuente de verdad.
Opción 2 — Puente de Prometheus a SNMP
Si la herramienta de monitoreo solo habla SNMP y un recolector personalizado no es una opción, el patrón de la comunidad es ejecutar el Exportador de Prometheus y colocar delante de él un puente de Prometheus a SNMP. El puente vuelve a exponer las métricas de Prometheus como OID SNMP que un sondeador SNMP puede recopilar.
No compatible con Verge
Los puentes de Prometheus a SNMP son proyectos comunitarios y no son construidos, probados ni compatibles por Verge. No avalamos un puente específico: la elección depende de qué subconjunto de métricas de Prometheus necesita volver a exponerse y de cómo la herramienta de destino consume SNMP. Considere esta ruta como una solución temporal, no como una integración a largo plazo.
Cómo elegir una ruta
Nueva implementación de monitoreo, sin compromiso previo con herramientas existentes
Exportador de Prometheus + Grafana
Pila existente de Prometheus / Grafana / VictoriaMetrics
Herramienta de monitoreo que sondea HTTP pero no Prometheus
API REST recolector personalizado
Salud del hardware (temperatura, ventiladores, energía)
SolarWinds / LogicMonitor / PRTG / Nagios (orientadas a SNMP)
Recolector REST personalizado preferido, Puente de Prometheus a SNMP como alternativa
Siguientes pasos
Exportador de Prometheus (ioMetrics) — descripción general dentro del producto y enlaces al proyecto de código abierto
Guía de API — autenticación, convenciones HTTP y solicitudes de ejemplo
IPMI — probar la conectividad, administrar credenciales y acceder a la interfaz web IPMI
Documentación y recursos
Exportador de Prometheus de código abierto para VergeOS
Documentación upstream de Prometheus
Creación de paneles con métricas de Prometheus
Última actualización
¿Te fue útil?