Pular para o conteúdo
Documentação

Inspetor PHP-FPM e slowlog

Como ver os workers PHP-FPM de uma conta em tempo real e usar o slowlog para achar a linha de código que trava o site.

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

O Inspetor PHP-FPM mostra, em tempo real, os workers do pool de um usuário e o que cada um está fazendo. Use quando um site fica lento, dá erro 504 ou o pool vive lotado.

Como abrir

  1. Vá em Runtime & Performance → Tuning.
  2. Em PHP-FPM Pools (por usuario), localize o cartão do usuário.
  3. Clique em Inspecionar.

O título da tela mostra o usuário e a versão de PHP do pool. O botão Tuning volta para a tela anterior.

Configuração do pool

A primeira faixa resume a configuração atual do pool:

Item Significado
pm Modo do gerenciador de processos (ondemand, dynamic ou static)
max_children Teto de workers
idle_timeout Tempo que um worker ocioso sobrevive (só em ondemand)
start e min/max_spare Reserva de workers (em dynamic)
terminate request_terminate_timeout: tempo máximo de uma requisição

Dica: nos modos dynamic e static, os workers ficam reservados mesmo sem acesso, ocupando memória. A tela avisa quando é o caso. Para liberar memória em baixa demanda, use pm = ondemand no Tuning ou reduza max_spare_servers.

Workers ativos

A tabela lista os workers do pool, ordenados por idade. Ela se atualiza a cada 5 segundos enquanto a chave Auto (5s) estiver ligada e a aba do navegador estiver visível (com a aba oculta, a atualização pausa). Use Atualizar para recarregar na hora.

Só entram os workers do pool deste usuário: pools de nomes parecidos (por exemplo, joao e joao2) não se misturam.

Coluna Significado
PID Número do processo
Idade Há quanto tempo o worker está vivo
CPU% e MEM% Consumo do processo
RSS Memória real usada, em MB
Estado R = rodando, S = dormindo, D = esperando disco ou rede (I/O)
Conexoes Conexões abertas do worker: MySQL, Redis, OpenSearch ou HTTP externo

Como identificar uma requisição travada

Fique atento a workers que somam estes sinais:

  • Idade alta (um minuto ou mais) com o mesmo PID.
  • Estado D, esperando I/O.
  • Uma conexão aberta que não fecha, por exemplo HTTP externo (API de frete, pagamento, ERP) ou MySQL.

Esse quadro costuma indicar que o código está esperando uma resposta lenta de um serviço externo ou de uma consulta pesada no banco.

Se a tabela mostrar Nenhum worker ativo (pool ocioso), o pool está sem requisições no momento.

Slowlog

O slowlog grava a pilha de chamadas PHP de toda requisição que passar de 5 segundos. Ele mostra o arquivo e a função exata em que o código estava parado.

  1. Clique em Ativar slowlog (>5s). O selo muda para ATIVO.
  2. Aguarde a lentidão acontecer de novo.
  3. Acompanhe o conteúdo no quadro da própria tela. Ele se atualiza a cada 5 segundos.
  4. Ao terminar a investigação, clique em Desativar slowlog.

O arquivo fica na pasta de logs do usuário:

/var/log/minicp/users/USUARIO/fpm-slow.log

O cliente lê o mesmo arquivo pelo atalho /home/USUARIO/logs/fpm-slow.log (somente leitura).

Atenção: o slowlog grava uma entrada a cada requisição lenta. Em site muito acessado ele cresce rápido. Desative quando não precisar mais.

Como ler uma entrada

Cada entrada traz a data, o PID do worker e a pilha de chamadas, da função mais interna para a mais externa. A primeira linha da pilha mostra onde o código estava naquele instante. Funções como curl_exec, PDOStatement->execute ou sleep no topo indicam espera por rede, banco de dados ou pausa no código.

Próximos passos

  • Se o pool lota com frequência e há memória livre, aumente pm.max_children no Tuning.
  • Se o problema é uma consulta lenta ou uma API externa, corrija no código da aplicação. Aumentar workers só aumenta a fila.
  • Para ver o histórico de pool lotado, scripts abortados e timeouts, use Eventos de Recurso.
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!