Medir uso sem cobrar duas vezes: a medição do Compute por dentro
Métricas do Cloud Run + PostgreSQL
A implantação paga em CPU do AIUBY Compute cobra pelo tempo em uso. Para isso funcionar, alguém precisa dizer quanto tempo foi, e esse alguém vai falhar, reiniciar e repetir trabalho. Este texto mostra como a medição foi desenhada para que uma repetição nunca vire cobrança em dobro, e onde ela aceita imprecisão de propósito.
#De onde vem o número
Não medimos dentro do contêiner do cliente e não contamos requisições por conta própria. Lemos duas séries das métricas do próprio Cloud Run, filtradas pelo nome do serviço e pela região:
- Tempo de instância cobrável. É o mesmo número que a nuvem usa para cobrar a AIUBY. Como a aplicação em CPU só tem CPU alocada enquanto atende requisições, ociosa ela não soma tempo.
- Bytes enviados. A saída de rede do serviço no período.
#Atraso e períodos
Métrica de nuvem não chega na hora. Por isso a medição só olha para o que já tem pelo menos 5 minutos. Um temporizador dentro do app roda a cada 10 minutos e, para cada implantação paga com uso ainda não cobrado, faz o seguinte:
Pergunta ao banco de onde continuar
Cada implantação guarda até que instante o uso dela já foi medido. O período novo começa exatamente ali.
Lê as métricas de um período de até 1 hora
Se a medição ficou para trás, ela não tenta cobrar tudo num bloco só: avança em períodos de no máximo 1 hora, até quatro por passada. O resto entra nas passadas seguintes.
Entrega ao banco só o que mediu
Identificador da implantação, início, fim, segundos cobráveis e bytes enviados. Nenhum valor em dinheiro.
É esse caminho que explica o aviso da tela de Cobrança do Compute: o uso entra no extrato com alguns minutos de atraso. Quando a aplicação é parada, a medição espera o mesmo atraso e fecha a conta até a hora da parada.
#Por que repetir não cobra duas vezes
O temporizador pode rodar duas vezes seguidas, o app pode reiniciar no meio de uma passada, uma chamada pode ser reenviada depois de um erro de rede. A defesa está em duas regras do banco:
- O período tem de continuar de onde a medição parou. A função que registra o uso compara o início informado com o instante já medido daquela implantação. Se não for o mesmo, ela recusa com erro. Um período antigo reapresentado não entra; um período com buraco também não.
- Restrição única por implantação e início de período. A tabela do extrato não aceita duas linhas com a mesma implantação e o mesmo início. Mesmo que a primeira regra tivesse um defeito, a segunda linha não seria gravada.
Gravar a linha do extrato, debitar o saldo e avançar o marcador de "medido até" acontecem na mesma transação, com a linha da implantação travada. Ou as três coisas acontecem, ou nenhuma.
O teste automatizado cobre isso de forma direta: mede dois períodos, roda a passada de novo e confere que nada foi cobrado a mais; depois reapresenta ao banco um período já medido e espera a recusa.
#O cálculo fica no banco
A aplicação informa o que mediu. Quem transforma isso em dinheiro é uma função do PostgreSQL, a partir do tamanho gravado na implantação. Ela faz quatro coisas:
- Limita os segundos à duração do período vezes as réplicas da aplicação. Com uma réplica, uma hora de relógio não pode ter mais de uma hora de uso; com três, não mais de três. Um valor absurdo vindo da métrica é cortado antes de virar cobrança.
- Calcula o custo do tempo: segundos vezes o custo por hora do tamanho, arredondado para cima.
- Soma a saída de rede do mês da organização e cobra só a parte que passou da franquia de 10 GiB. O mês é o do horário de Brasília, não o do fuso do servidor.
- Converte para reais pelo preço da conta, a mesma função usada no consumo de IA, sempre arredondando para cima.
O extrato é uma tabela em que a aplicação só lê: as linhas nascem dessa função.
#O corte por saldo e teto
A mesma função que cobra responde se a aplicação precisa parar. Depois de debitar, ela confere o saldo pré-pago da organização e o gasto de Compute do workspace no mês contra o teto. Se o saldo chegou a zero ou o teto foi atingido, devolve o motivo.
O temporizador então apaga o serviço na nuvem e encerra a implantação com esse motivo, registrando o evento na auditoria. A parada usa a mesma trava global das implantações. Se a trava estiver ocupada por alguém implantando, a parada tenta de novo na hora e, se ainda assim não conseguir, a próxima passada resolve.
O uso até a hora da parada ainda é medido e cobrado, uma vez. Depois disso a implantação sai da fila de medição.
#Quando a medição falha
Se a leitura das métricas falha, a passada registra o erro e segue para a próxima aplicação. Nada é cobrado por estimativa. Na passada seguinte o período recomeça do mesmo ponto, e o uso que ficou para trás é cobrado quando as métricas voltarem.
Existe um limite para essa paciência. Se uma aplicação viva fica 6 horas sem medição, ela é parada, com uma mensagem que diz exatamente isso. É um trade-off a favor da conta previsível e contra a disponibilidade, e vale saber dele antes de implantar.
#Limites
Limite
- A saída de rede não tem teto próprio: quem a limita é o saldo e o teto do workspace.
- O saldo considerado no corte não desconta as reservas de chamadas de IA em andamento na mesma conta.
- O temporizador roda dentro do app. Com o app fora do ar, a medição para e recomeça de onde parou quando ele volta. O uso do intervalo é cobrado depois, e o corte atrasa.
- Não publicamos números de validação contra a fatura real: a fatura da nuvem fecha com atraso, e essa comparação ainda não foi feita.
O que isso significa para quem usa, com tamanhos e regras de saldo, está em Implantação paga em CPU no AIUBY Compute. A referência do produto fica em Compute, na documentação.


