Base de Conhecimento

13.09 Como visualizar logs da aplicação Python

Visualizar os logs da aplicação Python serve para analisar erros, mensagens de execução e sinais de falha na inicialização ou no funcionamento do app.

Na prática, os logs são uma das ferramentas mais importantes para descobrir por que a aplicação não abre, retorna erro ou se comporta de forma inesperada.

Como acessar o cPanel

Primeiro entre no cPanel por:

https://seudominio.com.br/cpanel
https://seudominio.com.br:2083
área do cliente MyWay

Depois vá em Software > Setup Python App.

Como visualizar logs da aplicação Python

Por que os logs são importantes

Quando uma aplicação Python falha, o navegador muitas vezes mostra apenas um erro genérico.

Já os logs podem revelar detalhes como:

erro de importação
biblioteca faltando
variável de ambiente ausente
entry point incorreto
problema no startup file
erro interno do código

Sem olhar os logs, você pode gastar muito tempo tentando corrigir o problema “no escuro”.

Onde os logs podem ser vistos

Em aplicações Python registradas com Passenger/Application Manager, um local comum do log é o arquivo stderr.log dentro do diretório da aplicação.

Além disso, na edição da aplicação pode existir o campo relacionado ao Passenger log file.

Traduções úteis:

Passenger log file = arquivo de log do Passenger
stderr.log = log de erros padrão da aplicação

Esse arquivo costuma ser o primeiro ponto a consultar quando a aplicação não sobe corretamente.

Passo 1 – Localizar a aplicação no Setup Python App

Entre no Setup Python App e identifique qual aplicação você deseja investigar.

Confirme a URI, o diretório raiz e o status.

Isso garante que você analisará o log do app correto.

Passo 2 – Verificar o caminho do log

Ao editar a aplicação, observe se existe campo ou referência para Passenger log file.

Esse caminho ajuda a saber onde o aplicativo está registrando mensagens importantes de execução.

Em muitos casos, o erro real da aplicação aparece nesse arquivo, e não na tela pública do site.

Passo 3 – Abrir o arquivo de log

Com o caminho identificado, use o gerenciador de arquivos da hospedagem para abrir o arquivo correspondente.

Para aplicações Python registradas no Application Manager, é comum revisar o arquivo stderr.log dentro da pasta da aplicação.

Sempre leia as linhas mais recentes, especialmente logo depois de tentar acessar a aplicação ou reiniciá-la.

O que procurar no log

mensagens de ModuleNotFoundError
erros de sintaxe
falhas ao importar o objeto da aplicação
erros relacionados a variáveis de ambiente
caminhos incorretos de arquivos
mensagens de inicialização malsucedida

Os logs geralmente apontam a causa técnica real do problema, o que acelera muito o diagnóstico.

Exemplos práticos

Se o log apontar ausência de biblioteca, o caminho costuma ser instalar a dependência correta.

Se o log indicar erro no arquivo de inicialização, o foco deve ser revisar o startup file.

Se o erro mencionar o objeto da aplicação, é hora de revisar o entry point.

Ou seja, o log não é apenas um relatório: ele normalmente indica a direção da correção.

Cuidados importantes

não ignore mensagens repetidas
sempre compare o horário do erro com o momento do teste
depois de corrigir, reinicie a aplicação e gere novo teste
não conclua diagnóstico apenas pela mensagem do navegador

Confiar só no erro visual da URL pode levar a conclusões erradas. O log costuma ser a fonte mais confiável para entender o problema.

Resultado esperado

Ao final, você terá encontrado e lido o log mais relevante da aplicação, identificando a causa provável da falha ou confirmando o comportamento do app.

Resumo rápido:

1. Acesse Setup Python App
2. Identifique a aplicação correta
3. Verifique o caminho do log, quando disponível
4. Abra o arquivo de log da aplicação
5. Leia os erros mais recentes
6. Corrija a causa e teste novamente

Na prática, os logs são a principal fonte de diagnóstico técnico do app Python.

Sempre que a aplicação não abrir ou reiniciar corretamente, consulte o log antes de alterar várias configurações ao mesmo tempo.

Atenciosamente,
MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br

0 Usuários acharam útil