과거 데이터 평가

기록된 이벤트에 현재 측정 항목을 적용하고, 이전 답변을 유지할지 대체할지 선택하세요. 근거 자료가 없거나 작업이 비동기로 완료되는 경우도 고려하세요.

과거 데이터 평가는 조직에서 이미 수집한 이벤트에 측정 항목을 실행하는 기능입니다. 이전 번역에 새 기준을 적용하거나, 제공자의 기록에서 가져온 이벤트를 측정하거나, 수정된 정의로 특정 기간을 살펴볼 때 사용하세요. 측정 항목의 상세 페이지에 있는 백필 탭에서 실행할 수 있습니다.

제공자의 이전 콘텐츠를 평가하려면 먼저 GitHub 또는 Zendesk 기록을 가져온 뒤 원하는 이벤트가 레이더 → 로그에 표시되는지 확인하세요. 가져오기 진행률은 수집 큐에 추가된 제공자 항목 수를 나타내며, 매핑과 저장은 그 이후에 완료될 수 있습니다. 과거 데이터 평가는 저장된 이벤트 페이로드를 읽습니다. 가져온 기록의 이벤트는 수신 시 측정하지 않고 수집만 하므로, 측정하려면 백필을 실행해야 합니다.

이미 측정된 항목 확인하기 #

측정 완료 섹션에는 전체 기록 기간을 기준으로, 이 측정 항목의 대상 이벤트 유형 중 답변이 있는 이벤트 수가 표시됩니다. 해당 없음 답변도 포함되며, 예를 들어 “이벤트 8,154개 중 1,204개 측정 완료”처럼 표시됩니다. 페이로드가 저장된 이벤트를 집계하고, 측정 항목이 켜져 있든 꺼져 있든 해당 이벤트 유형을 포함합니다. 백필 날짜를 변경해도 이 수치는 달라지지 않습니다. 합계 아래에는 GitHub 저장소, Zendesk 도움말 센터, Crowdin 프로젝트, Lingo.dev 등 출처별로 측정된 이벤트 수가 “acme/web 7,600개 중 1,180개”처럼 표시됩니다. 기록에 출처가 명시되지 않은 이벤트는 알 수 없는 출처로 표시됩니다. GET /v2/organizations/:orgId/measurements/:measurementId/period-counts에 ISO 형식의 from(포함)와 to(미포함)을 지정하면 어느 기간에 대해서든 동일한 events, measured, origins을 반환합니다.

정의와 기간 선택하기 #

시작하기 전에 측정 항목을 켜세요. 꺼져 있으면 백필 시작을 사용할 수 없습니다. 활성화된 이벤트 유형에 따라 평가할 과거 이벤트가 결정되며, 각 이벤트가 해당 조건에 현재 설정된 언어, 엔진, 표본에 부합하는지 확인합니다. 실시간 평가와 마찬가지로 이 범위를 벗어나는 이벤트에는 해당 없음 답변이 부여됩니다.

시작일과 종료일 아래에는 해당 기간의 이벤트 수가 출처별로 표시됩니다. 출처는 각 GitHub 저장소, Zendesk 도움말 센터, Crowdin 프로젝트, Lingo.dev로 구분되며, 기록에 출처가 명시되지 않은 이벤트는 알 수 없는 출처로 표시됩니다. 이 수치는 백필이 읽을 이벤트, 즉 측정 항목에서 활성화된 이벤트 유형 중 페이로드가 저장된 이벤트를 조건 적용 전에 집계한 값입니다. 조건에 지정된 언어, 엔진 또는 출처 범위를 벗어나는 이벤트도 집계에 포함되며, 해당 없음 답변이 부여됩니다. 측정 항목이 꺼져 있으면 이벤트 수는 표시되지 않습니다.

이벤트를 직접 살펴볼 수 있도록 짧은 기간을 선택하세요. 페이로드에 평가 기준에 필요한 원문, 번역문, 초안 또는 맥락이 포함되어 있는지 확인하세요. 용어집 및 규칙 준수 여부를 확인할 때는 로컬라이제이션 엔진의 관련 최신 지침도 보존하세요. 이러한 검사는 생성 당시의 맥락을 재현하는 대신, 평가 실행 시 연결된 용어와 규칙을 읽습니다.

기간은 기록된 eventAt 값을 기준으로 선택됩니다. Crowdin 승인에는 제안이 생성된 시각의 타임스탬프가 사용되므로 승인일보다 앞선 시점일 수 있습니다. 기간을 선택할 때 이벤트의 타임스탬프를 확인하세요. 승인이 도착한 날짜만 선택하면 해당 이벤트가 누락될 수 있습니다.

이전 답변 유지 또는 대체하기 #

아직 측정되지 않은 이벤트만 옵션은 기본적으로 켜져 있습니다. 해당 기간에 이미 있는 답변은 유지하고, 답변이 없는 이벤트만 측정합니다. 해당 없음 답변도 측정된 것으로 간주하여 유지합니다.

