Nesta página

Excedente (overage)

O excedente permite que seus serviços continuem funcionando mesmo depois de atingir os limites do plano. Quando habilitado, o uso extra é cobrado por unidade consumida, como itens adicionais na fatura.

O que é o excedente

Cada plano do Guara Cloud tem limites para CPU, RAM, armazenamento e minutos de build. Se você precisa de mais recursos do que o seu plano oferece sem fazer upgrade, o excedente permite ultrapassar esses limites.

O excedente é opcional e nunca é ativado automaticamente (exceto no Enterprise). Você decide quando habilitar.

Disponibilidade por plano

PlanoExcedente
TesteNão disponível
StarterOpcional
ProOpcional
MaxOpcional
BusinessOpcional
EnterpriseIncluso por padrão

Como habilitar

O excedente é habilitado na assinatura, então a configuração vale para todos os projetos da conta:

  1. Acesse Configurações no dashboard.
  2. Abra a aba Conta.
  3. Em Uso Excedente, clique em Ativar Uso Excedente e confirme.

No plano Enterprise, o excedente já vem habilitado e não pode ser desativado. Durante o teste grátis, a opção não está disponível; ela é liberada assim que você escolhe um plano pago.

Ao desativar o excedente, os recursos que estiverem acima dos limites do plano são ajustados automaticamente ao final do ciclo.

Teto de gasto

Com o excedente ativo, você pode definir um teto de gasto: o valor máximo, em reais, que o excedente pode custar por ciclo de cobrança. O teto é opcional e pode ser alterado ou removido a qualquer momento em Configurações > Conta > Uso Excedente.

  • Acompanhamento: a mesma tela mostra quanto excedente o ciclo já acumulou em relação ao teto.
  • Avisos: você recebe um aviso por e-mail e no painel ao chegar em 80% do teto e outro ao atingi-lo, uma vez por ciclo.
  • Ao atingir o teto: a cobrança de excedente do ciclo para no valor do teto — você nunca paga mais do que ele. Novos builds além dos minutos incluídos no plano ficam pausados até o próximo ciclo ou até você aumentar o teto. Seus serviços continuam rodando normalmente.
  • Novo ciclo: o acumulado volta a zero no início de cada ciclo de cobrança.

Se você reduzir o teto para um valor abaixo do que o ciclo já acumulou, ele passa a valer na hora: nada mais é cobrado no ciclo e os builds além da franquia ficam pausados. O excedente que já tinha sido contabilizado antes da mudança continua na fatura.

Tarifas de excedente

O excedente é cobrado ao final do ciclo de cobrança, com base no uso medido. As mesmas tarifas aparecem no dashboard, em Uso Excedente:

RecursoPreço
vCPU além do pool R$ 4/vCPU-hora
RAM além do pool R$ 2/GiB-hora
Minutos de build além da cota R$ 0,03/minuto
Armazenamento além do total do projeto R$ 2,50/GiB-mês

Como o cálculo funciona

  • CPU e RAM são medidas em horas: vCPU-hora e GiB-hora. O plano inclui o pool da conta durante o ciclo inteiro (o pool multiplicado por 730 horas). Só as horas acima disso são cobradas, então você paga apenas pelo tempo em que realmente usou recursos extras.
  • Minutos de build acima da cota mensal são cobrados por minuto.
  • Armazenamento acima do incluído no plano é cobrado por GiB-mês.

Exemplo: se você usa 0,5 vCPU além do pool do seu plano durante 12 dias, são 144 vCPU-horas extras (0,5 × 12 dias × 24 horas). A R$ 4/vCPU-hora, o excedente de CPU fica em R$ 576.

Limites de segurança

O excedente ainda respeita o pool de recursos da conta, as quotas do namespace e os limites de segurança da plataforma para o seu plano. Ele dá margem de uso além da franquia incluída em planos pagos self-service, mas não ignora a admissão do Kubernetes nem os guardrails de confiabilidade da plataforma.

Quando um limite de segurança é atingido, o comportamento é o mesmo de quando você atinge o limite do plano sem excedente — seus serviços continuam rodando, mas novos recursos não podem ser alocados. Para ir além desses limites, você precisa fazer upgrade de plano.

Banda e excedente

Banda é ilimitada em todos os planos (uso justo) e não faz parte do excedente. Você nunca é cobrado por tráfego de rede.