# Ghi nhật ký

🤗 Diffusers có hệ thống ghi log tập trung để dễ dàng quản lý mức độ chi tiết của thư viện. Mức độ chi tiết mặc định được đặt là `WARNING`.

Để thay đổi mức độ chi tiết, hãy sử dụng một trong các bộ đặt trực tiếp. Ví dụ, để thay đổi mức độ chi tiết sang mức `INFO`.

```python
import diffusers

diffusers.logging.set_verbosity_info()
```

Bạn cũng có thể sử dụng biến môi trường `DIFFUSERS_VERBOSITY` để ghi đè mức độ chi tiết mặc định. Bạn có thể đặt nó thành một trong các giá trị sau: `debug`, `info`, `warning`, `error`, `critical`. Ví dụ:

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

Ngoài ra, một số `warnings` có thể bị vô hiệu hóa bằng cách đặt biến môi trường `DIFFUSERS_NO_ADVISORY_WARNINGS` thành một giá trị true, chẳng hạn `1`. Thao tác này sẽ vô hiệu hóa mọi cảnh báo được ghi log bởi `logger.warning_advice`. Ví dụ:

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

Dưới đây là một ví dụ về cách sử dụng cùng một trình ghi nhật ký (logger) như thư viện trong module hoặc script của bạn:

```python
from diffusers.utils import logging

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

Tất cả các phương thức của module ghi log được tài liệu hóa bên dưới. Các phương thức chính là `logging.get_verbosity` để lấy mức độ chi tiết hiện tại của trình ghi log và `logging.set_verbosity` để đặt mức độ chi tiết theo lựa chọn của bạn.

Theo thứ tự từ ít chi tiết nhất đến chi tiết nhất:

|                                                    Phương pháp | Giá trị nguyên |                                         Mô tả |
|----------------------------------------------------------:|--------------:|----------------------------------------------------:|
| `diffusers.logging.CRITICAL` hoặc `diffusers.logging.FATAL` |            50 |                chỉ báo cáo các lỗi quan trọng nhất |
|                                 `diffusers.logging.ERROR` |            40 |                                  chỉ báo cáo lỗi |
|   `diffusers.logging.WARNING` hoặc `diffusers.logging.WARN` |            30 |           chỉ báo cáo lỗi và cảnh báo (mặc định) |
|                                  `diffusers.logging.INFO` |            20 | chỉ báo cáo lỗi, cảnh báo và thông tin cơ bản |
|                                 `diffusers.logging.DEBUG` |            10 |                              báo cáo tất cả thông tin |

Mặc định, thanh tiến trình `tqdm` được hiển thị trong quá trình tải xuống mô hình. `logging.disable_progress_bar` và `logging.enable_progress_bar` được sử dụng để bật hoặc tắt hành vi này.

## Bộ thiết lập cơ bản[[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()
```

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L201)

Đặt mức độ chi tiết ở mức `ERROR`.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L191)

Đặt mức độ chi tiết ở mức `WARNING`.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L186)

Đặt mức độ chi tiết ở cấp độ `INFO`.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L196)

Đặt mức độ chi tiết ở mức `DEBUG`.

## Các hàm khác[[diffusers.utils.logging.get_verbosity]]

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L147)

**Trả về:** `int`

Các số nguyên cấp độ ghi log, có thể là một trong các giá trị:

- `50`: `diffusers.logging.CRITICAL` hoặc `diffusers.logging.FATAL`
- `40`: `diffusers.logging.ERROR`
- `30`: `diffusers.logging.WARNING` hoặc `diffusers.logging.WARN`
- `20`: `diffusers.logging.INFO`
- `10`: `diffusers.logging.DEBUG`

Trả về mức hiện tại cho trình ghi log gốc của 🤗 Diffusers dưới dạng `int`.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L167)

**Tham số:**

verbosity (`int`) : Mức ghi log, có thể là một trong các giá trị sau: - `diffusers.logging.CRITICAL` hoặc `diffusers.logging.FATAL` - `diffusers.logging.ERROR` - `diffusers.logging.WARNING` hoặc `diffusers.logging.WARN` - `diffusers.logging.INFO` - `diffusers.logging.DEBUG`

Đặt mức độ chi tiết cho trình ghi log gốc của 🤗 Diffusers.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L131)

Trả về một logger với tên được chỉ định.

Hàm này không được thiết kế để truy cập trực tiếp trừ khi bạn đang viết một module diffusers tùy chỉnh.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L215)

Bật trình xử lý mặc định của trình ghi log gốc của 🤗 Diffusers.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L206)

Tắt trình xử lý mặc định của trình ghi log gốc của 🤗 Diffusers.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L261)

Bật định dạng rõ ràng cho mọi trình ghi log của 🤗 Diffusers. Trình định dạng rõ ràng như sau:
```
[LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE
```

Tất cả các handler hiện đang được gắn với logger gốc đều bị ảnh hưởng bởi phương thức này.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L276)

Đặt lại định dạng cho các trình ghi log của 🤗 Diffusers.

Tất cả các handler hiện đang được gắn với logger gốc đều bị ảnh hưởng bởi phương thức này.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L352)

Bật thanh tiến trình tqdm.

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

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

[Nguồn](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L358)

Tắt thanh tiến trình tqdm.