Python - Usando Logging para Diagnosticar Erros no Ubuntu
Canal Qb

Entendendo o erro "Main process exited, code=exited, status=1/FAILURE"

Se você está utilizando um serviço no Ubuntu que executa um script Python e se depara com o erro "Main process exited, code=exited, status=1/FAILURE" ao verificar o journalctl, significa que o processo principal do serviço finalizou com falha. Geralmente, isso acontece porque o script Python encontrou um erro não tratado e foi encerrado abruptamente.

Causas comuns do erro

• Exceções não tratadas no código Python.
• Acesso a arquivos inexistentes ou indisponíveis.
• Operações inválidas ou incorretas em objetos ou variáveis.
• Problemas externos, como permissões insuficientes ou recursos indisponíveis.

Como usar o módulo logging do Python para depurar

Para identificar exatamente onde o seu script está falhando, você pode adicionar mensagens de log que registrem o progresso da execução e eventuais erros. O módulo logging do Python é ideal para isso e ajuda a criar um histórico detalhado dos eventos.

Configurando o logging

No início do seu script, configure o sistema de logs com o seguinte código:

import logging
logging.basicConfig(filename='knolix.log', level=logging.DEBUG, 
                    format='%(asctime)s - %(levelname)s - %(message)s')

Essa configuração cria um arquivo chamado knolix.log no diretório atual, grava mensagens a partir do nível DEBUG (mais detalhado) e formata as mensagens com data, nível e texto do log.

Inserindo logs no seu código

Adicione chamadas de log em pontos estratégicos do seu script para monitorar o fluxo e capturar erros:

logging.debug('Iniciando script')

try:
    # seu código aqui
    logging.info('Processo em andamento')
    # ...
except Exception as e:
    logging.error(f'Erro encontrado: {e}', exc_info=True)

logging.debug('Script finalizado com sucesso')

O bloco try-except ajuda a capturar exceções e registrá-las no log, incluindo o rastreamento completo do erro, facilitando a identificação do problema.

Verificando os logs para solução

Após executar o script, abra o arquivo knolix.log para revisar as mensagens registradas e identificar exatamente onde o erro ocorreu. Essa prática facilita muito a depuração e a correção do seu código Python rodando no Ubuntu.

Se quiser aprender mais sobre Python e Linux, visite o Canal Qb para conteúdos atualizados e tutoriais práticos.