Отчёты

Находите закономерности в событиях и ответах измерений с помощью обзора Radar и сохранённых отчётов раздела «Исследование». Сохраняйте расчёты, на которых основан регулярный анализ.

Отчёты помогают увидеть за отдельными переводами общие закономерности. Команда может выяснить, на какие языки приходится больше всего зафиксированной работы, у какого измерения изменились ответы или какое правило постоянно нарушается. Дальнейшие действия зависят от того, что считает отчёт: рост числа событий, снижение числа положительных ответов и рост расхода токенов говорят о разных ситуациях.

В Radar два экрана с отчётами. Обзор в Radar показывает итоги текущего месяца: среднюю оценку, количество сгенерированных слов, сегодняшние события и значения, которые измерения рассчитали для этих событий. В разделе Исследование в Radar можно строить графики событий и ответов с результатом «пройдено/не пройдено» или числовой оценкой, а затем сохранять их как отчёты организации. Откройте отдельный ответ в разделе Результаты, чтобы изучить его текст и объяснение. Классификации типов правок не входят в эти отчёты и списки результатов. Чтобы найти изменения, используйте частоту и расстояние редактирования, а затем прочитайте сравниваемые тексты.

Наведите указатель на название карточки в обзоре, чтобы узнать, что она считает. Для карточек оценки, слов, событий и Измерения за сегодня, а также раздела «Исследование» нужно право доступа к отчётам. Оно доступно на плане Enterprise. Без этого права карточки и раздел сообщают, что отчёты недоступны на вашем плане.

Выберите отчёт под свой вопрос #

ВопросГде смотреть
Сколько Lingo.dev сгенерировал за этот месяц?Сгенерировано слов в обзоре. Подробнее — в разделе Объём переводов.
Какой объём активности пришёлся на каждый язык, движок или провайдера?События в разделе «Исследование». Подробнее — в разделе Объём переводов.
Где коммиты в репозитории изменили локализованный контент?События GitHub в разделе Журналы в Radar. Подробнее — в разделе Изменения в репозитории.
Как менялись ответы измерений в течение месяца?Панель оценки в обзоре. Подробнее — в разделе Результаты оценки.
Какие ответы дало одно измерение в разбивке по языкам или движкам?Отчёт Измерения в разделе «Исследование». Подробнее — в разделе Результаты оценки.
Насколько последовательно соблюдались правила или терминология?Отчёт Оценка по соблюдению правил или глоссария с объяснениями отдельных ответов в разделе Результаты. См. Результаты оценки.

Ряды данных по токенам и стоимости моделей за расчётный период находятся на странице «Использование» в настройках, а не в Radar. Подробнее — в разделе Использование.

Как создать отчёт в разделе «Исследование» #

  1. Откройте раздел Исследование в Radar. Выберите Новый отчёт или откройте Примеры и выберите отчёт на основе ваших данных, чтобы настроить его.
  2. Чтобы отслеживать одно числовое измерение или измерение с результатом «пройдено/не пройдено», выберите его в поле Шаблон. Отчёт покажет ответы этого измерения по неделям за последние 90 дней: Оценка с функцией Среднее для шкалы от 0 до 100 или Логическое значение с функцией Среднее для результата «пройдено/не пройдено». Шаблон заменяет весь отчёт. Его название отображается в поле выбора, только пока настройки отчёта совпадают с шаблоном.
  3. В разделе Данные выберите Добавить данные, укажите, что считать или рассчитывать, а затем — как: Количество или Уникальные для поля, Сумма или Среднее для Оценки и Среднее для Логического значения. В зависимости от выбранных данных каждый ряд использует события или ответы измерений.
  4. В разделе Фильтры выберите Добавить фильтр, укажите поле и условие: Любое из, Ни одно из или Пусто. Список значений фильтра показывает самые частые значения за всю историю записей, а не только за выбранный период.
  5. В разделе Группировка при желании выберите Разбивку, а в поле Затем по — вторую. Для разбивки доступны только поля, которые есть у каждого ряда в отчёте.
  6. Над графиком выберите Диапазон дат и шаг в поле Время: День, Неделя, Месяц, Год или Всего. В разделе Диаграмма выберите способ отображения, затем выберите Сохранить отчёт.

Под названием каждого варианта в разделах Данные, Фильтры и Разбивка указано, что он содержит. У каждого типа события в списке значений фильтра тоже есть пояснение. Предлагаемое название отчёта отражает его содержимое и начинается с названия отслеживаемого измерения, например MQM · Score per week. В заголовке диаграммы используются названия из списка выбора Данные.

В зависимости от данных и группировки выберите линейный график, столбчатую диаграмму, число, горизонтальную столбчатую диаграмму, круговую диаграмму, тепловую карту, диаграмму рассеяния или точечную диаграмму. На временном графике действие Перетащите, чтобы увеличить сужает диапазон до целых периодов, а Сбросить масштаб возвращает сохранённый диапазон.

