Alertes
Des e-mails quand un nouveau type d'erreur apparaît, quand une erreur s'emballe, ou quand une version commence à échouer.
En Pro et Business, un projet peut vous envoyer un e-mail quand quelque chose casse, et poster sur Slack ou, en Business, vers un de vos webhooks. Personne ne reçoit d'alertes qu'il n'a pas demandées : chacun choisit les siennes dans les paramètres du projet, sous Alerts. Les organisations Free n'ont pas d'alertes.
Ce qui peut vous envoyer un e-mail
| Alerte | Quand |
|---|---|
| Un nouveau type d'erreur | Une erreur que le projet n'a pas eue ces 30 derniers jours : une nouvelle combinaison de domaine et de nom. Une fois par erreur. |
| Une erreur s'emballe | Dans la dernière heure, une erreur s'est produite au moins 20 fois et au moins 3 fois sa moyenne horaire de la semaine précédente. Au plus une fois toutes les six heures par erreur. |
| Une version commence à échouer | La version la plus récente comptant au moins 50 sessions a 5 points de sessions sans erreur de moins que la version précédente. Une fois par version. |
Les erreurs sont les événements de niveau error et critical. Les alertes surveillent
l'environnement sur lequel s'ouvre le tableau de bord (voir Environnements) :
les builds de développement ne réveillent donc personne. Elles sont vérifiées toutes les cinq
minutes ; un événement arrivé en retard est quand même pris en compte.
Chaque e-mail indique l'erreur ou la version concernée, le nombre d'événements et de personnes, et renvoie vers la page Errors ou Releases du projet. Il ne contient jamais plus d'informations sur un événement que la liste du tableau de bord n'en affiche.
Choisir les vôtres
Dans Alerts, sous Email me, activez celles que vous voulez. Elles arrivent à l'adresse e-mail de votre compte, qui doit être confirmée. Toute personne du projet peut choisir les siennes ; quitter l'organisation, ou en être retiré, les arrête.
Pour tout le projet
Les propriétaires choisissent quelles alertes le projet envoie, et à partir de quand un pic ou une version compte :
| Réglage | Par défaut | Plage |
|---|---|---|
| Un pic vaut ce multiple du rythme habituel | 3 | 1,5 à 20 |
| Avec au moins ce nombre d'événements dans l'heure | 20 | 1 à 100 000 |
| Une version échoue quand elle a au moins ce nombre de points de sessions sans erreur en moins | 5 | 1 à 50 |
| Une fois qu'elle compte ce nombre de sessions | 50 | 10 à 100 000 |
Une alerte qu'un propriétaire désactive s'arrête pour tout le projet, quel que soit le choix de chacun.
Offres
| Offre | Alertes |
|---|---|
| Free | Aucune |
| Pro | E-mail et Slack |
| Business | E-mail, Slack et webhooks |
Slack
Les propriétaires connectent un canal Slack par projet, sous Also send to :
- Dans Slack, créez un incoming webhook pour le canal (une app avec Incoming Webhooks activé, puis Add New Webhook).
- Collez son adresse (elle commence par
https://hooks.slack.com/services/) dans Slack, choisissez les alertes qui y vont, et choisissez Connect. - Send a test poste un message pour vérifier qu'il arrive.
L'adresse est un secret : quiconque la possède peut poster sur le canal. Lyrelog ne la montre plus jamais en entier, seulement sa fin, et ne la logge jamais. Les messages sont postés pour tout le projet, quel que soit le choix de chacun pour les e-mails. Si Slack répond que le webhook n'existe plus, Lyrelog cesse d'essayer ; supprimez-le et connectez-en un nouveau.
Webhooks
En Business, les propriétaires peuvent aussi connecter un webhook : n'importe quelle adresse
https:// sur le port 443 que Lyrelog peut joindre sur Internet. Chaque alerte est un POST
avec un corps 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 vaut new_error, spike, release ou test. Un pic porte issue avec les événements
et les personnes de la dernière heure ; une version qui échoue porte release à la place :
"release": { "version": "2.1", "previous": "2.0", "error_free": 0.8, "previous_error_free": 0.95, "sessions": 200 }Vérifier que la requête vient de Lyrelog
Quand vous connectez le webhook, Lyrelog affiche une seule fois son secret de signature
(whsec_...). Chaque requête porte X-Lyrelog-Signature: t=<unix seconds>,v1=<hex>, où v1 est
le HMAC-SHA256 de <t>.<body> avec ce secret. Recalculez-le sur le corps brut, comparez en temps
constant, et refusez un t vieux de plus de cinq minutes :
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))
}Livraison
Répondez avec n'importe quel 2xx en moins de 10 secondes. Lyrelog ne suit pas les
redirections. Un 5xx, un 408, un 429 ou une absence de réponse est retenté plus tard
(30 secondes, puis en doublant, jusqu'à 8 tentatives) ; tout autre 4xx est abandonné. Les
paramètres indiquent comment s'est passée la dernière livraison.