ドキュメントメニュー
マネージドランナー
ワークフローファイル
通知
Latchkey が送信できるすべての通知、配信チャネル、重要度の階層、およびイベントタイプごとの調整方法。
要点
- Critical、Important、Informational の階層にまたがる11のイベントタイプ。
- イベントごとのチャネル: メール、Slack、ブラウザプッシュ。informational イベントは週次の Digest トグルを使い、すべてはアプリ内のベルに届きます。
- ほとんどのイベントはデフォルトでオフから始まります。メールは "Trial ending soon"、"Trial expired"、"Managed runner blocked"、"Free tier running out" でオンになり、Slack は後者の 2 つでオンになります。マスタートグルと一括ボタンで調整は素早く済みます。

Latchkey は、注意が必要なときに通知します: パイプラインが繰り返し壊れている、AI スキャンがあなたの承認を待っている、トライアルや無料分の残りが少なくなっている、レビューする価値のある新しいインサイトがある、などです。すべては Settings, Notifications で設定します。
チャネル#
すべては、チャネル設定に関わらず、サイドバーの先頭にあるワークスペースメニューの横のアプリ内 通知ベル にも届きます。パネルは未読数を添えた "Notifications" ヘッダーの下に開き、Mark all read はワンクリックで未読の山を片付け、フッターは期待値をまっすぐに保ちます: "Showing the last 7 days - Manage preferences in Settings"。
重要度の階層とデフォルト#
イベントタイプは 3 つの階層に分類されます: Critical、Important、Informational。ほとんどのチャネルはデフォルトで オフ ですが、例外が 3 つあります: 「トライアル終了間近」と「トライアル期限切れ」はメールがオンなので、期限切れのトライアルが黙って過ぎることはありません。「Managed runner blocked」と「Free tier running out」はメールと Slack の両方がオンです。停止したコンピュートについての通知に、利用者が自らオプトインすることはないためです。また Informational 階層の 週次ダイジェスト もオンなので、オプトインしなくても週次のサマリーが届きます。有効化されていないリポジトリや期限切れのトライアルが原因のランナーブロックは、イベントをオンにするまでオフのままです。メールと Slack はイベントタイプごとに決まり、ブラウザプッシュとダイジェストは階層に従います。階層ごと、チャネルごとのマスタートグルで、グループ全体を一度に切り替えられます。
うるさめのタイプには独自の頻度上限もあります: "Managed runner blocked" は1日に最大1回送信され、その月の "Free tier running out" 通知が送られた後は無料枠については送信されません。"Free tier running out" はカード未登録のワークスペースでは80%で1日に最大1回、100%で暦月あたり1回、サブスクリプションではしきい値ごとに暦月あたり1回送信されます。"Pipeline is broken" は赤い実行のたびに知らせるのではなく、7回連続の失敗で発火し、20回でもう一度だけエスカレートします。最初の通知がすべてのシグナルを運びます。繰り返しはチャネルを無視するように仕向けるだけです。
通知される可能性のあるもの#
| 通知 | 発生条件 | 階層 |
|---|---|---|
| Pipeline is broken | リポジトリで Latchkey ランナー上の実行が7回以上連続して失敗した。20回でもう一度エスカレート | Critical |
| Scan failed | AI スキャンが完了しなかった。runners ページから再試行 | Critical |
| AI scan runner build didn't finish | AI スキャンランナーイメージのビルドが失敗した。タップして再試行 | Critical |
| Managed runner blocked | サブスクリプションまたは使用上限のためにマネージドランナーが起動できなかった。1日に最大1回で、その月の "Free tier running out" 通知が送られた後は無料枠については送信されない | Critical |
| Trial expired | 無料トライアルが終了した。ランナーを維持するにはプランを追加 | Critical |
| Scan ready for review | AI リポジトリスキャンが完了し、ランナー構成があなたの承認を必要としている | Important |
| AI scan runner is ready | AI がビルドしたランナーイメージが完成し、使用可能になった | Important |
| Free tier running out | 含まれるランナー分の80%、次に100%を超えた。カード未登録の場合は80%で1日に最大1回、100%で暦月あたり1回で、そのとき Latchkey は実行中のジョブを停止し、プランが始まるまで新しいジョブを保留する。サブスクリプションの場合はしきい値ごとに暦月あたり1回で、代わりに計測される超過分を伝える | Important |
| Trial ending soon | トライアルの残りが3日以下 | Important |
| New insights found | 夜間スキャンがレビューすべき新しい節約またはリスクを発見した | Informational |
| Insight applied | 適用されたインサイトのプルリクエストがマージされた | Informational |
推奨される基準#
ほとんどのイベントは今もオフから始まるため、受け取りたかったと悔やむアラートを待つのではなく、意図的に姿勢を選んでください。これがほとんどのチームで有効です:
| 階層 | 推奨されるルーティング | 理由 |
|---|---|---|
| Critical | メールに加えて Slack | 今すぐ対応すべきイベント: 壊れたパイプライン、失敗したスキャン、ブロックされたランナー起動、期限切れのトライアル。これらはチームが最初に見る場所に属します。 |
| Important | メール。free-tier とトライアルの警告には Slack を追加 | 日単位の緊急度。トライアルのメールと free-tier の警告はすでにデフォルトでオンで、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 専用です。メンバーは個人のメール、プッシュ、ダイジェストの選択を保持します。
- すべての通知メールには 通知設定 へのリンクも含まれているので、受信トレイ側からイベントをオフにできます。
既定で有効になっている通知は?
ほとんどのイベントは無効から始まるため、新しいワークスペースは意図的に静かな状態です。例外は "Trial ending soon" と "Trial expired" のメール、そして "Managed runner blocked" と "Free tier running out" のメールと Slack です。マトリクスでイベントごとに必要なものを有効にするか、マスタートグルと一括ボタンで素早く初期設定できます。
各イベントで使えるチャネルは?
メール、Slack、ブラウザのプッシュ通知を、Critical・Important・Informational の各層のイベント種別ごとに選べます。Informational のイベントは個別に発火せず週次ダイジェストにまとめられ、チャネルに関わらずすべてアプリ内のベルにも届きます。
イベントの種類はいくつありますか?
11 種類あり、3 つの重要度層に分かれています。Critical は人の作業を中断させる価値があるもの、Informational は週次でまとめて読む方が適しており、そのためにダイジェストがあります。