실패하는 도메인 점수 확인 호출: 401, 402 및 빈 행

진단 순서

상태 코드로 시작하세요. 401은 신원 확인과 관련되고, 402는 결제와 관련됩니다. 이들은 서로 다른 위치에서 해결됩니다.

그런 다음 ok를 확인하세요. 모든 응답에는 이 필드가 포함됩니다. 인증된 호출의 경우, _credits는 비용과 남은 잔액을 보여주므로, 402 오류가 발생하기 전에 잔액이 고갈되었는지 확인할 수 있습니다.

이 순서를 실행 매뉴얼(runbook)에 고정해 두세요. 데이터만 확인하는 사람은 상태 코드가 즉시 알려줄 문제를 해결하는 데 한 아침을 허비할 수 있습니다.

그 후에야 데이터에 문제가 있다고 의심해야 합니다. 신규 사이트는 종종 낮은 DR을 보입니다. 원인은 버그일 가능성이 낮으며, 링크 생성 이전의 월별 스냅샷 때문일 가능성이 더 큽니다. 이 수치를 공식 항목과 비교하세요.

핵심 문제와 잔액 문제 구분하기

스크립트에서는 401과 402가 동일한 루프를 중단하기 때문에 비슷해 보일 수 있습니다. 원인이 다르므로 무언가를 변경하기 전에 이를 구분해야 합니다.

동일한 도메인에서 무료 액션을 먼저 수행하세요. 응답이 오지만 유료 호출이 실패한다면, 도메인은 정상이며 문제는 키나 잔액에 있다는 뜻입니다.

복사 후 401이 발생할 때

키에 trailing space가 있거나 끝부분이 잘려 있는 것은 401의 흔한 원인입니다. 키는 sk_로 시작하므로, 이 접두어를 확인하고 계정 페이지의 복사본과 전체 문자열을 비교하세요.

키를 한 곳에서만 교체하고 동일한 단일 호출을 다시 실행하세요. 여러 가지를 동시에 변경하면 결과를 해석하기 어려워집니다.

충전 후 402가 발생할 때

402는 유료 액션에 크레딧이 남지 않았음을 의미합니다. 다른 작업보다 먼저 다음 인증된 응답의 _credits에서 남은 잔액을 확인하세요.

잔액이 정상이라고 판단되면, 실패한 호출의 비용과 비교하세요. 수치를 통해 호출 금액이 잔액보다 단순히 큰지 확인할 수 있습니다.

충전 시간을 기록해 두면, 나중에 로그와 잔액을 비교할 수 있습니다.

각 충전 전후의 잔액을 짧게 기록해 두면, 다음 402 오류를 더 쉽게 파악할 수 있습니다.

오류 없이도 점수가 잘못 보일 수 있는 이유

때로는 모든 필드가 제시간에 도착하지만 숫자가 여전히 놀라움을 줍니다. 응답은 해당 스냅샷에 대해 정확하므로, 실제 질문은 그 스냅샷이 무엇을 포함하는지입니다.

대부분의 이러한 사례는 세 가지 상황으로 설명됩니다.

최근에 출시된 도메인

최근에 출시된 사이트는 스냅샷이 링크보다 이전 시점이기 때문에 DR 0을 보일 수 있습니다. 여기서의 0은 링크 도메인이 발견되지 않았음을 의미하며, 사이트 자체에 대한 판단이 아닙니다.

사이트에 대한 판단으로 수치를 해석하기 전에 나중에 다시 업데이트될 때까지 기다리세요.

행동하기 전에 도메인의 연령과 업데이트 주기를 비교하세요. 새로운 이름과 링크가 거의 없었던 오래된 이름은 동일한 스냅샷에서 비슷하게 보입니다.

이번 달에 추가된 링크

최신 업데이트 이후에 추가된 링크는 수치에 반영되지 않습니다. 다음 업데이트가 있기 전까지는 반복 호출 시 동일한 결과가 반환됩니다.

링크 날짜와 스냅샷 날짜를 기록하여 보고서를 읽는 모든 사람이 간격을 쉽게 설명할 수 있도록 하세요.

사라진 링크

링크가 있는 페이지가 삭제되거나 링크 제공 사이트가 종료되면 링크가 사라질 수 있습니다. 귀하의 측에서는 변경된 것이 없어도 카운트는 감소합니다.

엔드포인트를 탓하기 전에 몇 달 간격으로 두 스냅샷을 비교하세요.

총합뿐만 아니라 이동하는 도메인 수도 세세요. 여러 사이트에 걸쳐 작은 손실은 단일 사이트에서의 큰 손실과 다르게 해석됩니다.

자동 재시도를 사용하지 않는 이유

402 오류에서 루프를 돌리면 시간이 소모될 뿐 이득이 없습니다. 401 오류에서 루프를 돌리면 ours나 Google의 제공업체 모두에서 위반 감지 시스템이 작동할 수 있습니다.

재시도는 네트워크 오류에만 한정하고, 각 재시도마다 이전보다 더 긴 대기 시간을 두세요. 야간 작업의 경우 시도 횟수 3회가 적절한 상한선입니다.

야간 작업이 새벽 2시에 402 오류를 만나면, 아침 식사까지 5분마다 재시도하면 약 100개의 동일한 실패가 발생하며, 각각 나중에 읽어야 하는 로그 줄이 됩니다.

네트워크 재시용에도 고정된 상한선을 사용하고 각 시도를 로그에 기록하세요. 한 문장으로 설명할 수 있는 상한선은 작업이 중단될 때 쉽게 변명할 수 있습니다.

무인 실행 작업에 대한 알림

야간 도메인 점수 확인 작업은 중단될 때 누군가에게 알려야 하며, 그 이유도 명시해야 합니다. 두 코드는 서로 다른 알림이 필요하므로 메시지 내에서 구분하세요.

첫 번째 401 오류에 알림

401 오류는 일반적으로 키 문제이므로, 단일 실패도 메시지가 필요합니다. 100개의 동일한 실패를 기다리면 수정이 지연됩니다.

알림에 전체 키 대신 키의 첫 글자와 마지막 글자를 포함하여 동료와 공유해도 안전하도록 하세요.

402 오류는 키 변경이 아닌 충전이 해결책이므로 별도의 메시지가 필요합니다.

조용한 작업이 반드시 건강한 것은 아닙니다. 실패한 실행 수뿐만 아니라 완료된 실행 수도 세고, 전체 주기 동안 두 카운트 모두 움직이지 않으면 알림을 보내세요.

하락하는 잔액에 대한 알림

경고 수준을 0이 아니라 나머지 실행을 커버할 수 있는 수준으로 설정하세요. 작업 시작 시 잔액이 거의 비어 있으면 재시도할 여지가 없습니다.

인증된 응답마다 _credits에서 수치를 읽어오면 추가 요청 없이 경고를 설정할 수 있습니다.