# Aviso de serviço caído no WHM sem queda real: o que ajustar

Como o chkservd decide que um serviço está fora, onde ficam tentativas e intervalo, e como confirmar no log que o alarme falso parou.

> o que eu aplico em produção é exigir 2 ou 3 falhas consecutivas antes de o chkservd notificar, ajustado no grupo Status do Tweak Settings do WHM. Isso filtra o blip de I/O da madrugada sem desligar o monitoramento, e a confirmação sai no /var/log/chkservd.log.

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

---

## O que o chkservd verifica antes de dizer que um serviço caiu

O `chkservd` é o monitor de serviços do cPanel/WHM. Ele não olha se o site abre. Ele roda uma rotina por serviço e decide, a cada ciclo, se aquele serviço passou ou falhou.

Um serviço pode ser verificado por até três caminhos, conforme o que está definido para ele:

- **Checagem de porta**: abre uma conexão TCP na porta do serviço e, em alguns casos, compara a resposta esperada do protocolo (o banner do SMTP, por exemplo).
- **Comando de checagem**: executa um comando e avalia a saída ou o código de retorno.
- **Checagem de processo**: procura o processo na tabela de processos pelo padrão configurado.

Isso importa porque cada caminho falha por motivos diferentes. Um pico de I/O no disco atrasa a resposta do comando. Um backup segurando o MySQL faz o handshake na porta estourar o tempo. Um `logrotate` reiniciando o Exim deixa o processo ausente por alguns segundos. Nos três casos o site do cliente continua respondendo, e mesmo assim o ciclo registra falha.

Quando a falha é registrada, o comportamento depende de duas decisões separadas: **notificar** e **tentar reiniciar**. Quem confunde as duas acaba desligando o monitoramento inteiro para parar um e-mail.

## Por que o alerta chega de madrugada e some sozinho

Madrugada é quando o servidor faz tudo que você agendou para não atrapalhar o dia: backup, otimização de tabela, rotação de log, atualização automática, varredura de antivírus. Todas essas tarefas disputam disco e CPU com os serviços monitorados.

O padrão do aviso falso é reconhecível:

- chega sempre na mesma faixa de horário;
- cita um serviço que depende de disco (MySQL, Exim, Dovecot, cpsrvd);
- vem seguido, minutos depois, de uma notificação de serviço restabelecido;
- nenhum monitor externo de uptime registrou indisponibilidade no mesmo minuto.

Se os quatro itens batem, o problema está na sensibilidade da sonda, não no serviço. Antes de mexer em qualquer parâmetro, confirme com um monitor externo. Se o monitor externo também acusou queda, pare de ler este artigo e vá investigar a causa real.

## Service Manager decide quais serviços, Tweak Settings decide com qual paciência

São duas telas com papéis distintos.

**WHM > Service Configuration > Service Manager** define, por serviço, duas caixas: monitorar e reiniciar quando falhar. É aqui que você decide se um serviço entra na conta. Desmarcar "Monitor" cala o alerta para sempre, inclusive numa queda real. Use só para serviço que você de fato não usa naquele servidor.

