로깅

🤗 Transformers에는 중앙 집중식 로깅 시스템이 있어 라이브러리의 로그 수준을 쉽게 설정할 수 있습니다.

현재 라이브러리의 기본 verbosity는 WARNING입니다.

로그 출력 수준을 변경하려면 직접 설정자를 사용하면 됩니다. 예를 들어, 로그 출력 수준을 INFO 수준으로 변경하는 방법은 다음과 같습니다.

import transformers

transformers.logging.set_verbosity_info()

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

TRANSFORMERS_VERBOSITY=error ./myprogram.py

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

TRANSFORMERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py

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

from transformers.utils import logging

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

이 로깅 모듈의 모든 메서드는 아래에 문서화되어 있으며, 주요 메서드는 로거의 현재 상세 수준을 가져오는 logging.get_verbosity()와 상세 수준을 원하는 수준으로 설정하는 logging.set_verbosity()입니다. (괄호 안의 int 값과 함께) 가장 덜 상세한 수준부터 가장 상세한 수준까지의 순서로, 해당 수준은 다음과 같습니다:

• transformers.logging.CRITICAL 또는 transformers.logging.FATAL (int 값, 50): 가장 치명적인 오류만 보고합니다.
• transformers.logging.ERROR (int 값, 40): 오류만 보고합니다.
• transformers.logging.WARNING 또는 transformers.logging.WARN (int 값, 30): 오류와 경고만 보고합니다. 이는 라이브러리가 기본적으로 사용하는 레벨입니다.
• transformers.logging.INFO (int 값, 20): 오류, 경고 및 기본 정보를 보고합니다.
• transformers.logging.DEBUG (int 값, 10): 모든 정보를 보고합니다.

기본적으로 모델 다운로드 중 tqdm 진행 표시줄이 표시됩니다. logging.disable_progress_bar()와 logging.enable_progress_bar()를 사용하여 이 동작을 억제하거나 해제할 수 있습니다.

logging과 warnings

Python에는 함께 사용되는 두 가지 로깅 시스템이 있습니다. 위에서 설명한 logging과, warnings입니다. warnings는 경고를 특정 범주로 더 세분화하여 분류할 수 있게 해 주며, 예를 들어 이미 비추천(deprecated)된 기능이나 경로를 나타내는 FutureWarning와 향후 비추천 예정임을 알리는 DeprecationWarning 등이 있습니다.

transformers 라이브러리에서는 두 가지를 모두 사용합니다. logging의 captureWarnings 메서드를 활용하고 수정하여, 위의 verbosity 설정자를 통해 이러한 경고 메시지를 관리할 수 있도록 합니다.

라이브러리 개발자에게는 어떤 의미가 있을까요? 다음 휴리스틱을 준수해야 합니다:

• warnings는 transformers에 의존하는 라이브러리 및 라이브러리 개발자에게 권장됩니다.
• logging은 해당 라이브러리를 일상적인 프로젝트에서 사용하는 최종 사용자를 위해 사용해야 합니다

아래의 captureWarnings 메서드 참조를 확인하세요.

기본 세터

기타 함수

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