Relatórios

Use a visão geral do Radar e os relatórios guardados em Explorar para identificar padrões nos eventos e nas respostas das medições e preservar o cálculo que sustenta uma análise recorrente.

Os relatórios ajudam a passar de uma tradução isolada à identificação de um padrão. Uma equipa pode descobrir que idiomas representam a maior parte do trabalho registado, em que medições as respostas mudaram ou onde uma regra continua a falhar. A ação seguinte depende do que o relatório contabiliza: mais eventos, menos respostas aprovadas e mais tokens descrevem situações diferentes.

O Radar tem dois ecrãs 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 apresenta gráficos de eventos e de respostas de aprovação/reprovação ou com pontuação numérica, e permite guardar esses gráficos como relatórios da organização. Abra uma resposta individual em Resultados para consultar o texto e a explicação. As classificações de padrões de edição não fazem parte destes relatórios nem das listas de resultados; use a taxa de edição 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 contabiliza. Os cartões de pontuação, palavras, eventos e Medições de hoje da visão geral, bem como Explorar, exigem acesso aos relatórios, disponível com o plano Enterprise; sem esse acesso, indicam que os relatórios não estão disponíveis no seu plano.

Escolher um relatório pela pergunta a que responde #

PerguntaOnde procurar
Quanto gerou o Lingo.dev este mês?Palavras geradas na visão geral; consulte Volume de trabalho de tradução.
Qual foi a atividade de cada idioma, motor ou fornecedor?Eventos em Explorar; consulte Volume de trabalho de tradução.
Onde é que os commits do repositório alteraram conteúdo localizado?Eventos do GitHub em Radar → Registos, descritos em Alterações no repositório.
Como mudaram as respostas das medições ao longo do mês?O painel de pontuação na visão geral, descrito em Resultados da avaliação.
Que respostas deu uma medição, por idioma ou motor?Um relatório de Medições em Explorar, descrito em Resultados da avaliação.
Com que consistência foram respeitadas as regras ou a terminologia?Um relatório de Pontuação de conformidade com as regras ou com o glossário, com explicações individuais em Resultados; consulte Resultados da avaliação.

As séries de tokens e de custos dos modelos para o período da conta encontram-se em Definições → Consumo, e não no Radar; estão explicadas em Consumo.

Criar um relatório em Explorar #

  1. Abra Radar → Explorar. Selecione Novo relatório ou abra Exemplos e escolha um relatório baseado nos seus dados para ajustar.
  2. Para acompanhar uma medição numérica ou de aprovação/reprovação, escolha-a em Predefinição. O relatório passa a mostrar as respostas dessa medição por semana, ao longo dos últimos 90 dias: Pontuação com Média para uma medição de 0 a 100, ou Valor booleano com Média para uma de aprovação/reprovação. Uma predefinição substitui o relatório inteiro, e o seletor só apresenta o respetivo nome enquanto o relatório continuar a corresponder-lhe.
  3. Em Dados, selecione Adicionar dados e escolha o que pretende contar ou calcular e de que forma: 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, consoante os dados escolhidos.
  4. Em Filtros, selecione Adicionar filtro, escolha um campo e use é um de, não é nenhum de ou está vazio. A lista de valores de um filtro apresenta os valores mais comuns de todo o histórico registado, não apenas do intervalo selecionado.
  5. Em Agrupar por, escolha uma Desagregação opcional e use Depois por para acrescentar uma segunda. A desagregação disponibiliza 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 apresentar os dados. Depois, selecione Guardar relatório.

Cada opção em Dados, Filtros e Desagregação indica, por baixo do nome, o que contém, e cada tipo de evento disponível como valor de filtro explica o seu significado. O nome sugerido para um relatório reflete o que este mostra e começa pela medição que acompanha, como MQM · Score per week. O título de um gráfico usa os nomes apresentados no seletor de Dados.

Escolha entre Gráfico de linhas, Gráfico de barras, Número, Barras horizontais, Gráfico circular, Mapa de calor, Gráfico de dispersão e Gráfico de pontos, consoante os dados e o agrupamento selecionados. Num gráfico temporal, Arrastar para ampliar restringe o intervalo a períodos completos; Repor ampliação restabelece o intervalo guardado.

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, desde o primeiro dia com dados. Cada intervalo termina no final do dia de hoje, pelo que o dia de hoje é incluído mesmo enquanto ainda decorre. Os dias, as semanas e os meses são delimitados pelo fuso horário da organização, definido em Definições → Geral; as semanas começam à segunda-feira. Os eventos e as respostas são posicionados no tempo com base na hora do evento, não na hora a que a resposta foi calculada.

