Acceso anticipadoSolo por invitación, y los SDK aún no están publicados.Pedir una invitación
Ir al contenido
Docs

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

AlertaCuándo
Un tipo de error nuevoUn 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 disparaEn 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 fallarLa 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:

AjustePor defectoRango
Un pico es este número de veces el ritmo habitual3De 1,5 a 20
Con al menos este número de eventos en la hora20De 1 a 100.000
Una versión falla con este número de puntos menos de sesiones sin errores5De 1 a 50
A partir de este número de sesiones50De 10 a 100.000

Una alerta que un propietario desactiva se detiene para todo el proyecto, eligiera lo que eligiera cada persona.

Planes

PlanAlertas
FreeNinguna
ProEmail y Slack
BusinessEmail, Slack y webhooks

Slack

Los propietarios conectan un canal de Slack por proyecto, en Also send to:

  1. En Slack, crea un incoming webhook para el canal (una app con Incoming Webhooks activado y, después, Add New Webhook).
  2. Pega su dirección (empieza por https://hooks.slack.com/services/) en Slack, elige qué alertas van ahí y elige Connect.
  3. 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.