- Documentação
- Cobrança
- Excedente (overage)
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
| Plano | Excedente |
|---|---|
| Teste | Não disponível |
| Starter | Opcional |
| Pro | Opcional |
| Max | Opcional |
| Business | Opcional |
| Enterprise | Incluso por padrão |
Como habilitar
O excedente é habilitado na assinatura, então a configuração vale para todos os projetos da conta:
- Acesse Configurações no dashboard.
- Abra a aba Conta.
- 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:
| Recurso | Preç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.