> 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/learn-the-platform/es/modulo-9-supervision-y-resolucion-de-problemas/02-alerts.md).

# Suscripciones y alertas

## Monitoreo proactivo con suscripciones

Los paneles y los registros son reactivos: ves los problemas cuando los miras. **Suscripciones** hacer que el monitoreo de VergeOS sea proactivo mediante el envío de notificaciones por correo electrónico cuando cambian las condiciones o según un horario regular. Todo entorno de VergeOS debería tener configurado desde el primer día un conjunto básico de suscripciones para que los administradores se enteren de los problemas antes que los usuarios finales.

Las suscripciones requieren una **configuración SMTP funcional** (tratada más adelante en esta página). Una vez que SMTP está en su lugar, cualquier panel, nivel, red, VM, inquilino u otro objeto de VergeOS puede tener una o más suscripciones asociadas.

```mermaid
graph LR
    subgraph triggers["Motor de suscripciones"]
        direction TB
        OD["Bajo demanda<br/>(Evento / Umbral)"]
        SC["Programado<br/>(Informes temporizados)"]
    end

    subgraph delivery["Entrega"]
        SMTP["Servidor SMTP"]
        QUEUE["Cola de correo"]
        INBOX["Bandeja de entrada del administrador"]
    end

    OD -->|se superó el umbral| SMTP
    SC -->|transcurrió el intervalo| SMTP
    SMTP --> QUEUE --> INBOX

    style triggers fill:#f0f4ff,stroke:#336
    style delivery fill:#f0fff4,stroke:#363
```

## Tipos de suscripción

VergeOS ofrece dos tipos complementarios de suscripción. Un entorno monitoreado de forma eficaz usa **ambos** ambos tipos juntos: suscripciones bajo demanda para conocer de inmediato los problemas y suscripciones programadas para seguir tendencias y supervisar el día a día.

### Suscripciones bajo demanda

Las suscripciones bajo demanda son **activadas por eventos o por umbral** alertas. Se activan tan pronto como se cumple una condición, lo que garantiza que los administradores sean notificados de posibles problemas casi en tiempo real.

Los desencadenantes comunes de las suscripciones bajo demanda incluyen:

| Categoría de desencadenante  | Ejemplo                                                                      |
| ---------------------------- | ---------------------------------------------------------------------------- |
| **Umbral de almacenamiento** | el nivel de vSAN alcanza un porcentaje especificado de capacidad utilizada   |
| **Actualización disponible** | Nuevos paquetes de actualización de VergeOS están listos para instalarse     |
| **Errores / advertencias**   | Cualquier evento de error o advertencia se registra en un objeto monitoreado |
| **Cambios de estado**        | Un nodo se desconecta, una VM se detiene inesperadamente, una red falla      |

Las suscripciones bajo demanda son la primera línea de defensa: te indican que algo necesita atención **ahora mismo**.

### Suscripciones programadas

Las suscripciones programadas entregan **información del panel o del listado en intervalos de tiempo configurados**. Están diseñadas para proporcionar resúmenes periódicos del estado del sistema y ayudar a los administradores con la supervisión diaria y el seguimiento de tendencias.

Ejemplos de suscripciones programadas:

* **Panel del sistema** enviado diariamente a las 7:00 AM: ofrece al equipo una instantánea matutina del estado
* **Panel del nivel vSAN** enviado semanalmente: sigue las tendencias de crecimiento de la capacidad a lo largo del tiempo
* **Listado de VM** enviado semanalmente: revisa el inventario de cargas de trabajo en ejecución
* **Panel del inquilino** enviado diariamente: supervisa el consumo de recursos del inquilino

{% hint style="success" %}
**Monitoreo eficiente**

Un entorno VergeOS bien monitoreado tendrá **múltiples suscripciones bajo demanda y programadas** configuradas. Las suscripciones bajo demanda detectan eventos agudos; las programadas revelan tendencias lentas como el consumo gradual de capacidad.
{% endhint %}

## Crear una suscripción

Las suscripciones se administran desde **System > Subscriptions** en la interfaz de VergeOS. El flujo de creación te guía por los siguientes campos:

### Configuración paso a paso

1. Vaya a **System > Subscriptions** desde el Cloud Dashboard
2. Selecciona **Nuevo** en el menú izquierdo
3. Configura los campos de la suscripción:

