§ ¹¦j ã ó¦—dZddlZddlZddlZddlmZdZdZdejfde de d ej fd „Z dej fd ej d e d eede d df d„ZdS)uUThÆ° viện dùng chung ghi log chuẩn hóa cho toàn bá»™ hệ thống AutoPOE2. Module này cung cấp cấu hình logger phân cấp chuẩn, định dạng đồng nhất và các hàm tiện ích ghi nhận ngoại lệ không nuốt lá»—i, tuân thủ nghiêm ngặt quy tắc chống nuốt lá»—i (Anti-Symptom Patching & Rule 16). éN)ÚOptionalzA[%(asctime)s.%(msecs)03d] [%(levelname)s] [%(name)s]: %(message)sz%Y-%m-%d %H:%M:%SÚAutoPOE2ÚnameÚlevelÚreturncó`—tj|¦«}| |¦«|js}tjt j¦«}| |¦«tjtt¬¦«}|  |¦«|  |¦«|S)uÐKhởi tạo hoặc trích xuất Logger phân cấp chuẩn cho module chỉ định. Tá»± Ä‘á»™ng cấu hình StreamHandler xuất ra stdout vá»›i định dạng chuẩn má»±c nếu logger chÆ°a có handler nào được đăng ký. Tránh trùng lặp handler khi gá»i nhiá»u lần. Args: name: Tên của logger (thÆ°á»ng là __name__ hoặc tên module nghiệp vụ). level: Cấp Ä‘á»™ ghi nhận nhật ký (mặc định logging.INFO). Returns: logging.Logger: Äối tượng logger đã được cấu hình chuẩn. Example: >>> logger = get_logger("VisualWatcher") >>> logger.info("Khởi Ä‘á»™ng hệ thống quan sát thành công.") )ÚfmtÚdatefmt) ÚloggingÚ getLoggerÚsetLevelÚhandlersÚ StreamHandlerÚsysÚstdoutÚ FormatterÚDEFAULT_LOG_FORMATÚDEFAULT_DATE_FORMATÚ setFormatterÚ addHandler)rrÚloggerÚhandlerÚ formatters ú/C:\Projects\AutoPOE2\src\common\logging_util.pyÚ get_loggerrsš€õ"Ô ˜tÑ $Ô $€FØ ‡O‚OEÑÔÐà Œ?ð#ÝÔ'­¬ Ñ3Ô3ˆØ×Ò˜ÑÔÐÝÔ%Õ*<ÕFYÐZÑZÔZˆ Ø×Ò˜YÑ'Ô'Ð'Ø×Ò˜'Ñ"Ô"Ð"à €MórÚcontextÚexcc óV—|€tj¦«\}}}|}|qd tjt |¦«||j¦«¦«}| |d|›dt |¦«j›d|›d|›¦«dS| |d|›d¦«dS)uÁGhi nhận chi tiết ngoại lệ kèm ngữ cảnh và traceback đầy đủ. Hàm này được thiết kế để triệt tiêu hoàn toàn các khối 'except: pass' vô trách nhiệm, đảm bảo má»i ngoại lệ trong runtime Ä‘á»u được lÆ°u vết chi tiết phục vụ Ä‘iá»u tra nguyên nhân gốc rá»… (Root Cause Analysis - Rule 8). Args: logger: Logger dùng để ghi nhận ngoại lệ. context: Chuá»—i mô tả ngữ cảnh xảy ra lá»—i (ví dụ: "Äá»c cấu hình visual_tool thất bại"). exc: Äối tượng ngoại lệ (nếu None, tá»± Ä‘á»™ng trích xuất từ sys.exc_info()). level: Cấp Ä‘á»™ log dùng để ghi nhận (mặc định logging.ERROR). Returns: None. Example: >>> try: ... risky_operation() ... except Exception as e: ... log_exception(logger, "Thá»±c thi tác vụ mạo hiểm", e) NÚz [EXCEPTION] z - z: ú u6 - Không trích xuất được thông tin traceback.) rÚexc_infoÚjoinÚ tracebackÚformat_exceptionÚtypeÚ __traceback__ÚlogÚ__name__)rrrrÚexc_typeÚexc_valÚexc_tbÚtb_strs rÚ log_exceptionr.0s¹€ð6 €{Ý$'¤L¡N¤NÑ!ˆ'˜6Øˆà €Ø—’Ô3µD¸±I´I¸sÀCÔDUÑVÔVÑWÔWˆØ Š 5ÐZ¨ÐZÐZµT¸#±Y´YÔ5GÐZÐZÈ3ÐZÐZÐRXÐZÐZÑ[Ô[Ð[Ð[Ð[à Š 5Ðh¨ÐhÐhÐhÑiÔiÐiÐiÐir)Ú__doc__r rr$ÚtypingrrrÚINFOÚstrÚintÚLoggerrÚERRORÚ BaseExceptionr.©rrúr8søðððð€€€Ø € € € ØÐÐÐØÐÐÐÐÐðYÐØ)Ðð&°G´LððSð¨cðÀWÄ^ðððððB$(Ø”ð #jð#jØ ŒNð#jà ð#jð -Ô ð#jð ð #jð  ð #jð#jð#jð#jð#jð#jr