번역 작업량

생성된 단어 수, 이벤트 수, 토큰 수, 저장소 변경 사항을 통해 기록된 로컬라이제이션 작업을 서로 다른 기준으로 살펴보세요.

작업량 보고서는 기록된 로컬라이제이션 활동이 어디에서 발생하는지 보여줍니다. 레이더 → 개요의 생성된 단어 수는 이번 달 Lingo.dev에서 생성한 분량을 추적합니다. 탐색의 이벤트 지표는 기록된 활동을 시간, 언어, 엔진 또는 제공업체별로 집계합니다.

비교하기 전에 먼저 단위를 선택하세요. 요청 하나에 많은 단어가 포함될 수 있고, 토큰 수는 언어와 모델에 따라 달라지며, 저장소 커밋 하나로 여러 로캘의 수많은 키가 변경될 수 있습니다.

생성된 단어 수 #

번역량은 기록된 번역 요청 중 성공한 요청의 단어 수와 요청 수를 합산한 값입니다. 기초 데이터는 조직, 협정 세계시 기준 시간, 로컬라이제이션 엔진, 원본 로캘, 대상 로캘별로 그룹화됩니다. words 또는 requests를 합산하세요. 행 수를 세면 요청 수가 아닌 시간별 그룹 수가 집계됩니다.

개요 타일은 이번 달의 단어 수를 보여주고, 이번 달 현재까지의 수치를 지난달 같은 날짜 범위의 수치와 비교합니다. 비교 대상 월은 vs Oct 1 – 2처럼 이름으로 표시됩니다. 보고서는 조직의 시간대를 사용하지만, 기초 집계 데이터는 협정 세계시 기준 한 시간 단위로 구성됩니다. 따라서 이 데이터만으로는 임의의 분 단위 경계나 시차에 분 단위가 포함된 시간대의 정확한 현지 날짜 경계를 항상 재구성할 수는 없습니다.

집계 대상은 기록된 트래픽 중 성공한 요청입니다. 실패한 요청, 누락된 기록, 이 데이터 소스에 없는 외부 번역은 집계에 포함되지 않습니다. 반복 요청과 샘플로 인해 고유 콘텐츠가 늘지 않아도 집계 수치는 증가할 수 있습니다. 일일 단어 생성량 역시 완료된 다국어 작업이나 게시된 텍스트와는 다릅니다.

번역량 조회인 POST /v2/organizations/:orgId/analytics/translation-volume를 사용하려면 조직 구성원이어야 합니다. 개요 타일과 기타 분석 조회에서는 보고서 이용 권한도 확인합니다. 특정 화면을 이용할 수 없다면 한 보고서의 접근 권한이 모든 보고서에 적용된다고 가정하지 말고, 기능 접근과 역할 및 권한을 확인하세요.

기간별 증가율을 구하려면 경계를 맞춘 완전한 구간끼리 비교하고 다음과 같이 계산하세요.

text
(current volume − previous volume) / previous volume

이전 값이 0이면 이 증가율은 정의되지 않습니다. 대신 새로 관측된 분량을 보고하세요. 수치 급증은 릴리스, 로캘 범위 확대, 반복 작업에서 비롯될 수 있으며, 그 자체만으로 품질을 판단할 수는 없습니다.

이벤트 수 #

데이터에서 이벤트를 선택하면 기록된 각 이벤트를 한 번씩 집계합니다.

집계하기 전에 이벤트 유형으로 필터링하세요. 로컬라이제이션의 시작과 완료는 각각 별개의 이벤트입니다. 단어 기준 번역량은 개요의 생성된 단어 수를 사용하세요.

이벤트 유형, 대상 로캘, 원본 로캘, 엔진 또는 제공업체별로 이벤트를 나누어 살펴보세요. 예를 들어 탐색 → 예시의 대상 로캘별 이벤트는 기록된 작업이 언어별로 어떻게 분포하는지 보여줍니다.

자세한 토큰 및 비용 분석은 사용량 페이지에서 확인하세요. 이벤트 수, 단어 수, 토큰 사용량은 서로 다른 작업 단위를 나타냅니다.

저장소 변경 사항 #

연결된 GitHub 저장소는 각 커밋의 .lingo/config.json를 사용해 원본 파일과 대상 파일을 식별하고, 기본 브랜치에서 지원되는 로컬라이제이션 키의 변경 사항을 기록합니다. 원본 파일에서는 source.* 이벤트가, 대상 파일에서는 target.* 이벤트가 생성되며, 이벤트 날짜는 커밋 날짜를 따릅니다. 병합 커밋과 파일 이름 변경에서는 키 변경 이벤트가 생성되지 않습니다. 실시간 수집에서는 앱 자체의 푸시를 건너뛰지만, 기록을 가져올 때는 앱의 이전 번역 커밋이 포함될 수 있습니다.

레이더 → 로그에서 소스 → GitHub를 선택한 다음 저장소로 피드 범위를 좁히세요. 이벤트를 열어 저장소, 커밋, 파일, 로캘, 키를 실제 저장소 변경 내역과 함께 확인하세요. 커밋 하나에서 여러 이벤트가 생성될 수 있으므로 이벤트 수는 릴리스나 커밋 수가 아니라 변경된 키 수를 나타냅니다.

커밋 기록을 가져오면 이전 이벤트가 추가될 수 있습니다. 지원되는 형식과 기록 수집 범위는 GitHub 활동 수집에서 확인하세요.

사람이 편집한 내용을 측정할 때는 초안과 대상 텍스트를 비교합니다. 저장소 이벤트는 변경된 키 수를 집계합니다. 변경된 키 수나 편집량이 줄었다는 사실만으로는 추가 근거 없이 번역 품질이 개선되었거나 검토 시간이 절약되었다고 볼 수 없습니다.

반복 비교의 일관성 유지 #

결과를 다시 살펴볼 때는 동일한 필터와 단위, 완전한 시간 구간을 사용하세요. 개요 요약과 탐색 차트는 집계 방식이 다를 수 있으므로, 모든 주요 수치에 동일한 비율 계산 방식이 적용된다고 가정하지 말고 계산식을 보관하세요.

집계 데이터의 갱신 방식만으로는 실시간 데이터가 어느 시점까지 반영되었는지 보장할 수 없습니다. 비교를 반복해야 한다면 결과와 함께 조회 날짜를 저장하세요. 반복 분석 보존에서는 보관해야 할 계산 방식과 집계 대상에 관한 기록을 설명합니다.