告警
出现新类型的错误、某个错误激增,或某个版本开始频繁出错时,通过邮件通知你。
在 Pro 和 Business 套餐中,项目可以在出问题时给你发邮件,也可以发送到 Slack,或者(在 Business 套餐中)发送到你自己的 webhook。没有人会收到自己没有订阅的告警:每个人在项目设置的 Alerts 下自行选择。Free 组织没有告警功能。
可以发邮件通知的告警
| 告警 | 触发条件 |
|---|---|
| 新类型的错误 | 项目在过去 30 天内没有出现过的错误:新的分类与名称组合。每个错误只通知一次。 |
| 错误激增 | 在过去一小时内,某个错误至少发生了 20 次,且至少是前一周每小时平均次数的 3 倍。每个错误最多每六小时通知一次。 |
| 版本开始频繁出错 | 至少有 50 个会话的最新版本,其无错误会话比例比上一个版本低 5 个百分点。每个版本只通知一次。 |
错误指的是 error 和 critical 级别的事件。告警只监控控制台默认打开的环境(参见环境),所以开发构建不会把任何人吵醒。系统每五分钟检查一次;迟到的事件也同样会被发现。
每封邮件都会说明是哪个错误或版本、涉及多少事件和用户,并附上项目 Errors 或 Releases 页面的链接。邮件包含的事件内容绝不会超过控制台列表中显示的部分。
选择你的告警
在 Alerts 的 Email me 下,打开你想要的告警。它们会发送到你账户的邮箱,该邮箱必须已确认。项目中的任何人都可以选择自己的告警;退出组织或被移出组织后,告警会停止。
全项目通用的设置
所有者决定项目到底发送哪些告警,以及什么情况算激增、什么情况算版本出错:
| 设置 | 默认值 | 范围 |
|---|---|---|
| 激增:达到平常频率的多少倍 | 3 | 1.5 到 20 |
| 且一小时内至少有多少个事件 | 20 | 1 到 100,000 |
| 版本出错:无错误会话比例低多少个百分点 | 5 | 1 到 50 |
| 且该版本至少有多少个会话 | 50 | 10 到 100,000 |
所有者关闭的告警,对项目中的所有人都会停止,无论他们各自如何选择。
套餐
| 套餐 | 告警 |
|---|---|
| Free | 无 |
| Pro | 邮件和 Slack |
| Business | 邮件、Slack 和 webhook |
Slack
所有者可以在 Also send to 下为每个项目连接一个 Slack 频道:
- 在 Slack 中为该频道创建一个 incoming webhook(创建一个开启了 Incoming Webhooks 的应用,然后选择 Add New Webhook)。
- 把它的地址(以
https://hooks.slack.com/services/开头)粘贴到 Slack 中,选择要发送到那里的告警,然后选择 Connect。 - Send a test 会发送一条消息,确认它能收到。
这个地址是保密的:任何拿到它的人都能向该频道发消息。Lyrelog 之后不会再完整显示它,只显示末尾部分,也从不把它写入日志。消息是面向项目中所有人发送的,与每个人各自的邮件选择无关。如果 Slack 返回该 webhook 已不存在,Lyrelog 会停止尝试;请移除它并连接一个新的。
Webhook
在 Business 套餐中,所有者还可以连接一个 webhook:任何 Lyrelog 能在互联网上访问到的、使用 443 端口的 https:// 地址。每条告警都是一个带 JSON 请求体的 POST:
{
"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 或 test。激增告警的 issue 中带有过去一小时的事件数和用户数;版本出错告警则改为带有 release:
"release": { "version": "2.1", "previous": "2.0", "error_free": 0.8, "previous_error_free": 0.95, "sessions": 200 }确认请求来自 Lyrelog
连接 webhook 时,Lyrelog 会显示一次它的签名密钥(whsec_...)。每个请求都带有 X-Lyrelog-Signature: t=<unix seconds>,v1=<hex>,其中 v1 是用该密钥对 <t>.<body> 计算的 HMAC-SHA256。请基于原始请求体重新计算,用恒定时间比较,并拒绝 t 超过五分钟的请求:
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))
}投递
请在 10 秒内返回任意 2xx。Lyrelog 不会跟随重定向。收到 5xx、408、429 或没有响应时,会稍后重试(先等 30 秒,之后每次翻倍,最多 8 次);其他任何 4xx 则直接放弃。设置页面会显示最近一次投递的结果。