> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/es/integraciones-y-api/external-monitoring.md). # Monitoreo externo ## 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. {% hint style="warning" %} **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](#snmp-first-tools) a continuación para ver las soluciones alternativas disponibles. {% endhint %} ### Rutas de monitoreo compatibles | Ruta | Uso para | Audiencia | | ---------------------------------------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------- | | [Exportador de Prometheus (ioMetrics)](#prometheus-exporter-iometrics) | métricas de vSAN, clúster y nodo | Punto de partida recomendado para la mayoría de los entornos | | [API REST](#rest-api) | Recolectores personalizados, sondeo de cualquier recurso | Integraciones específicas de herramientas, comprobaciones automatizadas | | [IPMI](#ipmi) | Estado de hardware y sensores por nodo | Monitoreo a nivel de hardware fuera de VergeOS | *** ## 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)](/automate-protect-and-extend/es/integraciones-y-api/prometheus-exporter.md) 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](/automate-protect-and-extend/es/superficies-de-administracion-compartidas/api-keys.md) para la configuración y la [Guía de API](/knowledge-base/es/automation-api/verge-api-guide.md) 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: 1. Haga clic en el **icono de usuario** en la parte superior derecha de la interfaz de VergeOS. 2. Seleccione **Sistema**. 3. 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. {% hint style="success" %} **Por dónde empezar** Para información sobre convenciones HTTP, filtrado, ordenación y solicitudes de ejemplo, consulte la [Guía de API](/knowledge-base/es/automation-api/verge-api-guide.md) en la base de conocimientos. {% endhint %} ### 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. 1. Navegue a **Infraestructura > Nodos** desde el menú superior. 2. Haga doble clic en el nodo deseado para abrir el panel del nodo. 3. 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. {% hint style="info" %} **Solo hardware** IPMI expone el **hardware físico** estado de un nodo host — no las métricas de la capa de aplicación de VergeOS. La mayoría de las plataformas de monitoreo ya incluyen recolectores IPMI que pueden sondear directamente los BMC de los nodos, en paralelo con el Exportador de Prometheus y las rutas de API REST anteriores. {% endhint %} Para configurar credenciales IPMI almacenadas y probar la conectividad, consulte la [IPMI](/run-the-platform/es/administracion-del-sistema/ipmi.md) página. *** ## Herramientas SNMP-first Herramientas como **SolarWinds**, **LogicMonitor**, **PRTG**y **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. {% hint style="success" %} **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](#prometheus-exporter-iometrics) y omita el resto de esta sección. Las dos opciones siguientes cubren herramientas que no hablan Prometheus — incluido el **SolarWinds Platform / SAM**, **PRTG**y **Nagios**. {% endhint %} ### Opción 1 — Recolector REST personalizado La mayoría de las plataformas de monitoreo empresarial permiten recolectores HTTP/REST personalizados: | Plataforma | Mecanismo | | ------------ | ------------------------------------------ | | 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 API](/knowledge-base/es/automation-api/verge-api-guide.md)y 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](#prometheus-exporter-iometrics) 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. {% hint style="warning" %} **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. {% endhint %} *** ## Cómo elegir una ruta | Escenario | Ruta recomendada | | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nueva implementación de monitoreo, sin compromiso previo con herramientas existentes | [Exportador de Prometheus](#prometheus-exporter-iometrics) + Grafana | | Pila existente de Prometheus / Grafana / VictoriaMetrics | [Exportador de Prometheus](#prometheus-exporter-iometrics) | | Herramienta de monitoreo que sondea HTTP pero no Prometheus | [API REST](#rest-api) recolector personalizado | | Salud del hardware (temperatura, ventiladores, energía) | [IPMI](#ipmi) | | SolarWinds / LogicMonitor / PRTG / Nagios (orientadas a SNMP) | [Recolector REST personalizado](#option-1-custom-rest-collector) preferido, [Puente de Prometheus a SNMP](#option-2-prometheus-to-snmp-bridge) como alternativa | ## Siguientes pasos * [Exportador de Prometheus (ioMetrics)](/automate-protect-and-extend/es/integraciones-y-api/prometheus-exporter.md) — descripción general dentro del producto y enlaces al proyecto de código abierto * [Guía de API](/knowledge-base/es/automation-api/verge-api-guide.md) — autenticación, convenciones HTTP y solicitudes de ejemplo * [IPMI](/run-the-platform/es/administracion-del-sistema/ipmi.md) — probar la conectividad, administrar credenciales y acceder a la interfaz web IPMI ## Documentación y recursos | Recurso | Descripción | | -------------------------------------------------------------------------------- | ------------------------------------------------------- | | [vergeos-exporter](https://github.com/verge-io/vergeos-exporter) | Exportador de Prometheus de código abierto para VergeOS | | [Documentación de Prometheus](https://prometheus.io/docs/introduction/overview/) | Documentación upstream de Prometheus | | [Documentación de Grafana](https://grafana.com/docs/) | Creación de paneles con métricas de Prometheus | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/automate-protect-and-extend/es/integraciones-y-api/external-monitoring.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.