Relatórios

Use a visão geral do Radar e os relatórios salvos em Explorar para identificar padrões em eventos e respostas de medições e preservar o cálculo por trás de análises recorrentes.

Os relatórios ajudam a ir além de uma tradução isolada e identificar padrões. A equipe pode descobrir quais idiomas concentram a maior parte do trabalho registrado, quais medições tiveram mudanças nas respostas ou onde uma regra falha repetidamente. A próxima ação depende do que o relatório contabiliza: mais eventos, menos respostas aprovadas e mais tokens representam situações diferentes.

O Radar tem duas telas de relatórios. Radar → Visão geral resume o mês atual: a pontuação média, as palavras geradas, os eventos de hoje e os valores calculados pelas medições para esses eventos. Radar → Explorar exibe gráficos de eventos e de respostas com resultado de aprovação ou reprovação ou com pontuação numérica, e salva esses gráficos como relatórios da organização. Abra uma resposta individual em Resultados para examinar o texto e a explicação. As classificações de padrões de edição não fazem parte desses relatórios nem das listas de resultados; use a taxa e a distância de edição para localizar alterações e, depois, leia os textos comparados.

Passe o cursor sobre o nome de um cartão na visão geral para ver o que ele contabiliza. Os cartões de pontuação, palavras, eventos e Medições de hoje da visão geral, assim como a tela Explorar, exigem acesso a relatórios, disponível apenas no plano Enterprise; sem esse acesso, exibem uma mensagem informando que os relatórios não estão disponíveis no seu plano.

Escolha um relatório pela pergunta que ele responde #

PerguntaOnde consultar
Quanto o Lingo.dev gerou neste mês?O cartão Palavras geradas na visão geral, descrito em Volume de trabalho de tradução.
Quanta atividade houve em cada idioma, engine ou provedor?A opção Eventos em Explorar, descrita em Volume de trabalho de tradução.
Onde os commits do repositório alteraram conteúdo localizado?Eventos do GitHub em Radar → Registros, descritos em Alterações no repositório.
Como as respostas das medições mudaram ao longo do mês?O painel de pontuação na visão geral, descrito em Resultados da avaliação.
O que uma medição respondeu, por idioma ou engine?Um relatório de Medições em Explorar, descrito em Resultados da avaliação.
Com que consistência as regras ou os termos foram seguidos?Um relatório de Pontuação de conformidade com regras ou com o glossário, com explicações individuais em Resultados; consulte Resultados da avaliação.

As séries de tokens e custos de modelos referentes ao período da conta ficam em Configurações → Consumo, e não no Radar; Consumo explica essas séries.

Crie um relatório em Explorar #

  1. Abra Radar → Explorar. Selecione Novo relatório ou abra Exemplos e escolha um relatório criado com seus dados para ajustá-lo.
  2. Para acompanhar uma medição numérica ou com resultado de aprovação ou reprovação, selecione-a em Predefinição. O relatório passa a mostrar as respostas dessa medição por semana nos últimos 90 dias: Pontuação com Média para uma medição de 0 a 100, ou Valor booleano com Média para uma medição de aprovação ou reprovação. Uma predefinição substitui o relatório inteiro, e o seletor só exibe o nome dela enquanto o relatório ainda corresponder à predefinição.
  3. Em Dados, selecione Adicionar dados e escolha o que contar ou calcular e, depois, como: Contagem ou Valores únicos para um campo, Soma ou Média para Pontuação, e Média para Valor booleano. Cada série lê eventos ou respostas de medições conforme os dados escolhidos.
  4. Em Filtros, selecione Adicionar filtro, escolha um campo e use é qualquer um de, não é nenhum de ou está vazio. A lista de valores de um filtro oferece os valores mais comuns de todo o histórico registrado, não apenas do intervalo selecionado.
  5. Em Agrupar por, escolha um Detalhamento opcional e use Depois por para adicionar um segundo. O detalhamento oferece apenas campos presentes em todas as séries do relatório.
  6. Acima do gráfico, escolha um Intervalo de datas e a granularidade de Tempo — Dia, Semana, Mês, Ano ou Total — e, em Gráfico, escolha como exibi-lo. Em seguida, selecione Salvar relatório.

