# Site fora do ar: ler o erro no cPanel em 5 passos

Como achar a tela de diagnóstico do cPanel, entender o que ela diz e separar o que você resolve sozinho do que precisa de suporte.

> o cPanel no visual novo tem uma tela de diagnóstico que lê os registros de erro por você. Na prática, o que ela aponta costuma cair em quatro grupos: erro de PHP, estouro de limite, falha de banco de dados e arquivo ausente. No tema antigo, você provavelmente não vai encontrá-la.

João Rizzon · 2026-10-28 · Painéis

---

## O que realmente quebrou quando o site parou de abrir

Antes de procurar botão, vale entender o que está quebrado. Seu site vive em um computador ligado o tempo todo, chamado **servidor**. Pense nele como um terreno alugado. O **domínio** (o `seusite.com.br`) é o endereço escrito na placa. O **DNS** é a lista telefônica que diz em qual terreno aquele endereço fica. E o **painel de controle** (na maioria das hospedagens, o cPanel) é a portaria onde você mexe em tudo isso sem precisar entrar no terreno com pá e enxada.

Quando o navegador mostra "erro 500", tela branca ou "erro ao estabelecer conexão com o banco de dados", quase sempre o terreno está lá e o endereço também. O que falhou foi o programa que monta a página. Esse programa costuma ser escrito em uma linguagem chamada **PHP**: pense nela como a receita que a cozinha segue para montar o prato na hora em que o cliente pede. Quando um passo da receita é impossível, o cozinheiro para no meio e nada chega à mesa.

Sempre que isso acontece, o servidor escreve o que deu errado em um arquivo de texto chamado **log** (registro). O log sempre existiu. O problema, para quem nunca abriu um, era saber qual dos vários logs abrir.

## Onde fica a tela de diagnóstico de erros no cPanel

