リンクバックチェッカーがリリースをブロックした：架空のポストモーテム

公開前にチームが確認していた内容

実際には非常に少ないものでした。テストリストには著名なドメインしか含まれていなかったため、パートナーリンクが到着するまでギャップは隠れたままでした。有名サイトでのテストは、配管（連携）が機能していることを証明しますが、インデックスにまだ登録されていないドメインについては何も示していません。

より良いテストリストには、3種類のドメインを含める必要があります：確立されたドメイン、小さなニッチドメイン、そして最近登録されたドメインです。誰もそれを信頼する前に、これら3つすべてをフックに通してください。

テストはどのドメインをカバーしていましたか？

簡単なものだけでした。リストにあるすべてのドメインには数年の歴史があったため、すべての応答が完全なもので返され、空の結果が公開にどのような影響を与えるのかを誰も見ていませんでした。

本当に新しいドメインを1つ追加し、その結果を手動で確認します。「不明」とすべきところに「不良」という注記がある場合、ルールは公開前に書き換える必要があります。

ステージング実行では何が省略されていましたか？

ステージング実行では残高が健全なキーが使用されたため、残高空のパスは実行されませんでした。意図的にクレジットを使い果たすテストが書かれていませんでした。

そのパスをテスト対象に含めてください。四半期に1回、402を強制的に発生させ、その後に編集者が何を見るかを確認してください。誰も実行しない失敗パスは、誰も信頼できないパスだからです。

なぜこれが起きたのか

ゲートは成功しないものをすべて判断基準として扱いました。これが根本原因です。残高の問題と不明なドメインは、ツールとインデックスに関する事実であり、ページ自体については何も示していません。

当社のグラフは約1ヶ月に1回再構築されます。最後の更新後に登録されたドメインは空のように見える可能性があり、新しいパートナーはランディングページの通常のケースです。誰も確認していませんでした。チームは、nytimes.comなどの古くからある著名なドメインのみを使用してフックをテストしていました。

2つ目の見落としは沈黙でした。関数はエラーをログに記録しましたが、アラートを送信せず、編集者はクレジットが枯渇したことを示すヒントのない汎用的な失敗メッセージだけを見ました。

コストは問題ではありませんでした。1回呼び出しあたり2クレジットで、この架空のサイトの1ヶ月分のチェックの合計は約$0.60でした。これはコストテーブルの3,000回公開行と同じ数字です。ゲートは安価でしたが、2026年には1時間の損失をもたらしました。

402は独自の行を持つに値します。プリペイド残高は監視可能な状態であるため、10,000クレジット（$1相当）で単純なアラームを設定していれば、数日早く通知が来ていたはずです。

修正の書き方

チームは1つの汎用的な失敗を3つに分割しました。なぜなら、各応答には異なる所有者がいるからです。401はキーの問題、402は課金状態、新しいドメインに対する空の結果は単に不明です。それぞれに独自のブランチとメッセージが割り当てられます。これこそが全ての変更です。

誰がスタックトレースを読む必要もありませんでした。アラート名が状態を特定し、編集者は次に何をすべきかを示す文章を見ることができます。

なぜ残高アラームはゼロよりもはるかに高い位置に設定されているのか？

10,000クレジットは公開価格で$1であり、早期に到着しても十分な警告を与えるには小さな金額です。アラームは、誰も金曜日に開かないログではなく、人間が目にする場所に設定してください。

毎日一度、大きく失敗するチェックは、公開中に沈黙して失敗するチェックよりも優れています。

その数字をチームと合意し、キーのローテーションに関するルールと同じ場所に記載してください。そうすれば、両方が一緒にレビューされます。

新しいドメインは失敗としてカウントすべきか？

いいえ。インデックスがまだ見ていないドメインは、ページに関する事実ではなくインデックスに関する事実です。日付付きで「不明」として保存し、編集者が次の更新を待つかどうかを判断できるようにします。

このルールは、薄い応答が返された場合にも適用されます。これを欠落データとして扱い、パートナーに対する判断基準として決して扱わないでください。

不明な応答を独自のリストにログ記録し、一般的なログに埋もれるのではなく、次のレビュー時にそのパターンを可視化できるようにします。

チームが後に投げかけた質問

レビュー会議では、この物語のすべてのバージョンで同じ数少ない質問が提起されました。以下は、架空のチームがそれらにどのように答え、なぜその答えが組織によって異なるのかを示しています。

これらの答えのいずれも普遍的なものではなく、それぞれがページが何のためにあるかに依存します。重要なのは、次のリリースの前に紙面上に答えを持っておくことです。

ゲートはフェイルクローズすべきだったか？

この架空のチームにとって、いいえ。リンクチェックは月次インデックスに基づいて構築されたシグナルであり、編集者と公開の間に立ちはだかる唯一の存在であってはなりません。

ポリシーを1文で記載し、次のエンジニアが意図的なブロックとバグを区別できるようにしてください。

より大きな残高があればこれを防げたか？

それは問題を修正するのではなく、遅らせるだけでした。より大きな残高でも枯渇する可能性はあり、成功しないものをすべて判断基準として扱うゲートは、最初の不明なドメインで依然としてブロックします。

修正は、3つの応答への分割と、早期に発生するアラートです。残高は物語の一部に過ぎません。

構築するすべてのゲートに対して同じ質問を投げかけてください：どの失敗が沈黙し、誰が最初にそれに気づくのか？

架空の事例に関する注記

実際のチームは異なるでしょう。あなたのチームは、すべての外部リンクが人間によってレビューされる規制対象サイトなど、良い理由でフェイルクローズするかもしれません。それで結構です。ただ、それを意図的な選択にしてください。

ウェブフックランブックには、同じ決定がチェックリストとして記載されており、ミスのリストには、この架空のチームを罠に陥らせた信念が網羅されています。