레이더 레퍼런스
레이더는 번역에서 일어나는 일을 이벤트로 기록하고 측정값 수로 점검합니다. 이 페이지에서는 이벤트 유형과 각 이벤트를 보내는 연동, 번역을 생성한 주체, 측정 결과의 의미까지 레이더의 각 페이지에서 접하는 모든 용어를 설명합니다. 대시보드의 레이더 → 참조에서도 조직의 자체 측정값 수와 함께 같은 정보를 확인할 수 있습니다. 정보는 이벤트, 번역 생성 주체, 측정값 수의 세 섹션으로 나뉘며, 각 섹션은 직접 열기 전까지 접힌 상태로 표시됩니다.
이벤트 유형#
이벤트는 문자열에 일어난 일 하나를 기록합니다. 이벤트 유형은 subject.action 형식입니다. 대상은 원문, 번역, 제안, Lingo.dev 로컬라이제이션 요청 중 무엇에 관한 이벤트인지를 나타내고, 동작은 그 대상에 어떤 일이 일어났는지를 나타냅니다.
| 유형 | 의미 | 전송 주체 |
|---|---|---|
localization.started | Lingo.dev 엔진이 로컬라이제이션 요청을 시작했습니다. | Lingo.dev |
localization.completed | Lingo.dev 엔진이 로컬라이제이션 요청을 완료했습니다. 이벤트에는 원문, 번역문, 엔진 정보가 포함됩니다. 이 이벤트를 대상으로 용어집 준수도, 규칙 준수도, MQM 측정이 실행됩니다. | Lingo.dev |
source.created | 소스 언어 문자열이 추가되었습니다. 소스 파일의 새 키, 도움말 센터의 새 문서·섹션·카테고리, Crowdin의 새 문자열이 이에 해당합니다. | GitHub, Zendesk, Crowdin |
source.updated | 문자열의 원문이 변경되었습니다. | GitHub, Zendesk, Crowdin |
source.deleted | 원본 언어에서 문자열이 삭제되었습니다. | GitHub, Crowdin |
target.created | 대상 언어로 된 번역이 추가되었습니다. 해당 번역의 편집률, 편집 거리, 편집 패턴을 계산합니다. | GitHub, Zendesk, Crowdin |
target.updated | 번역이 변경되었습니다. 편집률, 편집 거리, 편집 패턴을 기준으로 Lingo.dev에서 이전에 작성한 버전과 비교합니다. | GitHub, Zendesk, Crowdin |
target.deleted | 번역이 삭제되었습니다. | GitHub, Crowdin |
suggestion.created | 번역이 제안되었습니다. Crowdin에 번역 제안이 추가되거나, CLI, CI 또는 GitHub App을 통해 Lingo.dev에서 파일의 키를 번역한 경우가 이에 해당합니다. | Lingo.dev, Crowdin |
suggestion.updated | 제안이 수정되었습니다. | Crowdin |
suggestion.deleted | 제안이 삭제되었습니다. | Crowdin |
suggestion.approved | 검토자가 제안을 승인했습니다. | Crowdin |
suggestion.rejected | 검토자가 제안을 거부했습니다. | Crowdin |
GitHub 저장소는 커밋으로 추가, 변경 또는 삭제되는 로컬라이제이션 키마다 이벤트를 전송합니다. Zendesk 도움말 센터는 각 언어로 게시된 문서, 섹션 또는 카테고리의 필드마다 이벤트를 전송합니다. Crowdin은 웹훅을 통해 문자열 단위의 활동을 전송합니다. 각 서비스의 연결 방법은 이벤트 출처를 참고하세요.
하나의 문자열에 여러 이벤트가 발생할 수 있습니다. 제안, 제안 승인, 번역 업데이트는 각각 별개의 이벤트이므로 총 세 개로 기록됩니다. 번역 수를 집계하기 전에 이벤트 유형으로 필터링하세요.
생성 주체#
레이더 → 로그의 생성 주체 필터와 열에서 텍스트나 답변을 생성한 주체를 확인할 수 있습니다.
| 생성 주체 | 이름 | 의미 |
|---|---|---|
llm | AI 모델 | Lingo.dev 엔진이나 Crowdin 인공지능 사전 번역 같은 대규모 언어 모델입니다. |
human | 사람 | 번역가, 검토자 또는 저장소에 커밋하는 팀원입니다. |
mt | 기계 번역 | DeepL이나 구글 번역 같은 기계 번역 엔진입니다. |
tm | 번역 메모리 | 이전에 승인된 번역을 번역 메모리에서 가져와 재사용한 것입니다. |
algo | 알고리즘 | 모델이나 사람이 아니라 편집 거리 등의 결과를 계산하는 코드입니다. |
측정 결과#
각 측정은 실행 대상 이벤트마다 결과를 제공합니다. 레이더 → 로그 → 측정의 값 필터로 결과를 유형별로 좁혀 볼 수 있습니다.
| 값 | 의미 |
|---|---|
| 통과 | 통과 여부를 판정하는 측정에서 번역이 기준을 충족한 것으로 확인되었습니다. 수정률의 경우, 사람이 번역을 변경했다는 뜻입니다. |
| 실패 | 통과 여부를 판정하는 측정에서 번역이 기준을 충족하지 못한 것으로 확인되었습니다. 수정률의 경우, 아무도 번역을 변경하지 않았다는 뜻입니다. |
| 점수 산출 | MQM이나 편집 거리처럼 0~100점 척도를 사용하는 측정에서 점수가 산출되었습니다. |
| 해당 없음 | 측정 질문이 해당 이벤트에 적용되지 않았습니다. 용어집 용어가 없는 원문에 용어집 검사를 실행한 경우가 그 예입니다. 평균과 통과율 계산에서 제외됩니다. |
| 조건 미충족 | 이벤트 유형은 측정의 실행 대상이지만, 언어, 엔진, 출처 또는 표본 범위를 벗어납니다. 평가자를 호출하지 않고 해당 없음으로 처리하며, 요금은 부과되지 않습니다. |
기본 제공 측정#
| 측정 | 측정 내용 | 실행 대상 |
|---|---|---|
| 용어집 준수도 | 관련 용어집 용어 중 번역에 적용된 비율 | localization.completed |
| 규칙 준수도 | 적용 가능한 규칙 중 번역이 준수한 비율 | localization.completed |
| MQM | 모델이 나열한 오류를 바탕으로 계산한 0~100점 사이의 점수 | localization.completed |
| 수정률 | 사람이 번역을 변경했는지 여부 | target.created, target.updated |
| 편집 거리 | 텍스트가 얼마나 변경되었는지를 나타내는 백분율 | target.created, target.updated |
| 수정 패턴 | 변경 과정에서 이루어진 수정의 유형 | target.created, target.updated |
AI 평가자에서는 각 측정이 결과를 계산하는 방식과 나만의 측정을 만드는 방법을 설명합니다.