blog
Painéis

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.

JR · · 7 min de leitura · 1 tabela

Resposta curta: 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.

Neste artigo
  1. O que realmente quebrou quando o site parou de abrir
  2. Onde fica a tela de diagnóstico de erros no cPanel
  3. Os quatro apontamentos mais comuns e o que cada um significa
  4. Por que o resumo não basta e o registro completo resolve
  5. Quatro casos que você resolve sozinho sem trocar de plano
  6. Quando abrir chamado e os cinco dados que economizam uma ida e volta
  7. Quando a tela fica vazia e o problema é de endereço, não de programa

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. 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

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.

Do login ao registro completo em cinco passosEntrar no painelUsuário e senha da hospedagemBuscar por erroCampo de busca no topoLer a listaCompare o horário do problemaAbrir registro completoVeja o caminho do arquivoCopiar a linhaGuarde horário e endereço
Os cinco passos para ler o erro sem usar terminal.

Quatro casos que você resolve sozinho sem trocar de plano

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:

  1. O endereço completo da página que não abre.
  2. A data e a hora do erro, com fuso se você souber.
  3. A linha copiada do registro, inteira, sem resumir.
  4. O que você já tentou e o que aconteceu depois.
  5. 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.

Resolver sozinho ou abrir chamadoA lista mostrou algo?Se não, suspeite do endereçoErro de PHP ou arquivo ausenteDesative ou reenvie você mesmoLimite estourado uma vezInstale cache, desligue o pesadoSenha do banco trocadaCorrija o arquivo de configuraçãoRepete todo dia ou não entendeAbra chamado com os cinco dados
Caminho de decisão depois de ler o registro.

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.

Referências

  1. Documentação oficial (cpanel) — Diagnosing Site Errors (cPanel Meridian). Consultado em 2026-10-13.
Leia também