Buckets:

hf-doc-build
/

doc

Files

xet

hf-doc-build/doc / diffusers /main /ko /api /logging.md

mishig

about 20 hours ago

preview code

download

raw

8.1 kB

# 로깅

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

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

```python
import diffusers
diffusers.logging.set_verbosity_info()
```

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

```bash
DIFFUSERS_VERBOSITY=error ./myprogram.py
```

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

```bash
DIFFUSERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py
```

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

```python
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]]

```python
diffusers.utils.logging.set_verbosity_error()
```

[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L201)

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

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

```python
diffusers.utils.logging.set_verbosity_warning()
```

[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L191)

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

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

```python
diffusers.utils.logging.set_verbosity_info()
```

[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L186)

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

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

```python
diffusers.utils.logging.set_verbosity_debug()
```

[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L196)

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

## 기타 함수[[diffusers.utils.logging.get_verbosity]]
#### diffusers.utils.logging.get_verbosity[[diffusers.utils.logging.get_verbosity]]
```python
diffusers.utils.logging.get_verbosity()
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L147)
**반환값:** `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]]
```python
diffusers.utils.logging.set_verbosity(verbosity: int)
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L167)
**매개변수:**
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]]
```python
diffusers.utils.get_logger(name: str | None = None)
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L131)
지정된 이름의 로거를 반환합니다.
diffusers 모듈을 직접 작성하는 경우가 아니라면 이 함수에 직접 접근하지 않도록 설계되었습니다.
#### diffusers.utils.logging.enable_default_handler[[diffusers.utils.logging.enable_default_handler]]
```python
diffusers.utils.logging.enable_default_handler()
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L215)
🤗 Diffusers의 루트 로거 기본 핸들러를 활성화합니다.
#### diffusers.utils.logging.disable_default_handler[[diffusers.utils.logging.disable_default_handler]]
```python
diffusers.utils.logging.disable_default_handler()
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L206)
🤗 Diffusers의 루트 로거 기본 핸들러를 비활성화합니다.
#### diffusers.utils.logging.enable_explicit_format[[diffusers.utils.logging.enable_explicit_format]]
```python
diffusers.utils.logging.enable_explicit_format()
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L261)
모든 🤗 Diffusers 로거에 대해 명시적 포맷팅을 활성화합니다. 명시적 포맷터는 다음과 같습니다:
```
[LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE
```
이 메서드는 루트 로거에 현재 바인딩된 모든 핸들러에 영향을 미칩니다.
#### diffusers.utils.logging.reset_format[[diffusers.utils.logging.reset_format]]
```python
diffusers.utils.logging.reset_format()
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L276)
🤗 Diffusers의 로거 형식을 초기화합니다.
이 메서드는 루트 로거에 현재 바인딩된 모든 핸들러에 영향을 미칩니다.
#### diffusers.utils.logging.enable_progress_bar[[diffusers.utils.logging.enable_progress_bar]]
```python
diffusers.utils.logging.enable_progress_bar()
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L352)
tqdm 진행 표시줄을 활성화합니다.
#### diffusers.utils.logging.disable_progress_bar[[diffusers.utils.logging.disable_progress_bar]]
```python
diffusers.utils.logging.disable_progress_bar()
```
[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L358)
tqdm 진행 표시줄을 비활성화합니다.

Xet Storage Details

Size:: 8.1 kB
Xet hash:: e6b0cf79c8014d342343e8519fca3c2eb99fba95422292cbf49aad1689d5b0c4

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.

	# 로깅

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

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

	```python
	import diffusers

	diffusers.logging.set_verbosity_info()
	```

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

	```bash
	DIFFUSERS_VERBOSITY=error ./myprogram.py
	```

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

	```bash
	DIFFUSERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py
	```

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

	```python
	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]]

	```python
	diffusers.utils.logging.set_verbosity_error()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L201)

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

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

	```python
	diffusers.utils.logging.set_verbosity_warning()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L191)

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

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

	```python
	diffusers.utils.logging.set_verbosity_info()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L186)

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

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

	```python
	diffusers.utils.logging.set_verbosity_debug()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L196)

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

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

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

	```python
	diffusers.utils.logging.get_verbosity()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L147)

	반환값: `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]]

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

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L167)

	매개변수:

	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]]

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

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L131)

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

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

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

	```python
	diffusers.utils.logging.enable_default_handler()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L215)

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

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

	```python
	diffusers.utils.logging.disable_default_handler()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L206)

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

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

	```python
	diffusers.utils.logging.enable_explicit_format()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L261)

	모든 🤗 Diffusers 로거에 대해 명시적 포맷팅을 활성화합니다. 명시적 포맷터는 다음과 같습니다:
	```
	[LEVELNAME\|FILENAME\|LINE NUMBER] TIME >> MESSAGE
	```

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

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

	```python
	diffusers.utils.logging.reset_format()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L276)

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

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

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

	```python
	diffusers.utils.logging.enable_progress_bar()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L352)

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

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

	```python
	diffusers.utils.logging.disable_progress_bar()
	```

	[소스](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L358)

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