링크백 체커가 릴리스를 차단했습니다: 가상의 사후 분석

런칭 전에 팀이 확인한 항목

알고 보니 매우 적었습니다. 테스트 목록에는 잘 알려진 도메인만 포함되어 있었기 때문에 파트너 링크가 도착하기 전까지 격차가 숨겨져 있었습니다. 유명 사이트에서의 테스트는 파이프라인이 작동한다는 것을 증명할 뿐, 아직 인덱스에 등록되지 않은 도메인에 대해서는 아무것도 알려주지 않습니다.

더 나은 테스트 목록에는 세 가지 유형의 도메인이 포함되어야 합니다: 확립된 도메인, 작은 니치 도메인, 그리고 최근 등록된 도메인. 누구나 이를 신뢰하기 전에 이 세 가지를 모두 훅을 통해 실행해야 합니다.

테스트는 어떤 도메인을 포함했습니까?

쉬운 도메인만 포함했습니다. 목록의 모든 도메인은 수년 간의 이력을 가지고 있었으므로 모든 응답이 완전히 채워져 돌아왔고, 빈 응답이 게시에 어떤 영향을 미치는지 아무도 보지 못했습니다.

진짜로 새로운 도메인 하나를 추가하고 결과를 수동으로 확인하세요. 결과가 'unknown'이 아니라 'bad'라고 표시된다면, 런칭 전에 규칙을 수정해야 합니다.

스테이징 실행에서 누락된 항목은 무엇입니까?

스테이징 실행은 잔액이 건강한 키를 사용했으므로 빈 잔액 경로가 실행되지 않았습니다. 크레딧을 의도적으로 소모하는 테스트를 작성한 사람은 없었습니다.

해당 경로를 테스트로 유지하세요. 분기마다 한 번 402를 강제 실행하고, 이후 편집자가 무엇을 보는지 확인하세요. 아무도 실행하지 않는 실패 경로는 신뢰할 수 없는 경로입니다.

원인 분석

게이트는 모든 비성공 응답을 최종 판정으로 처리했습니다. 이것이 근본 원인입니다. 잔액 문제와 알 수 없는 도메인은 도구 및 인덱스에 대한 사실일 뿐, 페이지 자체에 대한 정보는 아닙니다.

우리의 그래프는 약 한 달에 한 번 재구축됩니다. 마지막 갱신 이후에 등록된 도메인은 빈 것처럼 보일 수 있으며, 새로운 파트너는 런칭 페이지의 정상적인 사례입니다. 아무도 이를 확인하지 않았습니다. 팀은 nytimes.com과 같은 오래되고 잘 알려진 도메인만을 사용하여 훅을 테스트했습니다.

두 번째 실수는 침묵이었습니다. 함수는 오류를 로깅했지만 알림을 보내지 않았고, 편집자는 크레딧이 고갈되었음을 암시하지 않는 일반적 실패 메시지를 보았습니다.

비용은 문제가 되지 않았습니다. 호출당 2 크레딧으로, 이 가상의 사이트의 한 달 전체 체크 비용은 약 $0.60이었습니다. 이는 비용 테이블의 3,000개 게시 행과 동일한 금액입니다. 게이트는 저렴했지만 2026년에 1시간의 비용을 발생시켰습니다.

402는 별도의 항목으로 다뤄야 합니다. 선불 잔액은 모니터링할 수 있는 상태이므로, $1에 해당하는 10,000 크레딧에서 간단한 알람을 설정했다면 며칠 더 일찍 알림이 발생했을 것입니다.

수정 방법

팀은 하나의 일반적 실패를 세 가지로 분리했습니다. 각 응답에는 다른 소유자가 있기 때문입니다. 401은 키 문제, 402는 청구 상태이며, 새로운 도메인에 대한 빈 결과는 단순히 알 수 없는 상태입니다. 각각 고유한 분기 및 고유한 메시지를 가집니다. 이것이 전체 변경 사항입니다.

누구도 스택 트레이스를 읽어서 어떤 오류가 발생했는지 알 필요가 없습니다. 알림은 상태를 명시하며, 편집자는 다음 단계를 알려주는 문구를 봅니다.

왜 잔액 알람이 0보다 훨씬 높은 곳에 설정됩니까?

10,000 크레딧은 공개 가격으로 $1이며, 조기 도착 시에도 충분한 경고를 제공할 수 있는 작은 금액입니다. 사람이 볼 수 있는 곳에 알람을 설정하세요. 금요일에 아무도 열지 않는 로그가 아닌 곳에요.

하루에 한 번 크게 실패하는 체크가, 런칭 중에 조용히 실패하는 체크보다 낫습니다.

팀과 숫자에 대해 합의하고, 키 교체 규칙이 기록된 동일한 곳에 기록하세요. 두 항목이 함께 검토되도록 합니다.

새로운 도메인은 실패로 간주해야 합니까?

아니요. 인덱스가 아직 보지 못한 도메인은 인덱스에 대한 사실일 뿐, 페이지에 대한 사실이 아닙니다. 날짜와 함께 'unknown'으로 저장하고, 편집자가 다음 갱신을 기다릴지 여부를 결정하도록 합니다.

이 규칙은 모든 얇은 응답에 적용됩니다. 누락된 데이터로 처리하고 파트너에 대한 판정으로 간주하지 마세요.

알 수 없는 응답을 별도의 목록에 로깅하여, 일반 로그에 묻히지 않고 다음 검토 시 패턴을 확인할 수 있도록 합니다.

팀이 이후에 던진 질문들

검토 미팅은 이 이야기의 모든 버전에서 동일한 몇 가지 질문을 제기했습니다. 가상의 팀이 이에 어떻게 답했는지, 그리고 그 답변이 조직마다 어떻게 다를 수 있는지 설명합니다.

이 답변들은 보편적이지 않으며, 각 답변은 페이지의 목적에 따라 다릅니다. 핵심은 다음 릴리스 전에 답변을 문서화하는 것입니다.

게이트가 차단 모드로 실패해야 했습니까?

이 가상의 팀의 경우, 아니요. 링크 체크는 월간 인덱스를 기반으로 한 신호이며, 편집자와 런칭 사이의 유일한 장벽이 되어서는 안 됩니다.

정책을 한 문장으로 작성하여, 다음 엔지니어가 의도된 차단과 버그를 구분할 수 있도록 합니다.

더 큰 잔액이 이를 방지했을까요?

문제를 해결하기보다는 지연시켰을 것입니다. 더 큰 잔액도 고갈될 수 있으며, 모든 비성공 응답을 판정으로 처리하는 게이트는 첫 번째 알 수 없는 도메인에서 여전히 차단할 것입니다.

수정은 세 가지 응답으로의 분리 및 조기 알림입니다. 잔액은 이야기의 일부일 뿐입니다.

빌드하는 모든 게이트에 동일한 질문을 하세요: 어떤 실패가 조용할 것이며, 누가 가장 먼저 이를 발견하겠습니까?

가설에 대한 참고

실제 팀은 다를 것입니다. 귀사의 팀은 규제된 사이트와 같이 모든 아웃바운드 링크가 사람에 의해 검토되는 등의 좋은 이유로 차단 모드로 실패할 수 있습니다. 좋습니다. 단지 그 선택을 명확히 하세요.

웹훅 런북은 동일한 결정을 체크리스트로 나열하며, 신화 목록은 이 가상의 팀을 함정에 빠뜨린 신념들을 다룹니다.