O metering

01Medir a utilização sem influenciar o serviço #sec_317780ad

O metering é o sistema de medição do consumo de REVIEWIT. Ele conta factos técnicos e funcionais — chamadas de API, pedidos dirigidos ao RITA, volumes exportados ou objetos processados — para produzir uma leitura fiável da utilização por subscrição.

Não calcula preços, nem faturas, nem direitos de acesso. Não decide que uma subscrição deve ser suspensa e nunca bloqueia uma ação de negócio. Esta separação é estruturante: o metering observa, não governa. Um erro de contagem deve ser detetado e tratado, mas não deve impedir um revisor de tomar uma decisão ou um administrador de explorar o seu workspace.

O facto de consumo é medido o mais próximo possível da sua fonte, consolidado localmente na região, e depois transmitido ao plano de controlo. A região envia os seus contadores; o plano de controlo nunca aspira dados de negócio regionais.

02Contadores, nunca pessoas #sec_213beff9

A unidade central é um contador diário: uma métrica, um perímetro, um dia UTC e uma quantidade. O perímetro para no nível necessário para a governação da utilização, nomeadamente a subscrição ou o workspace. Os contadores não transportam identidade do revisor, nem conteúdo da campanha, nem texto de conversação.

O catálogo de métricas é versionado como dados. Indica o que é medido, a unidade e o modo de agregação. Uma soma de pedidos não obedece às mesmas regras que um máximo diário ou que uma fotografia de estado; o modo é, portanto, explícito e não depende de uma interpretação posterior.

Quando o produto já possui um rasto durável, a medida é derivada. Por exemplo, um manifesto de exportação permite contar os eventos difundidos sem adicionar uma escrita no caminho de cada evento. A instrumentação em linha é reservada para factos que não deixam qualquer rasto fiável, como uma chamada de API ou um pedido RITA.

Esta regra limita a carga e evita as duplas verdades: uma única fonte durável faz autoridade para o facto e para a sua contagem.

03Uma medida idempotente e repetível #sec_64dede5c

Cada contador possui uma identidade determinística derivada das suas dimensões. Repetir o mesmo tratamento produz, portanto, o mesmo objeto lógico em vez de adicionar um segundo consumo. Os tratamentos podem retomar após um incidente sem inchar artificialmente os volumes.

Os contadores permanecem abertos durante o seu dia de recolha, depois são selados e transmitidos. O transporte aceita repetições e duplicados técnicos; o destinatário neutraliza-os graças a esta identidade estável.

Uma janela de recuperação permite recalcular as medidas deriváveis a partir de rastos datados. Por outro lado, uma fotografia de estado desaparecida nem sempre pode ser reconstruída honestamente. O sistema prefere, então, declarar uma falta em vez de inventar um valor. O princípio é simples: uma medida ausente não se adivinha.

Os defeitos de transmissão alimentam uma fila de recuperação e alertas de exploração. Eles nunca sobem até ao utilizador que realiza o ato de negócio medido.

04Fechar um período sem reescrever o passado #sec_817a7b16

Os períodos de medição seguem o calendário UTC: dias e meses têm, assim, a mesma definição em todas as regiões. Um período mensal passa de aberto para em fecho, depois para fechado após uma janela de graça destinada às chegadas normais em atraso.

Um período fechado é imutável. Um facto tardio não modifica silenciosamente os totais: produz uma revisão ou uma regularização visível num período ainda aberto. Esta regra protege a estabilidade dos relatórios e torna as correções explicáveis.

O metering distingue também o volume do cliente do custo do fornecedor. Para o RITA, por exemplo, o número de pedidos ou o volume funcional consumido não se confunde com os tokens técnicos faturados por um modelo de IA. Os dois podem ser observados, mas respondem a questões diferentes e nunca são substituídos um pelo outro.

05Residência e disponibilidade #sec_591c95b7

A medida é agregada na célula regional antes de sair da região. Apenas os contadores necessários ao pilotagem são transmitidos; nenhum detalhe documental ou decisão de revisão acompanha o fluxo.

O armazenamento local permite absorver uma indisponibilidade temporária do plano de controlo. Os contadores esperam, depois recomeçam na retomada. Indicadores monitorizam a idade do lote mais antigo, a profundidade da fila, os períodos que não conseguem fechar e a atividade regional que se tornou anormalmente silenciosa.

O relatório de atividade da região usa o mesmo canal, mas a sua ausência nunca constitui uma autorização automática para cortar o serviço. Mais uma vez, uma observação em falta desencadeia uma investigação, não uma decisão de negócio.

06Em resumo #sec_434f4b3f

O metering fornece uma visão durável, mínima e explicável da utilização. Mede o mais próximo possível da fonte, consolida contadores sem dados pessoais, suporta a repetição sem dupla contagem e mantém uma regra absoluta: uma falha de medição nunca deve se tornar uma falha de REVIEWIT.