현재 정의로 전체 기간을 다시 측정하려면 이 옵션을 끄세요. 이 상태에서 시작하면 이 기간을 다시 측정할까요?라는 확인 메시지가 표시됩니다. 해당 기간에 이 측정 항목이 기록한 이전 답변을 먼저 삭제한 뒤, 이벤트를 측정하면서 답변을 다시 기록하기 때문입니다.

대체하기 전에 이전 답변 저장하기

아직 측정되지 않은 이벤트만 옵션을 끄면 선택한 전체 기간에 걸쳐 해당 측정 항목의 답변이 삭제됩니다. 더 이상 선택되지 않은 이벤트 유형이나 로캘의 답변도 포함됩니다. 비교에 필요한 이전 정의와 결과를 먼저 저장하세요. 페이로드를 건너뛰거나 답변 대체에 실패하면 이전에 답변이 있던 자리가 비게 될 수 있습니다.

지정한 기간의 평가 시작하기 #

  1. 측정 항목의 백필 탭을 여세요.
  2. 시작일과 종료일을 설정하세요. 선택한 시작일과 종료일은 모두 UTC 기준으로 평가 기간에 포함되며, 오늘 이후의 날짜는 선택할 수 없습니다. 같은 날짜를 선택하면 해당 날짜만 평가합니다.
  3. 아직 측정되지 않은 이벤트만 옵션을 켜 둘지 결정하세요.
  4. 백필 시작을 선택하고, 답변을 대체하는 경우 확인 절차를 진행하세요.
  5. 진행 상태 표시줄에서 백필 진행 중에 이어 백필 완료 또는 백필 실패로 바뀌는 상태와 측정된 이벤트 수를 확인하세요. 백필은 모든 페이지 모서리에 있는 백그라운드 작업 도크에도 표시됩니다. 진행 상태 표시줄이나 도크의 백필 항목을 선택하면 진행 상황을 확인할 수 있습니다.

시작 요청의 기본 규약은 POST /v2/organizations/:orgId/measurements/:measurementId/backfill이며 ISO 형식의 타임스탬프를 사용합니다. from는 포함하고 to는 포함하지 않으며, from < to와 unmeasuredOnly가 필요합니다. API에서 unmeasuredOnly의 기본값은 답변을 대체하는 false입니다. 답변을 유지하려면 true을 보내세요. UTC 기준 하루의 기간은 해당 날짜 자정부터 다음 날 자정까지입니다. 화면에서는 선택한 종료일을 포함하기 위해 종료 경계를 그다음 날 자정으로 변환합니다. 응답은 HTTP 202이며 비동기 실행의 id가 포함됩니다. 동일한 측정 항목의 백필이 실행 중이면 두 번째 백필 요청은 거부됩니다. GET /v2/organizations/:orgId/backfills은 최근 실행 목록을 반환하며, status=running&startedBy=me은 그중 본인이 시작한 실행 중 현재 진행 중인 항목만 표시하도록 목록을 좁힙니다.

새 답변 대조하기 #

처리 과정에서는 이벤트를 페이지 단위로 읽고, 저장된 페이로드를 사용할 수 있는 경우에만 측정 작업을 큐에 추가합니다. 백필 완료는 해당 이벤트의 측정이 끝났다는 뜻이지만, 각 답변에는 개별 처리 결과가 기록됩니다. 백필 실행은 조건에 따라 건너뛴 답변을 제외하고 실시간 실행과 동일하게 사용량이 산정됩니다. 백필로 생성된 답변은 로컬라이제이션 엔진 제안을 생성하지 않습니다.

선택한 이벤트와 결과를 살펴보세요. 결과 기록에는 백필 실행 식별자가 표시되지 않으므로 이벤트 식별자, 측정 항목 식별자, 이벤트 기간, 계산 시각을 대조하세요. 반환된 행만으로 완료 여부를 판단하지 말고, 답변이 있어야 하지만 누락된 이벤트도 대조 대상에 포함하세요.

새로 생성된 해당 없음 답변마다 사유를 확인하세요. 조건의 선택 범위, 근거 자료 누락, 적용 가능한 지침의 부재, 또는 판정자가 명확한 답변을 내리지 못한 경우일 수 있습니다. 실행에 실패한 경우와 평가 대상 번역에 원문이 없는 경우는 서로 다른 방식으로 복구해야 합니다.

대체되는 기록과 별도로 비교 자료 보존하기 #

수정된 기준이 오류를 더 신뢰성 있게 감지하는지 확인하려면 이전 정의와 새 정의를 보관하고, 별도로 판정한 예시와 그 결과도 함께 보관하세요. 번역이 개선되었는지 확인하려면 비교 가능한 조건에서 두 번역 수정본을 모두 보존하세요.

백필에는 정해진 취소 또는 답변 되돌리기 작업이 없습니다. 누락된 결과를 조사하기 위해 재실행을 겹쳐 진행하지 마세요. 먼저 선택된 이벤트, 누락된 페이로드, 반환된 답변을 파악하세요. 번역 모델 비교하기에서는 변경 가능한 기록에 의존하지 않고 반복 가능한 실험을 보존하는 방법을 설명합니다.