diffusers/main/ko/api/logging.md

로깅

🤗 Diffusers는 라이브러리 로그의 상세 수준을 쉽게 관리할 수 있도록 중앙 집중식 로깅 시스템을 제공합니다. 기본 상세 수준은 WARNING으로 설정되어 있습니다.

로그 수준을 변경하려면 직접 설정자를 사용하세요. 예를 들어, 로그 수준을 INFO 수준으로 변경하려면 다음과 같습니다.

import diffusers

diffusers.logging.set_verbosity_info()

환경 변수 DIFFUSERS_VERBOSITY를 사용하여 기본 verbosity를 재정의할 수도 있습니다. 다음 값 중 하나로 설정할 수 있습니다: debug, info, warning, error, critical. 예를 들어:

DIFFUSERS_VERBOSITY=error ./myprogram.py

또한, 환경 변수 DIFFUSERS_NO_ADVISORY_WARNINGS를 1과 같은 true 값으로 설정하면 일부 warnings를 비활성화할 수 있습니다. 이렇게 하면 logger.warning_advice에 의해 기록되는 모든 경고가 비활성화됩니다. 예를 들어:

DIFFUSERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py

라이브러리와 동일한 로거를 자체 모듈이나 스크립트에서 사용하는 방법에 대한 예시는 다음과 같습니다:

from diffusers.utils import logging

logging.set_verbosity_info()
logger = logging.get_logger("diffusers")
logger.info("INFO")
logger.warning("WARN")

logging 모듈의 모든 메서드는 아래에 문서화되어 있습니다. 주요 메서드는 로거의 현재 verbosity 수준을 가져오는 logging.get_verbosity와 verbosity를 원하는 수준으로 설정하는 logging.set_verbosity입니다.

가장 간결한 것부터 가장 상세한 것 순서로:

메서드	정수 값	설명
diffusers.logging.CRITICAL 또는 diffusers.logging.FATAL	50	가장 중요한 오류만 보고
diffusers.logging.ERROR	40	오류만 보고
diffusers.logging.WARNING 또는 diffusers.logging.WARN	30	오류와 경고만 보고합니다(기본값)
diffusers.logging.INFO	20	오류, 경고 및 기본 정보만 보고
diffusers.logging.DEBUG	10	모든 정보를 보고

기본적으로 모델 다운로드 중에 tqdm 진행 표시줄이 표시됩니다. logging.disable_progress_bar와 logging.enable_progress_bar를 사용하여 이 동작을 활성화하거나 비활성화합니다.

기본 세터[[diffusers.utils.logging.set_verbosity_error]]

diffusers.utils.logging.set_verbosity_error[[diffusers.utils.logging.set_verbosity_error]]

diffusers.utils.logging.set_verbosity_error()

소스

verbose 수준을 ERROR로 설정합니다.

diffusers.utils.logging.set_verbosity_warning[[diffusers.utils.logging.set_verbosity_warning]]

diffusers.utils.logging.set_verbosity_warning()

소스

verbosity를 WARNING 수준으로 설정합니다.

diffusers.utils.logging.set_verbosity_info[[diffusers.utils.logging.set_verbosity_info]]

diffusers.utils.logging.set_verbosity_info()

소스

verbose 수준을 INFO로 설정합니다.

diffusers.utils.logging.set_verbosity_debug[[diffusers.utils.logging.set_verbosity_debug]]

diffusers.utils.logging.set_verbosity_debug()

소스

verbose 수준을 DEBUG 레벨로 설정합니다.

기타 함수[[diffusers.utils.logging.get_verbosity]]

diffusers.utils.logging.get_verbosity[[diffusers.utils.logging.get_verbosity]]

diffusers.utils.logging.get_verbosity()

소스

반환값: int

다음 중 하나일 수 있는 로깅 레벨 정수:

• 50: diffusers.logging.CRITICAL 또는 diffusers.logging.FATAL
• 40: diffusers.logging.ERROR
• 30: diffusers.logging.WARNING 또는 diffusers.logging.WARN
• 20: diffusers.logging.INFO
• 10: diffusers.logging.DEBUG

🤗 Diffusers의 루트 로거에 대한 현재 레벨을 int로 반환합니다.

diffusers.utils.logging.set_verbosity[[diffusers.utils.logging.set_verbosity]]

diffusers.utils.logging.set_verbosity(verbosity: int)

소스

매개변수:

verbosity (int) : 다음 중 하나인 로깅 레벨입니다: - diffusers.logging.CRITICAL 또는 diffusers.logging.FATAL - diffusers.logging.ERROR - diffusers.logging.WARNING 또는 diffusers.logging.WARN - diffusers.logging.INFO - diffusers.logging.DEBUG

🤗 Diffusers의 루트 로거에 대한 상세 수준을 설정합니다.

diffusers.utils.get_logger[[diffusers.utils.get_logger]]

diffusers.utils.get_logger(name: str | None = None)

소스

지정된 이름의 로거를 반환합니다.

diffusers 모듈을 직접 작성하는 경우가 아니라면 이 함수에 직접 접근하지 않도록 설계되었습니다.

diffusers.utils.logging.enable_default_handler[[diffusers.utils.logging.enable_default_handler]]

diffusers.utils.logging.enable_default_handler()

소스

🤗 Diffusers의 루트 로거 기본 핸들러를 활성화합니다.

diffusers.utils.logging.disable_default_handler[[diffusers.utils.logging.disable_default_handler]]

diffusers.utils.logging.disable_default_handler()

소스

🤗 Diffusers의 루트 로거 기본 핸들러를 비활성화합니다.

diffusers.utils.logging.enable_explicit_format[[diffusers.utils.logging.enable_explicit_format]]

diffusers.utils.logging.enable_explicit_format()

소스

모든 🤗 Diffusers 로거에 대해 명시적 포맷팅을 활성화합니다. 명시적 포맷터는 다음과 같습니다:

[LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE

이 메서드는 루트 로거에 현재 바인딩된 모든 핸들러에 영향을 미칩니다.

diffusers.utils.logging.reset_format[[diffusers.utils.logging.reset_format]]

diffusers.utils.logging.reset_format()

소스

🤗 Diffusers의 로거 형식을 초기화합니다.

이 메서드는 루트 로거에 현재 바인딩된 모든 핸들러에 영향을 미칩니다.

diffusers.utils.logging.enable_progress_bar[[diffusers.utils.logging.enable_progress_bar]]

diffusers.utils.logging.enable_progress_bar()

소스

tqdm 진행 표시줄을 활성화합니다.

diffusers.utils.logging.disable_progress_bar[[diffusers.utils.logging.disable_progress_bar]]

diffusers.utils.logging.disable_progress_bar()

소스

tqdm 진행 표시줄을 비활성화합니다.