mirror of
https://gitlab.com/allianceauth/allianceauth.git
synced 2025-07-09 20:40:17 +02:00
47 lines
1.2 KiB
Markdown
47 lines
1.2 KiB
Markdown
# Logging from Custom Apps
|
|
|
|
Alliance Auth provides a logger for use with custom apps to make everyone's life a little easier.
|
|
|
|
## Using the Extensions Logger
|
|
|
|
AllianceAuth provides a helper function to get the logger for the current module to reduce the amount of
|
|
code you need to write.
|
|
|
|
```python
|
|
from allianceauth.services.hooks import get_extension_logger
|
|
|
|
logger = get_extension_logger(__name__)
|
|
```
|
|
|
|
This works by creating a child logger of the extension logger which propagates all log entries
|
|
to the parent (extensions) logger.
|
|
|
|
## Changing the Logging Level
|
|
|
|
By default, the extension logger's level is set to `DEBUG`.
|
|
To change this, uncomment (or add) the following line in `local.py`.
|
|
|
|
```python
|
|
LOGGING['handlers']['extension_file']['level'] = 'INFO'
|
|
```
|
|
|
|
*(Remember to restart your supervisor workers after changes to `local.py`)*
|
|
|
|
This will change the logger's level to the level you define.
|
|
|
|
Options are: *(all options accept entries of levels listed below them)*
|
|
|
|
* `DEBUG`
|
|
* `INFO`
|
|
* `WARNING`
|
|
* `ERROR`
|
|
* `CRITICAL`
|
|
|
|
## allianceauth.services.hooks.get_extension_logger
|
|
|
|
```{eval-rst}
|
|
.. automodule:: allianceauth.services.hooks.get_extension_logger
|
|
:members:
|
|
:undoc-members:
|
|
```
|