Accelerate documentation

日志记录

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

日志记录

请参阅故障排除指南或以下示例,了解如何使用 Accelerate 的 logger。

accelerate.logging.get_logger

< >

( name: strlog_level: str | None = None )

参数

  • name (str) — 记录器的名称,例如 __file__
  • log_level (str, 可选) — 要使用的日志级别。如果未传入,则默认为 ACCELERATE_LOG_LEVEL 环境变量。如果两者均未设置,则保留日志记录器现有的级别,若未设置级别,则从其父级继承。

返回一个可处理多进程的 logging.Logger,用于 name。

如果日志应在所有进程上调用,请传入 main_process_only=False。如果日志应在所有进程上按顺序调用,请同时传入 in_order=True。

示例:

>>> from accelerate.logging import get_logger
>>> from accelerate import Accelerator

>>> logger = get_logger(__name__)

>>> accelerator = Accelerator()
>>> logger.info("My log", main_process_only=False)
>>> logger.debug("My log", main_process_only=True)

>>> logger = get_logger(__name__, log_level="DEBUG")
>>> logger.info("My log")
>>> logger.debug("My second log")

>>> array = ["a", "b", "c", "d"]
>>> letter_at_rank = array[accelerator.process_index]
>>> logger.info(letter_at_rank, in_order=True)

库的冗长程度

使用 logging.set_verbosity() 来设置 Accelerate 内部日志记录器的默认级别:

from accelerate.logging import set_verbosity

set_verbosity("warning")

通过 log_level 或 ACCELERATE_LOG_LEVEL 设置的每个日志记录器级别具有优先权。

accelerate.logging.get_verbosity

< >

( )

以整数形式返回 Accelerate 库记录器的有效日志级别。

accelerate.logging.set_verbosity

< >

( verbosity: int | str )

参数

  • verbosity (int 或 str) — Python 日志级别,例如 logging.WARNING,或不区分大小写的级别名称,例如 "warning"。

设置 Accelerate 库日志记录器的日志级别。

这会影响 accelerate 命名空间中继承其级别的所有现有和未来的 logger。显式设置了级别的 logger(包括通过 get_logger 的 log_level 参数或 ACCELERATE_LOG_LEVEL 设置的)将保留该级别。Python 根 logger 以及 accelerate 命名空间之外的 logger 不会受到影响。

accelerate.logging.set_verbosity_debug

< >

( )

将 Accelerate 库的日志详细程度设置为 DEBUG。

accelerate.logging.set_verbosity_info

< >

( )

将 Accelerate 库的日志详细程度设置为 INFO。

accelerate.logging.set_verbosity_warning

< >

( )

将 Accelerate 库的日志级别设置为 WARNING。

accelerate.logging.set_verbosity_error

< >

( )

将 Accelerate 库的日志级别设置为 ERROR。

Update on GitHub