Avaliação histórica

Aplique a medição atual a eventos registrados, escolha entre manter ou substituir respostas anteriores e leve em conta evidências indisponíveis e a conclusão assíncrona.

A avaliação histórica executa uma medição em eventos já coletados na sua organização. Use esse recurso para aplicar um novo critério a traduções anteriores, medir eventos importados do histórico de um provedor ou analisar um período delimitado com uma definição revisada. Na página de detalhes da medição, o recurso está na aba Preenchimento retroativo.

Para conteúdo mais antigo de provedores, primeiro importe o histórico do GitHub ou do Zendesk e confirme se os eventos desejados aparecem em Radar → Registros. O progresso da importação contabiliza os itens do provedor na fila de coleta; o mapeamento e o armazenamento podem terminar depois. A avaliação histórica lê os dados armazenados dos eventos. O histórico importado precisa de um preenchimento retroativo da medição porque esses eventos são coletados sem serem medidos no momento em que chegam.

Confira o que já foi medido #

A seção Medidos mostra quantos eventos dos tipos abrangidos pela medição têm uma resposta, incluindo N/A, em todo o histórico registrado — por exemplo, “1.204 de 8.154 eventos medidos”. Ela contabiliza eventos com dados armazenados, inclui os tipos de evento da medição, esteja ela ativada ou desativada, e não muda quando você altera as datas de Preenchimento retroativo. Abaixo do total, cada origem — um repositório do GitHub, uma Central de Ajuda do Zendesk, um projeto do Crowdin ou o Lingo.dev — mostra quantos de seus eventos foram medidos, como “acme/web 1.180 de 7.600”. Eventos cujo registro não informa uma origem aparecem em Origem desconhecida. GET /v2/organizations/:orgId/measurements/:measurementId/period-counts com from (inclusivo) e to (exclusivo) em formato ISO retorna os mesmos events, measured e origins para qualquer intervalo.

Selecione a definição e o período #

Ative a medição antes de começar: Iniciar preenchimento retroativo fica indisponível enquanto ela estiver desativada. Os tipos de evento habilitados determinam quais eventos antigos serão considerados, e cada evento é verificado com base nos idiomas, engines e na amostra definidos atualmente na condição. Um evento fora desses critérios recebe uma resposta N/A, como na avaliação em tempo real.

Abaixo de De e Até, a aba contabiliza os eventos do período por origem: cada repositório do GitHub, Central de Ajuda do Zendesk, projeto do Crowdin e Lingo.dev. Eventos cujo registro não informa uma origem aparecem em Origem desconhecida. A contagem abrange os eventos que o preenchimento retroativo lê: aqueles dos tipos habilitados na medição que têm dados armazenados, antes da filtragem pelas condições. Um evento fora dos idiomas, engines ou origens de uma condição entra nessa contagem e recebe uma resposta N/A. A contagem não é exibida enquanto a medição estiver desativada.

Escolha um período curto cujos eventos você consiga inspecionar. Verifique se os dados desses eventos contêm o texto de origem, o texto de destino, o rascunho ou o contexto exigido pelo critério. Para verificar a conformidade com o glossário e as regras, preserve também as orientações atuais relevantes do engine de localização: essas verificações leem os termos e as regras anexados no momento da avaliação, em vez de recriar o contexto do momento da geração.

O intervalo seleciona os valores registrados de eventAt. Uma aprovação do Crowdin usa a data e hora de criação da sugestão, que pode ser anterior ao dia da aprovação. Confira a data e hora do evento ao escolher um período; selecionar apenas o dia em que a aprovação chegou pode deixar esse evento de fora.

Mantenha ou substitua respostas anteriores #

A opção Somente eventos ainda não medidos vem ativada por padrão. Ela mantém as respostas já existentes no período e mede apenas os eventos sem resposta; uma resposta N/A conta como medição realizada e é mantida.

Desative essa opção para medir novamente todo o período com a definição atual. Nesse caso, ao iniciar, será exibida a pergunta Medir o período novamente?, pois as respostas anteriores da medição nesse período são excluídas primeiro e gravadas novamente à medida que os eventos são medidos.

