アーリーアクセス招待制です。SDK はまだ公開されていません。招待をリクエスト
本文へスキップ
ドキュメント

アラート

新しい種類のエラーが現れたとき、エラーが急増したとき、バージョンが失敗し始めたときにメールで知らせます。

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(通常の何倍で急増とみなすか)31.5~20
With at least this many events in the hour(1 時間あたりの最低イベント数)201~100,000
A version is failing at this many points fewer error-free sessions(エラーのないセッションが何ポイント少なければ失敗とみなすか)51~50
Once it has this many sessions(必要なセッション数)5010~100,000

オーナーがオフにしたアラートは、各自の選択にかかわらず、プロジェクトの全員に対して止まります。

プラン

プランアラート
Freeなし
Proメールと Slack
Businessメール、Slack、webhook

Slack

オーナーは Also send to で、プロジェクトごとに Slack のチャンネルを 1 つ接続できます。

  1. Slack で、そのチャンネルの Incoming Webhook を作成します(Incoming Webhooks をオンにしたアプリを作り、Add New Webhook を選びます)。
  2. そのアドレス(https://hooks.slack.com/services/ で始まります)を Slack に貼り付け、送るアラートを選んで、Connect を選びます。
  3. 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 の場合は諦めます。最後の配信の結果は設定画面に表示されます。