Доступны диапазоны Последние 7 дней, Последние 30 дней, Последние 90 дней, Последние 12 месяцев (365 дней) и Всё время — с первого дня, за который есть данные. Каждый диапазон заканчивается в конце сегодняшнего дня, поэтому сегодня учитывается, даже если день ещё не завершён. Границы дней, недель и месяцев определяются часовым поясом организации, заданным в разделе «Общие» в настройках. Недели начинаются в понедельник. События и ответы распределяются по времени события, а не по времени расчёта ответа.

Разбивка ограничивает число групп, показанных одновременно. Временные графики показывают 5 ведущих групп и группу Прочие. Одна разбивка без времени показывает 10 ведущих групп и группу Прочие, а для горизонтальной столбчатой диаграммы, тепловой карты, точечной диаграммы и диаграммы рассеяния — сначала 50 групп. Кнопка Показать ещё добавляет ещё 50. При второй разбивке остаются 100 ведущих комбинаций. Записи, у которых нет этого поля, отображаются как Не задано. Для одной разбивки без времени в поле Сортировка доступны варианты Сначала наибольшие и Сначала наименьшие.

Для рядов событий в разделах Фильтры и Разбивка доступны Тип события, Целевая локаль, Исходная локаль, Движок и Провайдер. Для рядов измерений также доступны Измерение, Тип значения, Не применимо, Кем принято решение и Модель-судья. Если в отчёте есть и ряды событий, и ряды измерений, их можно группировать по общим полям.

Сохраняйте отчёты и делитесь ими #

Сохранённый отчёт хранит название и настройки: ряды, фильтры, группировку, диаграмму и диапазон дат. Сами данные он не хранит. При открытии запрос выполняется заново, поэтому позже тот же отчёт может показать другие значения. Все участники организации видят её отчёты и могут переименовать, перезаписать или удалить любой из них. Удалённый отчёт восстановить нельзя.

После изменения сохранённого отчёта выберите Сохранить, чтобы перезаписать его, Сохранить как новый, чтобы оставить исходный, или Отменить изменения. Действие Скачать CSV экспортирует таблицу под диаграммой точно в том виде, в котором она показана: с форматированными процентами, — вместо отсутствующих значений и группой Прочие. Группы, скрытые из-за ограничения разбивки, в файл не попадают.

Разберитесь, как рассчитан основной показатель #

Усреднение процентов и объединение наблюдений могут дать разные результаты. Допустим, в один день получен 1 положительный ответ из 1, а в другой — 0 из 9. Среднее дневных процентов — 50 %, но по всем ответам вместе положительный ответ только 1 из 10, то есть 10 %.

Radar использует оба способа расчёта в разных местах:

ЭлементРасчёт
Панель оценки в обзореДля каждого дня объединяются все ответы за этот день. Основной показатель месяца — среднее по дням, за которые есть оценка, без взвешивания по числу ответов.
Изменение оценки в обзореСреднее дневных оценок текущего месяца по сегодняшний день минус среднее за те же дни прошлого месяца, в пунктах.
Сгенерировано словСумма слов за месяц в сравнении с теми же датами прошлого месяца. Период указан на карточке, например vs Oct 1 – 2.
Диаграмма Число в разделе «Исследование»Одно значение по объединённым данным за весь диапазон. Изменение рассчитывается относительно непосредственно предшествующего периода той же длины: в пунктах для процентов, как относительное изменение для количества и —, если предыдущее значение отсутствует или равно нулю.
Оценка с функцией Среднее в разделе «Исследование»Среднее числовых ответов по шкале от 0 до 100, кроме ответов «Не применимо».
Логическое значение с функцией Среднее в разделе «Исследование»Число положительных ответов, делённое на число ответов с результатом «пройдено/не пройдено», кроме ответов «Не применимо». Ответы по шкале от 0 до 100 в знаменатель не входят.

Чтобы получить долю по всей совокупности, используйте значение по объединённым данным — диаграмму Число в разделе «Исследование» или totals из ответа на запрос ниже, — а не усредняйте точки графика. Дни без значения исключаются из среднего в обзоре. Если за месяц нет ни одного ответа с оценкой, отображается —, а не ноль.

Пустые совокупности требуют такой же осторожности. Значение null, отображаемый ноль и отсутствие наблюдаемых строк могут означать разные состояния. По общему числу ответов нельзя выявить подходящие переводы, которые так и не были выбраны или завершены. Используйте раздел Результаты, чтобы наряду с долей положительных ответов указывать завершённость и охват ответами с определённым результатом.

Изучите закономерность, стоящую за числом #

Если оценка изменилась, изучите примеры для того же измерения, затем сравните состав контента, языки, выборку и инструкции. Общее среднее может измениться, потому что на сложный язык пришлось больше работы или другое измерение начало давать ответы. Рейтинг по наблюдаемым данным может стать поводом для контролируемого сравнения моделей, но не доказывает, что именно модель вызвала разницу.

