Módulo Logging do Python
O módulo logging permite registrar mensagens de debug, info, warning, error e exception de forma consistente.
import logging
Use logging em vez de print() quando as mensagens tiverem níveis de importância diferentes ou quando você puder enviá-las para um arquivo depois.
Configuração básica
basicConfig configura o logger padrão.
import logging
logging.basicConfig(level=logging.INFO)
logging.info('Application started')
logging.warning('Low disk space')
INFO:root:Application started
WARNING:root:Low disk space
Mensagens abaixo do nível configurado são ignoradas.
import logging
logging.basicConfig(level=logging.WARNING)
logging.info('Hidden message')
logging.warning('Visible message')
WARNING:root:Visible message
Criando um logger nomeado
Loggers nomeados são úteis em aplicações maiores.
import logging
logger = logging.getLogger('app.users')
logger.setLevel(logging.INFO)
print(logger.name)
app.users
Formatando mensagens
Você pode personalizar o formato de saída.
import logging
logging.basicConfig(
level=logging.INFO,
format='%(levelname)s:%(name)s:%(message)s',
)
logger = logging.getLogger('app')
logger.info('Ready')
INFO:app:Ready
Registrando exceções
logger.exception registra automaticamente o traceback dentro de um bloco except.
import logging
logging.basicConfig(level=logging.ERROR)
logger = logging.getLogger(__name__)
try:
1 / 0
except ZeroDivisionError:
logger.exception('Calculation failed')
ERROR:__main__:Calculation failed
Traceback (most recent call last):
...
ZeroDivisionError: division by zero