ドキュメントメニュー
はじめに
ダッシュボードと分析
マネージドランナー
キャッシュ
チームと通知
請求とプラン
ヘルプ
通知
Latchkey が送信できるすべての通知、4つの配信チャネル、重要度の階層、およびイベントタイプごとの調整方法。

Latchkey は、注意が必要なときに通知します: パイプラインが繰り返し壊れている、コストの急増、トライアルや無料分の残りが少なくなっている、修正の準備が整った、などです。すべては Settings, Notifications で設定します。
チャネル#
すべては、チャネル設定に関わらず、ダッシュボードヘッダーのアプリ内 通知ベル にも届きます。ベルには未読数(99+ で上限)が表示され、その履歴パネルで前回確認してからのすべてに追いつけます: 項目を1つずつ既読にするか、すべて既読にして新たに始めます。
重要度の階層とデフォルト#
イベントタイプは3つの階層にグループ化されます。Critical と Important のタイプはデフォルトでメールがオンになり、Informational のタイプはデフォルトで週次ダイジェストに入ります。各タイプにはクールダウンがあり、うるさいパイプラインが重複であなたを埋め尽くさないようにします。
クールダウンには、その理由を一言添える価値があります。最初の通知がすべてのシグナルを運びます: ワークフローが1時間に10回失敗したとき、"Pipeline is broken" は最初の失敗ですべてを伝えており、9回の繰り返しはチャネルを無視するように仕向けるだけです。各タイプのクールダウンウィンドウ内で繰り返しを抑制することで、受け取るすべての通知を開く価値のあるものに保ちます。
通知される可能性のあるもの#
| 通知 | 発生条件 | 階層 |
|---|---|---|
| Pipeline is broken | ワークフローが連続して何度も失敗する | Critical |
| Security risk detected | AI がワークフロー内のセキュリティ問題を検出する | Critical |
| Managed runner blocked | ランナーの起動がブロックされた(請求または free-tier の状態) | Critical |
| Trial expired | 無料トライアルが終了した | Critical |
| Scan failed / AI scan runner build failed | カスタムランナーのスキャンまたはイメージビルドが完了しなかった | Critical |
| Unexpected CI spend | 実行のコストが30日間の平均の4倍を超える | Important |
| Builds are slowing down | ビルド時間が30日間の平均の2.5倍を超える | Important |
| Diagnosis ready / Scan ready | AI 診断またはランナースキャンがレビューの準備完了 | Important |
| AI scan runner is ready | カスタムランナーイメージのビルドが完了した | Important |
| Pipeline health declined | 過去24時間でワークスペースの成功率が70%を下回った | Important |
| Recovery time worsening | 平均復旧時間が直前2週間より2倍悪化している | Important |
| Free tier running out | 含まれるランナー分の80%、次に100%を超えた | Important |
| Trial ending soon | トライアルの残りが3日以下 | Important |
| New optimization opportunity | 新しい AI の推奨事項が利用可能 | Informational |
| Fix was applied | Latchkey の最適化 PR がマージされた | Informational |
| Optimized workflows ready | ワークフロー最適化のバッチが準備完了 | Informational |
| Cost projection rising | 予測される月間支出が先月より30%以上多い | Informational |
推奨される基準#
デフォルトはすでに妥当です: Critical と Important はメールで通知し、Informational はダイジェストにまとめられます。調整の出発点となる姿勢が欲しい場合、これがほとんどのチームで有効です:
| 階層 | 推奨されるルーティング | 理由 |
|---|---|---|
| Critical | メール(デフォルト)に加えて Slack | 今すぐ対応すべきイベント: 壊れたパイプライン、ブロックされたランナー起動、期限切れのトライアル。これらはチームが最初に見る場所に属します。 |
| Important | メール(デフォルト)。free-tier とトライアルの警告には Slack を追加 | 日単位の緊急度。予算の警告は、ブロックが起きた後ではなく前に、チーム全体の目に触れさせる価値があります。 |
| Informational | 週次ダイジェスト(デフォルト) | 推奨事項や予測は、単発メールが少しずつ届くよりも、1つの週次バッチにまとまっている方が読みやすいです。 |
適用する際の2つの注意点。Slack のルーティングは admin 専用ですが、各メンバーは自分自身のメール、プッシュ、ダイジェストの選択を保持します。そのため基準は実際には2つの別々の決定です: 共有の Slack チャネルと、あなた個人のチャネルです。そしてブラウザプッシュは個人的なものとして扱うのが最適です: CI の問題に最初に対応する人が自分であれば、Notifications 設定タブで許可を付与した後、自分自身に対して有効にします。
週次ダイジェストの動作#
ダイジェストは informational 階層の居場所です。緊急度の低いイベント(新しい最適化の機会、マージされた修正、最適化されたワークフローのバッチ、上昇するコスト予測)は、1つずつ届く代わりに1通の週次メールにまとめられます。これが、informational タイプが設定マトリックスでイベントごとのメールトグルではなく Digest トグルを表示する理由でもあります: あなたが行っている選択は、そのタイプがまとめに参加するかどうかです。
推奨される習慣: ダイジェストを週次レビューのキューとして扱います。その中に当日の対応を必要とするものはありませんが、最適化の機会やコスト予測は、誰も見なければ積み重なっていきます。次のタブに 最適化インサイト を開いた状態で、短い週次の流し読みをすれば通常は十分です。
調整とテスト#
- 各イベントタイプには設定マトリックスにチャネルごとのトグルがあります。informational タイプはイベントごとのメールの代わりに Digest トグルを公開します。
- Shortcuts は大まかな変更をカバーします: マスタートグルは階層全体またはチャネル列全体を一度に切り替え、Mute all email はワンクリックでメールを無音化し、Critical only はページに値するアラートだけを残し、Reset to defaults は標準設定を復元します。
- admin は任意のタイプの test notification を送信して、配線がエンドツーエンドで機能することを確認できます。
- Slack の設定は admin 専用です。メンバーは個人のメール、プッシュ、ダイジェストの選択を保持します。
- すべての通知メールには、受信トレイ側からオプトアウトしたい場合のための unsubscribe link も含まれています。