Acesso antecipadoSó por convite, e os SDKs ainda não foram publicados.Pedir um convite
Ir para o conteúdo
Docs

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

AlertaQuando
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çãoPadrãoIntervalo
Um pico é esta quantidade de vezes a taxa habitual31,5 a 20
Com pelo menos esta quantidade de eventos na hora201 a 100.000
Uma versão está falhando com esta quantidade de pontos a menos de sessões sem erros51 a 50
Depois de ter esta quantidade de sessões5010 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

PlanoAlertas
FreeNenhum
ProE-mail e Slack
BusinessE-mail, Slack e webhooks

Slack

Os proprietários conectam um canal do Slack por projeto, em Also send to:

  1. No Slack, crie um incoming webhook para o canal (um app com Incoming Webhooks ativado e, depois, Add New Webhook).
  2. 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.
  3. 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.