Cada opção em Dados, Filtros e Detalhamento informa, abaixo do nome, o que contém. Cada tipo de evento oferecido como valor de filtro também informa o que significa. O nome sugerido para um relatório reflete o que ele mostra e começa pela medição acompanhada, como MQM · Score per week. Já o título do gráfico usa os nomes fornecidos pelo seletor de Dados.

Escolha entre Gráfico de linhas, Gráfico de barras, Número, Barras horizontais, Gráfico de pizza, Mapa de calor, Gráfico de dispersão e Gráfico de pontos, conforme os dados e o agrupamento selecionados. Em um gráfico temporal, Arrastar para ampliar restringe o intervalo a períodos inteiros; Redefinir zoom retorna ao intervalo salvo.

Os intervalos de datas são Últimos 7 dias, Últimos 30 dias, Últimos 90 dias, Últimos 12 meses, que abrange 365 dias, e Todo o período, a partir do primeiro dia com dados. Cada intervalo termina no fim do dia de hoje, portanto o dia atual é incluído mesmo antes de terminar. Os limites de dias, semanas e meses seguem o fuso horário da organização, definido em Configurações → Geral; as semanas começam na segunda-feira. Eventos e respostas são posicionados pelo horário do evento, não pelo horário em que a resposta foi calculada.

Um detalhamento limita os grupos exibidos de uma vez. Gráficos temporais mantêm os 5 principais mais Outros. Um único detalhamento sem tempo mantém os 10 principais mais Outros, ou começa com 50 grupos para Barras horizontais, Mapa de calor, Gráfico de pontos e Gráfico de dispersão; Mostrar mais adiciona outros 50. Um segundo detalhamento mantém as 100 principais combinações. Registros sem o campo aparecem como Não definido. Ordenar oferece Maiores primeiro e Menores primeiro para um único detalhamento sem tempo.

Para séries de eventos, Filtros e Detalhamento oferecem Tipo de evento, Idioma de destino, Idioma de origem, Engine e Provedor. Séries de medições também oferecem Medição, Tipo de valor, Não aplicável, Decidido por e Modelo avaliador. Um relatório com séries de eventos e de medições pode usar os campos que elas compartilham para fazer o agrupamento.

Salve e compartilhe relatórios #

Um relatório salvo armazena o nome e a definição: séries, filtros, agrupamento, gráfico e intervalo de datas. Ele não armazena dados. Ao abri-lo, a consulta é executada novamente, então o mesmo relatório pode mostrar valores diferentes mais tarde. Todos os membros da organização veem os relatórios dela e podem renomear, sobrescrever ou excluir qualquer um deles; um relatório excluído não pode ser restaurado.

Após alterar um relatório salvo, selecione Salvar para sobrescrevê-lo, Salvar como novo para manter o original ou Descartar. Baixar CSV exporta a tabela abaixo do gráfico exatamente como ela é exibida, incluindo porcentagens formatadas, — para valores ausentes e o grupo Outros. Os grupos ocultos pelo limite do detalhamento não entram no arquivo.

Explique o cálculo do indicador principal #

Calcular a média de porcentagens e combinar observações pode produzir resultados diferentes. Considere, como exemplo, um dia com 1 aprovação em 1 resposta e outro com 0 aprovações em 9 respostas. A média das porcentagens diárias é de 50%, mas a população combinada tem 1 aprovação em 10 respostas: 10%.

O Radar usa os dois cálculos em lugares diferentes:

