通知

Latchkey が送信できるすべての通知、配信チャネル、重要度の階層、およびイベントタイプごとの調整方法。

Latchkey は、注意が必要なときに通知します: パイプラインが繰り返し壊れている、AI スキャンがあなたの承認を待っている、トライアルや無料分の残りが少なくなっている、レビューする価値のある新しいインサイトがある、などです。すべては Settings, Notifications で設定します。

チャネル#

channelメールイベントタイプごと。"Trial ending soon" と "Trial expired" を除き、デフォルトでオフです。

channelSlackOAuth で一度接続するチャネルへ（設定ガイド）。

channelブラウザプッシュNotifications 設定タブで許可を付与した後。

channel週次ダイジェストinformational イベントはイベントごとのメールの代わりに Digest トグルを使い、1通の週次メールにまとめられます。

すべては、チャネル設定に関わらず、ダッシュボードヘッダーのアプリ内 通知ベル にも届きます。パネルは未読数を添えた "Notifications" ヘッダーの下に開き、Mark all read はワンクリックで未読の山を片付け、フッターは期待値をまっすぐに保ちます: "Showing the last 7 days - Manage preferences in Settings"。

重要度の階層とデフォルト#

イベントタイプは 3 つの階層に分類されます: Critical、Important、Informational。すべてのチャネルはデフォルトでオフですが、例外が 2 つあります: 「トライアル終了間近」と「トライアル期限切れ」はメールがオンなので、期限切れのトライアルが黙って過ぎることはありません。また Informational 階層の 週次ダイジェスト もオンなので、オプトインしなくても週次のサマリーが届きます。階層ごと、チャネルごとのマスタートグルで、グループ全体を一度に切り替えられます。

うるさめのタイプには独自の頻度上限もあります: "Managed runner blocked" は1日に最大1回、"Free tier running out" はしきい値ごとに1日に最大1回送信され、"Pipeline is broken" は赤い実行のたびに知らせるのではなく、7回連続の失敗で発火し、20回でもう一度だけエスカレートします。最初の通知がすべてのシグナルを運びます。繰り返しはチャネルを無視するように仕向けるだけです。

通知される可能性のあるもの#

通知	発生条件	階層
Pipeline is broken	7回以上連続したワークフローの失敗が検出された。20回でもう一度エスカレート	Critical
Scan failed	AI スキャンが完了しなかった。runners ページから再試行	Critical
AI scan runner build didn't finish	AI スキャンランナーイメージのビルドが失敗した。タップして再試行	Critical
Managed runner blocked	サブスクリプションまたは使用上限のためにマネージドランナーが起動できなかった。1日に最大1回	Critical
Trial expired	無料トライアルが終了した。ランナーを維持するにはプランを追加	Critical
Scan ready for review	AI リポジトリスキャンが完了し、ランナー構成があなたの承認を必要としている	Important
AI scan runner is ready	AI がビルドしたランナーイメージが完成し、使用可能になった	Important
Free tier running out	含まれるランナー分の80%、次に100%を超えた。しきい値ごとに1日に最大1回、支払い方法が登録されていない場合のみ	Important
Trial ending soon	トライアルの残りが3日以下	Important
New insights found	夜間スキャンがレビューすべき新しい節約またはリスクを発見した	Informational
Insight applied	適用されたインサイトのプルリクエストがマージされた	Informational

推奨される基準#

ほぼすべてがオフから始まるため、受け取りたかったと悔やむアラートを待つのではなく、意図的に姿勢を選んでください。これがほとんどのチームで有効です:

階層	推奨されるルーティング	理由
Critical	メールに加えて Slack	今すぐ対応すべきイベント: 壊れたパイプライン、失敗したスキャン、ブロックされたランナー起動、期限切れのトライアル。これらはチームが最初に見る場所に属します。
Important	メール。free-tier とトライアルの警告には Slack を追加	日単位の緊急度。トライアルのメールはすでにデフォルトでオンです。予算の警告は、ブロックが起きた後ではなく前に、チーム全体の目に触れさせる価値があります。
Informational	週次の Digest トグル	新しいインサイトと適用されたインサイトは、単発メールが少しずつ届くよりも、1つの週次バッチにまとまっている方が読みやすいです。

適用する際の2つの注意点。Slack のルーティングは admin 専用ですが、各メンバーは自分自身のメール、プッシュ、ダイジェストの選択を保持します。そのため基準は実際には2つの別々の決定です: 共有の Slack チャネルと、あなた個人のチャネルです。そしてブラウザプッシュは個人的なものとして扱うのが最適です: CI の問題に最初に対応する人が自分であれば、Notifications 設定タブで許可を付与した後、自分自身に対して有効にします。

週次ダイジェストの動作#

ダイジェストは informational 階層の居場所です。緊急度の低いイベント（夜間スキャンが発見した新しいインサイト、適用されたインサイトのプルリクエストのマージ）は、1つずつ届く代わりに1通の週次メールにまとめられます。これが、informational タイプが設定マトリックスでイベントごとのメールトグルではなく Digest トグルを表示する理由でもあります: あなたが行っている選択は、そのタイプがまとめに参加するかどうかです。

推奨される習慣: ダイジェストを週次レビューのキューとして扱います。その中に当日の対応を必要とするものはありませんが、レビューされていないインサイトは、誰も見なければ積み重なっていきます。次のタブに最適化インサイトを開いた状態で、短い週次の流し読みをすれば通常は十分です。

設定の調整#

各イベントタイプには設定マトリックスにチャネルごとのトグルがあります。informational タイプはイベントごとのメールの代わりに Digest トグルを公開します。
Shortcuts は大まかな変更をカバーします: マスタートグルは階層全体またはチャネル列全体を一度に切り替え、Mute all email はワンクリックでメールを無音化し、Critical only はページに値するアラートだけを残し、Reset to defaults は標準設定を復元します。
Save changes をクリックするまで何も適用されません。ページは "Preferences saved." と表示して確認します。
Slack の設定は admin 専用です。メンバーは個人のメール、プッシュ、ダイジェストの選択を保持します。
すべての通知メールには、受信トレイ側からオプトアウトしたい場合のための unsubscribe link も含まれています。

References

GitHub Actions documentation