KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

LoggerAdapter.error(): fouten loggen met teamcontext

Gebruik in Python 3.12 `LoggerAdapter.error()` om op niveau `ERROR` te loggen met een veld `team`, zonder dat veld bij elke aanroep mee te geven.

Versie: Python 3.12

Syntax

adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)

Maak de adapter met logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() logt op niveau ERROR via de meegegeven Logger. De modulefunctie logging.error() gebruikt daarentegen de rootlogger. De adapter heeft geen eigen niveaudrempel: de instellingen van de logger en zijn handlers bepalen of een record wordt uitgevoerd.

Gebruik adapter.error() om een mislukking te melden. De aanroep werpt zelf geen uitzondering op en voegt standaard geen traceback toe. Gebruik binnen except de aanroep adapter.exception(...) of adapter.error(..., exc_info=True) om de afgehandelde uitzondering mee te loggen.

In Python 3.12 vervangt de standaardimplementatie van process() een bij de aanroep meegegeven extra door de context uit de constructor, zonder beide samen te voegen. Het veld team wordt een attribuut van het LogRecord; de formatter toont het met %(team)s. Vermijd namen van ingebouwde attributen zoals levelname. Verwacht de formatter team maar ontbreekt dat veld, dan mislukt de formattering tenzij er een standaardwaarde is ingesteld.

Voorbeelden

import logging
import sys

logger = logging.getLogger("deploy")
logger.setLevel(logging.INFO)
logger.propagate = False

handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s [%(team)s] %(message)s"))
logger.addHandler(handler)

adapter = logging.LoggerAdapter(logger, extra={"team": "platform"})
adapter.info("Deployment started for %s", "api")
adapter.warning("Health check is slow")
adapter.error("Deployment failed")

Resultaat

INFO [platform] Deployment started for api
WARNING [platform] Health check is slow
ERROR [platform] Deployment failed

Voer de code uit als zelfstandig script. De drempel `INFO` laat alle drie de records door en de `StreamHandler` schrijft ze naar de standaarduitvoer. `propagate = False` voorkomt dat ze worden doorgestuurd naar handlers van bovenliggende loggers.

Gerelateerde lessen

  • Python · Les 27 · Gevorderd · Versie: 5

Bronnen