Alertas por email
Puedes disparar alertas en AlertHub simplemente enviando un email. Es útil cuando un sistema solo admite notificaciones por correo, cuando quieres reenviar emails de alerta existentes o cuando necesitas levantar una alerta rápido desde tu bandeja.
Cómo funciona
AlertHub escucha emails entrantes en direcciones dedicadas de sendalert.thealerthub.com. Cuando llega un email, se convierte en una alerta con este mapeo:
| Campo del email | Campo de la alerta |
|---|---|
| Asunto | ah_title |
| Cuerpo | ah_description |
| Dirección del destinatario | ah_key (Project Secret Key) y ah_level |
| Remitente | ah_source (con el prefijo Email:) |
Direcciones de email
La dirección del destinatario determina qué proyecto recibe la alerta y su nivel de gravedad.
Formato:
{YOUR_PROJECT_SECRET_KEY}@{level}.sendalert.thealerthub.comSustituye {YOUR_PROJECT_SECRET_KEY} por la Project Secret Key de 64 caracteres de tu panel de proyecto.
Niveles de alerta
| Nivel | Dirección del destinatario |
|---|---|
| Info (por defecto) | {ah_key}@sendalert.thealerthub.com |
| Info | {ah_key}@info.sendalert.thealerthub.com |
| Warning | {ah_key}@warning.sendalert.thealerthub.com |
| Critical | {ah_key}@critical.sendalert.thealerthub.com |
Consejo: Si usas
@sendalert.thealerthub.com(sin prefijo de nivel), el nivel de la alerta es info por defecto.
Ejemplo
Dada una Project Secret Key a1b2c3d4e5f6... (64 caracteres):
Para: [email protected]
Asunto: Database connection pool exhausted
Cuerpo:
Connection pool on prod-db-01 reached 100% capacity at 14:32 UTC.
Active connections: 50/50.Esto crea una alerta warning titulada “Database connection pool exhausted” con el cuerpo como descripción y el origen Email: [email protected].
Requisitos
- El asunto no puede estar vacío — se convierte en el título de la alerta.
- La Project Secret Key en la dirección del destinatario debe tener exactamente 64 caracteres.
- El email debe enviarse a uno de los cuatro dominios aceptados de arriba.
Emails reenviados
Si reenvías un email existente a AlertHub, el contenido y el asunto originales se extraen automáticamente. Se eliminan cabeceras habituales de reenvío de Gmail, Outlook, Apple Mail y otros clientes para que la alerta refleje la notificación original, no los metadatos del reenvío.
Casos de uso
- Reenviar alertas de monitorización de sistemas legacy que solo envían email.
- Dispositivos con salida solo por email — NAS, impresoras, SAI, equipos de red.
- Alertas manuales — envía un email desde el móvil o el escritorio en segundos.
- Reglas y filtros de correo — configura Outlook, Gmail o reglas en el servidor para reenviar automáticamente ciertos mensajes a AlertHub.
Consideraciones de seguridad
- Tu Project Secret Key forma parte de la dirección del destinatario. Evita compartir las direcciones de alerta en público o en reglas de reenvío no confiables.
- Restringe las reglas de reenvío automático a remitentes de confianza siempre que puedas.
- Para integraciones programáticas o entre servidores, usa la API de ingestión — mantiene tu clave secreta fuera de cabeceras y logs de email.
Relacionado
- API de ingestión — envía alertas por HTTP con control total del payload y variables personalizadas.
- Primeros pasos — crea un proyecto y localiza tu Project Secret Key.