При анализе правок рассматривайте частоту и расстояние редактирования вместе и проверяйте, что черновик сопоставлен с нужным итоговым текстом. Меньшее число правок может говорить о более качественных черновиках, меньшем объёме проверки или другой политике принятия. Ответы о типах правок имеют структурированный формат и не входят в показатели оценки или доли положительных ответов. Экономию времени нужно подтверждать отдельно.

При проблемах в работе используйте разделы Запуски и Запросы. Различайте отсутствующие, пропущенные, завершившиеся с ошибкой и завершённые этапы. Завершение перевода, запись в целевую систему и публикация результата — разные этапы работы. Отдельные записи помогают разобраться в проблеме, но не дают полной сводной истории переходов между состояниями.

Результаты проверки структурной целостности тоже нужно трактовать отдельно. Сопоставьте недостающие и лишние ключи, плейсхолдеры и исправленный результат с ожидаемыми требованиями к структуре. Отсутствие полей целостности не подтверждает успешную проверку, а ошибка структуры — не то же самое, что изменение утверждения.

При работе с временными метками событий и поступления данных учитывайте, что именно означает время в источнике. Одобрения в Crowdin сохраняют время создания предложения, поэтому разница может включать время до одобрения, а не только задержку сбора данных. В разделе События объясняется, как это влияет на фильтрацию по датам. Длительность работы судьи описывает другой интервал. При подсчёте событий или расчёте сводных показателей задержки учитывайте события строк провайдера отдельно от событий запросов или локалей заданий.

Сравнивайте затраты и время на одну и ту же работу #

Явно указывайте единицу учёта: запрос, шаг, ответ измерения или расчётный период. Несколько ответов измерений могут относиться к одному запросу на генерацию. Если отнести полную стоимость запроса к каждому ответу, одни и те же затраты будут учтены несколько раз. Общее число токенов отражает объём работы, а не деньги. Нулевые значения полей событий, заданные по умолчанию, не доказывают, что генерация ничего не стоила.

Длительность запроса охватывает меньше времени, чем полное время задания с ожиданием в очереди или на проверке. Зафиксированная стоимость в расчёте на ответ с определённым результатом может характеризовать результативность измерения, но не доказывает экономию человеческого труда. Нужные границы учёта описаны в разделе Затраты.

Сохраните основу для регулярного анализа #

Сохранённый отчёт раздела «Исследование» хранит параметры вопроса, но не рассуждения вокруг него и не показанные значения. Сохраняйте их вместе с анализом команды. Зафиксируйте, какое решение помогает принять анализ, исходную совокупность, единицу учёта, показатели, разбивки, фильтры, интервал, часовой пояс, временной шаг, порядок сортировки и способ учёта групп за пределами первых N на экране. Сохраняйте не только названия измерений, но и их ИД: названия могут измениться.

Для каждой доли указывайте числитель и знаменатель. Доля локали рассчитывается по всем группам, оставшимся после фильтрации, до скрытия малых групп. Доля положительных ответов по качеству рассчитывается по ответам с определённым результатом в рамках одного критерия, а охват указывается отдельно. Рост за период — это разница, делённая на значение предыдущего периода. Если предыдущее значение равно нулю, рост не определён.

Сохраняйте полученный результат или дату получения вместе с описанием расчёта. Позже сохранённый отчёт или запрос к текущим данным может вернуть другие данные, например после того, как оценка исторических данных заменит ответы в своём интервале. Скачанный CSV фиксирует то, что отчёт показывал в тот момент.

Наконец, проверьте само измерение, на котором основан отчёт. Раздел Проверка выводов о качестве помогает понять, обоснованны ли отметки о проблемах, а раздел Проектирование измерений — изучить ложные срабатывания, пропущенные ошибки и охват. Само по себе согласие двух моделей-судей не доказывает правильность результата.

Как запросить значения отчётов по объединённым данным #

Отправьте JSON с Content-Type: application/json на https://api.lingo.dev, используя для аутентификации серверный X-API-Key нужной организации или допустимые учётные данные Bearer. Для этих операций нужно состоять в организации и иметь право доступа к отчётам. Только для чтения аналитики роль владельца не требуется. Замените :orgId на ИД организации и не храните учётные данные в клиентском коде или сохранённых описаниях отчётов.

Путь POSTПоказатели для запроса и чтения из totals
/v2/organizations/:orgId/analytics/measurement-scoresaverageScore, reviews, scored

Чтобы получить оценку за весь период, используйте это тело запроса с операцией measurement-scores, заменив интервал из примера:

json
{
  "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, переданный вызывающей стороной. Сохраняйте этот часовой пояс вместе с явно заданными границами интервала. При повторном запуске запрос может вернуть другие данные, поэтому сохраняйте полученные итоги и дату получения вместе с расчётом.

Собственные ряды раздела «Исследование» используют /analytics/events и /analytics/measurement-answers с той же структурой запроса по оси eventAt. Они возвращают строки без totals. Сохранённые отчёты доступны по адресам GET и POST /v2/organizations/:orgId/reports, а также GET, PATCH и DELETE /v2/reports/:id.