KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

De drempel van een logger met naam instellen met setLevel()

Stel een logger met naam in op `logging.INFO`: `DEBUG` valt af, terwijl `INFO` en hogere niveaus de drempel van de logger passeren. De handler bepaalt nog steeds wat wordt uitgevoerd.

Versie: Python 3.12

Syntax

logger = logging.getLogger(name)
logger.setLevel(level)  # e.g. logging.INFO or "INFO"

De instantiemethode logging.Logger.setLevel stelt de drempel in van de logger waarop je de methode aanroept. In Python 3.12 geeft logging.getLogger("root") de rootlogger terug. Als je setLevel() daarop aanroept, stel je dus de drempel van de rootlogger in. Als je dezelfde naam opnieuw opvraagt, krijg je hetzelfde object. Geef een gehele constante door, zoals logging.INFO, of een niveaunaam zoals "INFO". Bij die drempel valt DEBUG af; INFO, WARNING, ERROR en CRITICAL komen door de niveaucontrole van de logger.

Een nieuwe logger die niet de rootlogger is, begint met logging.NOTSET. De effectieve drempel komt dan van de dichtstbijzijnde bovenliggende logger met een ander niveau dan NOTSET. Als alle bovenliggende loggers, inclusief de rootlogger, ook op NOTSET staan, is het effectieve niveau NOTSET. De rootlogger staat standaard op WARNING. Vraag de effectieve drempel op met logger.getEffectiveLevel().

setLevel() voegt geen handler toe en kiest geen bestemming. Elke handler heeft een eigen drempel (Handler.setLevel) en kan filters gebruiken. Een record dat de logger doorlaat, levert dus niet altijd uitvoer op. Bij het doorgeven gaan records rechtstreeks naar de handlers van bovenliggende loggers, zonder hun loggerniveaus of filters opnieuw te controleren. logger.propagate = False stopt het doorgeven aan bovenliggende loggers.

Voorbeelden

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")

Resultaat

INFO: Order accepted
WARNING: Receipt delayed

De handler schrijft naar `sys.stdout` en weigert met zijn standaardniveau `NOTSET` geen records op basis van ernst. Omdat doorgeven uitstaat, laat de logger in een nieuw proces `DEBUG` weg en verschijnen `INFO` en `WARNING` elk één keer.

Gerelateerde lessen

  • Python · Les 27 · Gevorderd · Versie: 5
  • Python · Les 24 · Gemiddeld · Versie: 3

Bronnen