Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

logging.Logger

Un Logger con nome ottenuto da getLogger controlla livello effettivo e filtri prima di inviare il record.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

logging.getLogger('work.sample')

Un Logger con nome ottenuto da getLogger controlla livello effettivo e filtri prima di inviare il record.

disabled=True sul logger di origine blocca le sue chiamate. Su un antenato la stessa impostazione non blocca la consegna di un record già accettato dal figlio ai suoi gestori. Con propagate=True il record passa direttamente ai gestori degli antenati senza controllare livelli o filtri dei loro logger. Le soglie e i filtri dei gestori restano attivi.

Con un gestore privato e propagate=False l’esempio stampa True ready senza duplicazioni nel genitore.

import logging,io
out=io.StringIO()
parent=logging.getLogger('ref.logger')
parent.propagate=False
parent.setLevel(logging.CRITICAL)
handler=logging.StreamHandler(out)
handler.setLevel(logging.WARNING)
parent.addHandler(handler)
child=logging.getLogger('ref.logger.child')
child.setLevel(logging.INFO)
child.info('filtered')
child.warning('delivered')
assert out.getvalue()=='delivered\n'
child.propagate=False
child.addHandler(logging.NullHandler())
child.warning('private')
assert out.getvalue()=='delivered\n'
child.propagate=True
parent.disabled=True
child.warning('child')
child.disabled=True
child.warning('blocked')
assert out.getvalue().splitlines()==['delivered','child']

logging.Logger.setLevel · logging.Logger.addHandler · logging.Logger.propagate · logging.Logger.getChild · logging.Logger.debug · logging.Logger.info · logging.Logger.warning · logging.Logger.error · logging.Logger.handlers

setLevel imposta la soglia, addHandler installa un gestore in handlers e getChild('jobs') ottiene un logger figlio. Leggere handlers e modificarlo tramite addHandler/removeHandler. debug/info/warning/error usano 10/20/30/40. Il figlio eredita INFO e passa tre record al genitore, il cui propagate=False blocca l’inoltro ulteriore.

import io,logging
out=io.StringIO()
log=logging.getLogger('app')
log.setLevel(logging.INFO)
log.propagate=False
h=logging.StreamHandler(out)
log.addHandler(h)
child=log.getChild('jobs')
assert child.name=='app.jobs' and h in log.handlers
for method in (child.debug,child.info,child.warning,child.error):
    method(method.__name__)
assert out.getvalue().splitlines()==['info','warning','error']
log.removeHandler(h)
h.close()

Esempi

import logging
from io import StringIO

out = StringIO()
log = logging.getLogger("private")
log.setLevel(logging.INFO)
log.propagate = False
log.addHandler(logging.StreamHandler(out))
log.info("ready")
print(isinstance(log, logging.Logger), out.getvalue().strip())

Risultato

True ready

Con un gestore privato e propagate=False l’esempio stampa True ready senza duplicazioni nel genitore.

Fonti