ExibiçãoCálculo
Painel de pontuação da visão geralO cálculo de cada dia reúne as respostas daquele dia. O indicador principal do mês calcula a média dos dias que têm pontuação, sem ponderá-los pela quantidade de respostas.
Variação da pontuação na visão geralA média diária do mês até hoje menos a média dos mesmos dias do mês anterior, em pontos.
Palavras geradasTotal de palavras do mês, comparado com as mesmas datas do mês anterior, indicadas no cartão, como vs Oct 1 – 2.
Gráfico de Número em ExplorarUm único valor agregado para todo o intervalo. A variação é calculada em relação ao período de mesma duração imediatamente anterior: pontos para porcentagens, variação relativa para contagens e — quando o valor anterior está ausente ou é zero.
Pontuação → Média em ExplorarA média das respostas numéricas de 0 a 100 que não são N/A.
Valor booleano → Média em ExplorarRespostas aprovadas divididas pelas respostas de aprovação ou reprovação que não são N/A. Respostas em uma escala de 0 a 100 ficam fora do denominador.

Para obter uma proporção da população combinada, consulte um valor agregado — um gráfico de Número em Explorar ou o totals da resposta da consulta abaixo — em vez de calcular a média dos pontos do gráfico. Dias com valor nulo são excluídos da média da visão geral, e um mês sem nenhuma resposta pontuada mostra — em vez de zero.

Populações vazias exigem o mesmo cuidado. Um valor nulo, um zero exibido e a ausência de linhas observadas podem representar estados diferentes. Os totais de respostas não permitem identificar traduções elegíveis que nunca foram selecionadas ou concluídas. Use Resultados para informar a conclusão e a cobertura de respostas com resultado determinado junto com as taxas de aprovação.

Investigue o padrão por trás do número #

Diante de uma mudança na pontuação, examine exemplos da mesma medição e depois compare a composição do conteúdo, os idiomas, a amostragem e as orientações. Uma média geral pode mudar porque um idioma difícil recebeu mais trabalho ou porque outra medição começou a responder. Uma classificação baseada em observações pode sugerir uma comparação controlada de modelos; ela não comprova que o modelo causou a diferença.

Para analisar a atividade de edição, leia a taxa e a distância de edição em conjunto e verifique a correspondência entre o rascunho e a versão de destino. Menos edições podem refletir rascunhos melhores, menos revisão ou uma política de aceitação diferente. As respostas sobre padrões de edição são estruturadas e não entram nas medidas de pontuação ou taxa de aprovação. O tempo economizado exige evidências separadas.

Para problemas operacionais, acompanhe Execuções e Solicitações. Distinga etapas ausentes, ignoradas, com falha e concluídas. A conclusão da tradução, a gravação no destino e a publicação do resultado são marcos diferentes. Registros individuais ajudam na investigação, mas não fornecem um histórico agregado completo das transições de estado.

As constatações de integridade estrutural também exigem uma interpretação própria. Compare chaves ausentes, chaves extras, marcadores de posição e a saída corrigida com o contrato esperado. A ausência de campos de integridade não comprova que a verificação foi bem-sucedida, e uma falha estrutural é diferente de uma alteração no que o texto afirma.

Interprete os registros de data e hora de eventos e de ingestão de acordo com o que esses horários realmente representam na fonte. As aprovações do Crowdin mantêm o horário de criação da sugestão, portanto a diferença pode incluir o tempo anterior à aprovação, e não apenas o atraso na coleta. Eventos explica a consequência para o filtro de datas. A duração da avaliação pelo modelo descreve outro intervalo. Mantenha os eventos de strings do provedor separados dos eventos de solicitação ou de idioma da tarefa ao calcular contagens ou resumos de atrasos.

Compare gastos e tempo para o mesmo trabalho #

Deixe explícita a unidade de contabilização: solicitação, etapa, resposta de medição ou período da conta. Várias respostas de medições podem se referir a uma única solicitação de geração; por isso, atribuir o custo total dela a cada resposta duplica o gasto. Totais de tokens representam volume de trabalho, não dinheiro, e campos de eventos com valor padrão zero não comprovam custo de geração zero.