| Campo                     | Descripción                                                                                                                                                   |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre**                | Una etiqueta única para la suscripción (se usa en la vista de lista y en las líneas de asunto del correo)                                                     |
| **Tipo de propietario**   | **Usuario** (destinatario individual) o **Grupo** (equipo de destinatarios)                                                                                   |
| **Propietario**           | Selecciona el usuario o grupo específico en la lista desplegable                                                                                              |
| **Tipo de destino**       | La categoría de objeto de VergeOS que se va a monitorear (por ejemplo, Cluster, nivel vSAN, red, VM, inquilino, sistema)                                      |
| **Destino**               | La instancia específica de ese tipo de objeto (por ejemplo, "Tier 1 - SSD", "Red de producción", "Nodo 1")                                                    |
| **Tipo**                  | **Bajo demanda** (activado) o **Programada** (temporizado)                                                                                                    |
| **Perfil de suscripción** | Obligatorio: define el contenido del informe/alerta y, para bajo demanda, la lógica de comparación; las opciones mostradas se filtran por **Tipo de destino** |
| **Suspender**             | Pausar opcionalmente las notificaciones hasta una fecha/hora o indefinidamente (útil durante ventanas de mantenimiento)                                       |

### Configuración bajo demanda

Cuando el tipo de suscripción se establece en **Bajo demanda**, aparecen campos adicionales:

| Campo                         | Descripción                                                                                                                                                                                              |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Perfil de suscripción**     | Plantilla obligatoria que codifica tanto qué vigilar (`onchange_fields`) como cómo se compara (`nuevo`, `gt0`, `gt`, `anyval`, o `diferente`) -- los perfiles disponibles se filtran por Tipo de destino |
| **Limitación**                | Mínimo de minutos entre alertas repetidas para la misma condición: evita inundar la bandeja de entrada (máximo 60 minutos)                                                                               |
| **Intervalo de recordatorio** | Con qué frecuencia volver a enviar la alerta mientras la condición persista (por ejemplo, cada 4 horas)                                                                                                  |

La **limitación** es crítica en entornos ruidosos. Sin ella, una condición inestable (por ejemplo, un sensor de temperatura oscilando alrededor de un umbral) podría generar cientos de correos. La limitación tiene un tope de **60 minutos** (el máximo del campo); elige un valor entre 15 y 60 minutos para la mayoría de las alertas, usando 60 cuando quieras el intervalo más largo que permite el sistema.

La **intervalo de recordatorio** garantiza que un problema persistente no se olvide. Si un nivel de vSAN está al 90% de capacidad y nadie actúa sobre la alerta inicial, el recordatorio volverá a notificar en el intervalo configurado hasta que la condición desaparezca.

### Configuración programada

Cuando el tipo de suscripción se establece en **Programada**, configuras el momento de entrega:

| Campo          | Descripción                                                           |
| -------------- | --------------------------------------------------------------------- |
| **Frecuencia** | Con qué frecuencia se envía el informe (por ejemplo, diario, semanal) |
| **Hora**       | La hora del día en que se genera y entrega el informe                 |
| **Día**        | Para programaciones semanales, qué día de la semana                   |

## Perfiles de suscripción y destino

Las suscripciones de VergeOS son flexibles en su destino: puedes crear suscripciones para prácticamente cualquier objeto del sistema:

### A nivel de sistema

Supervisa el panel general del sistema, la salud del clúster o la disponibilidad de actualizaciones en todo el entorno.

### A nivel de almacenamiento

Seguimiento de niveles vSAN individuales para umbrales de capacidad, errores de disco o estados de redundancia degradada.

### A nivel de red

Alertas sobre fallos de red, cambios de conectividad o anomalías de tráfico en redes internas o externas específicas.

### A nivel de carga de trabajo

Supervisa VMs individuales o entornos de inquilinos para detectar cambios de estado, agotamiento de recursos o eventos de error.

Este destino granular significa que puedes crear una estrategia de suscripción que se ajuste a tu modelo operativo: alertas amplias a nivel de sistema para el equipo de infraestructura, y alertas específicas de VM o inquilino para propietarios de aplicaciones o clientes MSP.

## Configuraciones de alertas comunes

Las siguientes configuraciones de suscripción representan las mejores prácticas para la mayoría de las implementaciones de VergeOS. Considéralas como una **plantilla de partida** y personalízalas según tu entorno.

### Alertas de capacidad de almacenamiento