Salve as respostas anteriores antes de substituí-las

Com a opção Somente eventos ainda não medidos desativada, a exclusão abrange as respostas da medição em todo o intervalo selecionado, incluindo tipos de evento ou idiomas que não estão mais selecionados. Antes de continuar, salve a definição anterior e os resultados necessários para a comparação. Se os dados de um evento forem ignorados ou a substituição falhar, pode ficar uma lacuna onde antes havia uma resposta.

Inicie uma avaliação com período delimitado #

  1. Abra a aba Preenchimento retroativo da medição.
  2. Defina De e Até. Os seletores de data incluem os dois dias escolhidos em UTC e não permitem datas posteriores a hoje; escolher o mesmo dia nos dois campos avalia apenas esse dia.
  3. Decida se a opção Somente eventos ainda não medidos deve permanecer ativada.
  4. Selecione Iniciar preenchimento retroativo e confirme se estiver substituindo respostas.
  5. Acompanhe a linha de progresso — Preenchimento retroativo em andamento, seguida de Preenchimento retroativo concluído ou Falha no preenchimento retroativo — e a contagem de eventos medidos. O preenchimento retroativo também fica no painel de tarefas em segundo plano, no canto de todas as páginas; selecione a linha ou o item no painel para abrir o progresso.

O contrato da API para iniciar a execução é POST /v2/organizations/:orgId/measurements/:measurementId/backfill, com datas e horas em formato ISO, from inclusivo e to exclusivo, exigindo from < to e unmeasuredOnly. Pela API, unmeasuredOnly usa por padrão false, que substitui as respostas; envie true para mantê-las. Para um dia em UTC, o intervalo vai da meia-noite desse dia até a meia-noite do dia seguinte; a interface converte a data final inclusiva nesse limite do dia seguinte. A resposta é HTTP 202, com um id de execução assíncrona. Um segundo preenchimento retroativo para a mesma medição é recusado enquanto houver outro em andamento, e GET /v2/organizations/:orgId/backfills lista as execuções recentes; status=running&startedBy=me restringe a lista às execuções em andamento iniciadas por você.

Concilie as novas respostas #

O processamento lê os eventos em páginas e coloca medições na fila apenas quando os dados armazenados estão disponíveis. Um preenchimento retroativo concluído significa que seus eventos foram medidos, mas cada resposta ainda registra seu próprio resultado. As execuções de preenchimento retroativo são contabilizadas da mesma forma que as realizadas em tempo real, exceto pelas respostas ignoradas por uma condição. As respostas de preenchimento retroativo não geram sugestões do engine de localização.

Inspecione os eventos e os resultados selecionados. O histórico de resultados não exibe a identificação da execução de preenchimento retroativo, então correlacione a identificação do evento, a identificação da medição, o intervalo do evento e o horário do cálculo. Inclua na conciliação os eventos esperados que estão sem resposta, em vez de deduzir que o processamento terminou apenas pelas linhas retornadas.

Confira o motivo de cada nova resposta N/A. Ela pode refletir a seleção de uma condição, a falta de evidências, a ausência de orientações aplicáveis ou a incapacidade de um avaliador de fornecer uma resposta conclusiva. Uma falha de execução exige medidas de recuperação diferentes das necessárias para uma tradução elegível sem o texto de origem.

Preserve uma comparação fora do histórico de substituições #

Se a questão for saber se um critério revisado detecta erros com mais confiabilidade, mantenha as definições antiga e nova com exemplos avaliados separadamente e seus resultados. Se a questão for saber se as traduções melhoraram, preserve as duas versões da tradução em condições comparáveis.

O preenchimento retroativo não tem uma operação estabelecida para cancelar a execução ou reverter respostas. Evite sobrepor novas execuções para investigar um resultado ausente: primeiro identifique os eventos selecionados, os dados ausentes e as respostas retornadas. Comparar modelos de tradução explica como manter testes repetíveis sem depender de um histórico mutável.