# Công cụ tiện ích

## Cấu hình ghi log[[datasets.utils.logging.get_verbosity]]

🤗 Datasets luôn hướng tới sự minh bạch và rõ ràng về cách hoạt động, nhưng đôi khi điều này có thể khá dài dòng. Chúng tôi đã bao gồm một loạt các phương thức ghi log cho phép bạn dễ dàng điều chỉnh mức độ chi tiết của toàn bộ thư viện. Hiện tại, mức độ chi tiết mặc định của thư viện được đặt ở `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ụ, đây là cách thay đổi mức độ chi tiết sang mức `INFO`:

```py
import datasets
datasets.logging.set_verbosity_info()
```

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

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

Tất cả các phương thức của module ghi log này được tài liệu hóa bên dưới. Các phương thức chính là:

- [logging.get_verbosity()](/docs/datasets/v5.2.0/vi/package_reference/utilities#datasets.utils.logging.get_verbosity) để lấy mức độ chi tiết hiện tại của logger
- [logging.set_verbosity()](/docs/datasets/v5.2.0/vi/package_reference/utilities#datasets.utils.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 (kèm các giá trị `int` tương ứng):

1. `logging.CRITICAL` hoặc `logging.FATAL` (giá trị int, 50): chỉ báo cáo các lỗi nghiêm trọng nhất.
2. `logging.ERROR` (giá trị int, 40): chỉ báo cáo các lỗi.
3. `logging.WARNING` hoặc `logging.WARN` (giá trị int, 30): chỉ báo cáo lỗi và cảnh báo. Đây là mức mặc định được thư viện sử dụng.
4. `logging.INFO` (giá trị int, 20): báo cáo lỗi, cảnh báo và thông tin cơ bản.
5. `logging.DEBUG` (giá trị int, 10): báo cáo tất cả thông tin.

#### datasets.utils.logging.get_verbosity[[datasets.utils.logging.get_verbosity]]

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

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L94)

**Trả về:**

Mức ghi log, ví dụ `datasets.logging.DEBUG` và `datasets.logging.INFO`.

Trả về mức hiện tại cho trình ghi log gốc của thư viện HuggingFace datasets.

> [!TIP]
> Thư viện datasets của HuggingFace có các cấp độ ghi log sau: - `datasets.logging.CRITICAL`, `datasets.logging.FATAL` - `datasets.logging.ERROR` - `datasets.logging.WARNING`, `datasets.logging.WARN` - `datasets.logging.INFO` - `datasets.logging.DEBUG`

#### datasets.utils.logging.set_verbosity[[datasets.utils.logging.set_verbosity]]

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

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L110)

**Tham số:**

verbosity : Mức ghi log, ví dụ: `datasets.logging.DEBUG` và `datasets.logging.INFO`.

Đặt cấp độ cho trình ghi log gốc của thư viện Hugging Face Datasets.

#### datasets.utils.logging.set_verbosity_info[[datasets.utils.logging.set_verbosity_info]]

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

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L119)

Đặt mức cho logger gốc của thư viện Hugging Face datasets thành `INFO`.

Điều này sẽ hiển thị hầu hết thông tin ghi log và các thanh tqdm.

Lối tắt đến `datasets.logging.set_verbosity(datasets.logging.INFO)`.

#### datasets.utils.logging.set_verbosity_warning[[datasets.utils.logging.set_verbosity_warning]]

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

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L129)

Đặt mức cho logger gốc của thư viện Hugging Face datasets thành `WARNING`.

Điều này sẽ chỉ hiển thị thông tin ghi log về cảnh báo và lỗi cùng các thanh tqdm.

Lối tắt đến `datasets.logging.set_verbosity(datasets.logging.WARNING)`.

#### datasets.utils.logging.set_verbosity_debug[[datasets.utils.logging.set_verbosity_debug]]

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

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L139)

Đặt mức cho logger gốc của thư viện Hugging Face datasets thành `DEBUG`.

Điều này sẽ hiển thị tất cả thông tin ghi log và các thanh tqdm.

Lối tắt đến `datasets.logging.set_verbosity(datasets.logging.DEBUG)`.

#### datasets.utils.logging.set_verbosity_error[[datasets.utils.logging.set_verbosity_error]]

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

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L149)

Đặt mức cho logger gốc của thư viện Hugging Face datasets thành `ERROR`.

Điều này sẽ chỉ hiển thị thông tin ghi log lỗi và các thanh tqdm.

Lối tắt đến `datasets.logging.set_verbosity(datasets.logging.ERROR)`.

#### datasets.utils.logging.disable_propagation[[datasets.utils.logging.disable_propagation]]

```python
datasets.utils.logging.disable_propagation()
```

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L159)

Tắt việc lan truyền các đầu ra nhật ký của thư viện. Lưu ý rằng lan truyền nhật ký bị tắt theo mặc định.

#### datasets.utils.logging.enable_propagation[[datasets.utils.logging.enable_propagation]]

```python
datasets.utils.logging.enable_propagation()
```

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L166)

Bật việc lan truyền các đầu ra nhật ký của thư viện. Vui lòng tắt trình xử lý mặc định của thư viện Hugging Face datasets để tránh ghi nhật ký trùng lặp nếu trình ghi nhật ký gốc đã được cấu hình.

## Cấu hình thanh tiến trình[[datasets.enable_progress_bars]]

Mặc định, thanh tiến trình `tqdm` sẽ được hiển thị trong quá trình tải xuống và tiền xử lý bộ dữ liệu. Bạn có thể tắt chúng toàn cục bằng cách đặt biến môi trường `HF_DATASETS_DISABLE_PROGRESS_BARS`. Bạn cũng có thể bật/tắt chúng bằng [enable_progress_bars()](/docs/datasets/v5.2.0/vi/package_reference/utilities#datasets.enable_progress_bars) và [disable_progress_bars()](/docs/datasets/v5.2.0/vi/package_reference/utilities#datasets.disable_progress_bars). Nếu được đặt, biến môi trường có ưu tiên cao hơn so với các hàm trợ giúp.

#### datasets.enable_progress_bars[[datasets.enable_progress_bars]]

```python
datasets.enable_progress_bars()
```

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L78)

Bật thanh tiến trình toàn cục được sử dụng trong `datasets`, trừ khi biến môi trường `HF_DATASETS_DISABLE_PROGRESS_BARS` đã được đặt.

Sử dụng [disable_progress_bars()](/docs/datasets/v5.2.0/vi/package_reference/utilities#datasets.disable_progress_bars) để tắt chúng.

#### datasets.disable_progress_bars[[datasets.disable_progress_bars]]

```python
datasets.disable_progress_bars()
```

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L61)

Tắt thanh tiến trình toàn cục được sử dụng trong `datasets`, trừ khi biến môi trường `HF_DATASETS_DISABLE_PROGRESS_BARS` đã được đặt.

Sử dụng [enable_progress_bars()](/docs/datasets/v5.2.0/vi/package_reference/utilities#datasets.enable_progress_bars) để bật lại chúng.

#### datasets.are_progress_bars_disabled[[datasets.are_progress_bars_disabled]]

```python
datasets.are_progress_bars_disabled()
```

[Nguồn](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L95)

Trả về trạng thái thanh tiến trình có bị vô hiệu hóa toàn cục hay không.

Thanh tiến trình được sử dụng trong `datasets` có thể được bật hoặc tắt toàn cục bằng cách sử dụng [enable_progress_bars()](/docs/datasets/v5.2.0/vi/package_reference/utilities#datasets.enable_progress_bars) và [disable_progress_bars()](/docs/datasets/v5.2.0/vi/package_reference/utilities#datasets.disable_progress_bars) hoặc bằng cách đặt `HF_DATASETS_DISABLE_PROGRESS_BARS` dưới dạng biến môi trường.