| Ajuste                    | Valor                                                                                                     |
| ------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Tipo de destino**       | Nivel vSAN                                                                                                |
| **Destino**               | Cada nivel individualmente (Nivel 1, Nivel 2, etc.)                                                       |
| **Tipo**                  | Bajo demanda                                                                                              |
| **Perfil de suscripción** | Un perfil de capacidad del nivel vSAN (por ejemplo, "% usado del nivel") que compara el uso con un umbral |
| **Limitación**            | 60 minutos                                                                                                |
| **Recordatorio**          | 4 horas                                                                                                   |

Crea suscripciones separadas en varios umbrales (80% advertencia, 90% crítico) para proporcionar urgencia creciente.

### Detección de nodo desconectado

| Ajuste                    | Valor                                                                         |
| ------------------------- | ----------------------------------------------------------------------------- |
| **Tipo de destino**       | Nodo                                                                          |
| **Destino**               | Cada nodo individualmente                                                     |
| **Tipo**                  | Bajo demanda                                                                  |
| **Perfil de suscripción** | Un perfil de estado del nodo que detecta una transición fuera de En ejecución |
| **Limitación**            | 15 minutos                                                                    |
| **Recordatorio**          | 1 hora                                                                        |

### Estado degradado de vSAN

| Ajuste                    | Valor                                                                               |
| ------------------------- | ----------------------------------------------------------------------------------- |
| **Tipo de destino**       | Nivel vSAN                                                                          |
| **Destino**               | Cada nivel individualmente                                                          |
| **Tipo**                  | Bajo demanda                                                                        |
| **Perfil de suscripción** | Un perfil de salud del nivel vSAN que se activa ante eventos de error o advertencia |
| **Limitación**            | 30 minutos                                                                          |
| **Recordatorio**          | 2 horas                                                                             |

### Disponibilidad de actualizaciones

| Ajuste                    | Valor                                                                                  |
| ------------------------- | -------------------------------------------------------------------------------------- |
| **Tipo de destino**       | Sistema                                                                                |
| **Tipo**                  | Bajo demanda                                                                           |
| **Perfil de suscripción** | Un perfil de disponibilidad de actualizaciones que detecta nuevos paquetes instalables |
| **Limitación**            | 60 minutos (el máximo)                                                                 |
| **Recordatorio**          | 7 días                                                                                 |

### Informe diario de estado del sistema

| Ajuste              | Valor             |
| ------------------- | ----------------- |
| **Tipo de destino** | Panel del sistema |
| **Tipo**            | Programada        |
| **Frecuencia**      | Diario            |
| **Hora**            | 7:00 AM           |

## Requisito previo de configuración SMTP

Las suscripciones dependen por completo de la entrega por correo electrónico. Antes de que cualquier suscripción pueda enviar notificaciones, **SMTP debe estar configurado** en **System > SMTP** en la interfaz de VergeOS.

VergeOS proporciona un servidor de correo integrado que puede enviar correo electrónico **directamente** o enrutarlo a través de un **relay SMTP** servicio.

### Configuración SMTP

Vaya a **System > SMTP > Edit Settings** y configura lo siguiente:

| Ajuste                      | Descripción                                                                                                           |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Usar TLS**                | Habilita o deshabilita el cifrado TLS: actívalo siempre que sea compatible con el relay o el servidor receptor        |
| **Nombre de host**          | FQDN del servidor de envío: debe resolverse en DNS con los SPF, DMARC y DNS inverso adecuados                         |
| **Nombre del remitente**    | Nombre para mostrar que aparece en los mensajes de correo electrónico (por ejemplo, "Alertas de VergeOS")             |
| **Dirección del remitente** | Dirección de correo de origen para todos los correos de suscripción                                                   |
| **Servidor de relay**       | Dirección de un servidor relay SMTP externo (deja en blanco para el envío directo)                                    |
| **Puerto del relay**        | Puerto TCP para el relay: 25 (sin cifrar), 587 (TLS/STARTTLS) o 465 (SSL heredado)                                    |
| **Usar autorización SASL**  | Actívalo cuando el relay requiera autenticación: mostrará los campos de Nombre de usuario y Contraseña a continuación |
| **Nombre de usuario**       | Nombre de usuario SASL para la autenticación del relay (se muestra cuando la autorización SASL está habilitada)       |
| **Contraseña**              | Contraseña SASL para la autenticación del relay (se muestra cuando la autorización SASL está habilitada)              |

### Envío directo vs. relay

| Enfoque           | Ventajas                                                  | Desventajas                                                         |
| ----------------- | --------------------------------------------------------- | ------------------------------------------------------------------- |
| **Envío directo** | Sin dependencias externas, entrega inmediata              | Requiere DNS/SPF/DMARC/rDNS correctos; puede ser filtrado como spam |
| **Relay SMTP**    | Mejor capacidad de entrega, requisitos de DNS más simples | Depende de un servicio externo; puede tener límites de tasa         |

