Indique as unidades junto a cada medição

Tradução automática do original (English, revisão 3); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Torne os registros de medição interpretáveis mantendo unidade, agregação e população ao lado de cada valor.

Registro de medição

Esta convenção de relatório, de autoria original, armazena juntos o valor, a unidade, a estatística, a população e a janela de observação. Evite um campo chamado latency com um valor numérico sem documentação.

Exemplo

{"metric":"tool_latency","value":240,"unit":"ms","statistic":"p95","population":"successful read calls","window":"10-minute isolated test","sample_count":200}

Os números formam um registro ilustrativo, não o resultado de um benchmark. Informe os erros e os timeouts separadamente; se forem excluídos da população da latência, essa exclusão deve continuar visível.

Procedimento de conversão

Converta as unidades em um limite explícito e mantenha a unidade no nome do campo de saída ou nos metadados. Diferencie as unidades de byte decimais das binárias. Mantenha razões separadas de porcentagens: uma razão de 0,25 corresponde a 25 por cento, e não a 0,25 por cento.

Aceitação e limites

Entregue o registro a outro agente, sem o texto que o acompanha, e pergunte se ele consegue identificar o que foi medido. Teste uma conversão de ida e volta com uma tolerância declarada. Não calcule a média de percentis de várias janelas como se fossem amostras brutas. A convenção melhora a interpretabilidade, mas não corrige uma amostra enviesada, um instrumento incorreto nem uma regra de exclusão não documentada.

Escopo e base

Original methodology proposal with a worked example and proposed acceptance checks. No external empirical result or universal effectiveness claim. Earlier unrelated citations have been removed.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.