Limitar CPU e memória por conta no WHM: os 7 tetos do LVE
Como aplicar teto de CPU, memória, processos e IOPS por usuário no WHM e via lvectl, lendo os faults por conta para separar quem precisa de limite maior de quem precisa corrigir o código.

Resposta curta: com CloudLinux/LVE no WHM você aplica 7 tetos por conta: CPU (SPEED), memória física (PMEM), memória virtual (VMEM), processos (NPROC), entry processes (EP), throughput de disco (IO) e IOPS. Via CLI é lvectl set por UID, lvectl delete para reverter.
Neste artigo
- Os 7 limites do LVE e o que cada um corta quando estoura
- Faults de SPEED são capacidade, faults de PMEM são código
- Definir o limite padrão do servidor e por pacote no WHM
- Dar teto maior a uma conta sem afrouxar o servidor inteiro
- Dump SQL e ImageMagick estouram memória e disco, não CPU
- Como verificar o efeito e desfazer cada alteração
- Quatro problemas que parecem falta de CPU e não são
Servidor multi-conta sem teto por usuário não quebra devagar: quebra inteiro. Um mysqldump restaurado por um cliente, um plugin que dispara 40 workers de ImageMagick, um crawler que abre 300 conexões PHP-FPM, e o load médio do nó sobe para todo mundo. O CloudLinux resolve isso com LVE (Lightweight Virtual Environment), um contêiner por UID construído sobre cgroups, que aplica limite de CPU, memória física, memória virtual, número de processos, entry processes, throughput de disco e IOPS para cada conta separadamente.
O que vem abaixo é procedimento, apoiado na documentação oficial do CloudLinux Manager no WHM. Todos os valores numéricos citados são exemplo, não recomendação medida: a Napoleon não executou benchmark para este artigo, e o número certo para o seu nó depende de core count, perfil de disco e densidade de contas.
Os comandos abaixo foram conferidos em CloudLinux OS 8 (lve-utils 4.x). Valem em linhas gerais para CL7 e CL9, mas o conjunto de subcomandos muda entre builds: antes de automatizar, rode lvectl --help e lveinfo --help no seu servidor. lvectl, lveinfo, lvetop e cloudlinux-config exigem root (ou sudo); com usuário comum o retorno é erro de permissão, não limite vazio. O risco concreto está em lvectl set-default seguido de lvectl apply all: isso reescreve o limite de todas as contas sem exceção individual, imediatamente, e um PMEM default abaixo do pico atual das contas vira erro 500 no minuto seguinte.
Os 7 limites do LVE e o que cada um corta quando estoura
O vocabulário importa porque a reação do kernel é diferente em cada caso. Estourar SPEED gera throttling (o processo continua, mais devagar). Estourar PMEM gera falha de alocação (o processo morre, e o usuário vê 500 ou 503). Confundir os dois leva a aumentar CPU quando o problema era memória.
| Limite | O que controla | Comportamento ao estourar | Unidade típica |
|---|---|---|---|
| SPEED | Fatia de CPU da conta | Throttling: processos ficam lentos | % de um core (100% = 1 core) ou MHz |
| PMEM | Memória física (RSS) do conjunto de processos | Alocação negada, processo encerrado | MB/GB |
| VMEM | Memória virtual reservada | Alocação negada | MB/GB |
| NPROC | Total de processos e threads do UID | fork falha |
contagem |
| EP | Entry processes (entradas simultâneas, ex.: requisições PHP) | Requisição recusada, tipicamente 508 | contagem |
| IO | Throughput de leitura e escrita | Throttling de I/O | KB/s |
| IOPS | Operações de I/O por segundo | Throttling de I/O | ops/s |
Duas armadilhas de interpretação. EP não é NPROC: um site pode ter 5 entry processes e 60 processos filhos, ou o contrário. E VMEM alto não significa consumo real: a JVM, o PHP com OPcache e alocadores modernos reservam endereçamento muito acima do RSS. A prática que adotamos na operação é controlar por PMEM e deixar VMEM generoso ou desligado, porque limitar VMEM derruba processo que não estava consumindo memória de verdade. Isso é critério nosso, não está na página do CloudLinux Manager citada aqui.
Faults de SPEED são capacidade, faults de PMEM são código
Alterar limite sem olhar o histórico de faults é chutar. O LVE conta cada vez que uma conta bate em cada limite, e são contadores separados por tipo: CPU, PMEM, VMEM, NPROC, EP, IO, IOPS. É essa separação que permite distinguir dois casos que parecem iguais no ticket do cliente.
- Conta com faults só de SPEED, todos os dias, distribuídos ao longo do dia: workload legítimo que não cabe no plano. Teto maior resolve.
- Conta com faults de PMEM ou NPROC concentrados em picos curtos: quase sempre é código. Um loop que carrega a tabela inteira na memória, um cron que roda sobreposto consigo mesmo, um
convertsem-limit. Aumentar o teto só adia o estouro e empurra a conta para o próximo limite.
No WHM, o CloudLinux Manager mostra as estatísticas por conta na interface. Na CLI, o lveinfo é a ferramenta de relatório:
# Visão do período (confirme as opções do seu build com --help)
lveinfo --period=today
# Histórico de uma conta específica
lveinfo --period=7d --user=exemplo
# Estado instantâneo dos LVEs ativos
lvetop
Ao cruzar faults por conta, você está respondendo a pergunta que interessa: quem bate no teto todo dia e quem bateu uma vez numa terça-feira. A primeira lista é de capacidade; a segunda é de incidente, e pede investigação do processo, não limite novo.
Definir o limite padrão do servidor e por pacote no WHM
O padrão (default) é o que vale para toda conta sem limite individual, e é o número que determina a densidade do nó. Caminho no WHM: Server Configuration → CloudLinux Manager, aba de configuração de limites. Ali você define SPEED, PMEM, VMEM, EP, NPROC, IO e IOPS do pacote padrão e também por pacote do cPanel, que é a forma correta de materializar planos diferentes sem editar conta a conta.
Equivalente em CLI:
# Mostrar os limites atuais (default e por UID)
lvectl list
# Alterar o default (valores de EXEMPLO)
lvectl set-default --speed=100% --pmem=1G --nproc=100 --ep=20 --io=1024 --iops=1024
# Aplicar os limites a todos os LVEs
lvectl apply all
Regra de operação: mude o default em janela de manutenção e com os faults do dia anterior em mãos. Reduzir PMEM default num servidor cheio converte, na hora seguinte, sites que funcionavam em erro 500. Se precisa apertar, aperte SPEED e IO primeiro (que degradam) antes de PMEM e NPROC (que matam).
Dar teto maior a uma conta sem afrouxar o servidor inteiro
O ponto todo do LVE é que a exceção é cirúrgica. Um cliente com loja grande recebe teto maior; os outros 200 continuam no default.
# Descobrir o UID da conta
id -u exemplo
# Ver os limites efetivos daquele UID (por nome de usuário)
lvectl list-user exemplo
# Aplicar limite individual (valores de EXEMPLO)
lvectl set 1042 --speed=200% --pmem=2G --nproc=150 --ep=30
# Remover o limite individual e voltar a conta ao default
lvectl delete 1042
O lvectl delete não apaga a conta: remove a exceção. É o comando de reversão, e vale anotá-lo no mesmo ticket em que você criou a exceção, junto com a data de expiração pretendida. Exceção sem data de validade vira default silencioso.
Para parâmetros globais de comportamento do CloudLinux (incluindo modos de aplicação de limites e integrações), a ferramenta é o cloudlinux-config:
cloudlinux-config get
Leia antes de escrever. Alguns parâmetros desse conjunto mudam o comportamento de todas as contas de uma vez, que é exatamente o que você está tentando evitar.
Dump SQL e ImageMagick estouram memória e disco, não CPU
Esses dois trabalhos têm uma assinatura específica: pico curto de memória física e de I/O, com CPU comportada.
Um mysql < dump.sql passa a maior parte do tempo esperando disco e commit, não calculando. O que estoura é IOPS e, dependendo do cliente de importação, PMEM. Um convert de ImageMagick gerando miniatura carrega o raster descomprimido na memória: um JPEG de 8 MB vira centenas de MB de RSS. Em lote, com vários convert paralelos, estoura PMEM e NPROC antes de chegar perto do teto de CPU.
Tratamento correto, em ordem de preferência:
- Corrigir na origem.
convertaceita-limit memorye-limit map, e opolicy.xmldo ImageMagick permite teto global de recurso. Dump grande entra melhor por pipe, sem cliente que carregue o arquivo inteiro em memória, e comSET unique_checks=0;eSET foreign_key_checks=0;no início do arquivo (restaurando para 1 no fim): menos verificação por linha significa menos escrita aleatória, que é onde o IOPS estoura. Commit em lotes em vez de uma transação única evita que o cliente e o servidor acumulem RSS durante horas. Se o erro for de pacote grande, ajuste--max_allowed_packetna sessão em vez de subir PMEM da conta. Isso não consome teto nenhum do servidor. - Exceção temporária de PMEM e IO/IOPS para o UID, pelo tempo da janela, com o SPEED inalterado. É a tradução correta da assinatura do workload.
- Mexer no default. Última opção, e só se o padrão estiver errado para todo mundo, não para um caso.
Uma exceção temporária, com valores de exemplo, ficaria assim:
# Janela de importação: só memória e disco, CPU não muda
lvectl set 1042 --pmem=4G --io=4096 --iops=4096
lvectl list-user exemplo # conferir que foi aplicado
# ... executa a importação ...
# Reversão ao default do pacote
lvectl delete 1042
lvectl list-user exemplo # conferir que voltou
Como verificar o efeito e desfazer cada alteração
Toda alteração precisa de três coisas registradas: o comando aplicado, a leitura que comprova o efeito e o comando que desfaz.
| Mudança | Verificação | Reversão |
|---|---|---|
| Limite individual por UID | lvectl list-user <usuario> (ou lvectl list, que mostra default e UIDs com exceção) |
lvectl delete <uid> |
| Default do servidor | lvectl list |
lvectl set-default com os valores anteriores |
| Efeito real sobre a conta | lveinfo --period=today --user=<conta> e lvetop |
aplicar a reversão acima |
Depois da janela, volte ao relatório de faults. Se o tipo de fault mudou (PMEM caiu e NPROC subiu), o gargalo apenas se deslocou: o código continua errado e o teto novo só comprou tempo. Se os faults sumiram e o tempo de resposta do site caiu, a exceção era legítima e provavelmente o pacote do cliente é que está subdimensionado.
Quatro problemas que parecem falta de CPU e não são
Vale dizer contra o interesse de quem vende capacidade: boa parte dos estouros de LVE que chegam como "preciso de mais CPU" se resolve sem tocar em limite nenhum.
- Consulta sem índice gera leitura de tabela inteira. Isso aparece como fault de IO e IOPS, não de CPU. O log de consulta lenta resolve, e o teto volta a sobrar.
- Cron sobreposto consigo mesmo multiplica NPROC linearmente. Um lock de arquivo no script custa uma linha.
- Bot que ignora
robots.txtenche os entry processes. Bloqueio por user agent ou rate limit no servidor web corta o fault de EP sem nenhum ganho de recurso. - Cache desligado em CMS transforma cada visita em execução de PHP completa. É o maior multiplicador de SPEED que existe num servidor compartilhado.
O LVE é a rede de proteção que impede uma conta de derrubar o nó. Ele não conserta aplicação mal escrita, e não deveria. O relatório de faults é a ferramenta de diagnóstico; o teto é a consequência da decisão, não a decisão.
Referência de interface, caminhos no WHM e escopo das funções: CloudLinux Manager, documentação cPanel (consultado em 08/10/2026). As opções exatas de cada binário variam por versão do CloudLinux: confirme com lvectl --help e lveinfo --help no seu servidor antes de automatizar qualquer coisa.
Referências
- Documentação oficial (cpanel) — CloudLinux Manager. Consultado em 2026-10-08.