アラート
新しい種類のエラーが現れたとき、エラーが急増したとき、バージョンが失敗し始めたときにメールで知らせます。
Pro と Business では、何かが壊れたときにプロジェクトからメールで知らせることができ、Slack や(Business では)自前の webhook に投稿することもできます。頼んでいないアラートが届くことはありません。各自がプロジェクトの 設定 の Alerts で、受け取るものを選びます。Free の組織にはアラートはありません。
メールで届くアラート
| アラート | 送られるとき |
|---|---|
| A new kind of error(新しい種類のエラー) | 過去 30 日間にプロジェクトで発生していないエラー(新しい領域と名前の組み合わせ)が発生したとき。エラーごとに 1 回。 |
| An error spikes(エラーの急増) | 直近 1 時間に、あるエラーが 20 回 以上、かつその前の 1 週間の 1 時間あたり平均の 3 倍 以上発生したとき。エラーごとに最大で 6 時間に 1 回。 |
| A version starts failing(バージョンの失敗) | 50 セッション 以上ある最新のバージョンで、エラーのないセッションの割合が 1 つ前のバージョンより 5 ポイント 低いとき。バージョンごとに 1 回。 |
エラーとは、error と critical のレベルのイベントです。アラートが監視するのはダッシュボードが最初に開く環境なので(環境 を参照)、開発ビルドのアラートで誰かが起こされることはありません。チェックは 5 分ごとに行われ、遅れて届いたイベントも見落としません。
各メールには、どのエラーやバージョンか、イベントとユーザーの数が書かれ、プロジェクトの Errors ページか Releases ページへのリンクが入っています。イベントの内容は、ダッシュボードの一覧に表示される以上のものは含まれません。
自分のアラートを選ぶ
Alerts の Email me で、受け取りたいものをオンにします。アラートはアカウントのメールアドレスに届くので、そのアドレスは確認済みである必要があります。プロジェクトのメンバーなら誰でも自分のアラートを選べます。組織から抜けたり外されたりすると、届かなくなります。
プロジェクト全体の設定
オーナーは、プロジェクトがそもそもどのアラートを送るか、そしてどんなときに急増やバージョンの失敗とみなすかを決めます。
| 設定 | デフォルト | 範囲 |
|---|---|---|
| A spike is this many times the usual rate(通常の何倍で急増とみなすか) | 3 | 1.5~20 |
| With at least this many events in the hour(1 時間あたりの最低イベント数) | 20 | 1~100,000 |
| A version is failing at this many points fewer error-free sessions(エラーのないセッションが何ポイント少なければ失敗とみなすか) | 5 | 1~50 |
| Once it has this many sessions(必要なセッション数) | 50 | 10~100,000 |
オーナーがオフにしたアラートは、各自の選択にかかわらず、プロジェクトの全員に対して止まります。
プラン
| プラン | アラート |
|---|---|
| Free | なし |
| Pro | メールと Slack |
| Business | メール、Slack、webhook |
Slack
オーナーは Also send to で、プロジェクトごとに Slack のチャンネルを 1 つ接続できます。
- Slack で、そのチャンネルの Incoming Webhook を作成します(Incoming Webhooks をオンにしたアプリを作り、Add New Webhook を選びます)。
- そのアドレス(
https://hooks.slack.com/services/で始まります)を Slack に貼り付け、送るアラートを選んで、Connect を選びます。 - Send a test でメッセージを投稿し、届くことを確かめます。
このアドレスは秘密情報です。知っている人なら誰でもそのチャンネルに投稿できてしまいます。Lyrelog はアドレス全体を二度と表示せず(末尾だけを表示します)、ログにも記録しません。メッセージは、各自がメールで何を選んだかにかかわらず、プロジェクトの全員に向けて投稿されます。Slack から webhook がなくなったという応答があると、Lyrelog は送信をやめます。その webhook を削除して、新しいものを接続してください。
Webhook
Business では、オーナーは webhook を 1 つ接続することもできます。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 のいずれかです。急増の場合は、直近 1 時間のイベント数とユーザー数を含む issue が入ります。バージョンの失敗の場合は、代わりに release が入ります。
"release": { "version": "2.1", "previous": "2.0", "error_free": 0.8, "previous_error_free": 0.95, "sessions": 200 }Lyrelog から届いたことを確かめる
webhook を接続すると、Lyrelog はその 署名シークレット(whsec_...)を 1 回だけ表示します。各リクエストには X-Lyrelog-Signature: t=<unix seconds>,v1=<hex> が付いています。v1 は、<t>.<body> をそのシークレットで計算した HMAC-SHA256 です。受け取った生のボディでこれを計算し直し、定数時間で比較し、t が 5 分より古ければ拒否してください。
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 の場合は諦めます。最後の配信の結果は設定画面に表示されます。