Uma desagregação limita os grupos apresentados de cada vez. Os gráficos temporais mantêm os 5 principais e Outros. Uma única desagregação sem dimensão temporal mantém os 10 principais e Outros, ou começa com 50 grupos no caso de Barras horizontais, Mapa de calor, Gráfico de pontos e Gráfico de dispersão; Mostrar mais acrescenta outros 50. Uma segunda desagregação mantém as 100 principais combinações. Os registos sem o campo aparecem como Não definido. Ordenar disponibiliza Mais altos primeiro e Mais baixos primeiro para uma única desagregação sem dimensão temporal.

Para séries de eventos, Filtros e Desagregação disponibilizam Tipo de evento, Idioma de destino, Idioma de origem, Motor e Fornecedor. As séries de medições também disponibilizam 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 permite agrupar pelos campos que ambas partilham.

Guardar e partilhar relatórios #

Um relatório guardado conserva o nome e a definição: séries, filtros, agrupamento, gráfico e intervalo de datas. Não guarda dados. Ao abri-lo, a consulta é executada novamente, pelo que o mesmo relatório pode apresentar valores diferentes mais tarde. Todos os membros da organização veem os relatórios da organização e podem mudar o nome, substituir ou eliminar qualquer um deles; não é possível restaurar um relatório eliminado.

Depois de alterar um relatório guardado, selecione Guardar para o substituir, Guardar como novo para manter o original ou Descartar. Descarregar CSV exporta a tabela por baixo do gráfico exatamente como é apresentada, incluindo as percentagens formatadas, — para valores em falta e o grupo Outros. Os grupos ocultos pelo limite da desagregação não são incluídos no ficheiro.

Explicar o cálculo do valor em destaque #

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

O Radar usa ambos os cálculos em locais diferentes:

ApresentaçãoCálculo
Painel de pontuação da visão geralCada dia agrega as respostas desse dia. O valor mensal em destaque é a média dos dias com pontuação, sem ponderação pelo número 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 geradasSoma das palavras ao longo do mês, comparada com as mesmas datas do mês anterior, indicadas no cartão, como vs Oct 1 – 2.
Gráfico Número de ExplorarUm único valor agregado para todo o intervalo. A variação é calculada por comparação com o período de igual duração imediatamente anterior: pontos para percentagens, variação relativa para contagens e — quando o valor anterior está ausente ou é zero.
Pontuação → Média de ExplorarA média das respostas numéricas de 0–100 que não são N/A.
Valor booleano → Média de ExplorarRespostas aprovadas divididas pelas respostas de aprovação/reprovação que não são N/A. As respostas numa escala de 0–100 não entram no denominador.

Para obter um rácio da população combinada, consulte um valor agregado — um gráfico Número de Explorar ou o totals da resposta à consulta abaixo — em vez de calcular a média dos pontos do gráfico. Os dias com valor nulo são excluídos da média da visão geral, e um mês sem respostas pontuadas apresenta — em vez de zero.

As populações vazias exigem o mesmo cuidado. Um valor nulo, um zero apresentado 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 apresentar a conclusão e a cobertura de respostas com resultado determinado, juntamente com as taxas de aprovação.

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

Perante uma variação de 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 global pode mudar porque um idioma difícil recebeu mais trabalho ou porque outra medição começou a produzir respostas. Uma classificação baseada em observações pode sugerir uma comparação controlada de modelos; não demonstra 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 o texto de destino. Menos edições podem refletir melhores rascunhos, 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 de taxa de aprovação. O tempo poupado exige evidência própria.

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

Os resultados relativos à integridade estrutural também exigem uma interpretação própria. Compare as chaves em falta, as chaves adicionais, os marcadores de posição e os resultados reparados com o contrato esperado. A ausência de campos de integridade não demonstra que a verificação foi bem-sucedida, e uma falha estrutural é diferente de uma alteração ao que o texto afirma.

