New in version 0.6.0.
Setting Up Logging¶
discord.py logs errors and debug information via the logging python
module. It is strongly recommended that the logging module is
configured, as no errors or warnings will be output if it is not set up.
Configuration of the
logging module can be as simple as:
import logging logging.basicConfig(level=logging.INFO)
Placed at the start of the application. This will output the logs from
discord as well as other libraries that uses the
directly to the console.
level argument specifies what level of events to log
out and can any of
DEBUG and if not specified defaults to
More advanced setups are possible with the
logging module. To for
example write the logs to a file called
discord.log instead of
outputting them to to the console the following snippet can be used:
import discord import logging logger = logging.getLogger('discord') logger.setLevel(logging.DEBUG) handler = logging.FileHandler(filename='discord.log', encoding='utf-8', mode='w') handler.setFormatter(logging.Formatter('%(asctime)s:%(levelname)s:%(name)s: %(message)s')) logger.addHandler(handler)
This is recommended, especially at verbose levels such as
DEBUG as there are a lot of events logged and it would clog the
stdout of your program.
For more information, check the documentation and tutorial of the logging module.