logging_utilities 模块

用于日志记录的实用工具模块。

函数

function_debug_log_wrapped

在转换器类函数周围添加日志包装器。

function_debug_log_wrapped(log_level: int = 10) -> Callable[[Callable[[...], Any]], Callable[[...], Any]]

参数

名称 说明
log_level
默认值: 10

get_logger

使用遥测挂钩创建记录器。

get_logger(namespace: str | None = None, filename: str | None = None, verbosity: int = 10, extra_handlers: List[Handler] | None = None, component_name: str | None = None) -> Logger

参数

名称 说明
namespace

记录器命名空间

默认值: None
filename

日志文件名称

默认值: None
verbosity

日志记录详细程度

默认值: 10
extra_handlers

要附加到记录器的任何额外处理程序

默认值: None
component_name

组件名称

默认值: None

返回

类型 说明

如果提供了日志文件名称和命名空间,则记录器为 null 记录器

is_exception_stacktrace_loggable

is_exception_stacktrace_loggable() -> bool

is_non_automl_exception_allowed

is_non_automl_exception_allowed(exception: BaseException) -> bool

参数

名称 说明
exception
必需

is_path_allowed

is_path_allowed(exception_path: str) -> bool

参数

名称 说明
exception_path
必需

is_stdlib_module

确定这是 Python 随附的模块。

is_stdlib_module(exception_path: str) -> bool

参数

名称 说明
exception_path
必需

log_activity

记录持续时间的活动状态。

log_activity(logger: Logger, activity_name: str, activity_type: str | None = None, custom_dimensions: Dict[str, Any] | None = None) -> Iterator[Any | None]

参数

名称 说明
logger
必需

记录器

activity_name
必需

活动名称

activity_type
必需

活动类型

custom_dimensions
必需

自定义维度

log_system_info

记录 CPU、内存和 OS 信息。

log_system_info(logger: Logger, prefix_message: str = '') -> None

参数

名称 说明
logger
必需

记录器对象

prefix_message
必需

日志中前缀中的字符串

返回

类型 说明

没有

log_traceback

记录异常跟踪。

log_traceback(exception: BaseException, logger: Logger | LoggerAdapter | None, override_error_msg: str | None = None, is_critical: bool | None = True, tb: Any | None = None) -> None

参数

名称 说明
exception
必需

要记录的异常。

logger
必需

要使用的记录器。

override_error_msg

要显示的消息将覆盖当前error_msg。

默认值: None
is_critical

如果is_critical,记录器将使用 log.critical,否则为 log.error。

默认值: True
tb

要用于日志记录的跟踪;如果未提供,则使用附加到异常的异常。

默认值: None

mark_package_exceptions_as_loggable

mark_package_exceptions_as_loggable(module: module) -> None

参数

名称 说明
module
必需

mark_path_as_loggable

mark_path_as_loggable(path: str) -> None

参数

名称 说明
path
必需

mark_path_as_not_loggable

mark_path_as_not_loggable(path: str) -> None

参数

名称 说明
path
必需

remove_blacklisted_logging_keys_from_dict

以递归方式从听写中删除键。

remove_blacklisted_logging_keys_from_dict(dict_obj: Dict[str, Any]) -> None

参数

名称 说明
dict_obj
必需

remove_blacklisted_logging_keys_from_json_str

以递归方式从 json str 中删除密钥并返回 json str。

remove_blacklisted_logging_keys_from_json_str(json_str: str) -> str

参数

名称 说明
json_str
必需