Styxis
Company
Knowledge

OpenSearch snapshot failure의 index_uuid: 이름과 세대를 나눠 설명하기

자체 왕복 일치와 실제 index 세대 식별은 다르다. 실패 응답의 UUID는 snapshot 당시 metadata의 UUID와 대조해야 한다.

왕복보다 실제 세대

자체 왕복 일치와 실제 index 세대 식별은 다르다. 실패 응답의 UUID는 snapshot 당시 metadata의 UUID와 대조해야 한다. Truthound 대사표에서 현재 cluster UUID를 무조건 기대값으로 쓰면 오래된 snapshot을 잘못 가리킨다. 당시 세대를 독립 보존해야 왕복만 맞는 잘못된 응답을 찾는다. [1, 2, 3]

string 타입이 가리는 의미 오류

OpenSearch #23299는 SnapshotShardFailure가 index_uuid 자리에 index name을 쓰고 다시 읽어도 같은 잘못된 값이 유지되는 코드 보고다. 같은 이름으로 삭제·재생성한 index 세대를 구별할 근거가 없어진다. 응답 serializer와 repository blob 양쪽이 같은 함수를 쓰는 소스 설명이다. field가 string이어서 decode 성공이 바뀌지 않는 점과 의미가 바뀌는 호환성 문제를 함께 읽는다. [1]

당시 manifest를 기준으로

같은 이름의 index를 재생성한 설명 예에서 실패 응답과 snapshot metadata의 세대를 대응하고, 이름만 반복한 UUID로 복구 대상을 고르지 않는다. snapshot 당시 manifest·index name·UUID를 묶고 복구 대상 선택표를 만든다. 현재 같은 이름의 index metadata로 과거 기준을 대체하지 않는다. [1, 3]

orders와 U_old의 차이

설명용 snapshot의 orders index UUID는 U_old이고 재생성본은 U_new다. 실패 응답의 기대 UUID는 U_old다. orders라는 이름은 문자열 타입이 맞아도 세대 식별에 실패한다. U_old는 해당 snapshot의 세대 조건을 충족한다. orders는 타입이 string이어도 UUID 기대값과 달라 실패다. U_new 역시 다른 세대다. [1, 3]

정체성 표의 제한된 검사

Truthound Core Python SDK 3.3.2의 ColumnPairValidator로 snapshot_metadata_uuid와 failure_index_uuid를 relationship="=="로 비교한다. 운영자가 당시 manifest를 해독해 비결측 식별자를 준비한다. SDK는 snapshot JSON을 수정하거나 shard를 복구하지 않으며 UUID 대사가 데이터 완전성 검사는 아니다. [1, 2, 3]

복구 대상과 복구 성공

검증된 snapshot manifest를 기준으로 복구 대상을 고르고 응답 값 변경에 의존한 client를 조사한다. 단순 이름 표시 화면은 같은 세대 판별 의무가 없을 수 있다. 복구에는 별도로 snapshot 읽기 가능성과 실제 데이터 대사가 필요하다. [1, 3]

적용 조건

snapshot 당시 metadata를 독립 보존하고 현재 cluster의 같은 이름 index를 기준으로 대체하지 않는다.

대안

검증된 snapshot manifest로 복구 대상을 식별하고 응답 값 변경의 client 호환성을 확인한다.

한계

  • Truthound는 snapshot JSON이나 shard를 복구하지 않는다. UUID 대사가 맞아도 snapshot 데이터가 온전하다는 증거는 아니다.

근거

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