**WHM > Server Configuration > Tweak Settings**, grupo **Status**, define o comportamento global do `chkservd`: de quanto em quanto tempo o ciclo roda e quantas falhas consecutivas são necessárias antes de o servidor notificar. Os nomes exatos dos campos variam entre versões do cPanel, então o caminho eficiente é abrir o Tweak Settings e digitar `chkservd` na caixa de busca da própria tela. A descrição oficial de cada opção do grupo Status está em [docs.cpanel.net/whm/server-configuration/tweak-settings/status](https://docs.cpanel.net/whm/server-configuration/tweak-settings/status/); confira os valores válidos lá antes de aplicar, porque é a referência que acompanha a sua versão.

Regra prática: o Service Manager responde "quais serviços", o Tweak Settings responde "com qual paciência".

## Que valores mexer sem cegar o monitoramento

O objetivo não é silenciar. É exigir confirmação antes de acordar alguém.

| Parâmetro | Efeito de subir | Risco se exagerar |
|---|---|---||
| Falhas consecutivas antes de notificar | Exige que o serviço falhe em mais de um ciclo seguido, filtrando o blip de I/O | Queda real demora N ciclos para virar e-mail |
| Intervalo entre ciclos do chkservd | Reduz a chance de a checagem cair exatamente dentro da janela de backup | Detecção mais lenta e menos amostras no log |
| Monitorar (Service Manager) | Nenhum, é liga/desliga | Serviço desmarcado nunca mais gera alerta nem reinício |
| Reiniciar ao falhar (Service Manager) | Recupera sozinho | Reinício em loop mascara causa raiz e pode piorar corrupção de dados |

Como eu encaminho em servidor de produção com serviço estável:

- Subir **falhas consecutivas antes de notificar** para 2 ou 3. Duas falhas seguidas já descartam quase todo blip isolado, e três é o teto que eu considero aceitável sem comprometer resposta a incidente.
- Mexer no **intervalo entre ciclos** só se o passo 1 não resolveu, e com aumento pequeno. Intervalo muito longo atrasa também a recuperação automática.
- Não desmarcar "Monitor" de serviço em uso. Nunca.
- Deixar "reiniciar ao falhar" ligado em MySQL, Exim e Dovecot, e tratar reinício frequente como sintoma a investigar, não como solução.

Antes de aceitar o ajuste como definitivo, vale olhar o óbvio: se o backup está programado para a mesma hora em cinco serviços, mover o agendamento resolve sem tocar no monitoramento.

## Como confirmar que o aviso recorrente parou

Duas fontes, nessa ordem.

### Contar as falhas no /var/log/chkservd.log antes e depois

O log registra cada ciclo e o resultado por serviço. Antes de contar qualquer coisa, abra o arquivo e veja como a falha aparece na sua versão. O formato muda entre releases do cPanel, e uma linha de falha costuma ter esta cara (exemplo ilustrativo, não copiado de um servidor nosso):

```
[2024-01-15 03:12:41 -0300] Service check ....
Service mysql is down
mysql [check command:failed]
```

Se no seu log a palavra for outra (`down`, `is not running`, `[notify]`), troque o termo nos comandos abaixo. Contar `failed` num log que nunca escreve `failed` devolve zero e faz você concluir que o ajuste funcionou quando nada foi medido.

Para isolar o período e o serviço:

```bash
# acompanhar em tempo real
tail -f /var/log/chkservd.log

# ver só as linhas de falha do serviço suspeito
grep -i mysql /var/log/chkservd.log | grep -i failed

# contar quantas vezes o serviço falhou no arquivo atual
grep -ci "mysql.*failed" /var/log/chkservd.log
```

Rode a contagem antes do ajuste e de novo depois de uma semana, no mesmo arquivo ou na mesma janela de rotação, usando o mesmo termo de busca nas duas vezes. Se o número caiu e o monitor externo continua sem registrar indisponibilidade, o ajuste funcionou. Se o número não caiu mas os e-mails pararam, o serviço continua falhando e você só adiou o aviso: investigue a causa.

### Service Status para a checagem rápida do dia seguinte

A tela **Service Status** mostra o estado corrente de cada serviço monitorado. Serve para a checagem rápida no dia seguinte ao ajuste: todos verdes, nenhum serviço fora da lista de monitorados por engano. É também a prova visual que você manda para o cliente, sem expor log de servidor.

## Checklist para padronizar o ajuste em vários servidores

Faça uma vez, anote, repita. A ordem evita retrabalho.

- Listar os servidores e, em cada um, abrir **Service Manager** e fotografar quais serviços estão monitorados. Divergência entre servidores quase sempre é resquício de migração.
- Marcar o horário dos alertas falsos dos últimos 30 dias por servidor. Se todos batem com a janela de backup, trate o agendamento primeiro.
- Definir um valor padrão de falhas consecutivas para a frota (2 ou 3) e aplicar igual em todos. Valor diferente por servidor torna qualquer comparação inútil.
- Conferir no Tweak Settings, grupo Status, se algum servidor está com intervalo fora do padrão que você escolheu.
- Registrar a data do ajuste num arquivo de runbook do cliente, com o valor anterior. Sem o valor anterior você não consegue reverter com confiança.
- Agendar revisão em 7 e em 30 dias: contagem de falhas no `chkservd.log` e comparação com o monitor externo.
- Garantir que existe monitor externo de uptime em todos os sites críticos. O `chkservd` olha de dentro, e o que o cliente percebe é de fora.

Dois cuidados que evitam dor: não aplique a mudança nos servidores todos na mesma noite (faça um, observe, depois o resto) e não use "Monitor" desmarcado como atalho para fechar chamado.

## Como explicar o alarme falso para o cliente sem jargão

O cliente recebeu um e-mail com a palavra "down" no assunto e já está escrevendo. Responda antes que ele pergunte, e sem jargão:

> **** "O site e o e-mail continuaram no ar. O que disparou foi o monitoramento interno do servidor: ele testa cada serviço em ciclos de poucos minutos e, durante a rotina de backup da madrugada, um desses testes demorou mais que o limite e foi contado como falha. Ajustamos o monitor para só avisar quando a falha se repetir em verificações seguidas, o que elimina o alarme falso sem deixar de avisar numa queda de verdade. O histórico de disponibilidade externo do período está sem nenhuma interrupção."

Se o cliente pedir prova, mande a captura do **Service Status** com tudo verde e o relatório do monitor externo cobrindo a janela do alerta. Log de servidor não ajuda ninguém que não opera servidor.

## Quando o alerta volta e a sonda está certa

Subir tentativas resolve o blip. Não resolve serviço que realmente cai, nem explica por que caiu. Se depois do ajuste o alerta voltar com a mesma frequência, a leitura correta é: o serviço está falhando mesmo, e a sonda só estava fazendo o trabalho dela.

Nesse caso a investigação muda de lugar: log do serviço (não o do `chkservd`), consumo de memória no horário do evento, consulta lenta segurando o MySQL, limite de conexões do Dovecot. Trocar de plano ou de servidor é a última hipótese da lista, não a primeira, e com frequência o problema some quando uma consulta mal indexada é corrigida.

Os parâmetros descritos aqui são os do grupo Status do Tweak Settings do WHM; os nomes e os valores aceitos na sua versão estão na [documentação oficial do cPanel](https://docs.cpanel.net/whm/server-configuration/tweak-settings/status/). Os exemplos de comando e de horário acima são exemplos de uso, não medições feitas por nós.

