Alertas

Las alertas vigilan tus datos para que no tengas que abrir el dashboard a ver si algo se rompió. Una regla revisa una métrica dentro de una ventana de tiempo y te avisa por email, por webhook o por ambos.

La página está dividida: a la izquierda tus tarjetas de reglas y la actividad reciente, a la derecha el constructor. Puedes tener hasta 10 reglas por proyecto.

Dos tipos de regla

Umbral (Threshold) — un valor cruza un límite. “Al menos 500 registros en 15 minutos.” “Como máximo 2 registros en 24 horas.”

Ausencia (Absence) — no hay ningún evento que coincida. La ausencia dispara cuando el conteo es exactamente 0. Esta es la que detecta caídas, y es la que casi todos se olvidan de configurar.

Campos de la regla

Se requiere al menos un canal. El botón de guardar queda deshabilitado hasta que completes un email o una URL de webhook. Una regla sin destino no es una regla.

Sobre el nombre del evento

Dejarlo vacío es una función, no descuido. Una regla de ausencia sin evento significa “no hay tráfico en absoluto”: la alarma de sitio caído.

Los eventos internos con prefijo $, como $pageview, sí son objetivos válidos de alerta. Es una excepción: tus propios nombres de evento no pueden empezar con $, pero las reglas de alerta sí pueden apuntar a los internos. El desplegable lista los eventos vistos en los últimos 30 días.

Cómo funciona la evaluación

Esta parte vale leerla dos veces, porque explica todas las dudas del tipo “¿por qué no me llegó la alerta?”.

Las reglas se recorren cada 60 segundos.

Control de intervalo. Una regla nunca se vuelve a consultar más rápido que max(60 segundos, ventana ÷ 4). Una regla con ventana de 5 minutos se revisa cada minuto. Una de 1 hora, cada 15 minutos. Y una regla de 24 horas se evalúa, como mucho, cada 6 horas: si configuras una ausencia de 24 horas y luego rompes tu tracking, espera la notificación dentro de unas seis horas, no dentro de un minuto. Elige la ventana teniendo eso en cuenta.

Notificaciones por flanco (edge-triggered). Te avisamos una vez cuando la regla pasa de OK → FIRING, y una vez más cuando pasa de FIRING → OK; esa segunda es el aviso de recuperación. No vuelve a notificar en cada intervalo mientras la condición siga siendo cierta. Esta es la diferencia clave con una alerta ingenua: una regla que lleva dos días disparada te manda dos mensajes en total, no doscientos.

Editar una regla la reinicia. Guardar una edición — y también pausar o reactivar una regla — reinicia su estado a OK y borra el último valor, para que la condición modificada se evalúe desde cero en vez de heredar el estado anterior.

Los alias cuentan. El conteo de las alertas respeta tus alias de eventos, igual que los insights.

Leer una tarjeta de regla

Cada tarjeta muestra un chip de estado: OK en verde, ACTIVA en naranja o Pausada en gris con la tarjeta atenuada.

La línea de detalle resume la regla — account_created ≥ 500 · 1 hour para un umbral, $pageview · 0 · 24 hours para una ausencia — más “last value: N”, para que veas qué encontró realmente la última evaluación.

Las píldoras de canal muestran la dirección de email y únicamente el host del webhook, nunca la URL completa con su ruta secreta.

Botones: Editar · Enviar prueba · Pausar/Activar · ✕ Delete.

Actividad reciente

Los últimos 30 disparos, con el tipo (Fired / Recovered / Test), el nombre de la regla, el valor que lo activó, una marca de falló la entrega si el canal no aceptó el mensaje, y la hora.

Los disparos de más de 90 días se purgan.

Qué dice la notificación

El mensaje es {head} — {project}: {body}.

El encabezado es 🚨 {nombre de la regla} al disparar, ✅ {nombre de la regla} recovered al recuperarse, o 🔔 Test: {nombre de la regla} en una prueba. Ejemplos reales:

🚨 Signup drought — MyApp: No account_created in the last 24h
🚨 Signup spike — MyApp: account_created = 812 (≥ 500) in 1h
✅ Signup drought recovered — MyApp: Recovered: account_created = 3 in 1h

Las notificaciones de alerta siempre llegan en inglés. La interfaz de la app es bilingüe, pero un webhook puede apuntar a cualquier lado y un email puede ir a cualquier persona, así que el idioma de quien recibe es desconocido. El texto de la notificación no sigue el idioma de tu interfaz.

El email llega como un mensaje con la marca de LaunchPulse y un botón “View alerts” que lleva directo a la página de alertas de ese proyecto.

Send test

Enviar prueba entrega por los canales reales de inmediato, usando el último valor de la regla (o 0 si no hay), y registra una entrada test en la actividad. Úsalo cada vez que agregues un webhook: es la forma más rápida de descubrir que pegaste la URL equivocada.

Si la entrega falla verás: “Falló el envío de prueba — revisa la configuración del canal.”

Tres reglas que vale la pena tener

Sin registros en 24 horas — Absence · Eventos · tu evento de registro (account_created) · 24 horas. Detecta la rotura silenciosa: el formulario envía, pero la llamada de tracking no.

Pico de tráfico — Threshold · Eventos · nombre de evento vacío · es al menos · 500 · 15 minutos. Te avisa cuando saliste en la portada de algo.

Sitio muerto — Absence · Eventos · nombre de evento vacío · 1 hora. Ningún evento de ningún tipo durante una hora significa que el sitio, el CDN o el script desapareció.

Elegir la ventana

Las ventanas cortas son tentadoras y casi siempre un error. Una regla de ausencia de 5 minutos en un sitio de poco tráfico va a dispararse en cualquier rato tranquilo — la hora del almuerzo, un domingo lento — y la vas a silenciar en menos de una semana.

Empieza en 1 hora. Es la opción práctica hasta que el tráfico sea lo bastante estable como para que un hueco de cinco minutos sea genuinamente anormal. Después ajusta.

Qué sigue

• Webhooks de alertas — formatos de payload, configuración de Slack/Discord/Google Chat y por qué se rechaza una URL
• Insights — arma el gráfico que vas a mirar después de que dispare una alerta
• Alias de eventos — asegúrate de que el evento que alertas es el que crees
• Reporte semanal — el resumen programado, para todo lo que no es urgente