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
- Python 3.14 documentation — logging.Logger
- Python 3.14 — logging.Logger.setLevel
- Python 3.14 — logging.Logger.addHandler
- Python 3.14 — logging.Logger.propagate
- Python 3.14 — logging.Logger.getChild
- Python 3.14 — logging.Logger.debug
- Python 3.14 — logging.Logger.info
- Python 3.14 — logging.Logger.warning
- Python 3.14 — logging.Logger.error
- Python 3.14 — logging.Logger.handlers