جدول المحتويات
11.5. التسجيل #
توفر وحدة التسجيل نظام تسجيل مرنًا وكامل الميزات. في أبسط صورها، تُرسل رسائل السجل إلى ملف أو إلى 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
افتراضيًا، يتم إخفاء رسائل المعلومات ورسائل التصحيح، ويُرسل الناتج إلى الخطأ القياسي. تتضمن خيارات الإخراج الأخرى توجيه الرسائل عبر البريد الإلكتروني، أو حزم البيانات، أو المقابس، أو إلى خادم HTTP. يمكن للمرشحات الجديدة تحديد مسارات مختلفة بناءً على أولوية الرسالة: DEBUG، INFO، WARNING، ERROR، وCRITICAL.
يمكن تهيئة نظام التسجيل مباشرةً من Python أو تحميله من ملف تهيئة قابل للتعديل من قِبل المستخدم لتسجيل مُخصص دون تغيير التطبيق.