Alertas
Emails cuando aparece un tipo de error nuevo, cuando uno se dispara o cuando una versión empieza a fallar.
En Pro y Business, un proyecto puede enviarte un email cuando algo se rompe, y publicar en Slack o (en Business) en un webhook tuyo. Nadie recibe alertas que no haya pedido: cada persona elige las suyas en la configuración del proyecto, en Alerts. Las organizaciones Free no tienen alertas.
Qué puede enviarte un email
| Alerta | Cuándo |
|---|---|
| Un tipo de error nuevo | Un error que el proyecto no ha tenido en los últimos 30 días: un área y un nombre nuevos. Una vez por error. |
| Un error se dispara | En la última hora, un error ocurrió al menos 20 veces y al menos 3 veces su media por hora de la semana anterior. Como mucho, una vez cada seis horas por error. |
| Una versión empieza a fallar | La versión más reciente con al menos 50 sesiones tiene 5 puntos menos de sesiones sin errores que la versión anterior. Una vez por versión. |
Los errores son eventos de nivel error y critical. Las alertas vigilan el entorno en el que se
abre el panel (consulta Entornos), así que las builds de
desarrollo no despiertan a nadie. Se comprueban cada cinco minutos; un evento que llega tarde
también se detecta.
Cada email indica qué error o qué versión, cuántos eventos y cuántas personas, y enlaza a la página Errors o Releases del proyecto. Nunca incluye de un evento más de lo que muestra la lista del panel.
Elegir las tuyas
En Alerts, en Email me, activa las que quieras. Llegan al email de tu cuenta, que tiene que estar confirmado. Cualquier persona del proyecto puede elegir las suyas; salir de la organización, o que te quiten de ella, las detiene.
Para todo el proyecto
Los propietarios eligen qué alertas envía el proyecto y cuándo cuenta un pico o una versión:
| Ajuste | Por defecto | Rango |
|---|---|---|
| Un pico es este número de veces el ritmo habitual | 3 | De 1,5 a 20 |
| Con al menos este número de eventos en la hora | 20 | De 1 a 100.000 |
| Una versión falla con este número de puntos menos de sesiones sin errores | 5 | De 1 a 50 |
| A partir de este número de sesiones | 50 | De 10 a 100.000 |
Una alerta que un propietario desactiva se detiene para todo el proyecto, eligiera lo que eligiera cada persona.
Planes
| Plan | Alertas |
|---|---|
| Free | Ninguna |
| Pro | Email y Slack |
| Business | Email, Slack y webhooks |
Slack
Los propietarios conectan un canal de Slack por proyecto, en Also send to:
- En Slack, crea un incoming webhook para el canal (una app con Incoming Webhooks activado y, después, Add New Webhook).
- Pega su dirección (empieza por
https://hooks.slack.com/services/) en Slack, elige qué alertas van ahí y elige Connect. - Send a test publica un mensaje para comprobar que llega.
La dirección es un secreto: cualquiera que la tenga puede publicar en el canal. Lyrelog nunca vuelve a mostrarla entera, solo su final, y nunca la registra en sus logs. Los mensajes se publican para todo el proyecto, eligiera lo que eligiera cada persona para el email. Si Slack responde que el webhook ya no existe, Lyrelog deja de intentarlo; quítalo y conecta uno nuevo.
Webhooks
En Business, los propietarios también pueden conectar un webhook: cualquier dirección https://
en el puerto 443 a la que Lyrelog pueda llegar por internet. Cada alerta es un POST con un cuerpo
JSON:
{
"type": "alert",
"kind": "new_error",
"project": { "id": "a83810a9e984", "name": "Tilefall" },
"title": "A new kind of error in Tilefall",
"detail": "Tilefall has an error it hadn't had in the last 30 days.",
"url": "https://app.lyrelog.com/p/a83810a9e984/errors",
"issue": { "area": "save", "name": "Couldn't write the save file", "events": 4, "people": 3 },
"release": null,
"sent_at": "2026-11-20T12:54:36Z"
}kind es new_error, spike, release o test. Un pico incluye issue con los eventos y las
personas de la última hora; una versión que falla incluye release en su lugar:
"release": { "version": "2.1", "previous": "2.0", "error_free": 0.8, "previous_error_free": 0.95, "sessions": 200 }Comprobar que viene de Lyrelog
Al conectar el webhook, Lyrelog muestra una sola vez su secreto de firma (whsec_...). Cada
petición lleva X-Lyrelog-Signature: t=<unix seconds>,v1=<hex>, donde v1 es el HMAC-SHA256 de
<t>.<body> con ese secreto. Vuelve a calcularlo sobre el cuerpo sin procesar, compáralo en
tiempo constante y rechaza un t de hace más de cinco minutos:
import { createHmac, timingSafeEqual } from "node:crypto"
function fromLyrelog(rawBody, header, secret) {
const { t, v1 } = Object.fromEntries(header.split(",").map((part) => part.split("=")))
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false
const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex")
return v1.length === expected.length && timingSafeEqual(Buffer.from(v1), Buffer.from(expected))
}Entrega
Responde con cualquier 2xx en menos de 10 segundos. Lyrelog no sigue redirecciones. Un 5xx, un
408, un 429 o la falta de respuesta se reintenta más tarde (a los 30 segundos y después
duplicando el tiempo, hasta 8 intentos); cualquier otro 4xx se descarta. La configuración
muestra cómo fue la última entrega.