Alertas
E-mails quando aparece um novo tipo de erro, quando um erro dispara ou quando uma versão começa a falhar.
Nos planos Pro e Business, um projeto pode enviar um e-mail para você quando algo quebra, e postar no Slack ou (no Business) num webhook seu. Ninguém recebe alertas que não pediu: cada pessoa escolhe os seus nas configurações do projeto, em Alerts. As organizações no plano Free não têm alertas.
O que pode gerar um e-mail
| Alerta | Quando |
|---|---|
| A new kind of error (um novo tipo de erro) | Um erro que o projeto não teve nos últimos 30 dias: uma nova combinação de área e nome. Uma vez por erro. |
| An error spikes (um erro dispara) | Na última hora, um erro aconteceu pelo menos 20 vezes e pelo menos 3 vezes a média por hora dele na semana anterior. No máximo uma vez a cada seis horas por erro. |
| A version starts failing (uma versão começa a falhar) | A versão mais recente com pelo menos 50 sessões tem 5 pontos a menos de sessões sem erros do que a versão anterior. Uma vez por versão. |
Os erros são eventos nos níveis error e critical. Os alertas observam o ambiente em que o
painel abre (veja Ambientes), então os builds de desenvolvimento
não acordam ninguém. Eles são verificados a cada cinco minutos; um evento que chega atrasado
continua sendo percebido.
Cada e-mail diz qual erro ou versão, quantos eventos e pessoas, e traz um link para a página Errors ou Releases do projeto. Ele nunca traz mais detalhes de um evento do que a lista do painel mostra.
Escolha os seus
Em Alerts, na seção Email me, ative os que você quer. Eles vão para o e-mail da sua conta, que precisa estar confirmado. Qualquer pessoa no projeto pode escolher os seus; sair da organização, ou ser removido dela, encerra os alertas.
Para todas as pessoas do projeto
Os proprietários escolhem quais alertas o projeto envia e quando um pico ou uma versão conta:
| Configuração | Padrão | Intervalo |
|---|---|---|
| Um pico é esta quantidade de vezes a taxa habitual | 3 | 1,5 a 20 |
| Com pelo menos esta quantidade de eventos na hora | 20 | 1 a 100.000 |
| Uma versão está falhando com esta quantidade de pontos a menos de sessões sem erros | 5 | 1 a 50 |
| Depois de ter esta quantidade de sessões | 50 | 10 a 100.000 |
Um alerta que um proprietário desativa para de ser enviado para todas as pessoas do projeto, seja qual for a escolha de cada uma.
Planos
| Plano | Alertas |
|---|---|
| Free | Nenhum |
| Pro | E-mail e Slack |
| Business | E-mail, Slack e webhooks |
Slack
Os proprietários conectam um canal do Slack por projeto, em Also send to:
- No Slack, crie um incoming webhook para o canal (um app com Incoming Webhooks ativado e, depois, Add New Webhook).
- Cole o endereço dele (começa com
https://hooks.slack.com/services/) em Slack, escolha quais alertas vão para lá e escolha Connect. - Send a test posta uma mensagem para conferir se ela chega.
O endereço é um segredo: qualquer pessoa que o tenha pode postar no canal. O Lyrelog nunca o mostra inteiro de novo, só o final, e nunca o registra em logs. As mensagens são postadas para todas as pessoas do projeto, seja qual for a escolha de cada pessoa para o e-mail. Se o Slack responder que o webhook não existe mais, o Lyrelog para de tentar; remova-o e conecte um novo.
Webhooks
No Business, os proprietários também podem conectar um webhook: qualquer endereço https:// na
porta 443 que o Lyrelog consiga acessar pela internet. Cada alerta é um POST com um corpo 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 é new_error, spike, release ou test. Um pico traz issue com os eventos e as pessoas
da última hora; uma versão com falhas traz release no lugar:
"release": { "version": "2.1", "previous": "2.0", "error_free": 0.8, "previous_error_free": 0.95, "sessions": 200 }Conferir se veio do Lyrelog
Quando você conecta o webhook, o Lyrelog mostra o segredo de assinatura dele uma única vez
(whsec_...). Cada requisição traz X-Lyrelog-Signature: t=<unix seconds>,v1=<hex>, em que v1 é
o HMAC-SHA256 de <t>.<body> com esse segredo. Recalcule-o sobre o corpo bruto, compare em tempo
constante e recuse um t com mais 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
Responda com qualquer 2xx em até 10 segundos. O Lyrelog não segue redirecionamentos. Se a resposta for 5xx,
408 ou 429, ou não houver resposta, o Lyrelog tenta de novo mais tarde (30 segundos, depois o
dobro a cada vez, até 8 tentativas); qualquer outro 4xx faz o Lyrelog desistir. As configurações mostram
como foi a última entrega.