Limites e quotas
Esta página centraliza limites operacionais conhecidos da Zenifra. Alguns limites dependem do plano, da organização, do tipo de projeto ou de condições comerciais vigentes no console.
API da Zenifra
| Recurso | Limite atual |
|---|---|
| Rate limit | Definido por rota e contado por endereço IP de origem; consultas aceitam mais chamadas por minuto que operações de escrita |
| Erro ao exceder limite | 429 Too Many Requests |
| Autenticação | API Key da organização em x-api-key ou Authorization: Bearer; veja API Zenifra |
Para automações com volume maior, entre em contato com o suporte antes de aumentar a frequência das chamadas.
Variáveis de ambiente
| Recurso | Limite atual |
|---|---|
| Variáveis por projeto via API | 50 |
| Tamanho máximo do nome | 120 caracteres |
| Tamanho máximo do valor | 32760 caracteres |
Use variáveis apenas para configuração e segredos. Arquivos grandes, certificados extensos ou listas volumosas devem ser tratados por outro mecanismo de configuração da aplicação.
Projetos HTTP
| Recurso | Limite ou regra |
|---|---|
| Instâncias HTTP | sem número fixo por projeto; cada aumento depende da capacidade disponível do plano. No plano Free, a organização pode somar no máximo 2 instâncias |
| Auto-scaling HTTP | disponível para projetos HTTP em planos com a feature habilitada |
| Porta | configurada manualmente no projeto |
| URL padrão | *.clients.zenifra.com |
| Capacidades | métricas, healthcheck, auto-scaling, subdomínio personalizado e acesso de rede dependem do plano retornado |
| Logs | em todos os planos; lidos ao vivo das instâncias, até cerca de 50 KB por consulta, sem histórico retido |
| Métricas HTTP | CPU, RAM, storage e requisições HTTP a partir do plano Premium |
| Armazenamento persistente | de 1 GB a 250 GB, cobrado à parte; pode aumentar, mas não diminuir |
| Domínios personalizados | até 20 por projeto, somente em projetos HTTP públicos |
| Acesso por IP | whitelist de 1 a 10 e blacklist de até 10 endereços IPv4 ou faixas CIDR, a partir do plano Premium Plus |
| Ambientes de preview | até 10 ativos por organização e 2 por projeto; TTL de 1 a 168 horas (padrão 24 horas); sempre 1 instância, sem auto-scaling |
Para picos de tráfego previstos ou necessidades específicas de capacidade, fale com o suporte antes de dimensionar a aplicação.
Antes da criação, consulte zenifra plans --type http. A saída legível descreve as capacidades disponíveis; zenifra plans --type http --json expõe o objeto booleano capabilities para scripts. O plano retornado, e não um exemplo de documentação, define a disponibilidade efetiva.
Deploy e imagem
| Recurso | Regra |
|---|---|
| Origem Git (GitHub ou Forgejo) | repositório, branch, runtime, versão, comandos e modo de deploy podem ser alterados depois da criação (GitHub: pela API ou CLI) |
| Logs de build | 200 linhas por consulta por padrão, até 500 |
| Histórico de builds | até 30 builds por projeto, por até 30 dias |
| Origem OCI | projeto continua sendo OCI depois da criação |
| Imagem pública | não exige autenticação |
| Imagem privada | pode usar AWS ECR ou usuário e token/senha de registry |
| Tipo de autenticação OCI | não deve ser tratado como editável depois da criação |
Use tags de imagem que identifiquem versão, commit ou release. Evite depender de latest em produção.
Bancos de dados
| Recurso | Limite ou regra |
|---|---|
| PostgreSQL | 1 a 3 instâncias totais |
| MariaDB | 3 instâncias |
| Downgrade de versão | não suportado |
| Storage | pode aumentar, mas não diminuir |
DATABASE_URL | não é injetada automaticamente em projetos HTTP |
| Planos gratuitos | até 2 projetos db-free por organização, somando PostgreSQL e Chave-Valor; Cache e Filas gratuitos limitados a 1 por perfil |
| Backup e restauração | não há backup automático com restauração pelo console; mantenha seus próprios dumps |
| Métricas de banco | CPU, RAM e storage nos planos db-premium e db-enterprise |
Upgrade de versão e aumento de storage podem causar indisponibilidade temporária. Execute essas alterações em janela de baixo uso.
Ao criar um projeto além dos limites gratuitos, o console mostra o aviso Limite do plano Free atingido. Veja o que fazer em cada caso.
Observabilidade
| Recurso | Comportamento atual |
|---|---|
| Logs HTTP | atualização em até 60 segundos |
| Métricas de recurso | atualização em até 5 minutos |
| Visualização | por instância quando aplicável |
| Métricas de requisições HTTP | volume, tráfego de rede, distribuição de status, rotas, user agents e latência P95 quando disponível conforme plano |
| Eventos de requisição HTTP | retidos por até 7 dias |
| Falhas de health check | histórico de 30 dias |
| Eventos de auto-scaling | histórico de cerca de 13 meses |
| Uptime por aplicação | não disponível como capacidade documentada atual |
Consulte Observabilidade para detalhes por tipo de projeto.
Jobs agendados
| Recurso | Regra |
|---|---|
| Agendamento | expressão cron de cinco campos, sempre em UTC |
| Duração máxima | 60 minutos por execução |
| Execuções simultâneas | não há execuções em paralelo do mesmo Job |
| Nova tentativa | não há nova tentativa automática |
| Cobrança | por minuto de execução, arredondado para cima |
| Histórico de execuções | 90 dias |
Veja Jobs agendados.
IA
| Recurso | Regra |
|---|---|
| API | compatível com clientes OpenAI-compatible |
| Chave de IA | criada no console com budget e modelos permitidos |
| Cobrança | pré-paga por tokens, usando o crédito compartilhado da organização |
| Modelos disponíveis | catálogo público GET https://ai.zenifra.com/v1/models ou aba Modelos Disponíveis no console |
| Limite de requisições | padrão de 200 requisições e 500.000 tokens por minuto por organização |
| Limite de custo | crédito da organização, com limite adicional opcional por chave |
Se a organização ficar sem crédito, a chave atingir seu limite adicional ou tentar usar um modelo não permitido, a aplicação deve tratar o erro retornado pela API e orientar o usuário a adicionar crédito ou revisar a chave no console.
O que depende do plano ou suporte
Estes limites podem variar e devem ser confirmados no console ou com o suporte:
- tamanho máximo de imagem OCI
- tempo máximo de build
- timeout de request HTTP
- número máximo de projetos por organização
- número máximo de chaves por recurso
Próximos passos
FAQ
Posso pedir limites maiores?
Sim. Para limites operacionais como instâncias, tráfego, API ou uso empresarial, entre em contato com o suporte antes de depender do aumento em produção.
Esta página substitui o console?
Não. O console continua sendo a fonte para planos, recursos disponíveis e condições comerciais vigentes.
O que acontece se eu exceder rate limit?
A API retorna 429 Too Many Requests. A aplicação deve aplicar backoff, reduzir frequência ou solicitar aumento de limite.
Última atualização em
Checklist antes de ir para produção
Lista prática para revisar deploy, configuração, segurança, banco, observabilidade e cobrança antes de publicar em produção.
Migrar para a Zenifra
Traga aplicações e bancos do Heroku, Render, Railway, Vercel ou de uma VPS para a Zenifra com um roteiro passo a passo, equivalências e migração de dados.