kisenon

Uso e cobrança

O que a Kisenon mede, a franquia gratuita e como o console a exibe.

A Kisenon mede o que você realmente usa e consolida por organização. Hoje o console mostra o seu uso; ele ainda não cobra por ele — veja Status do alpha abaixo.

O que medimos

O control plane amostra três dimensões por projeto e as agrega por organização:

DimensãoUnidadeComo é medida
ComputeCU-horasRecalculado a cada minuto a partir do runtime do lado do servidor de cada endpoint (Postgres now()), agrupado por hora e ponderado pelo tamanho do compute.
StorageGB-mesesColetado a cada 5 minutos do tamanho por projeto da camada de storage.
Branchesbranch-mesesAmostrado uma vez por dia às 02:00 UTC por projeto.

Compute é a dimensão que se move: um endpoint que suspende em ociosidade para de acumular CU-horas no momento em que para, então um projeto que dorme a maior parte do dia custa uma fração de um que roda a todo vapor. Contagens de storage e branch são estáveis dentro das suas janelas de amostragem, então uma cadência mais grosseira é suficiente.

As amostras se consolidam em uma única visão por organização de uso de compute, storage e branch para o ciclo de cobrança atual — os números que a página de cobrança renderiza.

O tier gratuito

O tier gratuito do alpha é aplicado como um limite de contagem de projetos por organização. Quando o limite está habilitado, uma organização sem método de pagamento cadastrado fica restrita a um número fixo de projetos; uma vez atingido, criar outro projeto retorna free_allowance_exhausted (HTTP 403). Organizações com método de pagamento cadastrado não têm limite. O valor exato do limite é uma configuração de implantação em vez de um número fixo no código, então ele pode ser ajustado conforme o alpha evolui.

À medida que o uso medido de um ciclo sobe, o console mostra um banner crescente acima do conteúdo principal em três limiares — as mesmas porcentagens 80 / 95 / 100 que o control plane registra em seu log de notificações por ciclo:

  • 80% — um aviso amarelo: "Você usou mais de 80% do seu tier gratuito neste período."
  • 95% — um alerta âmbar para adicionar um método de pagamento antes que o serviço seja interrompido.
  • 100% — um estado vermelho de esgotamento: o compute pode ser pausado até que um método de pagamento seja adicionado.

Cada banner é dispensável durante a sessão e leva a Adicionar um método de pagamento.

A página de cobrança da organização

Toda organização tem uma página de cobrança em /orgs/{id}/billing, acessível a partir da navegação da organização. Quando há dados de uso disponíveis, ela renderiza, por dimensão, uma barra usado / franquia (verde abaixo de 80%, âmbar 80–95%, vermelho em/acima de 95%) mais um marcador opcional de fim de período projetado, uma linha de fatura projetada, e o plano e método de pagamento atuais.

Status do alpha

A cobrança ainda não está ativa. Não há método de pagamento para adicionar, nenhuma fatura para pagar, e nenhum fluxo de checkout:

  • As amostras medidas acima são coletadas e armazenadas, e o console as expõe, mas o endpoint de cobrança do control plane (/v1/billing/customer) não está conectado no alpha.
  • Como esse endpoint não retorna nada hoje, o banner de uso sempre renderiza como nada (0% usado) e a página de cobrança degrada para um placeholder "Em breve" em vez de gerar erro.
  • O processamento de pagamentos é apenas estrutura em Stripe Test-Mode. O campo de cliente do Stripe, o gatilho NOTIFY de cobrança, e a rota do portal de owner/cobrança são todos stubs reservados — sem cartões reais, sem faturas reais.

Quando a cobrança chegar, essas superfícies se acendem sem reescrita: o banner e a página de cobrança já leem do mesmo endpoint, então elas começam a mostrar números reais no momento em que ele retorna dados.

Relacionado

  • Organizações — a unidade em que o uso é consolidado.
  • Endpoints — suspender em ociosidade é o que mantém as CU-horas baixas.
  • Status do alpha — o que está e o que não está habilitado ainda.