コンテンツへスキップ
Latchkey
ドキュメントメニュー

通知

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

通知設定のマトリックス
Settings, Notifications: チャネルごとのトグルを備えた各アラートタイプ。

Latchkey は、注意が必要なときに通知します: パイプラインが繰り返し壊れている、コストの急増、トライアルや無料分の残りが少なくなっている、修正の準備が整った、などです。すべては Settings, Notifications で設定します。

チャネル#

channelメールイベントタイプごと。critical と important のタイプはデフォルトでオンです。
channelSlackOAuth で一度接続するチャネルへ(設定ガイド)。
channelブラウザプッシュNotifications 設定タブで許可を付与した後。
channel週次ダイジェスト緊急度の低い informational イベントは1通の週次メールにまとめられます。

すべては、チャネル設定に関わらず、ダッシュボードヘッダーのアプリ内 通知ベル にも届きます。ベルには未読数(99+ で上限)が表示され、その履歴パネルで前回確認してからのすべてに追いつけます: 項目を1つずつ既読にするか、すべて既読にして新たに始めます。

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

イベントタイプは3つの階層にグループ化されます。CriticalImportant のタイプはデフォルトでメールがオンになり、Informational のタイプはデフォルトで週次ダイジェストに入ります。各タイプにはクールダウンがあり、うるさいパイプラインが重複であなたを埋め尽くさないようにします。

クールダウンには、その理由を一言添える価値があります。最初の通知がすべてのシグナルを運びます: ワークフローが1時間に10回失敗したとき、"Pipeline is broken" は最初の失敗ですべてを伝えており、9回の繰り返しはチャネルを無視するように仕向けるだけです。各タイプのクールダウンウィンドウ内で繰り返しを抑制することで、受け取るすべての通知を開く価値のあるものに保ちます。

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

通知発生条件階層
Pipeline is brokenワークフローが連続して何度も失敗するCritical
Security risk detectedAI がワークフロー内のセキュリティ問題を検出する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 readyAI 診断またはランナースキャンがレビューの準備完了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 appliedLatchkey の最適化 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 も含まれています。