Pular para o conteúdo

Medir uso sem cobrar duas vezes: a medição do Compute por dentro

Equipe AIUBYEngenharia de plataforma

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:

  1. 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.

  2. 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.

  3. 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

O corte acontece na passada de medição. Com o intervalo de 10 minutos e o atraso de 5, a aplicação pode consumir cerca de 15 minutos de uso além do saldo ou do teto antes de ser parada.
  • 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.