보고서
레이더의 개요와 저장된 탐색 보고서로 이벤트와 측정 응답의 패턴을 파악하고, 반복 분석에 쓰이는 계산 방식을 보존하세요.
보고서를 활용하면 개별 번역을 넘어 전체적인 패턴을 파악할 수 있습니다. 기록된 작업에서 어떤 언어가 가장 큰 비중을 차지하는지, 어떤 측정의 응답이 달라졌는지, 어떤 규칙이 계속 지켜지지 않는지 확인할 수 있습니다. 다음 조치는 보고서의 집계 대상에 따라 달라집니다. 이벤트 증가, 통과 응답 감소, 토큰 증가는 각각 다른 상황을 의미합니다.
레이더에는 두 가지 보고 화면이 있습니다. 레이더 → 개요에서는 이번 달 평균 점수와 생성된 단어 수, 오늘의 이벤트와 해당 이벤트에 대해 측정이 계산한 값을 요약해 보여줍니다. 레이더 → 탐색에서는 이벤트와 통과·실패 또는 수치 점수 응답을 차트로 표시하고, 조직에서 사용할 보고서로 저장할 수 있습니다. 텍스트와 설명을 자세히 보려면 결과에서 개별 응답을 여세요. 수정 패턴 분류는 이 보고서와 결과 목록에 포함되지 않습니다. 수정률과 수정 거리로 변경 사항을 찾은 다음, 비교된 텍스트를 읽어보세요.
개요에서 타일 이름 위에 마우스를 올리면 집계 대상을 확인할 수 있습니다. 개요의 점수, 단어, 이벤트, 오늘의 측정 타일과 탐색을 사용하려면 보고서 이용 권한이 필요합니다. 이 권한을 이용하려면 Enterprise 요금제가 필요합니다. 권한이 없으면 현재 요금제에서 보고서를 사용할 수 없다는 메시지가 표시됩니다.
질문에 맞는 보고서 선택하기 #
| 질문 | 확인할 위치 |
|---|---|
| 이번 달에 Lingo.dev에서 얼마나 생성했나요? | 개요의 생성된 단어 수. 번역 작업량에서 설명합니다. |
| 언어, 엔진 또는 제공업체별 활동량은 얼마나 되나요? | 탐색의 이벤트. 번역 작업량에서 설명합니다. |
| 저장소 커밋으로 현지화된 콘텐츠가 어디에서 변경되었나요? | 레이더 → 로그의 GitHub 이벤트. 저장소 변경 사항에서 설명합니다. |
| 한 달 동안 측정 응답이 어떻게 달라졌나요? | 개요의 점수 패널. 평가 결과에서 설명합니다. |
| 특정 측정은 언어 또는 엔진별로 어떤 응답을 내놓았나요? | 탐색의 측정 보고서. 평가 결과에서 설명합니다. |
| 규칙이나 용어가 얼마나 일관되게 지켜졌나요? | 규칙 또는 용어집 준수 점수 보고서와 결과의 개별 설명. 평가 결과를 참조하세요. |
계정 기간의 토큰 및 모델 비용 시계열은 레이더가 아닌 설정 → 사용량에서 확인할 수 있습니다. 자세한 내용은 사용량에서 설명합니다.
탐색에서 보고서 만들기 #
- 레이더 → 탐색을 여세요. 새 보고서를 선택하거나, 예시를 열어 내 데이터를 바탕으로 만든 보고서를 선택한 뒤 조정하세요.
- 수치형 또는 통과·실패 측정 하나를 추적하려면 사전 설정에서 해당 측정을 선택하세요. 보고서가 최근 90일간 해당 측정의 주별 응답을 표시하도록 바뀝니다. 0~100점 측정에는 점수와 평균이, 통과·실패 측정에는 불리언 값과 평균이 적용됩니다. 사전 설정을 선택하면 보고서 전체가 대체되며, 보고서가 해당 사전 설정과 일치하는 동안에만 선택기에 그 이름이 표시됩니다.
- 데이터에서 데이터 추가를 선택하고 집계하거나 계산할 대상과 방식을 고르세요. 필드에는 개수 또는 고유값 수, 점수에는 합계 또는 평균, 불리언 값에는 평균을 사용할 수 있습니다. 각 계열은 선택한 데이터에 따라 이벤트 또는 측정 응답을 읽어옵니다.
- 필터에서 필터 추가를 선택하고 필드를 고른 뒤 다음 중 하나임, 다음 중 어느 것도 아님, 비어 있음을 사용하세요. 필터 값 목록에는 선택한 범위만이 아니라 기록된 전체 이력에서 가장 자주 등장하는 값이 표시됩니다.
- 그룹화 기준에서 필요에 따라 세부 분류를 선택하세요. 두 번째 분류는 다음 기준으로 지정할 수 있습니다. 세부 분류에는 보고서의 모든 계열에 공통으로 있는 필드만 표시됩니다.
- 차트 위에서 날짜 범위를 선택하고, 시간 단위를 일, 주, 월, 년, 전체 중에서 고르세요. 차트에서 표시 방식을 선택한 다음 보고서 저장을 선택하세요.
데이터, 필터, 세부 분류의 각 옵션은 이름 아래에 포함된 내용을 설명합니다. 필터 값으로 제공되는 각 이벤트 유형에도 의미가 표시됩니다. 보고서의 추천 이름은 표시하는 내용에 따라 정해지며, MQM · Score per week처럼 추적하는 측정의 이름으로 시작합니다. 차트 제목에는 데이터 선택기에 표시된 이름이 사용됩니다.
선택한 데이터와 그룹화 방식에 맞춰 꺾은선형 차트, 막대 차트, 숫자, 가로 막대 차트, 원형 차트, 히트맵, 산점도, 점 도표 중에서 선택하세요. 시간 차트에서 드래그하여 확대하면 완전한 기간 단위로 범위가 좁혀집니다. 확대/축소 초기화를 선택하면 저장된 범위로 돌아갑니다.
날짜 범위는 최근 7일, 최근 30일, 최근 90일, 365일에 해당하는 최근 12개월, 데이터가 있는 첫날부터 시작하는 전체 기간입니다. 모든 범위는 오늘이 끝나는 시점까지이므로, 오늘이 아직 지나지 않았더라도 포함됩니다. 일, 주, 월의 경계는 설정 → 일반에 지정된 조직의 시간대를 따르며, 한 주는 월요일에 시작합니다. 이벤트와 응답은 응답이 계산된 시간이 아니라 이벤트 발생 시간을 기준으로 배치됩니다.
세부 분류는 한 번에 표시되는 그룹 수를 제한합니다. 시간 차트에는 상위 5개 그룹과 기타가 표시됩니다. 시간 축이 없는 단일 세부 분류에는 상위 10개 그룹과 기타가 표시됩니다. 다만 가로 막대 차트, 히트맵, 점 도표, 산점도에서는 처음에 50개 그룹이 표시되며, 더 보기를 선택할 때마다 50개씩 추가됩니다. 두 번째 세부 분류를 적용하면 상위 100개 조합이 표시됩니다. 해당 필드가 없는 레코드는 설정되지 않음으로 표시됩니다. 시간 축이 없는 단일 세부 분류에서는 정렬에서 높은 값부터 또는 낮은 값부터를 선택할 수 있습니다.
이벤트 계열의 필터와 세부 분류에서는 이벤트 유형, 대상 로캘, 원본 로캘, 엔진, 제공업체를 사용할 수 있습니다. 측정 계열에서는 측정, 값 종류, 해당 없음, 판정 주체, 평가 모델도 사용할 수 있습니다. 이벤트 계열과 측정 계열이 모두 있는 보고서는 두 계열의 공통 필드를 기준으로 그룹화할 수 있습니다.
보고서 보관 및 공유하기 #
저장된 보고서에는 이름과 정의, 즉 계열, 필터, 그룹화, 차트, 날짜 범위가 보관됩니다. 데이터 자체는 저장되지 않습니다. 보고서를 열 때마다 쿼리가 다시 실행되므로 같은 보고서라도 나중에는 다른 값이 표시될 수 있습니다. 조직의 모든 구성원은 조직의 보고서를 볼 수 있으며, 어떤 보고서든 이름을 바꾸거나 덮어쓰거나 삭제할 수 있습니다. 삭제한 보고서는 복원할 수 없습니다.
저장된 보고서를 수정한 뒤 저장을 선택하면 덮어쓰고, 새 보고서로 저장을 선택하면 원본을 유지한 채 새로 저장하며, 변경 사항 취소를 선택하면 수정을 취소합니다. CSV 다운로드는 차트 아래의 표를 표시된 그대로 내보냅니다. 서식이 적용된 백분율, 누락된 값을 나타내는 —, 기타 그룹도 포함됩니다. 세부 분류 제한으로 숨겨진 그룹은 파일에 포함되지 않습니다.
대표 수치의 계산 방식 설명하기 #
백분율의 평균을 구할 때와 관측값을 모두 합쳐 계산할 때는 결과가 다를 수 있습니다. 예를 들어 어느 날은 응답 1개 중 1개가 통과하고, 다른 날은 응답 9개 중 통과한 응답이 없다고 가정해 보세요. 일별 백분율의 평균은 50%이지만, 전체를 합치면 응답 10개 중 1개가 통과하므로 10%입니다.
레이더는 화면의 항목에 따라 두 계산 방식을 모두 사용합니다.
| 표시 항목 | 계산 방식 |
|---|---|
| 개요 점수 패널 | 일별 점수는 해당 날짜의 응답을 모두 합쳐 계산합니다. 월 대표 수치는 응답 수에 따른 가중치 없이 점수가 있는 날들의 평균을 구합니다. |
| 개요 점수 변화 | 이번 달 오늘까지의 일별 평균에서 지난달 같은 날짜 범위의 일별 평균을 뺀 값으로, 단위는 점입니다. |
| 생성된 단어 수 | 한 달간 생성된 단어 수의 합계를 지난달 같은 날짜 범위와 비교합니다. 비교 범위는 vs Oct 1 – 2처럼 타일에 표시됩니다. |
| 탐색 숫자 차트 | 전체 범위의 데이터를 합쳐 계산한 단일 값입니다. 변화량은 직전의 동일한 길이의 기간과 비교합니다. 백분율은 퍼센트포인트, 개수는 상대 변화율로 표시하며, 이전 값이 없거나 0이면 **—**로 표시합니다. |
| 탐색 점수 → 평균 | 해당 없음으로 분류되지 않은 0~100점 수치형 응답의 평균입니다. |
| 탐색 불리언 값 → 평균 | 통과한 응답 수를 해당 없음으로 분류되지 않은 통과·실패 응답 수로 나눈 값입니다. 0~100점 척도의 응답은 분모에 포함되지 않습니다. |
전체 모집단의 비율을 구하려면 차트에 표시된 점들의 평균을 내지 말고, 탐색 숫자 차트나 아래 쿼리 응답의 totals처럼 전체를 합쳐 계산한 값을 확인하세요. 값이 없는 날은 개요의 평균에서 제외되며, 점수가 매겨진 응답이 전혀 없는 달은 0이 아닌 **—**로 표시됩니다.
모집단이 비어 있을 때도 주의해서 해석해야 합니다. 값 없음, 화면에 표시된 0, 관측된 행이 없는 상태는 서로 다를 수 있습니다. 응답 총수만으로는 대상에 해당하지만 선택되거나 완료된 적이 없는 번역을 식별할 수 없습니다. 결과를 사용해 통과율과 함께 완료 범위와 확정 판정 범위를 보고하세요.
수치 이면의 패턴 조사하기 #
점수가 달라졌다면 같은 측정의 예시를 살펴본 뒤 콘텐츠 구성, 언어, 표본 추출 방식, 지침을 비교하세요. 까다로운 언어의 작업량이 늘었거나 다른 측정이 응답을 내기 시작해 전체 평균이 달라질 수도 있습니다. 관측 결과에 따른 순위는 통제된 모델 비교를 시도할 근거가 될 수 있지만, 그 차이가 모델 때문에 발생했음을 입증하지는 않습니다.
수정 활동을 살펴볼 때는 수정률과 수정 거리를 함께 확인하고, 초안과 대상 텍스트가 올바르게 짝지어졌는지 검증하세요. 수정이 줄어든 이유는 초안의 품질이 좋아졌기 때문일 수도 있고, 검토가 줄었거나 수락 정책이 달라졌기 때문일 수도 있습니다. 수정 패턴 응답은 구조화된 형식이며 점수나 통과율 지표에는 포함되지 않습니다. 시간 절감 여부는 별도의 근거로 확인해야 합니다.
운영상의 문제는 실행과 요청을 따라가며 조사하세요. 단계가 없는 상태와 건너뛴 상태, 실패한 상태, 완료된 상태를 구분하세요. 번역 완료, 대상 위치에 다시 쓰기, 결과 게시는 서로 다른 진행 단계입니다. 개별 기록은 조사에 도움이 되지만, 집계된 전체 상태 전환 이력을 제공하지는 않습니다.
구조적 무결성 검사 결과도 별도로 해석해야 합니다. 누락된 키, 추가된 키, 자리표시자, 복구된 출력을 예상된 규약과 비교하세요. 무결성 필드가 없다고 해서 검사를 통과했다고 볼 수는 없으며, 구조적 실패와 서술 내용의 변경은 서로 다릅니다.
이벤트와 수집 타임스탬프는 원본에서 각 시간이 실제로 무엇을 의미하는지에 맞춰 해석하세요. Crowdin 승인에는 제안 생성 시간이 유지되므로, 두 시점의 차이에는 수집 지연뿐 아니라 승인 전 시간도 포함될 수 있습니다. 날짜 필터에 미치는 영향은 이벤트에서 설명합니다. 평가 소요 시간은 이와는 다른 구간을 나타냅니다. 개수나 지연 요약을 계산할 때는 제공업체 문자열 이벤트를 요청 이벤트 또는 작업별 로캘 이벤트와 구분하세요.
동일한 작업의 지출과 시간 비교하기 #
비용 집계 단위를 명확히 하세요. 요청, 단계, 측정 응답, 계정 기간 중 무엇을 기준으로 하는지 밝혀야 합니다. 여러 측정 응답이 하나의 생성 요청을 참조할 수 있으므로, 각 응답에 요청의 전체 비용을 배정하면 지출이 중복 집계됩니다. 토큰 총수는 금액이 아닌 작업량을 나타내며, 기본값이 0인 이벤트 필드만으로 생성 비용이 0이라고 단정할 수는 없습니다.
요청 소요 시간이 포괄하는 범위는 큐 대기나 검토 대기를 포함한 전체 작업 경과 시간보다 좁습니다. 확정 판정 응답당 기록된 비용은 측정의 산출 효율을 보여줄 수 있지만, 사람의 노력이 얼마나 절약되었는지는 입증하지 못합니다. 필요한 비용 집계 범위는 비용에서 설명합니다.
반복 분석 보존하기 #
저장된 탐색 보고서는 질문의 정의를 보관하지만, 그에 관한 추론이나 당시 표시된 값은 보관하지 않습니다. 팀의 분석 기록에 이러한 내용도 함께 남기세요. 분석이 뒷받침하는 의사결정, 원본 모집단, 단위, 지표, 세부 분류, 필터, 기간, 시간대, 시간 단위, 정렬 순서, 상위 일부만 표시할 때 나머지 그룹을 처리하는 방식을 기록하세요. 이름은 바뀔 수 있으므로 측정 이름과 함께 식별자도 보존하세요.
모든 비율에 분자와 분모를 명시하세요. 로캘 비중은 작은 그룹을 숨기기 전, 필터를 통과한 모든 그룹을 기준으로 계산합니다. 품질 통과율은 하나의 기준에서 확정 판정이 난 응답을 사용하며, 판정 범위는 별도로 보고합니다. 기간 증가율은 차이를 이전 기간의 값으로 나누어 계산하며, 이전 값이 0이면 정의되지 않습니다.
분석 명세와 함께 관측 결과 또는 조회 날짜를 보관하세요. 저장된 보고서나 실시간 쿼리는 나중에 다른 데이터를 반환할 수 있습니다. 예를 들어 과거 데이터 평가로 해당 기간의 응답이 대체될 수 있습니다. 다운로드한 CSV는 그 시점에 보고서에 표시된 내용을 기록합니다.
마지막으로 보고서의 바탕이 되는 측정을 검증하세요. 품질 검사 결과 검증에서는 문제 표시가 타당한지 살펴보고, 측정 설계에서는 오탐, 놓친 오류, 측정 범위를 살펴봅니다. 두 평가 모델의 판정이 일치한다는 사실만으로 정확성이 입증되지는 않습니다.
전체를 합산한 보고서 값 쿼리하기 #
Content-Type: application/json을 사용해 https://api.lingo.dev로 JSON을 전송하고, 대상 조직의 서버 측 X-API-Key 또는 허용되는 베어러 자격 증명으로 인증하세요. 이 작업에는 조직 구성원 자격과 보고서 이용 권한이 필요하지만, 분석을 조회하기만 할 때는 소유자 역할이 필요하지 않습니다. :orgId를 조직 식별자로 바꾸고, 클라이언트 코드와 저장된 보고서 명세에 자격 증명을 넣지 마세요.
| POST 경로 | totals에서 요청하고 읽을 지표 |
|---|---|
/v2/organizations/:orgId/analytics/measurement-scores | averageScore, reviews, scored |
전체 기간의 점수를 구하려면 측정 점수 작업에 다음 본문을 사용하고, 예시 기간을 실제 기간으로 바꾸세요.
{
"measures": ["averageScore", "reviews", "scored"],
"time": {
"axis": "createdAt",
"from": "2026-10-01T00:00:00.000Z",
"to": "2026-11-01T00:00:00.000Z"
}
}totals.averageScore을 totals.reviews 및 totals.scored과 함께 읽으세요. averageScore는 0~1 척도이며, reviews는 해당 없음을 포함한 모든 응답을, scored는 확정 판정이 난 응답을 셉니다. 차원을 생략하면 전체 모집단을 요청합니다. 그룹화된 응답에서도 각 행과 별개로 전체 모집단을 합산한 총계를 계산합니다. createdAt 축은 이벤트 발생 시간을 나타냅니다.
지원되는 필터로 모집단의 범위를 좁힐 수 있습니다. 예를 들어 filters: {"reviewerId":"…"}는 식별자로 측정 하나를 선택하고, engineId, sourceLocale, targetLocale는 엔진과 언어를 선택합니다. 측정 조회에서 얻은 실제 식별자를 사용하세요. 이 작업은 임의의 SQL이 아니라 미리 선언된 쿼리를 실행합니다. 서버가 조직의 시간대를 제공하며, 호출자가 지정한 timezone는 거부합니다. 명시적인 기간 경계와 함께 해당 시간대를 보관하세요. 나중에 쿼리를 실행하면 다른 데이터가 반환될 수 있으므로, 관측된 총계와 조회 날짜를 계산 방식과 함께 저장하세요.
탐색의 자체 계열은 eventAt 축에서 동일한 요청 구조로 /analytics/events 및 /analytics/measurement-answers를 사용하며, totals 없이 행을 반환합니다. 저장된 보고서는 GET, POST /v2/organizations/:orgId/reports, GET, PATCH, DELETE /v2/reports/:id에서 확인할 수 있습니다.