{% hint style="success" %}
**Recomendación práctica**

Muchos clientes optan por un servicio comercial de relay SMTP (por ejemplo, SendGrid, Amazon SES o un relay interno de Exchange) porque simplifica la configuración de DNS, mejora la capacidad de entrega y evita problemas de filtrado de spam. El proveedor del relay te proporcionará el host, el puerto y las credenciales correctas para tu configuración SMTP.
{% endhint %}

### Requisitos de DNS y capacidad de entrega

Al usar **envío directo** (sin relay), los siguientes registros DNS deben estar configurados correctamente para evitar que el correo sea rechazado o marcado como spam:

* **Registro SPF** -- Autoriza la IP del servidor VergeOS para enviar correo electrónico para el dominio configurado
* **Registro DMARC** -- Define la política de autenticación de correo del dominio
* **DNS inverso (PTR)** -- La IP de envío debe tener un registro PTR que coincida con el nombre de host configurado
* **Registro MX** -- Aunque no es necesario para enviar, una configuración MX correcta ayuda a establecer la legitimidad del dominio

### Panel y supervisión SMTP

La **Panel SMTP** (System > SMTP) proporciona visibilidad operativa sobre la entrega de correo electrónico:

* **Cola de correo** -- Ver mensajes pendientes, estado de reintento y fallos de entrega
* **Registro de correo** -- Registro de auditoría de todos los mensajes enviados con marcas de tiempo y estado de entrega
* **Correo de prueba** -- Envía un mensaje de prueba para verificar la configuración antes de confiar en ella para alertas de producción

Envía siempre un **correo de prueba** después de configurar SMTP y antes de crear suscripciones. Esto valida la entrega de extremo a extremo, incluida la resolución DNS, la negociación TLS, la autenticación del relay y la llegada a la bandeja de entrada.

## Gestión de suscripciones

### Ver y editar suscripciones

Todas las suscripciones configuradas aparecen listadas en **System > Subscriptions**. Desde esta vista puedes:

* Ver el propietario, el destino, el tipo y el estado de cada suscripción
* Editar suscripciones existentes para ajustar umbrales, intervalos de limitación o destinatarios
* Eliminar suscripciones que ya no se necesitan
* Identificar rápidamente qué objetos tienen cobertura de alertas y cuáles no

### Consideraciones multiinquilino

En entornos multiinquilino, las suscripciones pueden configurarse **de forma independiente en cada nivel de inquilino**. Esto significa:

* La **proveedor de servicios** configura suscripciones a nivel de sistema en el entorno host
* Cada **administrador del inquilino** puede configurar sus propias suscripciones dentro del ámbito de su inquilino
* Las suscripciones del inquilino solo tienen visibilidad sobre sus propios recursos: no pueden ver ni generar alertas sobre objetos del nivel host

Este aislamiento garantiza que los clientes MSP puedan gestionar por sí mismos sus alertas sin requerir la intervención del proveedor.

{% hint style="info" %}
**¿Vienes de VMware o Nutanix?**

En VergeOS, una sola **suscripción** unifica la condición (mediante su Perfil de suscripción), el enrutamiento (Propietario + SMTP) y cualquier informe programado del panel en un solo objeto, por lo que configuras los tres juntos sobre el mismo destino en lugar de ensamblar constructos separados.
{% endhint %}

## Puntos clave

### Dos tipos de suscripción

**Bajo demanda** para alertas inmediatas de eventos/umbrales y **Programada** para informes recurrentes del panel. Usa ambos juntos para una cobertura completa.

### SMTP primero

Configura y prueba la entrega SMTP antes de crear cualquier suscripción. Envío directo o relay: ambos funcionan, pero el relay suele ser más fácil de mantener.

### Limitar y recordar

Usa la configuración de limitación para evitar tormentas de alertas y los intervalos de recordatorio para asegurarte de que los problemas persistentes no se olviden.

### Destina cualquier cosa

Las suscripciones pueden dirigirse a cualquier objeto de VergeOS: sistemas, clústeres, niveles, redes, VMs e inquilinos, para lograr la máxima flexibilidad de monitoreo.


---

# 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/learn-the-platform/es/modulo-9-supervision-y-resolucion-de-problemas/02-alerts.md?ask=<question>&goal=<endgoal>
```

`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.
