Avaliação histórica
Aplique a medição atual a eventos registados, escolha entre manter ou substituir respostas anteriores e tenha em conta os dados indisponíveis e a conclusão assíncrona.
A avaliação histórica aplica uma medição a eventos já recolhidos na sua organização. Utilize-a para aplicar um novo critério a traduções anteriores, medir eventos importados do histórico de um fornecedor ou analisar um período delimitado com uma definição revista. Na página de detalhes da medição, esta funcionalidade está no separador Preenchimento retroativo.
Para conteúdo mais antigo de um fornecedor, comece por importar o histórico do GitHub ou do Zendesk e confirme que os eventos pretendidos estão visíveis em Radar → Registos. O progresso da importação contabiliza os itens do fornecedor em fila para recolha; o mapeamento e o armazenamento podem só terminar mais tarde. A avaliação histórica lê os dados armazenados dos eventos. O histórico importado requer um preenchimento retroativo da medição, porque esses eventos são recolhidos sem serem medidos à chegada.
Consulte o que já foi medido #
A secção Medidos mostra quantos eventos dos tipos abrangidos pela medição têm uma resposta, incluindo N/A, em todo o histórico registado — por exemplo, «1 204 de 8 154 eventos medidos». Contabiliza eventos com dados armazenados, abrange os tipos de evento da medição, quer esta esteja ativa ou inativa, e mantém-se igual quando altera as datas de Preenchimento retroativo. Abaixo do total, cada origem — um repositório do GitHub, um Centro de Ajuda do Zendesk, um projeto do Crowdin ou o Lingo.dev — indica quantos dos seus eventos foram medidos, por exemplo, «acme/web 1 180 de 7 600». Os eventos cujo registo não indica uma origem aparecem em Origem desconhecida. GET /v2/organizations/:orgId/measurements/:measurementId/period-counts com from (inclusivo) e to (exclusivo) em formato ISO devolve 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 a medição estiver inativa. Os tipos de evento ativados determinam quais os eventos antigos a considerar, e cada evento é verificado face aos idiomas, motores e amostra atuais da respetiva condição. Um evento que não cumpra esses critérios recebe uma resposta N/A, tal como na avaliação em tempo real.
Abaixo de De e Até, o separador contabiliza os eventos do período por origem: cada repositório do GitHub, Centro de Ajuda do Zendesk, projeto do Crowdin e o Lingo.dev. Os eventos cujo registo não indica uma origem aparecem em Origem desconhecida. A contagem abrange os eventos lidos pelo preenchimento retroativo: os que pertencem aos tipos de evento ativados na medição e têm dados armazenados, antes de as condições restringirem a seleção. Um evento que não corresponda aos idiomas, motores ou origens de uma condição entra nessa contagem e recebe uma resposta N/A. A contagem não é apresentada enquanto a medição estiver inativa.
Escolha um período curto cujos eventos possa inspecionar. Verifique se os dados dos eventos contêm o texto de origem, a tradução de destino, o rascunho ou o contexto exigidos pelo critério. Para verificar a conformidade com o glossário e as regras, preserve também as orientações atuais relevantes do motor de localização: estas verificações leem os termos e as regras associados no momento da avaliação, em vez de recriarem o contexto existente no momento da geração.
O intervalo seleciona os valores registados de eventAt. Uma aprovação do Crowdin utiliza a data e hora de criação da sugestão, que podem ser anteriores ao dia da aprovação. Consulte a data e hora do evento ao escolher um período; selecionar apenas o dia em que a aprovação chegou pode excluir esse evento.
Mantenha ou substitua respostas anteriores #
A opção Apenas eventos ainda não medidos está ativa por predefinição. Mantém as respostas já existentes no período e mede apenas os eventos sem resposta; uma resposta N/A conta como medida e é mantida.
Desative esta opção para voltar a medir todo o período com a definição atual. Ao iniciar, surge a pergunta Medir o período novamente?, porque as respostas anteriores da medição nesse período são primeiro eliminadas e depois gravadas de novo à medida que os eventos são medidos.
Guarde as respostas anteriores antes de as substituir
Com a opção Apenas eventos ainda não medidos desativada, a eliminação abrange as respostas da medição em todo o intervalo selecionado, incluindo tipos de evento ou idiomas que já não estão selecionados. Guarde primeiro a definição anterior e os resultados necessários para comparação. Se os dados de um evento forem ignorados ou uma substituição falhar, pode ficar uma lacuna onde antes existia uma resposta.
Inicie uma avaliação num período delimitado #
- Abra o separador Preenchimento retroativo da medição.
- Defina De e Até. Os seletores de data incluem ambos os dias escolhidos, em UTC, e não permitem datas posteriores ao dia de hoje; se escolher o mesmo dia nos dois campos, a avaliação abrange esse dia.
- Decida se pretende manter ativa a opção Apenas eventos ainda não medidos.
- Selecione Iniciar preenchimento retroativo e confirme se estiver a substituir respostas.
- Acompanhe a linha de progresso — Preenchimento retroativo em curso, seguida de Preenchimento retroativo concluído ou Falha no preenchimento retroativo — e a respetiva contagem de eventos medidos. O preenchimento retroativo também fica disponível no painel de tarefas em segundo plano, no canto de todas as páginas; selecione qualquer um destes pontos para abrir o progresso.
O contrato de início subjacente é POST /v2/organizations/:orgId/measurements/:measurementId/backfill, com datas e horas em formato ISO, from inclusivo e to exclusivo, sendo obrigatórios from < to e unmeasuredOnly. Na API, o valor predefinido de unmeasuredOnly é false, o que substitui as respostas; envie true para as manter. Para um dia UTC, o intervalo vai da meia-noite desse dia até à 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 um em curso. GET /v2/organizations/:orgId/backfills lista as execuções recentes; status=running&startedBy=me restringe a lista às execuções em curso que iniciou.
Reconcilie as novas respostas #
O processamento lê os eventos por páginas e coloca medições em fila apenas quando os dados armazenados estão disponíveis. Um preenchimento retroativo concluído significa que os seus eventos foram medidos, mas cada resposta continua a registar o seu próprio resultado. As execuções retroativas são contabilizadas para efeitos de consumo da mesma forma que as execuções em tempo real, exceto no caso das respostas ignoradas por uma condição. As respostas retroativas não geram sugestões do motor de localização.
Inspecione os eventos e os resultados selecionados. O histórico de resultados não apresenta o identificador da execução de preenchimento retroativo, pelo que deve cruzar o identificador do evento, o identificador da medição, o intervalo dos eventos e o momento do cálculo. Inclua na reconciliação os eventos esperados que não tenham resposta, em vez de deduzir que o processo terminou apenas com base nas linhas devolvidas.
Consulte o motivo de cada nova resposta N/A. Pode dever-se à seleção de uma condição, a dados em falta, à ausência de orientações aplicáveis ou à incapacidade de um avaliador de dar uma resposta conclusiva. Uma falha de execução exige medidas de recuperação diferentes das necessárias para uma tradução elegível sem texto de origem.
Preserve uma comparação fora do histórico de substituições #
Se pretende saber se um critério revisto deteta erros de forma mais fiável, guarde as definições antiga e nova, juntamente com exemplos avaliados de forma independente e os respetivos resultados. Se pretende saber se as traduções melhoraram, preserve ambas as versões da tradução em condições comparáveis.
O preenchimento retroativo não dispõe de uma operação estabelecida para cancelar a execução ou repor respostas anteriores. Evite repetir execuções com períodos sobrepostos para investigar um resultado em falta: identifique primeiro os eventos selecionados, os dados em falta e as respostas devolvidas. Comparar modelos de tradução explica como preservar ensaios repetíveis sem depender de um histórico mutável.