# Logging

## Logging

🌍 Diffusers has a centralized logging system to easily manage the verbosity of the library. The default verbosity is set to `WARNING`.

To change the verbosity level, use one of the direct setters. For instance, to change the verbosity to the `INFO` level.

Copied

```
import diffusers

diffusers.logging.set_verbosity_info()
```

You can also use the environment variable `DIFFUSERS_VERBOSITY` to override the default verbosity. You can set it to one of the following: `debug`, `info`, `warning`, `error`, `critical`. For example:

Copied

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

Additionally, some `warnings` can be disabled by setting the environment variable `DIFFUSERS_NO_ADVISORY_WARNINGS` to a true value, like `1`. This disables any warning logged by `logger.warning_advice`. For example:

Copied

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

Here is an example of how to use the same logger as the library in your own module or script:

Copied

```
from diffusers.utils import logging

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

All methods of the logging module are documented below. The main methods are [logging.get\_verbosity()](https://huggingface.co/docs/diffusers/v0.21.0/en/api/logging#diffusers.utils.logging.get_verbosity) to get the current level of verbosity in the logger and [logging.set\_verbosity()](https://huggingface.co/docs/diffusers/v0.21.0/en/api/logging#diffusers.utils.logging.set_verbosity) to set the verbosity to the level of your choice.

In order from the least verbose to the most verbose:

|                                                    Method | Integer value |                                         Description |
| --------------------------------------------------------: | ------------: | --------------------------------------------------: |
| `diffusers.logging.CRITICAL` or `diffusers.logging.FATAL` |            50 |                only report the most critical errors |
|                                 `diffusers.logging.ERROR` |            40 |                                  only report errors |
|   `diffusers.logging.WARNING` or `diffusers.logging.WARN` |            30 |           only report errors and warnings (default) |
|                                  `diffusers.logging.INFO` |            20 | only report errors, warnings, and basic information |
|                                 `diffusers.logging.DEBUG` |            10 |                              report all information |

By default, `tqdm` progress bars are displayed during model download. [logging.disable\_progress\_bar()](https://huggingface.co/docs/diffusers/v0.21.0/en/api/logging#diffusers.utils.logging.disable_progress_bar) and [logging.enable\_progress\_bar()](https://huggingface.co/docs/diffusers/v0.21.0/en/api/logging#diffusers.utils.logging.enable_progress_bar) are used to enable or disable this behavior.

### Base setters

**diffusers.utils.logging.set\_verbosity\_error**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L179)

( )

Set the verbosity to the `ERROR` level.

**diffusers.utils.logging.set\_verbosity\_warning**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L169)

( )

Set the verbosity to the `WARNING` level.

**diffusers.utils.logging.set\_verbosity\_info**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L164)

( )

Set the verbosity to the `INFO` level.

**diffusers.utils.logging.set\_verbosity\_debug**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L174)

( )

Set the verbosity to the `DEBUG` level.

### Other functions

**diffusers.utils.logging.get\_verbosity**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L125)

( ) → `int`

Returns

`int`

Logging level integers which can be one of:

* `50`: `diffusers.logging.CRITICAL` or `diffusers.logging.FATAL`
* `40`: `diffusers.logging.ERROR`
* `30`: `diffusers.logging.WARNING` or `diffusers.logging.WARN`
* `20`: `diffusers.logging.INFO`
* `10`: `diffusers.logging.DEBUG`

Return the current level for the 🌍 Diffusers’ root logger as an `int`.

**diffusers.utils.logging.set\_verbosity**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L145)

( verbosity: int )

Parameters

* **verbosity** (`int`) — Logging level which can be one of:
  * `diffusers.logging.CRITICAL` or `diffusers.logging.FATAL`
  * `diffusers.logging.ERROR`
  * `diffusers.logging.WARNING` or `diffusers.logging.WARN`
  * `diffusers.logging.INFO`
  * `diffusers.logging.DEBUG`

Set the verbosity level for the 🌍 Diffusers’ root logger.

**diffusers.utils.get\_logger**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L111)

( name: typing.Optional\[str] = None )

Return a logger with the specified name.

This function is not supposed to be directly accessed unless you are writing a custom diffusers module.

**diffusers.utils.logging.enable\_default\_handler**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L193)

( )

Enable the default handler of the 🌍 Diffusers’ root logger.

**diffusers.utils.logging.disable\_default\_handler**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L184)

( )

Disable the default handler of the 🌍 Diffusers’ root logger.

**diffusers.utils.logging.enable\_explicit\_format**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L239)

( )

Enable explicit formatting for every 🌍 Diffusers’ logger. The explicit formatter is as follows:

Copied

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

All handlers currently bound to the root logger are affected by this method.

**diffusers.utils.logging.reset\_format**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L254)

( )

Resets the formatting for 🌍 Diffusers’ loggers.

All handlers currently bound to the root logger are affected by this method.

**diffusers.utils.logging.enable\_progress\_bar**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L330)

( )

Enable tqdm progress bar.

**diffusers.utils.logging.disable\_progress\_bar**

[\<source>](https://github.com/huggingface/diffusers/blob/v0.21.0/src/diffusers/utils/logging.py#L336)

( )

Disable tqdm progress bar.