CKTIS / Python
Gebeurtenissen loggen met Logger.debug, info, warning en error
Kies een methode van een logger met naam op basis van de ernst van de gebeurtenis en ontdek hoe de logger en handlers bepalen welke berichten verschijnen.
Versie: Python 3.12
Syntax
logger = logging.getLogger(name)
logger.debug(msg, *args, **kwargs)
logger.info(msg, *args, **kwargs)
logger.warning(msg, *args, **kwargs)
logger.error(msg, *args, **kwargs)In Python 3.12 haal je een logger met naam op via logging.getLogger(name), in een module meestal via logging.getLogger(__name__). Roep debug, info, warning en error aan op de teruggegeven Logger-instantie. Vraag je opnieuw dezelfde naam op, dan krijg je dezelfde instantie. Modulefuncties zoals logging.info() gebruiken daarentegen de rootlogger en roepen basicConfig() aan als die geen handlers heeft. Instantiemethoden configureren de rootlogger niet automatisch.
In oplopende ernst gebruik je debug() voor diagnosedetails (DEBUG), info() voor normale gebeurtenissen (INFO), warning() voor een mogelijk of onverwacht probleem waarbij het programma kan doorgaan (WARNING), en error() als een bewerking is mislukt (ERROR). Gebruik warning() in plaats van het verouderde warn(). Als je een uitzondering op niveau ERROR logt, wordt die uitzondering niet opnieuw opgegooid. De aanroep van error() kan wel zelf een uitzondering opgooien, bijvoorbeeld een KeyError als extra een gereserveerd veld van een LogRecord probeert te overschrijven.
Alle vier de methoden accepteren msg, *args, **kwargs. Geef waarden apart door, zoals in logger.debug("Items scanned: %d", 3): bij het opmaken van het bericht worden de waarden met % ingevuld. Zonder positionele argumenten na msg gebeurt dat niet. De opties met een naam zijn exc_info (informatie over een uitzondering), stack_info (huidige aanroepstack), stacklevel (welke aanroeplocatie wordt vastgelegd) en extra (eigen velden in het logrecord).
Het effectieve niveau van de logger is een drempel: INFO houdt DEBUG tegen. Bij NOTSET zoekt een logger met naam naar een niveau bij bovenliggende loggers; de rootlogger staat standaard op WARNING. Handlers kunnen eigen drempels en filters toepassen. Als een logrecord bij handlers van bovenliggende loggers terechtkomt, worden de niveaus en filters van die loggers zelf niet opnieuw gecontroleerd.
Voorbeelden
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")Resultaat
DEBUG inventory: Items scanned: 3 INFO inventory: Inventory loaded WARNING inventory: Stock is low ERROR inventory: Could not save inventory
Voer het script uit in een nieuw Python 3.12-proces. `basicConfig()` zet het niveau van de rootlogger op `DEBUG` en stuurt de uitvoer naar `sys.stdout`. Er verschijnen vier regels; na `logger.setLevel(logging.INFO)` wordt het laatste `DEBUG`-bericht weggefilterd.
Gerelateerde lessen
- Python · Les 24 · Gemiddeld · Versie: 3