A tela Tuning ajuda a dimensionar o servidor para a memória e a CPU disponíveis. Ela mostra o orçamento de RAM, o uso real do PHP-FPM e sugere valores para Apache, OPcache e cada pool. Acesse em Runtime & Performance → Tuning.
No topo aparecem a quantidade de núcleos de CPU e a RAM do servidor.
Os dados ao vivo da tela se atualizam a cada 15 segundos, e só enquanto a aba do navegador estiver visível. Com a aba oculta, a atualização pausa e volta sozinha ao reabrir.
Orçamento de RAM
A barra Orcamento de RAM mostra o pior caso: todos os pools lotados ao mesmo tempo.
| Fatia | Como é calculada |
|---|---|
| Sistema | 15% da RAM, reservados ao sistema |
| Apache | Workers × 15MB (só quando o Apache está em uso) |
| PHP Pools | max_children × memória real de cada worker |
| OPcache | Memória compartilhada de cada versão de PHP |
| Livre | O que sobra |
O percentual comprometido passar de 100% não é, sozinho, um problema quando os pools usam ondemand: dificilmente todos lotam juntos. Por isso o painel também mede o uso real.
Uso real do PHP-FPM
O painel mede a cada 10 segundos quantos workers estão ativos e guarda os últimos 7 dias. Com pelo menos 24 horas de amostras, o bloco Uso real do PHP-FPM mostra:
- Simultaneos no servidor: workers ativos ao mesmo tempo em todas as contas (p99, p95 e máximo) e o horário do pico.
- Memoria no pico real: quanto o PHP usou no pico, comparado à memória disponível para PHP.
- CPU no pico real: workers ativos comparados à capacidade útil (núcleos × 2). Acima de 100% o gargalo é CPU.
Até completar 24 horas, a sugestão usa os valores do perfil. Para pegar picos de campanha e fim de semana, o ideal é esperar 7 dias.
Os avisos no topo da página apontam riscos, por exemplo:
- Memória no pico acima de 90% da capacidade: risco de falta de memória (OOM).
- Pior caso acima de 2 vezes a capacidade: reduza o
max_childrendos pools mais pesados. - Mais workers ativos do que núcleos × 2: o gargalo é CPU. Aumentar
max_childrensó aumenta a fila.
Perfis de carga
Cada usuário tem um perfil de carga. Ele define os valores que o painel usa ao criar o pool e o que o Tuning sugere depois.
| Perfil | Uso típico | max_children |
memory_limit |
Tempo limite |
|---|---|---|---|---|
| Light | WordPress, sites estáticos | 5 | 256M | 120s |
| Medium | Laravel, APIs | 8 | 384M | 300s |
| Heavy | Magento, ERP | 20 | 768M | 600s |
Todos usam pm = ondemand por padrão. Sites Magento usam sempre o perfil Heavy.
Para mudar os valores de cada perfil, ou o perfil padrão de um site novo, use Configuracoes → Templates, bloco Parametros dos Perfis de Carga. Os pools que já existem não mudam; para reaplicar, use o Tuning.
Ajustar um pool PHP-FPM
Cada usuário tem um cartão em PHP-FPM Pools (por usuario), com o uso ao vivo (workers, memória total e por worker), quantas vezes o limite foi atingido em 24h e as estatísticas de 7 dias. A contagem de "limite atingido" é feita pool a pool, sem misturar contas de nomes parecidos (por exemplo, joao e joao2).
- Se preciso, troque o perfil no seletor do cartão. A troca muda a sugestão; não altera o pool sozinha.
- Clique em Aplicar Sugestao para preencher os campos com os valores sugeridos (marcados como sug: em cada campo).
- Revise os campos e clique em Salvar e Recarregar PHP X.Y-FPM.
| Campo | O que controla |
|---|---|
pm |
ondemand (cria worker quando chega requisição), dynamic (mantém uma reserva) ou static (número fixo) |
pm.max_children |
Teto de workers do pool |
pm.start_servers, pm.min_spare_servers, pm.max_spare_servers |
Reserva de workers nos modos dynamic |
pm.max_requests |
Requisições antes de reciclar o worker |
process_idle_timeout |
Quanto tempo um worker ocioso sobrevive no ondemand |
request_terminate_timeout |
Encerra a requisição depois desse tempo |
memory_limit |
Limite de memória por requisição |
Com dados suficientes, a sugestão de max_children usa o pico real da conta (p99 × 1,5). A base do cálculo aparece abaixo do campo.
Ao salvar, o painel altera no pool só as diretivas do tuning (pm.*, request_terminate_timeout e memory_limit). O slowlog, as opções PHP da conta (como short_open_tag) e as edições manuais feitas no pool são preservados.
O painel testa a configuração antes de recarregar. Se o teste falhar, o pool anterior é mantido.
Para ver os workers em tempo real e ativar o slowlog, clique em Inspecionar. Veja Inspetor PHP-FPM e slowlog.
OPcache por versão de PHP
O OPcache é um bloco único por versão de PHP, dividido entre todos os pools. O cartão de cada versão mostra os sites atendidos e a estimativa de memória e arquivos necessários. A sugestão total é limitada a 20% da RAM, dividida entre as versões ativas.
FPM (serve os sites):
| Campo | Observação |
|---|---|
memory_consumption |
Bloco total compartilhado pelos pools |
max_accelerated_files |
O PHP arredonda para o primo seguinte |
interned_strings_buffer |
Strings repetidas entre os sites |
validate_timestamps |
Desligado rende mais, mas cada deploy exige recarregar o FPM |
revalidate_freq |
Ignorado com validate_timestamps desligado |
CLI (cron, consumers, deploy): aqui o custo é por processo. O cartão mostra quantos processos CLI estão vivos e quanto isso compromete. Por isso o valor do CLI fica separado e menor.
Clique em Aplicar Sugestao e depois em Salvar e Recarregar PHP X.Y-FPM. O cache esvazia no reload e se reconstrói nas primeiras requisições.
Dica: os valores com que uma versão nova de PHP entra no ar ficam em Configuracoes → Templates, bloco OPcache — defaults de instalacao.
Apache MPM Event
Aparece quando o Apache está em uso. Campos: StartServers, MinSpareThreads, MaxSpareThreads, ThreadsPerChild, MaxRequestWorkers, ServerLimit e MaxConnectionsPerChild.
- Clique em Aplicar Sugestao.
- Revise e clique em Salvar e Recarregar Apache.
O painel testa a configuração do Apache antes de recarregar. Se o teste falhar, o arquivo anterior volta exatamente como estava e o Apache não é recarregado.
No modo NGINX Only este bloco não aparece. Os ajustes do NGINX ficam em Configuracoes → Tuning.