Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

Journaliser avec Logger.debug, info, warning et error

Choisissez une méthode du journaliseur nommé selon la gravité de l’événement et voyez comment les réglages du journaliseur et des gestionnaires filtrent les messages.

Version : Python 3.12

Syntaxe

logger = logging.getLogger(name)
logger.debug(msg, *args, **kwargs)
logger.info(msg, *args, **kwargs)
logger.warning(msg, *args, **kwargs)
logger.error(msg, *args, **kwargs)

En Python 3.12, obtenez un journaliseur nommé avec logging.getLogger(name), généralement logging.getLogger(__name__) dans un module. Appelez debug, info, warning et error sur l’instance de Logger renvoyée. Le même nom renvoie à nouveau la même instance. Les fonctions du module, comme logging.info(), utilisent plutôt le journaliseur racine et appellent basicConfig() s’il n’a aucun gestionnaire. Les méthodes d’instance ne configurent pas automatiquement la racine.

Par gravité croissante, utilisez debug() pour les détails de diagnostic (DEBUG), info() pour les événements courants (INFO), warning() pour un problème possible ou inattendu alors que le programme peut continuer (WARNING), et error() lorsqu’une opération a échoué (ERROR). Préférez warning() à warn(), qui est obsolète. Journaliser une exception au niveau ERROR ne la relance pas. L’appel à error() peut toutefois lever une exception, par exemple une KeyError si extra tente d’écraser un champ réservé d’un LogRecord.

Les quatre méthodes acceptent msg, *args, **kwargs. Passez les valeurs séparément, comme dans logger.debug("Items scanned: %d", 3) : la substitution avec % a lieu lors du formatage du message. Sans argument positionnel après msg, aucune substitution n’est faite. Les options nommées sont exc_info (détails de l’exception), stack_info (pile d’appels actuelle), stacklevel (emplacement d’appel enregistré) et extra (champs personnalisés de l’enregistrement).

Le niveau effectif du journaliseur sert de seuil : INFO écarte DEBUG. Avec NOTSET, un journaliseur nommé recherche un niveau chez ses ancêtres ; par défaut, la racine est à WARNING. Les gestionnaires peuvent appliquer leurs propres seuils et filtres. Lorsqu’un enregistrement est transmis aux gestionnaires des ancêtres, les niveaux et filtres de ces journaliseurs ne sont pas vérifiés de nouveau.

Exemples

import logging
import sys

logging.basicConfig(
    level=logging.DEBUG,
    stream=sys.stdout,
    format="%(levelname)s %(name)s: %(message)s",
)
logger = logging.getLogger("inventory")

logger.debug("Items scanned: %d", 3)
logger.info("Inventory loaded")
logger.warning("Stock is low")
logger.error("Could not save inventory")

logger.setLevel(logging.INFO)
logger.debug("This line is filtered out")

Résultat

DEBUG inventory: Items scanned: 3
INFO inventory: Inventory loaded
WARNING inventory: Stock is low
ERROR inventory: Could not save inventory

Exécutez le script dans un nouveau processus Python 3.12. `basicConfig()` règle le niveau de la racine sur `DEBUG` et envoie la sortie vers `sys.stdout`. Quatre lignes s’affichent ; après `logger.setLevel(logging.INFO)`, le dernier message `DEBUG` est écarté.

Leçons associées

  • Python · Leçon 24 · Intermédiaire · Version : 3

Sources