Python Academy · Leçon

Bases du module logging

Configurez les enregistreurs, définissez les niveaux et émettez correctement les messages.

Bases du module logging est une leçon Python Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Python Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Python Academy comprend 4 leçons au total.

Pourquoi préférer la journalisation à print ?

Le module logging fournit des niveaux de gravité, des destinations de sortie configurables, des horodatages et la possibilité de désactiver la sortie sans modifier le code.

import logging

logging.basicConfig(level=logging.DEBUG)
logging.debug("debug message")
logging.info("info message")
logging.warning("warning message")
logging.error("error message")
logging.critical("critical message")

Niveaux de journalisation

Python définit cinq niveaux standard par gravité croissante : DEBUG, INFO, WARNING, ERROR, CRITICAL. Seuls les messages du niveau configuré ou d’un niveau supérieur sont émis.

import logging
# Numeric values:
# DEBUG    = 10
# INFO     = 20
# WARNING  = 30
# ERROR    = 40
# CRITICAL = 50

logging.basicConfig(level=logging.WARNING)
logging.debug("hidden")   # not shown
logging.warning("shown")  # shown

Obtenir un journaliseur

Utilisez logging.getLogger(__name__) dans chaque module. Cela crée une hiérarchie correspondant à la structure des modules.

import logging

logger = logging.getLogger(__name__)

def process(data):
    logger.info("Processing %d items", len(data))
    return [x * 2 for x in data]

Options de basicConfig

basicConfig configure rapidement le journaliseur racine. Les arguments nommés courants sont : level, format, filename, filemode.

import logging

logging.basicConfig(
    level=logging.DEBUG,
    format="%(asctime)s %(levelname)s %(name)s — %(message)s",
    datefmt="%Y-%m-%d %H:%M:%S",
)

Champs de format des journaux

Champs de format essentiels : %(levelname)s, %(name)s, %(message)s, %(asctime)s, %(filename)s, %(lineno)d.

import logging

fmt = "%(asctime)s | %(levelname)-8s | %(name)s:%(lineno)d | %(message)s"
logging.basicConfig(level=logging.DEBUG, format=fmt)
logging.info("Server started on port 8080")

Journaliser les exceptions

Utilisez logger.exception() dans un bloc except pour journaliser le message ET la trace complète de l’erreur.

import logging
logger = logging.getLogger(__name__)

try:
    1 / 0
except ZeroDivisionError:
    logger.exception("Division failed")
    # Logs message + traceback automatically

Ajouter du contexte avec extra=

Transmettez un dict comme extra= pour ajouter des champs personnalisés à l’enregistrement de journal.

import logging
logger = logging.getLogger(__name__)

logging.basicConfig(
    format="%(asctime)s %(levelname)s [%(user)s] %(message)s"
)
logger.info("Login successful", extra={"user": "alice"})

Formatage différé des chaînes

Transmettez les arguments de format séparément — ne préformatez pas les chaînes. Cela évite le coût de leur construction lorsque le message est filtré.

import logging
logger = logging.getLogger(__name__)

# BAD (always builds the string):
logger.debug(f"Processing {len(data)} items")

# GOOD (only builds if DEBUG is enabled):
logger.debug("Processing %d items", len(data))

Désactiver la journalisation

Appelez logging.disable(level) pour supprimer globalement tous les messages jusqu’à ce niveau inclus — ce qui est utile dans les tests.

import logging

logging.disable(logging.CRITICAL)  # suppress everything
# All log calls now silently do nothing

logging.disable(logging.NOTSET)    # re-enable

Hiérarchie des journaliseurs

Les noms des journaliseurs utilisent des points comme séparateurs. Les journaliseurs enfants transmettent leurs enregistrements aux journaliseurs parents, sauf si propagate=False.

import logging

parent = logging.getLogger("myapp")
child = logging.getLogger("myapp.database")

# child propagates to parent by default
child.warning("DB slow")  # also appears in myapp's handlers

Le journaliseur racine

Le journaliseur racine, utilisé notamment par logging.warning(), est l’ancêtre de tous les journaliseurs. Configurez-le avec basicConfig ou en ajoutant directement des gestionnaires.

import logging

root = logging.getLogger()  # root logger
root.setLevel(logging.DEBUG)

handler = logging.StreamHandler()
root.addHandler(handler)

Vérification rapide

Quelle méthode de journalisation devez-vous utiliser dans un bloc except pour inclure automatiquement la trace complète de l’erreur ?

Récapitulatif

Utilisez des journaliseurs nommés avec getLogger(__name__), configurez-les via basicConfig, transmettez les arguments de format de manière différée et utilisez logger.exception() pour les traces d’erreur. Les journaliseurs forment une hiérarchie enracinée dans le journaliseur racine.

Questions Fréquemment Posées

La leçon « Bases du module logging » est-elle gratuite ?

Oui — le texte complet de « Bases du module logging » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Python Academy, passe à CoddyKit PRO. Le cours Python Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Bases du module logging » ?

Configurez les enregistreurs, définissez les niveaux et émettez correctement les messages. Tu pratiques Python Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Python Academy ?

Aucune expérience préalable n'est requise. Python Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Bases du module logging » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Python Academy ?

Oui. Chaque leçon Python Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Python Academy