O cPanel tem uma área dedicada a diagnosticar erros do site, documentada em [Diagnosing Site Errors](https://docs.cpanel.net/cpanel/meridian/performance/diagnosing-site-errors/). A ideia dela é simples: em vez de você escolher o log, ela olha os registros recentes, separa o que parece erro e mostra isso em lista, em linguagem mais próxima de frase do que de código.

Essa área aparece no visual novo do painel. Se o seu cPanel ainda está no tema antigo, você provavelmente não vai achar essa tela, e a saída é trocar o tema ou pedir ao suporte que troque. Não se sinta perdido por não encontrar: os nomes de menu mudam entre versões do painel e entre provedores. Procure pelo grupo de **Desempenho** ou use o campo de busca no topo do painel e digite "erro" ou "error".

### O que ter em mãos antes de abrir o painel

- O endereço de acesso ao painel, o usuário e a senha (vieram no e-mail de boas-vindas da hospedagem).
- O endereço exato da página que não abre, copiado da barra do navegador.
- A hora aproximada em que você viu o problema pela primeira vez.
- Papel e caneta, ou um bloco de notas aberto. Você vai copiar texto de lá.

## Os quatro apontamentos mais comuns e o que cada um significa

A tela de diagnóstico resume o que encontrou. A documentação do cPanel não divide os apontamentos em categorias fixas: as mensagens variam conforme o que o site fez. Mas, na prática, o que aparece ali quase sempre cai em um destes quatro grupos. A tabela abaixo é a nossa tradução deles, não uma lista oficial do painel.

| O que a tela aponta | O que significa na prática | Analogia | Quem costuma resolver |
|---|---|---|---||
| Erro de PHP | A receita que monta a página travou em uma linha específica, em geral depois de atualizar um plugin, um tema ou a própria versão do PHP | A receita tinha um passo impossível e o cozinheiro parou no meio | Você, desativando o que mudou por último |
| Estouro de limite de recurso | O site pediu mais memória, mais processador ou mais processos do que o plano permite naquele instante | O elevador parou porque entrou gente demais | Você primeiro (cache, plugin pesado), suporte depois |
| Falha de conexão com o banco de dados | O site não conseguiu falar com o arquivo onde ficam textos, usuários e pedidos. Senha errada, nome errado ou banco indisponível | A chave não abre o arquivão, ou o arquivão está trancado | Você, se for senha no arquivo de configuração; suporte, se for o serviço |
| Arquivo ausente | O site pediu uma imagem, uma folha de estilo (o arquivo que define cores e layout) ou um script (um pequeno programa que roda dentro da página) que não está mais no lugar | Pediram a pasta da prateleira e ela sumiu | Você, reenviando o arquivo |

Duas observações honestas. Primeira: "arquivo ausente" costuma ser barulho. Uma imagem faltando deixa o site feio, não derruba. Se o site está fora do ar inteiro e só há apontamento de arquivo ausente, procure outra coisa. Segunda: um erro pode gerar outro. Falta de memória pode aparecer disfarçada de erro de PHP.

## Por que o resumo não basta e o registro completo resolve

O valor da tela não é só o resumo. É o atalho. Ao lado de cada item costuma haver uma ação que leva ao registro completo daquele erro, com data, hora e o caminho do arquivo que falhou. É esse texto completo que resolve o caso.

### Entre no painel com usuário e senha da hospedagem

Abra o endereço do painel, informe usuário e senha. Resultado esperado: a tela inicial com vários ícones agrupados.

### Ache a área de diagnóstico buscando por "erro"

Use a busca no topo e digite "erro". Resultado esperado: um resultado ligado a diagnóstico de erros do site. Se nada aparecer, seu painel está no tema antigo ou o recurso não foi habilitado pelo provedor.

### Leia a lista de cima para baixo e compare o horário

Os itens mais recentes ficam no topo. Compare o horário com o momento em que você viu o site fora. Resultado esperado: um ou dois itens repetindo no mesmo minuto. Repetição é pista forte.

### Abra o registro completo e veja o caminho do arquivo

Clique no item ou na ação de detalhe. Resultado esperado: o texto bruto do erro, com o caminho de um arquivo dentro do seu site. Esse caminho costuma dizer qual plugin ou tema é o culpado.

### Copie a linha inteira, o horário e o endereço da página

Selecione a linha inteira e copie. Guarde no bloco de notas junto com o horário e o endereço da página. Se o problema virar chamado, isso economiza uma ida e volta inteira.

## Quatro casos que você resolve sozinho sem trocar de plano

- **Erro de PHP logo depois de atualizar algo.** Desative o plugin ou tema citado no caminho do arquivo. No WordPress, isso é um botão na lista de plugins. Se o painel do site também não abre, renomeie a pasta do plugin pelo gerenciador de arquivos do cPanel: renomear uma pasta já desativa o plugin.
- **Arquivo ausente.** Reenvie o arquivo pelo gerenciador de arquivos, na mesma pasta que aparece no registro.
- **Estouro de limite com um pico isolado.** Instale um plugin de **cache**, que guarda uma cópia pronta da página para entregar sem refazer a receita a cada visita, e desligue o que consome muito, como uma importação de dados rodando em horário de visita.
- **Banco de dados com senha trocada.** Se você mudou a senha do usuário do banco pelo painel e esqueceu de atualizar no arquivo de configuração do site, o sintoma é exatamente esse. Dá para corrigir pelo gerenciador de arquivos, editando o arquivo de configuração.

Começar pelo registro evita a decisão mais cara do iniciante, que é trocar de plano achando que é falta de recurso. Muitas vezes o apontamento aponta um plugin, e desativar o plugin custa zero.

## Quando abrir chamado e os cinco dados que economizam uma ida e volta

Abra chamado quando o registro indicar que o serviço de banco de dados não responde, quando o estouro de limite se repete várias vezes por dia mesmo depois de você limpar o que podia, quando o erro aparece em todos os sites da conta ao mesmo tempo, ou quando você simplesmente não entende o texto do registro. Não entender não é vergonha, é o motivo de existir suporte.

Cole no chamado, nesta ordem:

- O endereço completo da página que não abre.
- A data e a hora do erro, com fuso se você souber.
- A linha copiada do registro, inteira, sem resumir.
- O que você já tentou e o que aconteceu depois.
- Se mudou algo recentemente: atualização, instalação, migração, troca de versão do PHP.

Um chamado com esses cinco itens já chega pronto para análise. Um chamado com "meu site caiu" começa com uma pergunta de volta.

## Quando a tela fica vazia e o problema é de endereço, não de programa

Ela lê o que o servidor registrou. Se nada foi registrado, ela fica vazia, e isso também é informação: o pedido talvez nem tenha chegado ao seu servidor. Nesses casos, o problema costuma ser de endereço, não de programa. Domínio vencido, DNS apontando para o lugar errado depois de uma migração, ou certificado de segurança expirado, que faz o navegador barrar a entrada antes de carregar qualquer coisa.

Também vale lembrar que é uma tela de leitura. Ela mostra e organiza, não conserta. O conserto continua sendo seu, no gerenciador de arquivos e no painel do site, ou do suporte, no servidor.

O hábito que vale a pena criar: ao ver o site fora, abra o painel antes de abrir o chamado. Dois minutos de leitura do registro mudam completamente a qualidade da conversa que vem depois.

