# Service Manager do WHM: a caixa que religa o MySQL sozinho

Enabled e Monitored não são a mesma coisa, e confundir as duas é o que deixa o site fora do ar até alguém acordar. Checklist por tipo de servidor, auditoria em lote e como confirmar no dia seguinte.

> No Service Manager do WHM, Enabled apenas faz o serviço subir no boot. Quem religa o MySQL depois de uma queda de madrugada é a caixa Monitored, que coloca o serviço sob o chkservd. Com as duas marcadas, o banco volta sozinho, e a confirmação de que o restart aconteceu sai do /var/log/chkservd.log.

João Rizzon · 2026-10-13 · Servidores

---

## Enabled sobe no boot, Monitored religa depois da queda

No WHM, em **Service Configuration > Service Manager**, cada serviço aparece com duas caixas de seleção. Elas parecem redundantes e não são.

- **Enabled**: o serviço é habilitado no servidor e sobe quando o servidor inicia. Se você desmarca aqui, o cPanel desabilita o serviço.
- **Monitored**: o `chkservd`, o daemon de monitoramento de serviços do cPanel, verifica o serviço periodicamente e tenta reiniciá-lo quando ele não responde.

A documentação oficial do [Service Manager](https://docs.cpanel.net/whm/service-configuration/service-manager/100/) é explícita nessa divisão: marcar apenas *Enabled* dá um serviço que sobe no boot e fica entregue à própria sorte depois disso. É exatamente o cenário de "caiu às 3h40 e ninguém mexeu até as 9h".

O erro clássico em servidor de cliente é alguém desmarcar *Monitored* no MySQL durante uma manutenção (para o chkservd não religar o banco no meio de um restore) e nunca remarcar. O servidor passa semanas bem, até a primeira queda real de madrugada.

### O que o chkservd faz quando o serviço cai

O monitoramento checa o serviço, registra a falha e dispara a ação de restart. A notificação de falha de serviço que chega por e-mail vem desse mesmo caminho. Ou seja: receber o alerta de "Service Failure" e ver o site de pé quando você abre o notebook não é coincidência, é o chkservd tendo feito o trabalho antes de você.

## Quais serviços manter monitorados em cada tipo de servidor

Não existe "marque tudo e seja feliz". Monitorar serviço que você não usa gera alerta ruidoso, e alerta ruidoso é ignorado. O corte que uso como padrão em servidor de agência:

| Serviço (nome na tela) | Site WordPress | Servidor só de e-mail | Observação |
|---|---|---|---||
| `httpd` (Apache) / web server | Enabled + Monitored | Enabled + Monitored | Sem ele não há site nem webmail |
| `mysql` / MariaDB | Enabled + Monitored | Enabled + Monitored se houver webmail com banco local | A queda mais comum em servidor com pouca RAM |
| `exim` | Enabled + Monitored | Enabled + Monitored | Fila de e-mail parada é dano silencioso |
| `dovecot` | Enabled + Monitored | Enabled + Monitored | IMAP/POP do cliente |
| `named` (DNS) | Enabled + Monitored se o servidor é autoritativo | idem | Se o DNS é externo (Cloudflare, registrar), não precisa |
| `ftpd` (Pure-FTPd/ProFTPD) | Enabled + Monitored se a equipe usa FTP | Desabilitado | Se todo mundo usa SFTP, desabilite e reduza superfície |
| `cpsrvd` (WHM/cPanel) | Enabled + Monitored | Enabled + Monitored | É o painel; sem ele você não entra para consertar nada |
| `queueprocd`, `cpanellogd` | Enabled + Monitored | Enabled + Monitored | Tarefas internas e estatísticas |
| `spamd` | conforme uso | Enabled + Monitored | Só se filtro antispam estiver ligado |

Regra prática: **se a ausência do serviço gera chamado de cliente, ele é Monitored**. Se ninguém percebe em 24 horas, ele não precisa de monitoramento, precisa de decisão sobre continuar existindo.

## Como auditar vários servidores sem abrir a mesma tela 30 vezes

Agência com vários servidores não deveria conferir Service Manager no olho. Duas abordagens que escalam.

### Auditar o monitoramento pelo /etc/chkserv.d via SSH

O estado de monitoramento vive em `/etc/chkserv.d/`. Cada serviço tem um arquivo e o `chkservd.conf` guarda a lista do que está ligado. Para inventariar rápido via SSH:

```bash
# o que está marcado como monitorado neste servidor
cat /etc/chkserv.d/chkservd.conf

# estado atual dos serviços como o cPanel enxerga
/scripts/restartsrv_mysql --status
/scripts/restartsrv_httpd --status
/scripts/restartsrv_exim --status
```

Rode isso em cada servidor e compare a saída com o checklist da tabela acima. Diferença encontrada vira tarefa, não vira "depois eu vejo".

### Padronizar com um arquivo de referência da agência

Monte um `chkservd-padrao.txt` com a lista que sua agência considera obrigatória e guarde no repositório de infraestrutura junto com os outros padrões (versão de PHP, política de backup, regra de firewall). Na entrada de um servidor novo, a conferência é um `diff` mental de dois minutos, não uma inspeção caso a caso.

Um detalhe que economiza discussão, e aqui é prática minha, não citação de documentação: eu faço a mudança sempre pela tela do WHM. Editar arquivo na unha funciona, mas quando algo diverge entre o que está no disco e o que a interface mostra, você perde tempo reconciliando os dois. Use SSH para **auditar**, use o Service Manager para **mudar**.

## Três confirmações de que o restart realmente aconteceu

Marcar a caixa e torcer não é processo. No dia seguinte a uma queda, três confirmações independentes:

### Uptime do processo contra uptime do servidor

Se o MySQL reiniciou às 3h40, o processo é mais novo que o servidor. Isso aparece sozinho:

```bash
# há quanto tempo o servidor está de pé
uptime

# desde quando o processo do mysql está rodando
ps -eo pid,lstart,etime,comm | grep -i mysqld
```

Servidor com dias de uptime e processo de banco com poucas horas é a assinatura de um restart automático. Se os dois batem, não houve queda (ou houve reboot inteiro, o que é outro problema).

### A falha e o restart registrados no chkservd.log

O registro do monitoramento fica em `/var/log/chkservd.log`. É ali que a falha e a tentativa de restart aparecem com horário:

```bash
grep -i mysql /var/log/chkservd.log | tail -40
```

Complemente com o log do próprio serviço (`/var/log/mysqld.log` ou o errorlog configurado) para entender **por que** caiu. Restart automático resolve o sintoma, não a causa. OOM killer derrubando o `mysqld` por falta de memória vai se repetir toda madrugada enquanto a causa continuar lá, e o chkservd vai religar todas as vezes, mascarando o problema até o dia em que não religa.

### Service Status no WHM, a conferência de 10 segundos

Em **Server Status > Service Status**, você vê o estado atual de cada serviço na visão do cPanel. É a conferência de 10 segundos, boa para antes de responder ao cliente. Se a tela mostra tudo verde e o log mostra a falha de madrugada, a recuperação funcionou.

## Derrubar o serviço de propósito para medir a volta

Não descubra em produção, às 3h, se o monitoramento está ativo. Em janela combinada, derrube o serviço de propósito e cronometre a volta:

```bash
# pare o serviço pelo caminho do cPanel
/scripts/restartsrv_mysql --stop

# acompanhe o log do monitoramento
tail -f /var/log/chkservd.log
```

O que você está validando: o chkservd percebe a ausência, tenta o restart e o serviço volta. O intervalo entre a queda e a volta depende da periodicidade da checagem configurada no servidor, então meça o seu em vez de assumir um número. Anote o valor observado nesse servidor e guarde na ficha do cliente. Ele é a referência do ciclo de checagem naquele servidor, não um SLA: serve para dimensionar expectativa de recuperação em falha simples de processo, quando o serviço consegue subir de novo. Se a causa impede o serviço de iniciar (disco cheio, configuração quebrada, tabela corrompida), o restart entra em loop e esse número não vale nada. Trate uma medição como amostra de um cenário, e repita o teste depois de mudanças grandes no servidor.

Se o serviço **não** voltar, a ordem de investigação é: *Monitored* está marcado, o `chkservd` está rodando, e o serviço consegue subir manualmente (`/scripts/restartsrv_mysql`). Se ele não sobe nem manual, o problema é configuração ou disco cheio, e nenhum monitoramento conserta isso.

## O que o monitoramento não resolve

Seja honesto com o cliente sobre o escopo. O Service Manager cuida de **processo que morreu**. Ele não cuida de:

- **Serviço vivo e inútil**: MySQL de pé recusando conexão por `max_connections` estourado, Apache respondendo 503 porque o PHP-FPM está saturado. O processo existe, o monitoramento considera tudo certo.
- **Causa recorrente**: falta de RAM, tabela corrompida, cron pesado às 3h. O restart automático compra tempo, não resolve.
- **Disco cheio**: serviço cai, chkservd tenta subir, não consegue, cai de novo. Loop. Por isso o log vale mais que a tela verde.
- **Problema de rede ou de DNS externo**: nada disso passa pelo chkservd.

Ou seja: deixar tudo monitorado é a linha de base. Causa raiz continua sendo trabalho humano, e é por isso que ler o log do serviço no dia seguinte não é opcional.

## A frase pronta para o cliente

Quando o cliente perguntar por que o site "deu uma travada de madrugada" e já estava normal pela manhã, use algo nessa linha, adaptando o serviço:

> **** O banco de dados do site parou por volta das 3h40. O servidor tem monitoramento ativo de serviços: ele detectou a parada e reiniciou o banco automaticamente, sem intervenção manual, por isso o site voltou antes de qualquer chamado. Estamos analisando o registro do servidor para identificar a causa e evitar que se repita. Se houver impacto em pedidos ou formulários nesse intervalo, nós verificamos e avisamos.

Três coisas acontecem com essa frase: o cliente entende que existe uma camada automática funcionando, você não promete que o problema nunca mais ocorre, e você já sinaliza a investigação de causa, que é o trabalho pelo qual você cobra.

## Checklist de entrada em servidor de cliente

- Abra **Service Configuration > Service Manager** e confira *Enabled* e *Monitored* contra a tabela padrão da agência.
- Desabilite o que não é usado (FTP, se todos usam SFTP; `named`, se o DNS é externo).
- Confirme que o endereço de notificação do WHM é um e-mail que alguém lê, não o `root@` do servidor.
- Faça um teste controlado de queda e volta em um serviço não crítico, com janela combinada.
- Registre na ficha do cliente: lista de serviços monitorados, tempo de recuperação observado no teste e data da conferência.
- Repita a conferência depois de qualquer migração, upgrade de cPanel ou manutenção em que alguém tenha desmarcado algo "só por enquanto".

O item da reconferência depois de migração, upgrade ou manutenção é o que mais evita madrugada perdida. Manutenção que desmarca *Monitored* é legítima; manutenção que esquece de remarcar é a origem da maior parte dessas noites.

*Referência de parâmetros e comportamento das opções: documentação oficial do cPanel, [Service Manager](https://docs.cpanel.net/whm/service-configuration/service-manager/100/), consultada em 07/10/2026. Horários e nomes de cliente citados aqui são exemplos ilustrativos.*