A duração da solicitação abrange um intervalo menor que o tempo total decorrido da tarefa, que inclui esperas na fila ou por revisão. O custo registrado por resposta com resultado determinado pode descrever o rendimento da medição, mas não comprova a economia de esforço humano. Custos apresenta os limites de contabilização necessários.

Preserve uma análise recorrente #

Um relatório salvo em Explorar mantém a definição da pergunta, mas não o raciocínio por trás dela nem os valores que exibiu. Guarde essas informações junto com a análise da equipe: a decisão que ela orienta, a população de origem, a unidade, as medidas, os detalhamentos, os filtros, o intervalo, o fuso horário, a granularidade temporal, a ordenação e o tratamento dos grupos que ficam fora dos N principais exibidos. Preserve os IDs das medições, além dos nomes, pois os nomes podem mudar.

Para cada proporção, identifique o numerador e o denominador. A participação por idioma usa todos os grupos que restam após a filtragem, antes de ocultar os menores. Uma taxa de aprovação de qualidade usa respostas com resultado determinado sob um único critério e informa a cobertura separadamente. O crescimento no período divide a diferença pelo valor do período anterior e fica indefinido quando esse valor anterior é zero.

Guarde o resultado observado ou a data da consulta junto com a especificação. Um relatório salvo ou uma consulta em tempo real pode retornar dados diferentes mais tarde, por exemplo, depois que uma avaliação histórica substituir respostas no intervalo. Um CSV baixado registra o que o relatório mostrava naquele momento.

Por fim, teste a medição por trás do relatório. Validar constatações de qualidade examina se as sinalizações são justificadas; elaboração de medições examina falsos alarmes, erros não detectados e cobertura. A concordância entre dois modelos avaliadores, por si só, não comprova que o resultado está correto.

Consulte valores agregados de relatórios #

Envie JSON com Content-Type: application/json para https://api.lingo.dev, autenticando-se com uma X-API-Key no lado do servidor para a organização desejada ou com uma credencial bearer aceita. Essas operações exigem que você seja membro da organização e tenha acesso a relatórios; não é necessário ter a função de Proprietário apenas para consultar análises. Substitua :orgId pelo ID da organização e mantenha as credenciais fora do código do cliente e das especificações de relatórios salvos.

Caminho POSTMedidas a solicitar e ler em totals
/v2/organizations/:orgId/analytics/measurement-scoresaverageScore, reviews, scored

Para obter uma pontuação de todo o período, use este corpo com a operação measurement-scores, substituindo o intervalo do exemplo:

json
{
  "measures": ["averageScore", "reviews", "scored"],
  "time": {
    "axis": "createdAt",
    "from": "2026-10-01T00:00:00.000Z",
    "to": "2026-11-01T00:00:00.000Z"
  }
}

Leia totals.averageScore com totals.reviews e totals.scored. averageScore está em uma escala de 0 a 1; reviews conta todas as respostas, incluindo N/A, e scored conta aquelas com resultado determinado. Omitir dimensões solicita a população combinada; respostas agrupadas também calculam totais agregados independentemente de suas linhas. O eixo createdAt corresponde ao horário do evento.

Os filtros disponíveis restringem a população: por exemplo, filters: {"reviewerId":"…"} seleciona uma medição pelo ID, e engineId, sourceLocale e targetLocale selecionam engines e idiomas. Use IDs reais obtidos nas leituras de medições. Essas operações usam consultas declaradas, não SQL arbitrário. O servidor fornece o fuso horário da organização e rejeita um timezone fornecido por quem faz a chamada; guarde esse fuso horário junto com os limites explícitos do intervalo. Uma consulta executada mais tarde pode retornar dados diferentes, então salve os totais observados e a data da consulta junto com o cálculo.

As próprias séries de Explorar usam /analytics/events e /analytics/measurement-answers com a mesma estrutura de solicitação em um eixo eventAt; elas retornam linhas sem totals. Os relatórios salvos estão disponíveis em GET e POST /v2/organizations/:orgId/reports, além de GET, PATCH e DELETE /v2/reports/:id.