دوره آموزش پایتون
ماژول logging یک سیستم ثبت وقایع منعطف و کامل (از نظر ویژگی) ارائه می کند. در ساده ترین حالت، پیام های گزارش مربوط به وقایع ثبت شده، به یک فایل یا sys.stderr فرستاده می شود.
import logging
logging.debug('Debugging information')
logging.info('Informational message')
logging.warning('Warning:config file %s not found', 'server.conf')
logging.error('Error occurred')
logging.critical('Critical error -- shutting down')
این کد، خروجی زیر را تولید می کند.
WARNING:root:Warning:config file server.conf not found
ERROR:root:Error occurred
CRITICAL:root:Critical error -- shutting down
به طور پیش فرض، پیام های اطلاعاتی و اشکال زدایی متوقف می شوند، و خروجی به خطای استاندارد فرستاده می شود. سایر گزینه های خروجی شامل مسیریابی پیام ها از طریق ایمیل، دیتاگرام (datagrams)، سوکت ها(sockets) یا یک سرور HTTP است. فیلتر های جدید می توانند بر اساس اولویت پیام (DEBUG, INFO, WARNING, ERROR, CRITICAL اشکال زدایی، اطلاعاتی، اخطار، خطا، بحرانی)، مسیر یابی های مختلفی را انتخاب کنند.
سیستم واقعه نگاری می تواند مستقیما توسط پایتون پیکربندی شود یا از یک فایل پیکربندی قابل اصلاح یک کاربر بارگذاری شود. به این ترتیب، می توان واقعه نگاری سفارشی را بدون تغییر برنامه کاربردی داشت.