CKTIS / Python
Définir le seuil d’un journal nommé avec setLevel()
Réglez un journal nommé sur `logging.INFO` : `DEBUG` est écarté, tandis que les niveaux `INFO` et supérieurs passent le contrôle du journal. Le gestionnaire décide encore de la sortie.
Version : Python 3.12
Syntaxe
logger = logging.getLogger(name)
logger.setLevel(level) # e.g. logging.INFO or "INFO"La méthode d’instance logging.Logger.setLevel règle le seuil du journal sur lequel vous l’appelez. Dans Python 3.12, logging.getLogger("root") renvoie le journal racine : appeler setLevel() sur ce journal règle donc son seuil. Une nouvelle recherche du même nom renvoie le même objet. Passez une constante entière comme logging.INFO ou un nom de niveau comme "INFO". À ce seuil, DEBUG est écarté ; INFO, WARNING, ERROR et CRITICAL passent le contrôle de niveau du journal.
Un nouveau journal autre que la racine démarre au niveau logging.NOTSET. Son seuil effectif est alors celui de l’ancêtre le plus proche dont le niveau diffère de NOTSET. Si tous ses ancêtres, y compris le journal racine, sont aussi au niveau NOTSET, son niveau effectif est NOTSET. Le niveau par défaut du journal racine est WARNING. Pour consulter le seuil effectif, utilisez logger.getEffectiveLevel().
setLevel() n’ajoute aucun gestionnaire et ne choisit aucune destination. Chaque gestionnaire possède son propre seuil (Handler.setLevel) et peut appliquer des filtres : un enregistrement accepté par le journal peut donc ne produire aucune sortie. Lors de la propagation, les enregistrements sont transmis directement aux gestionnaires des ancêtres sans revérifier les niveaux ni les filtres de ces journaux. logger.propagate = False arrête cette transmission.
Exemples
import logging
import sys
logger = logging.getLogger("cktis.checkout")
logger.setLevel(logging.INFO)
logger.propagate = False
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
logger.addHandler(handler)
logger.debug("Checking cart")
logger.info("Order accepted")
logger.warning("Receipt delayed")Résultat
INFO: Order accepted WARNING: Receipt delayed
Le gestionnaire écrit dans `sys.stdout` et son niveau par défaut `NOTSET` ne rejette aucun enregistrement selon sa gravité. La propagation étant désactivée, dans un nouveau processus le journal écarte `DEBUG`, et `INFO` et `WARNING` s’affichent chacun une fois.
Leçons associées
- Python · Leçon 27 · Avancé · Version : 5
- Python · Leçon 24 · Intermédiaire · Version : 3