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
- Vá em Runtime & Performance → Tuning.
- Em PHP-FPM Pools (por usuario), localize o cartão do usuário.
- 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
dynamicestatic, os workers ficam reservados mesmo sem acesso, ocupando memória. A tela avisa quando é o caso. Para liberar memória em baixa demanda, usepm = ondemandno Tuning ou reduzamax_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.
- Clique em Ativar slowlog (>5s). O selo muda para ATIVO.
- Aguarde a lentidão acontecer de novo.
- Acompanhe o conteúdo no quadro da própria tela. Ele se atualiza a cada 5 segundos.
- 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_childrenno 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.