Interprete as marcas temporais dos eventos e da ingestão de acordo com o significado real dos tempos na origem. As aprovações do Crowdin mantêm a hora de criação da sugestão, pelo que a diferença pode incluir tempo anterior à aprovação, e não apenas um atraso na recolha. Eventos explica a consequência para o filtro de datas. A duração da avaliação descreve outro intervalo. Ao calcular contagens ou resumos de atrasos, mantenha os eventos de cadeias de texto do fornecedor separados dos eventos de pedidos ou dos eventos por idioma de uma tarefa.

Comparar custos e tempo para o mesmo trabalho #

Indique sempre a unidade de contabilização: pedido, passo, resposta de medição ou período da conta. Várias respostas de medições podem referir-se a um único pedido de geração, pelo que atribuir o custo total desse pedido a cada resposta duplica a despesa. Os totais de tokens representam volume de trabalho, não dinheiro, e os campos de eventos com zero por predefinição não provam que o custo de geração foi nulo.

A duração do pedido abrange menos do que o tempo total decorrido da tarefa, que inclui esperas em fila ou por revisão. O custo registado por resposta com resultado determinado pode descrever o rendimento da medição, mas não permite demonstrar o esforço humano poupado. Custos apresenta os limites de contabilização necessários.

Preservar uma análise recorrente #

Um relatório guardado em Explorar mantém a definição da pergunta, mas não o raciocínio associado nem os valores que apresentou. Guarde essas informações com a análise da equipa: a decisão que fundamenta, a população de origem, a unidade, as medidas, as desagregações, 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 apresentados. Preserve os IDs das medições, além dos nomes, uma vez que estes podem mudar.

Para cada rácio, identifique o numerador e o denominador. A proporção de um idioma usa todos os grupos que restam após a filtragem, antes de ocultar os mais pequenos. Uma taxa de aprovação de qualidade usa respostas com resultado determinado segundo um único critério e apresenta a cobertura separadamente. O crescimento entre períodos divide a diferença pelo valor do período anterior e é indefinido quando esse valor é zero.

Guarde o resultado observado ou a data de obtenção juntamente com a especificação. Um relatório guardado ou uma consulta em tempo real pode devolver dados diferentes mais tarde, por exemplo, depois de uma avaliação histórica substituir respostas no respetivo intervalo. Um CSV descarregado regista o que o relatório apresentava naquele momento.

Por fim, teste a medição que sustenta o relatório. Validar conclusões sobre a qualidade analisa se as sinalizações são justificadas; a conceção de medições analisa falsos alarmes, erros não detetados e cobertura. A concordância entre dois modelos avaliadores, por si só, não demonstra que o resultado esteja correto.

Consultar valores agregados de relatórios #

Envie JSON com Content-Type: application/json para https://api.lingo.dev, autenticando-se com um X-API-Key do lado do servidor para a organização pretendida ou com uma credencial de portador aceite. Estas operações exigem que seja membro da organização e tenha acesso aos relatórios; não é necessário ter a função de Proprietário apenas para consultar dados analíticos. Substitua :orgId pelo ID da organização e mantenha as credenciais fora do código do cliente e das especificações de relatórios guardados.

Caminho POSTMedidas a pedir e a ler de 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 de 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á numa escala de 0–1; reviews conta todas as respostas, incluindo N/A, e scored conta as que têm um resultado determinado. A omissão de dimensões solicita a população combinada; as respostas agrupadas também calculam totais agregados, independentemente das suas linhas. O eixo createdAt corresponde à hora do evento.

Os filtros suportados restringem a população: por exemplo, filters: {"reviewerId":"…"} seleciona uma medição pelo respetivo ID, e engineId, sourceLocale e targetLocale selecionam motores e idiomas. Use IDs reais obtidos nas leituras de medições. Estas são operações de consulta declarada, não SQL arbitrário. O servidor fornece o fuso horário da organização e rejeita um timezone fornecido por quem faz o pedido; guarde esse fuso horário juntamente com os limites explícitos do intervalo. Uma consulta executada mais tarde pode devolver dados diferentes, pelo que deve guardar os totais observados e a data de obtenção juntamente com o cálculo.

As séries de Explorar usam /analytics/events e /analytics/measurement-answers com a mesma estrutura de pedido num eixo eventAt; devolvem linhas sem totals. Os relatórios guardados estão disponíveis em GET e POST /v2/organizations/:orgId/reports, bem como em GET, PATCH e DELETE /v2/reports/:id.