Pular para o conteúdo
Documentação

Tuning: perfis de carga, pools PHP-FPM e OPcache

Como dimensionar os pools PHP-FPM, o OPcache e o Apache pela tela Tuning, usando perfis de carga e o uso real medido.

R Regis Manze 20/11/2026 6 min de leitura

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_children dos pools mais pesados.
  • Mais workers ativos do que núcleos × 2: o gargalo é CPU. Aumentar max_children só 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).

  1. Se preciso, troque o perfil no seletor do cartão. A troca muda a sugestão; não altera o pool sozinha.
  2. Clique em Aplicar Sugestao para preencher os campos com os valores sugeridos (marcados como sug: em cada campo).
  3. 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.

  1. Clique em Aplicar Sugestao.
  2. 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.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!