Python Academy · Lección

Handlers, formatters y filtros

Dirija la salida de los registros a archivos, streams y destinos personalizados.

Handlers, formatters y filtros es una lección gratuita de Python Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Python Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Python Academy incluye 4 lecciones en total.

Los handlers enrutan los registros de log

Un handler envía los registros de log a un destino: consola, archivo, endpoint HTTP, etc. Un logger puede tener varios handlers.

import logging

logger = logging.getLogger("myapp")
logger.setLevel(logging.DEBUG)

sh = logging.StreamHandler()
logger.addHandler(sh)

logger.info("Goes to console")

StreamHandler

StreamHandler escribe en un flujo (de forma predeterminada, sys.stderr). Pase sys.stdout para enviar la salida a stdout.

import logging, sys

logger = logging.getLogger("out")
handler = logging.StreamHandler(sys.stdout)
logger.addHandler(handler)
logger.warning("printed to stdout")

FileHandler

FileHandler añade registros a un archivo. Use mode="w" para sobrescribirlo en cada ejecución.

import logging

logging.basicConfig(
    filename="app.log",
    filemode="a",
    level=logging.INFO,
    format="%(asctime)s %(levelname)s %(message)s"
)
logging.info("Persisted to disk")

RotatingFileHandler

Rota automáticamente los archivos de log cuando superan un límite de tamaño y conserva N archivos de respaldo.

from logging.handlers import RotatingFileHandler
import logging

handler = RotatingFileHandler(
    "app.log", maxBytes=1_000_000, backupCount=5
)
logging.getLogger().addHandler(handler)

TimedRotatingFileHandler

Rota los archivos de log según un horario (diario, semanal o por hora), lo que resulta ideal para servicios de larga duración.

from logging.handlers import TimedRotatingFileHandler
import logging

handler = TimedRotatingFileHandler(
    "app.log", when="midnight", backupCount=7
)
logging.getLogger().addHandler(handler)

Formatters

Un Formatter controla la disposición del texto de cada registro de log. Asócielo a un handler con handler.setFormatter().

import logging

fmt = logging.Formatter(
    fmt="%(asctime)s %(levelname)-8s %(name)s — %(message)s",
    datefmt="%Y-%m-%dT%H:%M:%S"
)
handler = logging.StreamHandler()
handler.setFormatter(fmt)
logging.getLogger().addHandler(handler)

Filtrado a nivel de handler

Cada handler tiene su propio nivel. Un registro debe superar tanto el nivel del logger como el del handler para poder emitirse.

import logging

logger = logging.getLogger("app")
logger.setLevel(logging.DEBUG)   # logger passes DEBUG+

err_handler = logging.FileHandler("errors.log")
err_handler.setLevel(logging.ERROR)  # only ERROR+
logger.addHandler(err_handler)

Filtros personalizados

Herede de logging.Filter y sobrescriba filter(record) para aceptar o rechazar registros según cualquier criterio.

import logging

class SensitiveFilter(logging.Filter):
    def filter(self, record):
        return "password" not in record.getMessage().lower()

handler = logging.StreamHandler()
handler.addFilter(SensitiveFilter())
logging.getLogger().addHandler(handler)

Añadir campos adicionales con un filtro

Los filtros también pueden modificar el registro para inyectar campos adicionales (por ejemplo, un ID de solicitud) antes de aplicar el formato.

import logging

class RequestIDFilter(logging.Filter):
    def __init__(self, request_id):
        self.request_id = request_id
    def filter(self, record):
        record.request_id = self.request_id
        return True

# fmt: "%(request_id)s %(message)s"

Varios handlers en un logger

Añada varios handlers para enviar los mismos registros de log a múltiples destinos simultáneamente.

import logging

logger = logging.getLogger("multi")
logger.addHandler(logging.StreamHandler())             # console
logger.addHandler(logging.FileHandler("audit.log"))   # file
logger.setLevel(logging.INFO)
logger.info("Both destinations receive this")

Deshabilitar la propagación

Establezca logger.propagate = False para impedir que los registros asciendan hasta el logger raíz y se registren dos veces.

import logging

logger = logging.getLogger("mylib")
logger.propagate = False   # stays here, does not reach root
logger.addHandler(logging.StreamHandler())

Comprobación rápida

¿Qué método asocia un Formatter a un Handler?

Resumen

Los handlers enrutan los registros; los formatters les dan formato; los filtros los dejan pasar o bloquean selectivamente. Use RotatingFileHandler para logs limitados por tamaño y TimedRotatingFileHandler para rotación basada en fechas.

Preguntas frecuentes

¿La lección «Handlers, formatters y filtros» es gratis?

Sí — el texto completo de «Handlers, formatters y filtros» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Python Academy, actualiza a CoddyKit PRO. El curso de Python Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Handlers, formatters y filtros»?

Dirija la salida de los registros a archivos, streams y destinos personalizados. Practicas Python Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Python Academy?

No se requiere experiencia previa. Python Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «Handlers, formatters y filtros»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Python Academy?

Sí. Cada lección de Python Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Python Academy