Styxis
Company
Knowledge

httpjson Degraded 표시: optional rate-limit header와 실제 polling 실패 구분하기

옵션 헤더 부재와 실제 polling 실패는 다르다. 상태 표시는 서비스가 약속한 헤더 계약과 실제 요청 결과를 함께 반영해야 한다.

경고가 뜻해야 하는 상태

옵션 헤더 부재와 실제 polling 실패는 다르다. 상태 표시는 서비스가 약속한 헤더 계약과 실제 요청 결과를 함께 반영해야 한다. Truthound는 상태 label과 승인한 조건을 대조하는 표에 쓸 수 있다. 잘못된 경고를 없애려고 실제 429나 네트워크 실패까지 숨기면 다른 운영 오류가 된다. [1, 2, 3]

reporter 경로의 차이

Beats #53565의 Bug Hunter 보고는 percent early_limit 경로가 optional limit header 부재를 Degraded로 표시하는 시험을 제시한다. healthy polling 표시의 문제이며 데이터 손실 관측은 아니다. percent early_limit에서 ignore-empty reporter와 다른 reporter를 쓰는 경로의 차이가 원문 근거다. 공개 자동 test를 실제 운영 데이터 완전성 시험으로 표현하지 않는다. [1]

없는 헤더에 값을 만들지 않기

헤더의 필수 여부·응답 성공·정한 health label을 나란히 보여 주고, optional 헤더 부재만으로 Degraded가 된 상태를 분리한다. percent early_limit 여부와 헤더 계약을 기록하고 성공 응답 및 다른 오류를 함께 본다. 없는 헤더를 limit=0으로 채우면 원래 optional 의미를 바꾼다. [1, 3]

Healthy의 조건부 기대값

설명용 계약은 limit header가 optional이고 요청은 성공하며 다른 오류가 없다. 승인 label은 Healthy다. Degraded는 이 조건의 상태 계약을 어긴다. 헤더 부재를 limit=0으로 채우지 않는다. Healthy는 이 정의한 조건을 충족하고 Degraded는 실패다. 헤더 필수 계약이나 실제 오류에는 같은 기대 label을 강제하지 않는다. [1, 3]

상태 의미를 정하는 주체

Truthound Core Python SDK 3.3.2의 ColumnPairValidator로 policy_health_label과 reported_health_label을 relationship="=="로 비교한다. API 소유자가 필수 여부와 성공의 의미를 정해 운영자가 비결측 label을 준비한다. SDK는 limiter나 Agent 상태를 변경하지 않으며 Healthy 일치가 수집 완전성을 보장하지 않는다. [1, 2, 3]

경고와 데이터의 다른 근거

실제 요청 성공률·429·대기 동작을 별도 관측하고 reporter 수정판을 제한된 환경에서 시험한다. 필수 헤더가 빠지거나 네트워크 오류가 있으면 Degraded는 정당할 수 있다. 상태 경고의 정확도와 데이터 품질은 각자 근거로 안내한다. [1, 3]

적용 조건

해당 API의 헤더 optional 계약과 정상 요청 결과를 확인하고 percent early_limit 경로를 구분한다.

대안

실제 요청 성공률·429·대기 동작을 별도 관측하고 reporter 수정본을 제한된 환경에서 시험한다.

한계

  • Truthound는 rate limiter나 Elastic Agent 상태를 변경하지 않는다. Healthy label 일치가 데이터 완전성이나 rate-limit 미초과를 보증하지 않는다.

근거

사건 확인일
대상 확인일
수정일